華為云計(jì)算 云知識(shí) 修改終端節(jié)點(diǎn)服務(wù)UpdateEndpointService
修改終端節(jié)點(diǎn)服務(wù)UpdateEndpointService

 

功能介紹

修改終端節(jié)點(diǎn)服務(wù)。

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

PUT /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

project_id

String

項(xiàng)目ID。

vpc_endpoint_service_id

String

終端節(jié)點(diǎn)服務(wù)的ID

請(qǐng)求參數(shù)

表2 請(qǐng)求Header參數(shù)

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

X-Auth-Token

String

用戶(hù)Token。通過(guò)調(diào)用 IAM 服務(wù)獲取用戶(hù)Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。

Content-Type

String

發(fā)送的實(shí)體的MIME類(lèi)型。推薦用戶(hù)默認(rèn)使用application/json, 如果API是對(duì)象、 鏡像 上傳等接口,媒體類(lèi)型可按照流類(lèi)型的不同進(jìn)行確定。

缺省值:application/json

表3 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

approval_enabled

Boolean

是否需要審批。 ● false:不需審批,創(chuàng)建的終端節(jié)點(diǎn)連接直接為accepted狀態(tài)。 ● true:需審批,創(chuàng)建的終端節(jié)點(diǎn)連接需要終端節(jié)點(diǎn)服務(wù)所屬用戶(hù)審核后方可使用。 默認(rèn)為true,需要審批。

缺省值:true

service_name

String

終端節(jié)點(diǎn)服務(wù)的名稱(chēng),長(zhǎng)度不大于16,允許傳入大小寫(xiě)字母、數(shù)字、下劃線、中劃線。

最小長(zhǎng)度:0

最大長(zhǎng)度:16

ports

Array of PortList objects

服務(wù)開(kāi)放的端口映射列表,同一個(gè)終端節(jié)點(diǎn)服務(wù)下,不允許重復(fù)的端口映射。 若多個(gè)終端節(jié)點(diǎn)服務(wù)共用一個(gè)port_id, 則終端節(jié)點(diǎn)之間服務(wù)的所有端口映射的server_port和protocol的組合不能重復(fù), 單次最多添加200個(gè)。 該參數(shù)值將被全量更新。

port_id

String

標(biāo)識(shí)終端節(jié)點(diǎn)服務(wù)后端資源的ID, 格式為通用唯一識(shí)別碼(Universally UniqueIdentifier,下文簡(jiǎn)稱(chēng)UUID)。 取值為: ● LB類(lèi)型: 負(fù)載均衡 器內(nèi)網(wǎng)IP對(duì)應(yīng)的端口ID。 詳細(xì)內(nèi)容請(qǐng)參考《 彈性負(fù)載均衡 API參考》中的“查詢(xún)負(fù)載均衡詳情”。 ● VM類(lèi)型:彈性 云服務(wù)器 IP地址對(duì)應(yīng)的網(wǎng)卡ID。 詳細(xì)內(nèi)容請(qǐng)參考《彈性云服務(wù)器API參考》中的“查詢(xún)?cè)品?wù)器網(wǎng)卡信息”, 詳見(jiàn)響應(yīng)消息中的“port_id”字段。 ● VIP類(lèi)型:虛擬資源所在物理服務(wù)器對(duì)應(yīng)的網(wǎng)卡ID。(該字段已廢棄,請(qǐng)優(yōu)先使用LB類(lèi)型) 說(shuō)明: 當(dāng)后端資源為“LB類(lèi)型”時(shí),僅支持修改為同類(lèi)型后端資源。 例如,共享型負(fù)載均衡僅支持更換為共享型負(fù)載均衡,不支持更換為獨(dú)享型負(fù)載均衡。

tcp_proxy

String

