IAMRolesAnywhere / Client / list_subjects

list_subjects

IAMRolesAnywhere.Client.list_subjects(**kwargs)

Lists the subjects in the authenticated account and Amazon Web Services Region.

Required permissions: rolesanywhere:ListSubjects.

See also: AWS API Documentation

Request Syntax

response = client.list_subjects(
    nextToken='string',
    pageSize=123
)

Parameters:

• nextToken (string) – A token that indicates where the output should continue from, if a previous operation did not show all results. To get the next results, call the operation again with this value.

• pageSize (integer) – The number of resources in the paginated list.

Return type:

dict

Returns:

Response Syntax

{
    'nextToken': 'string',
    'subjects': [
        {
            'createdAt': datetime(2015, 1, 1),
            'enabled': True|False,
            'lastSeenAt': datetime(2015, 1, 1),
            'subjectArn': 'string',
            'subjectId': 'string',
            'updatedAt': datetime(2015, 1, 1),
            'x509Subject': 'string'
        },
    ]
}

Response Structure

• (dict) –

  • nextToken (string) –

    A token that indicates where the output should continue from, if a previous operation did not show all results. To get the next results, call the operation again with this value.

  • subjects (list) –

    A list of subjects.

    • (dict) –

      A summary representation of Subject resources returned in read operations; primarily ListSubjects.

      • createdAt (datetime) –

        The ISO-8601 time stamp of when the certificate was first used in a CreateSession operation.

      • enabled (boolean) –

        The enabled status of the Subject.

      • lastSeenAt (datetime) –

        The ISO-8601 time stamp of when the certificate was last used in a CreateSession operation.

      • subjectArn (string) –

        The ARN of the resource.

      • subjectId (string) –

        The id of the resource.

      • updatedAt (datetime) –

        The ISO-8601 timestamp when the subject was last updated.

      • x509Subject (string) –

        The x509 principal identifier of the authenticating certificate.

Exceptions

• IAMRolesAnywhere.Client.exceptions.ValidationException

• IAMRolesAnywhere.Client.exceptions.AccessDeniedException