華為云計(jì)算 云知識(shí) 查詢終端節(jié)點(diǎn)服務(wù)概要ListServiceDescribeDetails
查詢終端節(jié)點(diǎn)服務(wù)概要ListServiceDescribeDetails

 

功能介紹

查詢終端節(jié)點(diǎn)服務(wù)的概要信息, 此接口是供創(chuàng)建終端節(jié)點(diǎn)的用戶來查詢需要連接的終端節(jié)點(diǎn)服務(wù)信息。 此接口既可以方便其他用戶查詢到您的終端節(jié)點(diǎn)服務(wù)概要信息, 又可以避免您的終端節(jié)點(diǎn)服務(wù)的細(xì)節(jié)信息暴露給其他用戶。

調(diào)試

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

URI

GET /v1/{project_id}/vpc-endpoint-services/describe

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID。

最小長度:1

最大長度:64

表2 Query參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

endpoint_service_name

String

終端節(jié)點(diǎn)服務(wù)的名稱。說明:該字段和id字段必須二選一,否則會(huì)出現(xiàn)錯(cuò)誤。

最小長度:1

最大長度:128

id

String

終端節(jié)點(diǎn)服務(wù)的ID,唯一標(biāo)識(shí)。 說明:該字段必須和endpoint_service_name字段二選一,否則會(huì)出現(xiàn)錯(cuò)誤。

最小長度:1

最大長度:64

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

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

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

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

最小長度:1

最大長度:2048

Content-Type

String

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

缺省值:application/json

最小長度:1

最大長度:64

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

狀態(tài)碼: 200

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

參數(shù)

參數(shù)類型

描述

id

String

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

service_name

String

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

service_type

String

終端節(jié)點(diǎn)服務(wù)類型。僅支持將用戶私有服務(wù)創(chuàng)建為interface類型的終端節(jié)點(diǎn)服務(wù)。 ● gataway:由運(yùn)維人員配置。用戶無需創(chuàng)建,可直接使用。 ● interface:包括運(yùn)維人員配置的云服務(wù)和用戶自己創(chuàng)建的私有服務(wù)。 其中,運(yùn)維人員配置的云服務(wù)無需創(chuàng)建,用戶可直接使用。 您可以通過創(chuàng)建終端節(jié)點(diǎn)創(chuàng)建訪問Gateway和Interface類型終端節(jié)點(diǎn)服務(wù)的終端節(jié)點(diǎn)。

created_at

String

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

is_charge

Boolean

連接該終端節(jié)點(diǎn)服務(wù)的終端節(jié)點(diǎn)是否計(jì)費(fèi)。 ● true:計(jì)費(fèi) ● false:不計(jì)費(fèi)

public_border_group

String

終端節(jié)點(diǎn)對(duì)應(yīng)Pool的Public Border Group信息

enable_policy

Boolean

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

狀態(tài)碼: 400

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表6 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 401

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表8 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 403

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表10 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 404

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表12 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 405

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表14 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 406

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表16 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 407

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表18 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 408

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表20 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 409

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表22 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 500

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表24 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 501

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表26 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 502

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表28 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 503

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表30 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 504

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表32 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

請(qǐng)求示例

查詢終端節(jié)點(diǎn)服務(wù)概要

GET https://{endpoint}/v1/{project_id}/vpc-endpoint-services/describe?id=4189d3c2-8882-4871-a3c2-d380272eed83

響應(yīng)示例

狀態(tài)碼: 200

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

{
  "id" : "9d4c1028-1336-4556-9881-b5d807c1b8a8",
  "service_name" : "test123",
  "service_type" : "interface",
  "created_at" : "2018-09-17T07:28:31Z",
  "is_charge" : "true"
}

狀態(tài)碼

狀態(tài)碼

描述

200

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

400

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

401

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

403

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

404

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

405

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

406

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

407

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

408

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

409

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

500

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

501

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

502

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

503

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

504

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

錯(cuò)誤碼

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