用于控制將哪些信息(如客戶(hù)端的源IP、源端口、marker_id等)攜帶到服務(wù)端。 支持?jǐn)y帶的客戶(hù)端信息包括如下兩種類(lèi)型: ● TCP TOA:表示將客戶(hù)端信息插入到tcp option字段中攜帶至服務(wù)端。 說(shuō)明:僅當(dāng)后端資源為OBS時(shí),支持TCP TOA類(lèi)型信息攜帶方式。 ● Proxy Protocol:表示將客戶(hù)端信息插入到tcp payload字段中攜帶至服務(wù)端。 僅當(dāng)服務(wù)端支持解析上述字段時(shí),該參數(shù)設(shè)置才有效。 該參數(shù)的取值包括: ● close:表示關(guān)閉代理協(xié)議。 ● toa_open:表示開(kāi)啟代理協(xié)議“tcp_toa”。 ● proxy_open:表示開(kāi)啟代理協(xié)議“proxy_protocol”。 ● open:表示同時(shí)開(kāi)啟代理協(xié)議“tcp_toa”和“proxy_protocol”。 ● proxy_vni: 關(guān)閉toa,開(kāi)啟proxy和vni。 默認(rèn)值為“close”。

description

String

描述字段,支持中英文字母、數(shù)字等字符,不支持“<”或“>”字符。

表4 PortList

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

client_port

Integer

終端節(jié)點(diǎn)訪問(wèn)的端口。 終端節(jié)點(diǎn)提供給用戶(hù),作為訪問(wèn)終端節(jié)點(diǎn)服務(wù)的端口,范圍1-65535。

最小長(zhǎng)度:1

最大長(zhǎng)度:65535

server_port

Integer

終端節(jié)點(diǎn)服務(wù)的端口。 終端節(jié)點(diǎn)服務(wù)綁定了后端資源,作為提供服務(wù)的端口,范圍1-65535。

最小長(zhǎng)度:1

最大長(zhǎng)度:65535

protocol

String

端口映射協(xié)議,支持TCP。

缺省值:TCP

響應(yīng)參數(shù)

狀態(tài)碼: 200

表5 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

id

String

終端節(jié)點(diǎn)服務(wù)的ID,唯一標(biāo)識(shí)。

port_id

String

標(biāo)識(shí)終端節(jié)點(diǎn)服務(wù)后端資源的ID, 格式為通用唯一識(shí)別碼(Universally Unique Identifier,下文簡(jiǎn)稱(chēng)UUID)。 取值為: ● LB類(lèi)型:負(fù)載均衡器內(nèi)網(wǎng)IP對(duì)應(yīng)的端口ID。 ● VM類(lèi)型:彈性云服務(wù)器IP地址對(duì)應(yīng)的網(wǎng)卡ID。 ● VIP類(lèi)型:虛擬資源所在物理服務(wù)器對(duì)應(yīng)的網(wǎng)卡ID。(該字段已廢棄,請(qǐng)優(yōu)先使用LB類(lèi)型)

service_name

String

終端節(jié)點(diǎn)服務(wù)的名稱(chēng)。

最小長(zhǎng)度:0

最大長(zhǎng)度:128

server_type

String

資源類(lèi)型。 ● VM:云服務(wù)器。 ● VIP:虛擬IP。 ● LB:增強(qiáng)負(fù)載均衡型。

vpc_id

String

終端節(jié)點(diǎn)服務(wù)對(duì)應(yīng)后端資源所在的VPC的ID。

pool_id

String

終端節(jié)點(diǎn)服務(wù)對(duì)應(yīng)的集群id

approval_enabled

Boolean

是否需要審批。 ● false:不需要審批,創(chuàng)建的終端節(jié)點(diǎn)連接直接為accepted狀態(tài)。 ● true:需要審批,創(chuàng)建的終端節(jié)點(diǎn)連接為pendingAcceptance狀態(tài), 需要終端節(jié)點(diǎn)服務(wù)所屬用戶(hù)審核后方可使用。

status

String

終端節(jié)點(diǎn)服務(wù)的狀態(tài)。 ● creating:創(chuàng)建中 ● available:可連接 ● failed:失敗

service_type

String

