LicenseManagerUserSubscriptions

Client

class LicenseManagerUserSubscriptions.Client

A low-level client representing AWS License Manager User Subscriptions

With License Manager, you can create user-based subscriptions to utilize licensed software with a per user subscription fee on Amazon EC2 instances.

client = session.create_client('license-manager-user-subscriptions')

These are the available methods:

associate_user(**kwargs)

Associates the user to an EC2 instance to utilize user-based subscriptions.

See also: AWS API Documentation

Request Syntax

response = client.associate_user(
    Domain='string',
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'DirectoryId': 'string'
        }
    },
    InstanceId='string',
    Username='string'
)
Parameters
  • Domain (string) -- The domain name of the user.
  • IdentityProvider (dict) --

    [REQUIRED]

    The identity provider of the user.

    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.

  • Username (string) --

    [REQUIRED]

    The user name from the identity provider for the user.

Return type

dict

Returns

Response Syntax

{
    'InstanceUserSummary': {
        'AssociationDate': 'string',
        'DisassociationDate': 'string',
        'Domain': 'string',
        'IdentityProvider': {
            'ActiveDirectoryIdentityProvider': {
                'DirectoryId': 'string'
            }
        },
        'InstanceId': 'string',
        'Status': 'string',
        'StatusMessage': 'string',
        'Username': 'string'
    }
}

Response Structure

  • (dict) --

    • InstanceUserSummary (dict) --

      Metadata that describes the associate user operation.

      • 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.

Exceptions

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
close()

Closes underlying endpoint connections.

deregister_identity_provider(**kwargs)

Deregisters the identity provider from providing user-based subscriptions.

See also: AWS API Documentation

Request Syntax

response = client.deregister_identity_provider(
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'DirectoryId': 'string'
        }
    },
    Product='string'
)
Parameters
  • 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.

  • Product (string) --

    [REQUIRED]

    The name of the user-based subscription product.

Return type

dict

Returns

Response Syntax

{
    'IdentityProviderSummary': {
        'FailureMessage': 'string',
        'IdentityProvider': {
            'ActiveDirectoryIdentityProvider': {
                'DirectoryId': 'string'
            }
        },
        'Product': 'string',
        'Status': 'string'
    }
}

Response Structure

  • (dict) --

    • IdentityProviderSummary (dict) --

      Metadata that describes the results of an identity provider operation.

      • FailureMessage (string) --

        The failure message associated with an identity provider.

      • 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.

      • Product (string) --

        The name of the user-based subscription product.

      • Status (string) --

        The status of an identity provider.

Exceptions

disassociate_user(**kwargs)

Disassociates the user from an EC2 instance providing user-based subscriptions.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_user(
    Domain='string',
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'DirectoryId': 'string'
        }
    },
    InstanceId='string',
    Username='string'
)
Parameters
  • Domain (string) -- The domain name of the user.
  • 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.

  • Username (string) --

    [REQUIRED]

    The user name from the identity provider for the user.

Return type

dict

Returns

Response Syntax

{
    'InstanceUserSummary': {
        'AssociationDate': 'string',
        'DisassociationDate': 'string',
        'Domain': 'string',
        'IdentityProvider': {
            'ActiveDirectoryIdentityProvider': {
                'DirectoryId': 'string'
            }
        },
        'InstanceId': 'string',
        'Status': 'string',
        'StatusMessage': 'string',
        'Username': 'string'
    }
}

Response Structure

  • (dict) --

    • InstanceUserSummary (dict) --

      Metadata that describes the associate user operation.

      • 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.

Exceptions

get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
list_identity_providers(**kwargs)

Lists the identity providers for user-based subscriptions.

See also: AWS API Documentation

Request Syntax

response = client.list_identity_providers(
    MaxResults=123,
    NextToken='string'
)
Parameters
  • 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

