LicenseManagerUserSubscriptions / Client / stop_product_subscription

stop_product_subscription#

LicenseManagerUserSubscriptions.Client.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': {
            'ActiveDirectorySettings': {
                'DomainCredentialsProvider': {
                    'SecretsManagerCredentialsProvider': {
                        'SecretId': 'string'
                    }
                },
                'DomainIpv4List': [
                    'string',
                ],
                'DomainName': 'string',
                'DomainNetworkSettings': {
                    'Subnets': [
                        'string',
                    ]
                }
            },
            'ActiveDirectoryType': 'SELF_MANAGED'|'AWS_MANAGED',
            'DirectoryId': 'string'
        }
    },
    Product='string',
    ProductUserArn='string',
    Username='string'
)
Parameters:
  • Domain (string) – The domain name of the Active Directory that contains the user for whom to stop the product subscription.

  • 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 can be set: ActiveDirectoryIdentityProvider.

    • ActiveDirectoryIdentityProvider (dict) –

      The ActiveDirectoryIdentityProvider resource contains settings and other details about a specific 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.

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

        • DomainIpv4List (list) –

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

          • (string) –

        • DomainName (string) –

          The domain name for the Active Directory.

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

      • DirectoryId (string) –

        The directory ID for an Active Directory identity provider.

  • Product (string) –

    The name of the user-based subscription product.

    Valid values: VISUAL_STUDIO_ENTERPRISE | VISUAL_STUDIO_PROFESSIONAL | OFFICE_PROFESSIONAL_PLUS

  • ProductUserArn (string) – The Amazon Resource Name (ARN) of the product user.

  • Username (string) – The user name from the identity provider for the user.

Return type:

dict

Returns:

Response Syntax

{
    'ProductUserSummary': {
        'Domain': 'string',
        'IdentityProvider': {
            'ActiveDirectoryIdentityProvider': {
                'ActiveDirectorySettings': {
                    'DomainCredentialsProvider': {
                        'SecretsManagerCredentialsProvider': {
                            'SecretId': 'string'
                        }
                    },
                    'DomainIpv4List': [
                        'string',
                    ],
                    'DomainName': 'string',
                    'DomainNetworkSettings': {
                        'Subnets': [
                            'string',
                        ]
                    }
                },
                'ActiveDirectoryType': 'SELF_MANAGED'|'AWS_MANAGED',
                'DirectoryId': 'string'
            }
        },
        'Product': 'string',
        'ProductUserArn': '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 Active Directory that contains the user information for the product subscription.

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

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

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

            • DomainIpv4List (list) –

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

              • (string) –

            • DomainName (string) –

              The domain name for the Active Directory.

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

          • DirectoryId (string) –

            The directory ID for an Active Directory identity provider.

      • Product (string) –

        The name of the user-based subscription product.

      • ProductUserArn (string) –

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

      • Status (string) –

        The status of a product for this user.

      • StatusMessage (string) –

        The status message for a product for this 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 for this product user.

Exceptions