LicenseManagerUserSubscriptions / Client / list_user_associations

list_user_associations#

LicenseManagerUserSubscriptions.Client.list_user_associations(**kwargs)#

Lists user associations for an identity provider.

See also: AWS API Documentation

Request Syntax

response = client.list_user_associations(
    Filters=[
        {
            'Attribute': 'string',
            'Operation': 'string',
            'Value': 'string'
        },
    ],
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'DirectoryId': 'string'
        }
    },
    InstanceId='string',
    MaxResults=123,
    NextToken='string'
)
Parameters:
  • Filters (list) –

    An array of structures that you can use to filter the results to those that match one or more sets of key-value pairs that you specify.

    • (dict) –

      A filter name and value pair that is used to return more specific results from a describe operation. Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs.

      • Attribute (string) –

        The name of an attribute to use as a filter.

      • Operation (string) –

        The type of search (For example, eq, geq, leq)

      • Value (string) –

        Value of the filter.

  • IdentityProvider (dict) –

    [REQUIRED]

    An object that specifies details for the identity provider.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: ActiveDirectoryIdentityProvider.

    • ActiveDirectoryIdentityProvider (dict) –

      An object that details an Active Directory identity provider.

      • DirectoryId (string) –

        The directory ID for an Active Directory identity provider.

  • InstanceId (string) –

    [REQUIRED]

    The ID of the EC2 instance, which provides user-based subscriptions.

  • MaxResults (integer) – Maximum number of results to return in a single call.

  • NextToken (string) – Token for the next set of results.

Return type:

dict

Returns:

Response Syntax

{
    'InstanceUserSummaries': [
        {
            'AssociationDate': 'string',
            'DisassociationDate': 'string',
            'Domain': 'string',
            'IdentityProvider': {
                'ActiveDirectoryIdentityProvider': {
                    'DirectoryId': 'string'
                }
            },
            'InstanceId': 'string',
            'Status': 'string',
            'StatusMessage': 'string',
            'Username': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • InstanceUserSummaries (list) –

      Metadata that describes the list user association operation.

      • (dict) –

        Describes users of an EC2 instance providing user-based subscriptions.

        • AssociationDate (string) –

          The date a user was associated with an EC2 instance.

        • DisassociationDate (string) –

          The date a user was disassociated from an EC2 instance.

        • Domain (string) –

          The domain name of the user.

        • IdentityProvider (dict) –

          An object that specifies details for the identity provider.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: ActiveDirectoryIdentityProvider. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          
          • ActiveDirectoryIdentityProvider (dict) –

            An object that details an Active Directory identity provider.

            • DirectoryId (string) –

              The directory ID for an Active Directory identity provider.

        • InstanceId (string) –

          The ID of the EC2 instance, which provides user-based subscriptions.

        • Status (string) –

          The status of a user associated with an EC2 instance.

        • StatusMessage (string) –

          The status message for users of an EC2 instance.

        • Username (string) –

          The user name from the identity provider for the user.

    • NextToken (string) –

      Token for the next set of results.

Exceptions

  • LicenseManagerUserSubscriptions.Client.exceptions.ServiceQuotaExceededException

  • LicenseManagerUserSubscriptions.Client.exceptions.ConflictException

  • LicenseManagerUserSubscriptions.Client.exceptions.ValidationException

  • LicenseManagerUserSubscriptions.Client.exceptions.ThrottlingException

  • LicenseManagerUserSubscriptions.Client.exceptions.InternalServerException

  • LicenseManagerUserSubscriptions.Client.exceptions.ResourceNotFoundException

  • LicenseManagerUserSubscriptions.Client.exceptions.AccessDeniedException