检索资源共享权限内容
功能介绍
检索指定资源类型的共享资源指定版本的权限内容,如果不指定权限版本,则返回默认版本的权限内容。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET https://{endpoint}/v1/permissions/{permission_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
permission_id |
是 |
String |
共享资源权限的ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
permission_version |
否 |
Integer |
资源权限版本。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据,则此header是必需的,该值是临时安全凭据的安全令牌(会话令牌)。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
permission |
Permission object |
有关RAM权限的信息。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
权限ID。 |
name |
String |
权限名称。 |
resource_type |
String |
资源类型。 |
content |
String |
权限的影响和行为。 |
is_resource_type_default |
Boolean |
该权限是否是此资源类型的默认权限。 |
created_at |
String |
权限的创建时间。 |
updated_at |
String |
最后一次更新权限的时间。 |
permission_urn |
String |
权限URN。 |
permission_type |
String |
权限类型。 |
default_version |
Boolean |
此权限是否为默认版本。 |
version |
Integer |
权限版本。 |
status |
String |
权限的状态 |
请求示例
检索指定资源类型的共享资源指定版本的权限内容,如果不指定权限版本,则返回默认版本的权限内容。
GET https://{endpoint}/v1/permissions/{permission_urn}
响应示例
状态码: 200
请求成功。
{ "permission" : { "id" : "string", "name" : "string", "resource_type" : "string", "content" : "string", "is_resource_type_default" : true, "created_at" : "2022-08-22T11:40:31.871Z", "updated_at" : "2022-08-22T11:40:31.871Z", "permission_urn" : "string", "permission_type" : "string", "default_version" : false, "version" : 1, "status" : "string" } }
状态码
状态码 |
描述 |
---|---|
200 |
请求成功。 |
错误码
请参见错误码。