获取权限的所有版本 - 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 |
请求成功。 |
错误码
请参见错误码。