終端節(jié)點(diǎn)服務(wù)類(lèi)型。 終端節(jié)點(diǎn)服務(wù)類(lèi)型包括“網(wǎng)關(guān)(gataway)型”和“接口(interface)型”: ● gataway:由運(yùn)維人員配置。用戶(hù)無(wú)需創(chuàng)建,可直接使用。 ● interface:包括運(yùn)維人員配置的云服務(wù)和用戶(hù)自己創(chuàng)建的私有服務(wù)。 其中,運(yùn)維人員配置的云服務(wù)無(wú)需創(chuàng)建,用戶(hù)可直接使用。 您可以通過(guò)創(chuàng)建終端節(jié)點(diǎn)創(chuàng)建訪問(wèn)Gateway和Interface類(lèi)型終端節(jié)點(diǎn)服務(wù)的終端節(jié)點(diǎn)。

created_at

String

終端節(jié)點(diǎn)服務(wù)的創(chuàng)建時(shí)間。 采用UTC時(shí)間格式,格式為:YYYY-MMDDTHH:MM:SSZ

updated_at

String

終端節(jié)點(diǎn)服務(wù)的更新時(shí)間。 采用UTC時(shí)間格式,格式為:YYYY-MMDDTHH:MM:SSZ

project_id

String

項(xiàng)目ID

ports

Array of PortList objects

服務(wù)開(kāi)放的端口映射列表 同一個(gè)終端節(jié)點(diǎn)服務(wù)下,不允許重復(fù)的端口映射。 若多個(gè)終端節(jié)點(diǎn)服務(wù)共用一個(gè)port_id, 則終端節(jié)點(diǎn)服務(wù)之間的所有端口映射的server_port和protocol的組合不能重復(fù)。

tcp_proxy

String

用于控制將哪些信息(如客戶(hù)端的源IP、源端口、marker_id等)攜帶到服務(wù)端。 支持?jǐn)y帶的客戶(hù)端信息包括如下兩種類(lèi)型: ● TCP TOA:表示將客戶(hù)端信息插入到tcp option字段中攜帶至服務(wù)端。 說(shuō)明:僅當(dāng)后端資源為OBS時(shí),支持TCP TOA類(lèi)型信息攜帶方式。 ● Proxy Protocol:表示將客戶(hù)端信息插入到tcp payload字段中攜帶至服務(wù)端。 僅當(dāng)服務(wù)端支持解析上述字段時(shí),該參數(shù)設(shè)置才有效。 該參數(shù)的取值包括: ● close:表示關(guān)閉代理協(xié)議。 ● toa_open:表示開(kāi)啟代理協(xié)議“tcp_toa”。 ● proxy_open:表示開(kāi)啟代理協(xié)議“proxy_protocol”。 ● open:表示同時(shí)開(kāi)啟代理協(xié)議“tcp_toa”和“proxy_protocol”。 ● proxy_vni: 關(guān)閉toa,開(kāi)啟proxy和vni。 默認(rèn)值為“close”。

tags

Array of TagList objects

資源標(biāo)簽列表

description

String

描述字段,支持中英文字母、數(shù)字等字符,不支持“<”或“>”字符。

enable_policy

Boolean

是否開(kāi)啟終端節(jié)點(diǎn)策略。 ● false:不支持設(shè)置終端節(jié)點(diǎn)策略 ● true:支持設(shè)置終端節(jié)點(diǎn)策略 默認(rèn)為false

表6 PortList

參數(shù)

參數(shù)類(lèi)型

描述

client_port

Integer

終端節(jié)點(diǎn)訪問(wèn)的端口。 終端節(jié)點(diǎn)提供給用戶(hù),作為訪問(wèn)終端節(jié)點(diǎn)服務(wù)的端口,范圍1-65535。

最小長(zhǎng)度:1

最大長(zhǎng)度:65535

server_port

Integer

終端節(jié)點(diǎn)服務(wù)的端口。 終端節(jié)點(diǎn)服務(wù)綁定了后端資源,作為提供服務(wù)的端口,范圍1-65535。

最小長(zhǎng)度:1

最大長(zhǎng)度:65535

protocol

String

端口映射協(xié)議,支持TCP。

缺省值:TCP

表7 TagList

參數(shù)

參數(shù)類(lèi)型

描述

key

String

鍵。 最大長(zhǎng)度36個(gè)unicode字符。 key不能為空。不能包含“=”、“*”、“<”、“>”、“\”、“,”、“|”和“/”,且首尾字符不能為空格。

