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.

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

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