功能介绍
批量添加或移除当前用户下 终端节点 服务的白名单。 说明 本帐号默认在自身用户的终端节点服务的白名单中。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/permissions/action
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 最小长度:1 最大长度:64 |
vpc_endpoint_service_id |
是 |
String |
终端节点服务的ID。 最小长度:1 最大长度:64 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:1 最大长度:2048 |
Content-Type |
否 |
String |
发送的实体的MIME类型。推荐用户默认使用application/json, 如果API是对象、 镜像 上传等接口,媒体类型可按照流类型的不同进行确定。 缺省值:application/json 最小长度:1 最大长度:65 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
permissions |
是 |
Array of strings |
permission列表。 权限格式为: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; “”表示所有终端节点可连接。 例如:iam:domain::6e9dfd51d1124e8d8498dce894923a0dd或者organizations:orgPath::o-3j59d1231uprgk9yuvlidra7zbzfi578/r-rldbu1vmxdw5ahdkknxnvd5rgag77m2z/ou-7tuddd8nh99rebxltawsm6qct5z7rklv/* |
permission_type |
否 |
String |
终端节点服务白名单类型。 ● domainId:基于账户ID配置终端节点服务白名单。 ● orgPath:基于账户所在组织路径配置终端节点服务白名单。 |
action |
是 |
String |
要执行的操作。 add/remove。 最小长度:1 最大长度:32 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
permissions |
Array of strings |
permission列表。 权限格式为: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”、“/-?”或者“”。 “”表示所有终端节点可连接。 例如:iam:domain::6e9dfd51d1124e8d8498dce894923a0dd或者organizations:orgPath::o-3j59d1231uprgk9yuvlidra7zbzfi578/r-rldbu1vmxdw5ahdkknxnvd5rgag77m2z/ou-7tuddd8nh99rebxltawsm6qct5z7rklv/* |
permission_type |
String |
终端节点服务白名单类型。 ● domainId:基于账户ID配置终端节点服务白名单。 ● orgPath:基于账户所在组织路径配置终端节点服务白名单。 |
状态码: 400
状态码: 401
状态码: 403
状态码: 404
状态码: 405
状态码: 406
状态码: 407
状态码: 408
状态码: 409
状态码: 500
状态码: 501
状态码: 502
状态码: 503
状态码: 504
请求示例
-
添加终端节点服务的白名单
POST https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2- d380272eed88/
permissions/action { "permissions" : [ "iam:domain::fc973eea581490997e82ea11a1d0101" ], "action" : "add" } -
移除终端节点服务的白名单
POST https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2- d380272eed88/
permissions/action { "permissions" : [ "iam:domain::fc973eea581490997e82ea11a1d0101" ], "action" : "remove" }
响应示例
状态码: 200
服务器已成功处理了请求
{ "permissions" : [ "iam:domain::5fc973eea581490997e82ea11a1d0101", "iam:domain::5fc973eea581490997e82ea11a1d0102" ] }
状态码
状态码 |
描述 |
---|---|
200 |
服务器已成功处理了请求 |
400 |
服务器未能处理请求 |
401 |
被请求的页面需要用户名和密码 |
403 |
对被请求页面的访问被禁止 |
404 |
服务器无法找到被请求的页面 |
405 |
请求中指定的方法不被允许 |
406 |
服务器生成的响应无法被客户端所接受 |
407 |
用户必须首先使用代理服务器进行验证,这样请求才会被处理 |
408 |
请求超出了服务器的等待时间 |
409 |
由于冲突,请求无法被完成 |
500 |
请求未完成。服务异常 |
501 |
请求未完成。服务器不支持所请求的功能 |
502 |
请求未完成。服务器从上游服务器收到一个无效的响应 |
503 |
请求未完成。系统暂时异常 |
504 |
网关超时 |
错误码
请参见错误码。