最小長(zhǎng)度:1

最大長(zhǎng)度:36

value

String

值。 每個(gè)值最大長(zhǎng)度43個(gè)unicode字符,可以為空字符串。 不能包含“=”、“*”、“<”、“>”、“\”、“,”、“|”和“/”,且首尾字符不能為空格。

最小長(zhǎng)度:1

最大長(zhǎng)度:43

狀態(tài)碼: 400

表8 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表9 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 401

表10 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表11 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 403

表12 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表13 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 404

表14 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表15 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 405

表16 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表17 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 406

表18 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表19 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 407

表20 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表21 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 408

表22 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表23 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 409

表24 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表25 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 500

表26 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表27 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 501

表28 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表29 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 502

表30 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表31 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 503

表32 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表33 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

狀態(tài)碼: 504

表34 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類(lèi)型

描述

error

Error object

提交任務(wù)異常時(shí)返回的異常信息

表35 Error

參數(shù)

參數(shù)類(lèi)型

描述

message

String

任務(wù)異常錯(cuò)誤信息描述

code

String

任務(wù)異常錯(cuò)誤信息編碼

請(qǐng)求示例

修改終端節(jié)點(diǎn)服務(wù),訪問(wèn)端口為8081和8082,服務(wù)端口為22和23,需審批。

PUT https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2- d380272eed88

{
  "approval_enabled" : true,
  "service_name" : "test",
  "ports" : [ {
    "client_port" : 8081,
    "server_port" : 22,
    "protocol" : "TCP"
  }, {
    "client_port" : 8082,
    "server_port" : 23,
    "protocol" : "TCP"
  } ]
}

響應(yīng)示例

狀態(tài)碼: 200

服務(wù)器已成功處理了請(qǐng)求

{
  "id" : "4189d3c2-8882-4871-a3c2-d380272eed83",
  "port_id" : "4189d3c2-8882-4871-a3c2-d380272eed88",
  "vpc_id" : "4189d3c2-8882-4871-a3c2-d380272eed80",
  "pool_id" : "5289d3c2-8882-4871-a3c2-d380272eed80",
  "status" : "available",
  "approval_enabled" : false,
  "service_name" : "test123",
  "service_type" : "interface",
  "server_type" : "VM",
  "project_id" : "6e9dfd51d1124e8d8498dce894923a0d",
  "created_at" : "2022-04-14T09:35:47Z",
  "ports" : [ {
    "client_port" : 8080,
    "server_port" : 90,
    "protocol" : "TCP"
  }, {
    "client_port" : 8081,
    "server_port" : 80,
    "protocol" : "TCP"
  } ],
  "tcp_proxy" : "proxy_open"
}

狀態(tài)碼

狀態(tài)碼

描述

200

服務(wù)器已成功處理了請(qǐng)求

400

服務(wù)器未能處理請(qǐng)求

401

被請(qǐng)求的頁(yè)面需要用戶(hù)名和密碼

403

對(duì)被請(qǐng)求頁(yè)面的訪問(wèn)被禁止

404

服務(wù)器無(wú)法找到被請(qǐng)求的頁(yè)面

405

請(qǐng)求中指定的方法不被允許

406

服務(wù)器生成的響應(yīng)無(wú)法被客戶(hù)端所接受

407

用戶(hù)必須首先使用代理服務(wù)器進(jìn)行驗(yàn)證,這樣請(qǐng)求才會(huì)被處理

408

請(qǐng)求超出了服務(wù)器的等待時(shí)間

409

由于沖突,請(qǐng)求無(wú)法被完成

500

請(qǐng)求未完成。服務(wù)異常

501

請(qǐng)求未完成。服務(wù)器不支持所請(qǐng)求的功能

502

請(qǐng)求未完成。服務(wù)器從上游服務(wù)器收到一個(gè)無(wú)效的響應(yīng)

503

請(qǐng)求未完成。系統(tǒng)暫時(shí)異常

504

網(wǎng)關(guān)超時(shí)

錯(cuò)誤碼

請(qǐng)參見(jiàn)錯(cuò)誤碼。