Querying Permission Set Quotas
Function
This API is used to query permission set quotas. It can be called only from the organization's management account or from a delegated administrator account of a cloud service.
URI
GET /v1/instances/{instance_id}/permission-set-summary
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
instance_id |
Yes |
String |
Globally unique ID of an IAM Identity Center instance. |
Request Parameters
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
X-Security-Token |
No |
String |
Security token (session token) of your temporary security credentials. If a temporary security credential is used, this header is required. |
Response Parameters
Status code: 200
|
Parameter |
Type |
Description |
|---|---|---|
|
permission_sets |
Long |
Number of created permission sets. |
|
permission_sets_quota |
Long |
Quota of permission sets. |
|
permission_policy_count_quota |
Long |
Quota of policies that can be bound to a permission set. |
|
permission_policy_quota |
Long |
Quota of identity policies that can be bound to a permission set. |
Status code: 400
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. |
|
error_msg |
String |
Error message. |
|
request_id |
String |
Unique ID of a request. |
Status code: 403
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. |
|
error_msg |
String |
Error message. |
|
request_id |
String |
Unique ID of a request. |
|
encoded_authorization_message |
String |
Encrypted error message. |
Example Request
Querying permission set quotas
GET https://{hostname}/v1/instances/{instance_id}/permission-set-summary
Example Response
Status code: 200
Successful
{
"permission_sets" : 50,
"permission_sets_quota" : 20,
"permission_policy_count_quota" : 20,
"permission_policy_quota" : 10
}
Status Codes
|
Status Code |
Description |
|---|---|
|
200 |
Successful. |
|
400 |
Bad request. |
|
403 |
Forbidden. |
Error Codes
For details, see Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.
