華為云計算 云知識 更新終端節(jié)點連接描述UpdateEndpointConnectionsDesc
更新終端節(jié)點連接描述UpdateEndpointConnectionsDesc

 

功能介紹

更新終端節(jié)點服務(wù)連接的終端節(jié)點的描述。

調(diào)試

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

URI

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

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

租戶ID

最小長度:32

最大長度:64

vpc_endpoint_service_id

String

終端節(jié)點服務(wù)ID

最小長度:36

最大長度:64

請求參數(shù)

表2 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

connections

Array of ConnectionsDesc objects

連接管理描述字段列表

表3 ConnectionsDesc

參數(shù)

是否必選

參數(shù)類型

描述

id

String

終端節(jié)點ID,UUID格式字符

description

String

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

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

狀態(tài)碼: 200

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

參數(shù)

參數(shù)類型

描述

connections

Array of ConnectionEndpoints objects

連接列表

表5 ConnectionEndpoints

參數(shù)

參數(shù)類型

描述

id

String

終端節(jié)點的ID,唯一標(biāo)識。

marker_id

Integer

終端節(jié)點的報文標(biāo)識。

created_at

String

終端節(jié)點的創(chuàng)建時間。 采用UTC時間格式,格式為:YYYY-MMDDTHH:MM:SSZ

updated_at

String

終端節(jié)點的更新時間。 采用UTC時間格式,格式為:YYYY-MMDDTHH:MM:SSZ

domain_id

String

用戶的Domain ID。

error

Array of QueryError objects

錯誤信息。

當(dāng)終端節(jié)點服務(wù)狀態(tài)異常,即“status”的值為“failed”時,會返回該字段。

status

String

終端節(jié)點的連接狀態(tài)。 ● pendingAcceptance:待接受 ● creating:創(chuàng)建中 ● accepted:已接受 ● rejected:已拒絕 ● failed:失敗 ● deleting:刪除中

description

String

終端節(jié)點連接描述。

表6 QueryError

參數(shù)

參數(shù)類型

描述

error_code

String

錯誤編碼。

error_message

String

錯誤信息。

狀態(tài)碼: 400

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表8 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 401

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表10 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 403

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表12 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 404

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表14 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 405

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表16 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 406

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表18 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 407

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表20 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 408

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表22 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 409

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表24 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 500

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表26 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 501

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表28 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 502

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表30 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 503

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表32 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 504

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表34 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

請求示例

更新終端節(jié)點連接描述

https://{endpoint}/v1/{project_id}/vpc-endpoint-services/813d9300-8473-405b-bfcd-f711117bad65/connections/description

{
  "connections" : [ {
    "id" : "0df78897-35b0-4a93-ad17-0bc0585f546b",
    "description" : "終端節(jié)點節(jié)點1, 屬于賬戶[0605767a3300d5762fb7c0186d9e1779]abc_26"
  }, {
    "id" : "0d837f75-90d5-4528-bd11-5d974238ebca",
    "description" : "終端節(jié)點節(jié)點2, 屬于賬戶[7876999999999]abc_26"
  } ]
}

響應(yīng)示例

狀態(tài)碼: 200

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

{
  "connections" : [ {
    "id" : "0d837f75-90d5-4528-bd11-5d974238ebca",
    "status" : "accepted",
    "description" : "終端節(jié)點節(jié)點2, 屬于賬戶[7876999999999]abc_26",
    "marker_id" : 302008767,
    "domain_id" : "05b5408a0a80d2b10f06c0184a774460",
    "created_at" : "2022-04-14T02:09:08Z",
    "updated_at" : "2022-04-14T07:55:40Z"
  }, {
    "id" : "0df78897-35b0-4a93-ad17-0bc0585f546b",
    "status" : "accepted",
    "description" : "終端節(jié)點節(jié)點1, 屬于賬戶[0605767a3300d5762fb7c0186d9e1779]abc_26",
    "marker_id" : 302001833,
    "domain_id" : "05b5408a0a80d2b10f06c0184a774460",
    "created_at" : "2022-04-14T01:59:31Z",
    "updated_at" : "2022-04-14T07:57:39Z"
  } ]
}

狀態(tài)碼

狀態(tài)碼

描述

200

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

400

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

401

被請求的頁面需要用戶名和密碼

403

對被請求頁面的訪問被禁止

404

服務(wù)器無法找到被請求的頁面

405

請求中指定的方法不被允許

406

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

407

用戶必須首先使用代理服務(wù)器進行驗證,這樣請求才會被處理

408

請求超出了服務(wù)器的等待時間

409

由于沖突,請求無法被完成

500

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

501

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

502

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

503

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

504

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

錯誤碼

請參見錯誤碼。