Listing Custom Policies¶
Function¶
This API is provided for the administrator to list all custom policies.
The API can be called using both the global endpoint and region-specific endpoints.
URI¶
GET /v3.0/OS-ROLE/roles
Parameter | Mandatory | Type | Description |
---|---|---|---|
page | No | Integer | Page number for pagination query. The minimum value is 1. This parameter must be used together with per_page. |
per_page | No | Integer | Number of data records to be displayed on each page. The value ranges from 1 to 300. This parameter must be used together with page. |
Request Parameters¶
Parameter | Mandatory | Type | Description |
---|---|---|---|
Content-Type | Yes | String | Fill application/json;charset=utf8 in this field. |
X-Auth-Token | Yes | String | Token with Security Administrator permissions. |
Response Parameters¶
Parameter | Type | Description |
---|---|---|
Object | Resource link information. | |
Array of objects | Custom policy information. | |
total_number | Integer | Total number of custom policies returned. |
Parameter | Type | Description |
---|---|---|
self | String | Resource link. |
previous | String | Previous resource link. |
next | String | Next resource link. |
Parameter | Type | Description |
---|---|---|
domain_id | String | ID of the account to which the custom policy belongs. |
references | Integer | Number of references. |
updated_time | String | Time when the custom policy was last updated. |
created_time | String | Time when the custom policy was created. |
description_cn | String | Description of the custom policy. |
catalog | String | Service catalog. |
name | String | Name of the custom policy. |
description | String | Description of the custom policy. |
Object | Resource link of the custom policy. | |
id | String | Policy ID. |
display_name | String | Display name of the custom policy. |
type | String | Display mode. Note
|
Object | Content of custom policy. |
Parameter | Type | Description |
---|---|---|
self | String | Resource link. |
Parameter | Type | Description |
---|---|---|
Version | String | Policy version. Note
|
Array of objects | Statement of the policy. A policy can contain a maximum of eight statements. |
Parameter | Type | Description |
---|---|---|
Action | Array of strings | Specific operation permission on a resource. A maximum of 100 actions are allowed. Note
|
Effect | String | Effect of the permission. The value can be Allow or Deny. If both Allow and Deny statements are found in a policy, the authentication starts from the Deny statements. |
Object | Conditions for the permission to take effect. A maximum of 10 conditions are allowed. | |
Resource | Array of strings | Cloud resource. The array can contain a maximum of 10 resource strings, and each string cannot exceed 128 characters. Note
|
Parameter | Type | Description |
---|---|---|
Object | Operator, for example, Bool and StringEquals. The parameter type is custom object. |
Parameter | Type | Description |
---|---|---|
attribute | Array of strings | Condition key. The condition key must correspond to the specified operator. A maximum of 10 condition keys are allowed. The parameter type is custom character string array. |
Example Request¶
GET https://sample.domain.com/v3.0/OS-ROLE/roles
Example Response¶
Status code: 200
The request is successful.
{
"roles" : [ {
"domain_id" : "d78cbac186b744899480f25bd022f...",
"updated_time" : "1579229246886",
"created_time" : "1579229246886",
"description_cn" : "Description in Chinese",
"catalog" : "CUSTOMED",
"name" : "custom_d78cbac186b744899480f25bd022f468_1",
"description" : "IAMDescription",
"links" : {
"self" : "https://sample.domain.com/v3/roles/93879fd90f1046f69e6e0b31c94d2..."
},
"id" : "93879fd90f1046f69e6e0b31c94d2...",
"display_name" : "IAMCloudServicePolicy",
"type" : "AX",
"policy" : {
"Version" : "1.1",
"Statement" : [ {
"Condition" : {
"StringStartWith" : {
"g:ProjectName" : [ "AZ-1" ]
}
},
"Action" : [ "obs:bucket:GetBucketAcl" ],
"Resource" : [ "obs:*:*:bucket:*" ],
"Effect" : "Allow"
} ]
}
}, {
"domain_id" : "d78cbac186b744899480f25bd022f...",
"updated_time" : "1579229242358",
"created_time" : "1579229242358",
"description_cn" : "Description in Chinese",
"catalog" : "CUSTOMED",
"name" : "custom_d78cbac186b744899480f25bd022f468_0",
"description" : "IAMDescription",
"links" : {
"self" : "https://sample.domain.com/v3/roles/f67224e84dc849ab954ce29fb4f47..."
},
"id" : "f67224e84dc849ab954ce29fb4f473...",
"display_name" : "IAMAgencyPolicy",
"type" : "AX",
"policy" : {
"Version" : "1.1",
"Statement" : [ {
"Action" : [ "iam:agencies:assume" ],
"Resource" : {
"uri" : [ "/iam/agencies/07805acaba800fdd4fbdc00b8f888..." ]
},
"Effect" : "Allow"
} ]
}
} ],
"links" : {
"next" : null,
"previous" : null,
"self" : "https://sample.domain.com/v3/roles?domain_id=d78cbac186b744899480f25bd022f..."
},
"total_number" : 300
}
Status Codes¶
Status Code | Description |
---|---|
200 | The request is successful. |
400 | The server failed to process the request. |
401 | Authentication failed. |
403 | Access denied. |
500 | Internal server error. |
Error Codes¶
None