功能介紹
查詢當(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
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項(xiàng)目ID。 最小長度:1 最大長度:64 |
|
vpc_endpoint_service_id |
是 |
String |
終端節(jié)點(diǎn)服務(wù)的ID。 最小長度:1 最大長度:64 |
|
參數(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ù)
|
參數(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
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
permissions |
permission列表。 |
|
|
total_count |
Integer |
滿足查詢條件的終端節(jié)點(diǎn)服務(wù)的白名單總條數(shù),不受分頁(即limit、offset參數(shù))影響。 |
|
參數(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
狀態(tài)碼: 401
狀態(tài)碼: 403
狀態(tài)碼: 404
狀態(tài)碼: 405
狀態(tài)碼: 406
狀態(tài)碼: 407
狀態(tài)碼: 408
狀態(tài)碼: 409
狀態(tài)碼: 500
狀態(tài)碼: 501
狀態(tài)碼: 502
狀態(tài)碼: 503
狀態(tài)碼: 504
請求示例
查詢終端節(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ò)誤碼。
最新文章
- 好用的VPCEP_終端節(jié)點(diǎn)服務(wù)管理_VPC終端節(jié)點(diǎn)是什么
- VPCEP終端節(jié)點(diǎn)產(chǎn)品功能_VPC終端節(jié)點(diǎn)免費(fèi)嗎_VPC終端節(jié)點(diǎn)優(yōu)勢
- 終端節(jié)點(diǎn)管理_如何使用VPC終端節(jié)點(diǎn)_VPC終端節(jié)點(diǎn)應(yīng)用場景
- VPC終端節(jié)點(diǎn)的作用是什么_VPC終端節(jié)點(diǎn)應(yīng)用場景_華為云VPC終端節(jié)點(diǎn)
- web應(yīng)用防火墻添加黑白名單_web應(yīng)用防火墻修改黑白名單_web應(yīng)用防火墻刪除黑白名單
- 企業(yè)信息安全_企業(yè)信息安全服務(wù)_
