華為云計(jì)算 云知識 查詢終端節(jié)點(diǎn)服務(wù)的白名單列表listservicepermissionsdetails
查詢終端節(jié)點(diǎn)服務(wù)的白名單列表listservicepermissionsdetails

 

功能介紹

查詢當(dāng)前用戶下終端節(jié)點(diǎn)服務(wù)的白名單列表。 說明 本帳號默認(rèn)在當(dāng)前用戶下終端節(jié)點(diǎn)服務(wù)的白名單中。

調(diào)試

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

URI

GET /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/permissions

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID。

最小長度:1

最大長度:64

vpc_endpoint_service_id

String

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

最小長度:1

最大長度:64

表2 Query參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

permission

String

權(quán)限帳號ID,格式為“iam:domain::domain_id”。 其中“domain_id”為授權(quán)用戶的帳號ID, 例如“iam:domain::6e9dfd51d1124e8d8498dce894923a0d”,支持模糊搜索。

最小長度:1

最大長度:1000

limit

Integer

查詢返回終端節(jié)點(diǎn)服務(wù)的白名單數(shù)量限制,即每頁返回的個(gè)數(shù)。 取值范圍:0~500,取值一般為10,20或者50,默認(rèn)為10。

最小值:1

最大值:500

缺省值:10

offset

Integer

偏移量。 偏移量為一個(gè)大于0小于終端節(jié)點(diǎn)服務(wù)總個(gè)數(shù)的整數(shù), 表示從偏移量后面的終端節(jié)點(diǎn)服務(wù)開始查詢。

最小值:0

sort_key

String

查詢結(jié)果中白名單列表的排序字段,取值為create_at,表示白名單的添加時(shí)間。

缺省值:create_at

sort_dir

String

查詢結(jié)果中白名單列表的排序方式,取值為: ● desc:降序排序 ● asc:升序排序 默認(rèn)值為desc。

缺省值:desc

請求參數(shù)

表3 請求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是對象、 鏡像 上傳等接口,媒體類型可按照流類型的不同進(jìn)行確定。

缺省值:application/json

最小長度:1

最大長度:64

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

狀態(tài)碼: 200

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

參數(shù)

參數(shù)類型

描述

permissions

Array of PermissionObject objects

permission列表。

total_count

Integer

滿足查詢條件的終端節(jié)點(diǎn)服務(wù)的白名單總條數(shù),不受分頁(即limit、offset參數(shù))影響。

表5 PermissionObject

參數(shù)

參數(shù)類型

描述

id

String

permission的ID,唯一標(biāo)識。

permission

String

permission列表。 權(quán)限格式為:iam:domain::domain_id或者organizations:orgPath::org_path其中, ● “iam:domain::”和“organizations:orgPath::”為固定格式。 ● “domain_id”為可連接用戶的帳號ID,org_path可連接用戶的組織路徑 domain_id類型支持輸入包括“a~z”、“A~Z”、“0~9”或者“”,org_path類型支持“a~z”、“A~Z”、“0~9”、“/-?”或者“”。 “”表示所有終端節(jié)點(diǎn)可連接。 例如:iam:domain::6e9dfd51d1124e8d8498dce894923a0dd或者organizations:orgPath::o-3j59d1231uprgk9yuvlidra7zbzfi578/r-rldbu1vmxdw5ahdkknxnvd5rgag77m2z/ou-7tuddd8nh99rebxltawsm6qct5z7rklv/*

permission_type

String

終端節(jié)點(diǎn)服務(wù)白名單類型。 ● domainId:基于賬戶ID配置終端節(jié)點(diǎn)服務(wù)白名單。 ● orgPath:基于賬戶所在組織路徑配置終端節(jié)點(diǎn)服務(wù)白名單。

created_at

String

白名單的添加時(shí)間。 采用UTC時(shí)間格式,格式為:YYYY-MMDDTHH:MM:SSZ

狀態(tài)碼: 400

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表7 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 401

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表9 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 403

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表11 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 404

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表13 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 405

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表15 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 406

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表17 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 407

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表19 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 408

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表21 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 409

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表23 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 500

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表25 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 501

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表27 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 502

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表29 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 503

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表31 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

狀態(tài)碼: 504

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表33 Error

參數(shù)

參數(shù)類型

描述

message

String

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

code

String

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

請求示例

查詢終端節(jié)點(diǎn)服務(wù)的白名單列表

GET https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2-d380272eed88/permissions?
permission={permission}&sort_dir={sort_dir}&limit={limit}&offset={offset} 查詢終端節(jié)點(diǎn)服務(wù)ID為“4189d3c2-8882-4871-a3c2-d380272eed88”的白名單列表。 GET https://{endpoint}/v1/{project_id}/
vpc-endpoint-services/4189d3c2-8882-4871-a3c2-d380272eed88/permissions

響應(yīng)示例

狀態(tài)碼: 200

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

{
  "permissions" : [ {
    "id" : "f2659906-c622-480a-83e9-ef42bdb67b90",
    "permission" : "*",
    "created_at" : "2018-10-18T13:26:40Z"
  } ],
  "total_count" : 1
}

狀態(tài)碼

狀態(tài)碼

描述

200

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

400

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

401

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

403

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

404

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

405

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

406

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

407

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

408

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

409

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

500

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

501

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

502

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

503

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

504

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

錯(cuò)誤碼

請參見錯(cuò)誤碼。