LicenseManagerUserSubscriptions / Client / start_product_subscription

start_product_subscription

LicenseManagerUserSubscriptions.Client.start_product_subscription(**kwargs)

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

Note

Your estimated bill for charges on the number of users and related costs will take 48 hours to appear for billing periods that haven’t closed (marked as Pending billing status) in Amazon Web Services Billing. For more information, see Viewing your monthly charges in the Amazon Web Services Billing User Guide.

See also: AWS API Documentation

Request Syntax

response = client.start_product_subscription(
    Username='string',
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'DirectoryId': 'string',
            'ActiveDirectorySettings': {
                'DomainName': 'string',
                'DomainIpv4List': [
                    'string',
                ],
                'DomainCredentialsProvider': {
                    'SecretsManagerCredentialsProvider': {
                        'SecretId': 'string'
                    }
                },
                'DomainNetworkSettings': {
                    'Subnets': [
                        'string',
                    ]
                }
            },
            'ActiveDirectoryType': 'SELF_MANAGED'|'AWS_MANAGED',
            'IsSharedActiveDirectory': True|False
        }
    },
    Product='string',
    Domain='string',
    Tags={
        'string': 'string'
    }
)
Parameters:

  • Username (string) –

    [REQUIRED]

    The user name from the identity provider 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) –

      The ActiveDirectoryIdentityProvider resource contains settings and other details about a specific Active Directory identity provider.

      • DirectoryId (string) –

        The directory ID for an Active Directory identity provider.

      • ActiveDirectorySettings (dict) –

        The ActiveDirectorySettings resource contains details about the Active Directory, including network access details such as domain name and IP addresses, and the credential provider for user administration.

        • DomainName (string) –

          The domain name for the Active Directory.

        • DomainIpv4List (list) –

          A list of domain IPv4 addresses that are used for the Active Directory.

          • (string) –

        • DomainCredentialsProvider (dict) –

          Points to the CredentialsProvider resource that contains information about the credential provider for user administration.

          Note

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

          • SecretsManagerCredentialsProvider (dict) –

            Identifies the Secrets Manager secret that contains credentials needed for user administration in the Active Directory.

            • SecretId (string) –

              The ID of the Secrets Manager secret that contains credentials.

        • DomainNetworkSettings (dict) –

          The DomainNetworkSettings resource contains an array of subnets that apply for the Active Directory.

          • Subnets (list) – [REQUIRED]

            Contains a list of subnets that apply for the Active Directory domain.

            • (string) –

      • ActiveDirectoryType (string) –

        The type of Active Directory – either a self-managed Active Directory or an Amazon Web Services Managed Active Directory.

      • IsSharedActiveDirectory (boolean) –

        Whether this directory is shared from an Amazon Web Services Managed Active Directory. The default value is false.

  • Product (string) –

    [REQUIRED]

    The name of the user-based subscription product.

    Valid values: VISUAL_STUDIO_ENTERPRISE | VISUAL_STUDIO_PROFESSIONAL | OFFICE_PROFESSIONAL_PLUS | REMOTE_DESKTOP_SERVICES

  • Domain (string) – The domain name of the Active Directory that contains the user for whom to start the product subscription.

  • Tags (dict) –

    The tags that apply to the product subscription.

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'ProductUserSummary': {
        'Username': 'string',
        'Product': 'string',
        'IdentityProvider': {
            'ActiveDirectoryIdentityProvider': {
                'DirectoryId': 'string',
                'ActiveDirectorySettings': {
                    'DomainName': 'string',
                    'DomainIpv4List': [
                        'string',
                    ],
                    'DomainCredentialsProvider': {
                        'SecretsManagerCredentialsProvider': {
                            'SecretId': 'string'
                        }
                    },
                    'DomainNetworkSettings': {
                        'Subnets': [
                            'string',
                        ]
                    }
                },
                'ActiveDirectoryType': 'SELF_MANAGED'|'AWS_MANAGED',
                'IsSharedActiveDirectory': True|False
            }
        },
        'Status': 'string',
        'ProductUserArn': 'string',
        'StatusMessage': 'string',
        'Domain': 'string',
        'SubscriptionStartDate': 'string',
        'SubscriptionEndDate': 'string'
    }
}

Response Structure

  • (dict) –

    • ProductUserSummary (dict) –

      Metadata that describes the start product subscription operation.

      • Username (string) –

        The user name from the identity provider for this product user.

      • Product (string) –

        The name of the user-based subscription product.

      • 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) –

          The ActiveDirectoryIdentityProvider resource contains settings and other details about a specific Active Directory identity provider.

          • DirectoryId (string) –

            The directory ID for an Active Directory identity provider.

          • ActiveDirectorySettings (dict) –

            The ActiveDirectorySettings resource contains details about the Active Directory, including network access details such as domain name and IP addresses, and the credential provider for user administration.

            • DomainName (string) –

              The domain name for the Active Directory.

            • DomainIpv4List (list) –

              A list of domain IPv4 addresses that are used for the Active Directory.

              • (string) –

            • DomainCredentialsProvider (dict) –

              Points to the CredentialsProvider resource that contains information about the credential provider for user administration.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: SecretsManagerCredentialsProvider. 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'}

              • SecretsManagerCredentialsProvider (dict) –

                Identifies the Secrets Manager secret that contains credentials needed for user administration in the Active Directory.

                • SecretId (string) –

                  The ID of the Secrets Manager secret that contains credentials.

            • DomainNetworkSettings (dict) –

              The DomainNetworkSettings resource contains an array of subnets that apply for the Active Directory.

              • Subnets (list) –

                Contains a list of subnets that apply for the Active Directory domain.

                • (string) –

          • ActiveDirectoryType (string) –

            The type of Active Directory – either a self-managed Active Directory or an Amazon Web Services Managed Active Directory.

          • IsSharedActiveDirectory (boolean) –

            Whether this directory is shared from an Amazon Web Services Managed Active Directory. The default value is false.

      • Status (string) –

        The status of a product for this user.

      • ProductUserArn (string) –

        The Amazon Resource Name (ARN) for this product user.

      • StatusMessage (string) –

        The status message for a product for this user.

      • Domain (string) –

        The domain name of the Active Directory that contains the user information for the product subscription.

      • SubscriptionStartDate (string) –

        The start date of a subscription.

      • SubscriptionEndDate (string) –

        The end date of a subscription.

Exceptions