获取权限的所有版本 - ListPermissionVersions
功能介绍
获取权限的所有版本。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。 
    授权项 访问级别 资源类型(*为必须) 条件键 别名 依赖的授权项 ram:permission:listVersions List - - - - 
URI
GET /v1/permissions/{permission_id}/versions
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| permission_id | 是 | String | 共享资源权限的ID。 | 
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| limit | 否 | Integer | 页面中最大结果的数量。当未指定limit参数情况下,系统默认值为2000。 | 
| marker | 否 | String | 页面标记。 | 
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| X-Security-Token | 否 | String | 如果正在使用临时安全凭据,则此header是必需的,该值是临时安全凭据的安全令牌(会话令牌)。 | 
响应参数
状态码:200
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| permissions | Array of PermissionSummary objects | 共享资源权限的详细信息列表。 | 
| page_info | PageInfo object | 分页详细信息。 | 
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| id | String | 权限ID。 | 
| name | String | 权限名称。 | 
| resource_type | String | 此权限适用的资源类型。 | 
| is_resource_type_default | Boolean | 该权限是否是此资源类型的默认权限。 | 
| created_at | String | 权限的创建时间。 | 
| updated_at | String | 上次更新权限的时间。 | 
| permission_urn | String | 权限URN。 | 
| permission_type | String | 权限类型,RAM托管或者租户自定义权限。 | 
| default_version | Boolean | 是否是默认版本。 | 
| version | Integer | 权限版本。 | 
| status | String | 权限的状态 | 
请求示例
无
响应示例
状态码:200
请求成功。
{
  "permissions" : [ {
    "id" : "string",
    "name" : "string",
    "resource_type" : "string",
    "is_resource_type_default" : true,
    "created_at" : "2022-09-19T02:02:18.155Z",
    "updated_at" : "2022-09-19T02:02:18.155Z",
    "permission_urn" : "string",
    "permission_type" : "string",
    "default_version" : false,
    "version" : 1,
    "status" : "string"
  } ],
  "page_info" : {
    "previous_marker" : "string",
    "next_marker" : "string",
    "current_count" : 2000
  }
}
 状态码
| 状态码 | 描述 | 
|---|---|
| 200 | 请求成功。 | 
错误码
请参见错误码。
 
  