華為云計算 云知識 接受或拒絕終端節(jié)點的連接AcceptOrRejectEndpoint
接受或拒絕終端節(jié)點的連接AcceptOrRejectEndpoint

 

功能介紹

接受或者拒絕終端節(jié)點連接到當前的終端節(jié)點服務。

調試

您可以在API Explorer中調試該接口,支持自動認證鑒權。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調試功能。

URI

POST /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/connections/action

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目ID。

最小長度:1

最大長度:64

vpc_endpoint_service_id

String

終端節(jié)點服務的ID。

最小長度:1

最大長度:64

請求參數(shù)

表2 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。通過調用 IAM 服務獲取用戶Token接口獲取(響應消息頭中X-Subject-Token的值)。

最小長度:1

最大長度:2048

Content-Type

String

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

缺省值:application/json

最小長度:1

最大長度:64

表3 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

action

String

允許或拒絕連接。 ● receive:允許連接。 ● reject:拒絕連接。

最小長度:1

最大長度:32

endpoints

Array of strings

終端節(jié)點ID列表。 每次請求目前支持單條endpoint的接受或拒絕。

響應參數(shù)

狀態(tài)碼: 200

表4 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

connections

Array of ConnectionEndpoints objects

連接列表

表5 ConnectionEndpoints

參數(shù)

參數(shù)類型

描述

id

String

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

marker_id

Integer

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

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

錯誤信息。

當終端節(jié)點服務狀態(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 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表8 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 401

表9 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表10 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 403

表11 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表12 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 404

表13 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表14 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 405

表15 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表16 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 406

表17 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表18 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 407

表19 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表20 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 408

表21 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表22 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 409

表23 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表24 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 500

表25 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表26 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 501

表27 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表28 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 502

表29 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表30 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 503

表31 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表32 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

狀態(tài)碼: 504

表33 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

提交任務異常時返回的異常信息

表34 Error

參數(shù)

參數(shù)類型

描述

message

String

任務異常錯誤信息描述

code

String

任務異常錯誤信息編碼

請求示例

接受終端節(jié)點的連接

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

{
  "endpoints" : [ "705290f3-0d00-41f2-aedc-71f09844e879" ],
  "action" : "receive"
}

響應示例

狀態(tài)碼: 200

服務器已成功處理了請求

{
  "connections" : [ {
    "id" : "4189d3c2-8882-4871-a3c2-d380272eed83",
    "status" : "accepted",
    "marker_id" : 422321321312321321,
    "domain_id" : "6e9dfd51d1124e8d8498dce894923a0d",
    "created_at" : "2022-04-14T09:35:47Z",
    "updated_at" : "2022-04-14T09:36:47Z"
  } ]
}

狀態(tài)碼

狀態(tài)碼

描述

200

服務器已成功處理了請求

400

服務器未能處理請求

401

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

403

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

404

服務器無法找到被請求的頁面

405

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

406

服務器生成的響應無法被客戶端所接受

407

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

408

請求超出了服務器的等待時間

409

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

500

請求未完成。服務異常

501

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

502

請求未完成。服務器從上游服務器收到一個無效的響應

503

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

504

網(wǎng)關超時

錯誤碼

請參見錯誤碼。