{
    'IdentityProviderSummaries': [
        {
            'FailureMessage': 'string',
            'IdentityProvider': {
                'ActiveDirectoryIdentityProvider': {
                    'DirectoryId': 'string'
                }
            },
            'Product': 'string',
            'Status': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • IdentityProviderSummaries (list) --

      Metadata that describes the list identity providers operation.

      • (dict) --

        Describes an identity provider.

        • FailureMessage (string) --

          The failure message associated with an identity provider.

        • 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.

        • Product (string) --

          The name of the user-based subscription product.

        • Status (string) --

          The status of an identity provider.

    • NextToken (string) --

      Token for the next set of results.

Exceptions

list_instances(**kwargs)

Lists the EC2 instances providing user-based subscriptions.

See also: AWS API Documentation

Request Syntax

response = client.list_instances(
    Filters=[
        {
            'Attribute': 'string',
            'Operation': 'string',
            'Value': '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.

  • 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

{
    'InstanceSummaries': [
        {
            'InstanceId': 'string',
            'LastStatusCheckDate': 'string',
            'Products': [
                'string',
            ],
            'Status': 'string',
            'StatusMessage': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • InstanceSummaries (list) --

      Metadata that describes the list instances operation.

      • (dict) --

        Describes an EC2 instance providing user-based subscriptions.

        • InstanceId (string) --

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

        • LastStatusCheckDate (string) --

          The date of the last status check.

        • Products (list) --

          A list of provided user-based subscription products.

          • (string) --
        • Status (string) --

          The status of an EC2 instance resource.

        • StatusMessage (string) --

          The status message for an EC2 instance.

    • NextToken (string) --

      Token for the next set of results.

Exceptions

list_product_subscriptions(**kwargs)

Lists the user-based subscription products available from an identity provider.

See also: AWS API Documentation

Request Syntax

response = client.list_product_subscriptions(
    Filters=[
        {
            'Attribute': 'string',
            'Operation': 'string',
            'Value': 'string'
        },
    ],
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'DirectoryId': 'string'
        }
    },
    MaxResults=123,
    NextToken='string',
    Product='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.

  • MaxResults (integer) -- Maximum number of results to return in a single call.
  • NextToken (string) -- Token for the next set of results.
  • Product (string) --

    [REQUIRED]

    The name of the user-based subscription product.

Return type

dict

Returns

Response Syntax

{
    'NextToken': 'string',
    'ProductUserSummaries': [
        {
            'Domain': 'string',
            'IdentityProvider': {
                'ActiveDirectoryIdentityProvider': {
                    'DirectoryId': 'string'
                }
            },
            'Product': 'string',
            'Status': 'string',
            'StatusMessage': 'string',
            'SubscriptionEndDate': 'string',
            'SubscriptionStartDate': 'string',
            'Username': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

      Token for the next set of results.

    • ProductUserSummaries (list) --

      Metadata that describes the list product subscriptions operation.

      • (dict) --

        The summary of the user-based subscription products for a user.

        • 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.

        • Product (string) --

          The name of the user-based subscription product.

        • Status (string) --

          The status of a product for a user.

        • StatusMessage (string) --

          The status message for a product for a user.

        • SubscriptionEndDate (string) --

          The end date of a subscription.

        • SubscriptionStartDate (string) --

          The start date of a subscription.

        • Username (string) --

          The user name from the identity provider of the user.

Exceptions

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

register_identity_provider(**kwargs)

Registers an identity provider for user-based subscriptions.

See also: AWS API Documentation

Request Syntax

response = client.register_identity_provider(
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'DirectoryId': 'string'
        }
    },
    Product='string'
)
Parameters
  • 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.

  • Product (string) --

    [REQUIRED]

    The name of the user-based subscription product.

Return type

dict

Returns

Response Syntax

{
    'IdentityProviderSummary': {
        'FailureMessage': 'string',
        'IdentityProvider': {
            'ActiveDirectoryIdentityProvider': {
                'DirectoryId': 'string'
            }
        },
        'Product': 'string',
        'Status': 'string'
    }
}

Response Structure

  • (dict) --

    • IdentityProviderSummary (dict) --

      Metadata that describes the results of an identity provider operation.

      • FailureMessage (string) --

        The failure message associated with an identity provider.

      • 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.

      • Product (string) --

        The name of the user-based subscription product.

      • Status (string) --

        The status of an identity provider.

Exceptions

start_product_subscription(**kwargs)

Starts a product subscription for a user with the specified identity provider.

See also: AWS API Documentation

Request Syntax

response = client.start_product_subscription(
    Domain='string',
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'DirectoryId': 'string'
        }
    },
    Product='string',
    Username='string'
)
Parameters
  • Domain (string) -- The domain name of the user.
  • 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.

  • Product (string) --

    [REQUIRED]

    The name of the user-based subscription product.

  • Username (string) --

    [REQUIRED]

    The user name from the identity provider of the user.

Return type

dict

Returns

Response Syntax

{
    'ProductUserSummary': {
        'Domain': 'string',
        'IdentityProvider': {
            'ActiveDirectoryIdentityProvider': {
                'DirectoryId': 'string'
            }
        },
        'Product': 'string',
        'Status': 'string',
        'StatusMessage': 'string',
        'SubscriptionEndDate': 'string',
        'SubscriptionStartDate': 'string',
        'Username': 'string'
    }
}

Response Structure

  • (dict) --

    • ProductUserSummary (dict) --

      Metadata that describes the start product subscription operation.

      • 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.

      • Product (string) --

        The name of the user-based subscription product.

      • Status (string) --

        The status of a product for a user.

      • StatusMessage (string) --

        The status message for a product for a user.

      • SubscriptionEndDate (string) --

        The end date of a subscription.

      • SubscriptionStartDate (string) --

        The start date of a subscription.

      • Username (string) --

        The user name from the identity provider of the user.

Exceptions

stop_product_subscription(**kwargs)

Stops a product subscription for a user with the specified identity provider.

See also: AWS API Documentation

Request Syntax

response = client.stop_product_subscription(
    Domain='string',
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'DirectoryId': 'string'
        }
    },
    Product='string',
    Username='string'
)
Parameters
  • Domain (string) -- The domain name of the user.
  • 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.

  • Product (string) --

    [REQUIRED]

    The name of the user-based subscription product.

  • Username (string) --

    [REQUIRED]

    The user name from the identity provider for the user.

Return type

dict

Returns

Response Syntax

{
    'ProductUserSummary': {
        'Domain': 'string',
        'IdentityProvider': {
            'ActiveDirectoryIdentityProvider': {
                'DirectoryId': 'string'
            }
        },
        'Product': 'string',
        'Status': 'string',
        'StatusMessage': 'string',
        'SubscriptionEndDate': 'string',
        'SubscriptionStartDate': 'string',
        'Username': 'string'
    }
}

Response Structure

  • (dict) --

    • ProductUserSummary (dict) --

      Metadata that describes the start product subscription operation.

      • 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.

      • Product (string) --

        The name of the user-based subscription product.

      • Status (string) --

        The status of a product for a user.

      • StatusMessage (string) --

        The status message for a product for a user.

      • SubscriptionEndDate (string) --

        The end date of a subscription.

      • SubscriptionStartDate (string) --

        The start date of a subscription.

      • Username (string) --

        The user name from the identity provider of the user.

Exceptions

Client Exceptions

Client exceptions are available on a client instance via the exceptions property. For more detailed instructions and examples on the exact usage of client exceptions, see the error handling user guide.

The available client exceptions are:

class LicenseManagerUserSubscriptions.Client.exceptions.AccessDeniedException

You don't have sufficient access to perform this action.

Example

try:
  ...
except client.exceptions.AccessDeniedException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    You don't have sufficient access to perform this action.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class LicenseManagerUserSubscriptions.Client.exceptions.ConflictException

The request couldn't be completed because it conflicted with the current state of the resource.

Example

try:
  ...
except client.exceptions.ConflictException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    The request couldn't be completed because it conflicted with the current state of the resource.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class LicenseManagerUserSubscriptions.Client.exceptions.InternalServerException

An exception occurred with the service.

Example

try:
  ...
except client.exceptions.InternalServerException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    An exception occurred with the service.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class LicenseManagerUserSubscriptions.Client.exceptions.ResourceNotFoundException

The resource couldn't be found.

Example

try:
  ...
except client.exceptions.ResourceNotFoundException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    The resource couldn't be found.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class LicenseManagerUserSubscriptions.Client.exceptions.ServiceQuotaExceededException

The request failed because a service quota is exceeded.

Example

try:
  ...
except client.exceptions.ServiceQuotaExceededException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    The request failed because a service quota is exceeded.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class LicenseManagerUserSubscriptions.Client.exceptions.ThrottlingException

The request was denied because of request throttling. Retry the request.

Example

try:
  ...
except client.exceptions.ThrottlingException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    The request was denied because of request throttling. Retry the request.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class LicenseManagerUserSubscriptions.Client.exceptions.ValidationException

A parameter is not valid.

Example

try:
  ...
except client.exceptions.ValidationException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    A parameter is not valid.

    • message (string) --
    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.

Paginators

The available paginators are:

class LicenseManagerUserSubscriptions.Paginator.ListIdentityProviders
paginator = client.get_paginator('list_identity_providers')
paginate(**kwargs)

Creates an iterator that will paginate through responses from LicenseManagerUserSubscriptions.Client.list_identity_providers().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
PaginationConfig (dict) --

A dictionary that provides parameters to control pagination.

  • MaxItems (integer) --

    The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

  • PageSize (integer) --

    The size of each page.

  • StartingToken (string) --

    A token to specify where to start paginating. This is the NextToken from a previous response.

Return type
dict
Returns
Response Syntax
{
    'IdentityProviderSummaries': [
        {
            'FailureMessage': 'string',
            'IdentityProvider': {
                'ActiveDirectoryIdentityProvider': {
                    'DirectoryId': 'string'
                }
            },
            'Product': 'string',
            'Status': 'string'
        },
    ],

}

Response Structure

  • (dict) --
    • IdentityProviderSummaries (list) --

      Metadata that describes the list identity providers operation.

      • (dict) --

        Describes an identity provider.

        • FailureMessage (string) --

          The failure message associated with an identity provider.

        • 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.

        • Product (string) --

          The name of the user-based subscription product.

        • Status (string) --

          The status of an identity provider.

class LicenseManagerUserSubscriptions.Paginator.ListInstances
paginator = client.get_paginator('list_instances')
paginate(**kwargs)

Creates an iterator that will paginate through responses from LicenseManagerUserSubscriptions.Client.list_instances().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filters=[
        {
            'Attribute': 'string',
            'Operation': 'string',
            'Value': 'string'
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': '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.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'InstanceSummaries': [
        {
            'InstanceId': 'string',
            'LastStatusCheckDate': 'string',
            'Products': [
                'string',
            ],
            'Status': 'string',
            'StatusMessage': 'string'
        },
    ],

}

Response Structure

  • (dict) --

    • InstanceSummaries (list) --

      Metadata that describes the list instances operation.

      • (dict) --

        Describes an EC2 instance providing user-based subscriptions.

        • InstanceId (string) --

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

        • LastStatusCheckDate (string) --

          The date of the last status check.

        • Products (list) --

          A list of provided user-based subscription products.

          • (string) --
        • Status (string) --

          The status of an EC2 instance resource.

        • StatusMessage (string) --

          The status message for an EC2 instance.

class LicenseManagerUserSubscriptions.Paginator.ListProductSubscriptions
paginator = client.get_paginator('list_product_subscriptions')
paginate(**kwargs)

Creates an iterator that will paginate through responses from LicenseManagerUserSubscriptions.Client.list_product_subscriptions().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filters=[
        {
            'Attribute': 'string',
            'Operation': 'string',
            'Value': 'string'
        },
    ],
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'DirectoryId': 'string'
        }
    },
    Product='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': '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.

  • Product (string) --

    [REQUIRED]

    The name of the user-based subscription product.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'ProductUserSummaries': [
        {
            'Domain': 'string',
            'IdentityProvider': {
                'ActiveDirectoryIdentityProvider': {
                    'DirectoryId': 'string'
                }
            },
            'Product': 'string',
            'Status': 'string',
            'StatusMessage': 'string',
            'SubscriptionEndDate': 'string',
            'SubscriptionStartDate': 'string',
            'Username': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • ProductUserSummaries (list) --

      Metadata that describes the list product subscriptions operation.

      • (dict) --

        The summary of the user-based subscription products for a user.

        • 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.

        • Product (string) --

          The name of the user-based subscription product.

        • Status (string) --

          The status of a product for a user.

        • StatusMessage (string) --

          The status message for a product for a user.

        • SubscriptionEndDate (string) --

          The end date of a subscription.

        • SubscriptionStartDate (string) --

          The start date of a subscription.

        • Username (string) --

          The user name from the identity provider of the user.

class LicenseManagerUserSubscriptions.Paginator.ListUserAssociations
paginator = client.get_paginator('list_user_associations')
paginate(**kwargs)

Creates an iterator that will paginate through responses from LicenseManagerUserSubscriptions.Client.list_user_associations().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filters=[
        {
            'Attribute': 'string',
            'Operation': 'string',
            'Value': 'string'
        },
    ],
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'DirectoryId': 'string'
        }
    },
    InstanceId='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': '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.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

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'
        },
    ],

}

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.