Listing Permission Sets Provisioned to an Account

This API is used to list the permission sets provisioned to a specified account.

GET /v1/instances/{instance_id}/permission-sets/provisioned-to-accounts

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
instance_id	Yes	String	Globally unique ID of an IAM Identity Center instance

**Table 2** Query parameters
Parameter	Mandatory	Type	Description
limit	No	Integer	Maximum number of results returned for each request Minimum value: 1 Maximum value: 100 Default value: 100
marker	No	String	Pagination marker Minimum length: 24 Maximum length: 24
account_id	Yes	String	Unique ID of a specified account
provisioning_status	No	String	Authorization status of a permission set Enumerated value: LATEST_PERMISSION_SET_PROVISIONED LATEST_PERMISSION_SET_NOT_PROVISIONED

**Table 3** Parameters in the request header
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. Maximum length: 2048

Status code: 200

**Table 4** Parameters in the response body
Parameter	Type	Description
permission_sets	Array of strings	Permission set ID list that meets the query conditions
page_info	Object	Pagination information

**Table 5** page_info
Parameter	Type	Description
next_marker	String	If present, it indicates that the available output is more than the output contained in the current response. Use this value in the marker request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this operation until the next_marker response returns null.
current_count	Integer	Number of records returned on this page

Status code: 400

Status code: 403

Listing the permission sets provisioned to a specified account

GET https://{hostname}/v1/instances/{instance_id}/permission-sets/provisioned-to-accounts

Status code: 200

Successful

{
  "permission_sets" : [ "ps-8603aaaaaaaa14bd" ],
  "page_info" : {
    "next_marker" : null,
    "current_count" : 1
  }
}

For details, see Status Codes.

For details, see Error Codes.

Parent topic: Permission Set Management

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.