检索资源共享权限内容 - ShowPermission

功能介绍

检索指定资源类型的共享资源指定版本的权限内容，如果不指定权限版本，则返回默认版本的权限内容。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
ram:permissions:get
Read
permission *
-
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
ram:permissions:get	Read	permission *	-	-	-

URI

GET /v1/permissions/{permission_id}

表1 路径参数
参数	是否必选	参数类型	描述
permission_id	是	String	共享资源权限的ID。

表2 Query参数
参数	是否必选	参数类型	描述
permission_version	否	Integer	资源权限版本。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Security-Token	否	String	如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
permission	Permission object	有关RAM权限的信息。

表5 Permission
参数	参数类型	描述
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 /v1/permissions/{permission_id}

响应示例

状态码：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"
  }
}