list_account_roles

list_account_roles(**kwargs)

Lists all roles that are assigned to the user for a given AWS account.

See also: AWS API Documentation

Request Syntax

response = client.list_account_roles(
    nextToken='string',
    maxResults=123,
    accessToken='string',
    accountId='string'
)
Parameters
  • nextToken (string) -- The page token from the previous response output when you request subsequent pages.
  • maxResults (integer) -- The number of items that clients can request per page.
  • accessToken (string) --

    [REQUIRED]

    The token issued by the CreateToken API call. For more information, see CreateToken in the IAM Identity Center OIDC API Reference Guide .

  • accountId (string) --

    [REQUIRED]

    The identifier for the AWS account that is assigned to the user.

Return type

dict

Returns

Response Syntax

{
    'nextToken': 'string',
    'roleList': [
        {
            'roleName': 'string',
            'accountId': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • nextToken (string) --

      The page token client that is used to retrieve the list of accounts.

    • roleList (list) --

      A paginated response with the list of roles and the next token if more results are available.

      • (dict) --

        Provides information about the role that is assigned to the user.

        • roleName (string) --

          The friendly name of the role that is assigned to the user.

        • accountId (string) --

          The identifier of the AWS account assigned to the user.

Exceptions

  • SSO.Client.exceptions.InvalidRequestException
  • SSO.Client.exceptions.UnauthorizedException
  • SSO.Client.exceptions.TooManyRequestsException
  • SSO.Client.exceptions.ResourceNotFoundException