功能介绍
更新当前用户下 终端节点 服务白名单的描述信息
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
PUT /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/permissions/{permission_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 最小长度:1 最大长度:64 |
vpc_endpoint_service_id |
是 |
String |
终端节点服务的ID。 最小长度:1 最大长度:64 |
permission_id |
是 |
String |
白名单的ID。 最小长度:1 最大长度:64 |
请求参数
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
白名单表主键ID |
permission |
String |
权限格式为: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/* 最小长度:1 最大长度:1024 |
permission_type |
String |
终端节点服务白名单类型。 ● domainId:基于账户ID配置终端节点服务白名单。 ● orgPath:基于账户所在组织路径配置终端节点服务白名单。 |
description |
String |
终端节点服务白名单描述 |
created_at |
String |
白名单创建时间 |
状态码: 400
状态码: 401
状态码: 403
状态码: 404
状态码: 405
状态码: 406
状态码: 407
状态码: 408
状态码: 409
状态码: 500
状态码: 501
状态码: 502
状态码: 503
状态码: 504
请求示例
更新终端节点服务白名单描述
PUT https://{endpoint}/v1/{project_id}/vpc-endpoint-services/c07132bf-4071-439a-9ff3-2068eb45092f/
permissions/849046d9-7342-44ba-b2d2-367d8de6311b { "permission" : { "description" : "终端节点服务添加白名单" } }
响应示例
状态码: 200
服务器已成功处理了请求
{ "permissions" : [ { "id" : "849046d9-7342-44ba-b2d2-367d8de6311b", "permission" : "*", "description" : "终端节点服务添加白名单", "created_at" : "2022-06-16T09:48:21Z" } ] }
状态码
状态码 |
描述 |
---|---|
200 |
服务器已成功处理了请求 |
400 |
服务器未能处理请求 |
401 |
被请求的页面需要用户名和密码 |
403 |
对被请求页面的访问被禁止 |
404 |
服务器无法找到被请求的页面 |
405 |
请求中指定的方法不被允许 |
406 |
服务器生成的响应无法被客户端所接受 |
407 |
用户必须首先使用代理服务器进行验证,这样请求才会被处理 |
408 |
请求超出了服务器的等待时间 |
409 |
由于冲突,请求无法被完成 |
500 |
请求未完成。服务异常 |
501 |
请求未完成。服务器不支持所请求的功能 |
502 |
请求未完成。服务器从上游服务器收到一个无效的响应 |
503 |
请求未完成。系统暂时异常 |
504 |
网关超时 |
错误码
请参见错误码。