功能介紹
批量添加或移除當(dāng)前用戶下終端節(jié)點服務(wù)的白名單。 說明 本帳號默認(rèn)在自身用戶的終端節(jié)點服務(wù)的白名單中。
調(diào)試
您可以在API Explorer中調(diào)試該接口，支持自動認(rèn)證鑒權(quán)。API Explorer可以自動生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。
URI
POST /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/permissions/action
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項目ID。 最小長度：1 最大長度：64 |
|
vpc_endpoint_service_id |
是 |
String |
終端節(jié)點服務(wù)的ID。 最小長度：1 最大長度：64 |
請求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用戶Token。通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。 最小長度：1 最大長度：2048 |
|
Content-Type |
否 |
String |
發(fā)送的實體的MIME類型。推薦用戶默認(rèn)使用application/json， 如果API是對象、 鏡像 上傳等接口，媒體類型可按照流類型的不同進行確定。 缺省值：application/json 最小長度：1 最大長度：65 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
permissions |
是 |
Array of strings |
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”或者“，最大長度可以傳64； org_path類型支持“a~z”、“A~Z”、“0~9”、“/-?”或者“”，最大長度可以傳1024； “”表示所有終端節(jié)點可連接。 例如：iam:domain::6e9dfd51d1124e8d8498dce894923a0dd或者organizations:orgPath::o-3j59d1231uprgk9yuvlidra7zbzfi578/r-rldbu1vmxdw5ahdkknxnvd5rgag77m2z/ou-7tuddd8nh99rebxltawsm6qct5z7rklv/* |
|
permission_type |
否 |
String |
終端節(jié)點服務(wù)白名單類型。 ● domainId：基于賬戶ID配置終端節(jié)點服務(wù)白名單。 ● orgPath：基于賬戶所在組織路徑配置終端節(jié)點服務(wù)白名單。 |
|
action |
是 |
String |
要執(zhí)行的操作。 add/remove。 最小長度：1 最大長度：32 |
響應(yīng)參數(shù)
狀態(tài)碼： 200
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
permissions |
Array of strings |
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é)點可連接。 例如：iam:domain::6e9dfd51d1124e8d8498dce894923a0dd或者organizations:orgPath::o-3j59d1231uprgk9yuvlidra7zbzfi578/r-rldbu1vmxdw5ahdkknxnvd5rgag77m2z/ou-7tuddd8nh99rebxltawsm6qct5z7rklv/* |
|
permission_type |
String |
終端節(jié)點服務(wù)白名單類型。 ● domainId：基于賬戶ID配置終端節(jié)點服務(wù)白名單。 ● orgPath：基于賬戶所在組織路徑配置終端節(jié)點服務(wù)白名單。 |
狀態(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é)點服務(wù)的白名單
POST https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2- d380272eed88/
permissions/action { "permissions" : [ "iam:domain::fc973eea581490997e82ea11a1d0101" ], "action" : "add" } -
移除終端節(jié)點服務(wù)的白名單
POST https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2- d380272eed88/
permissions/action { "permissions" : [ "iam:domain::fc973eea581490997e82ea11a1d0101" ], "action" : "remove" }
響應(yīng)示例
狀態(tài)碼： 200
服務(wù)器已成功處理了請求
{
"permissions" : [ "iam:domain::5fc973eea581490997e82ea11a1d0101", "iam:domain::5fc973eea581490997e82ea11a1d0102" ]
}
狀態(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)超時 |
錯誤碼
請參見錯誤碼。
