LicenseManagerUserSubscriptions / Client / disassociate_user

disassociate_user#

LicenseManagerUserSubscriptions.Client.disassociate_user(**kwargs)#

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

Request Syntax

response = client.disassociate_user(
    Domain='string',
    IdentityProvider={
        'ActiveDirectoryIdentityProvider': {
            'ActiveDirectorySettings': {
                'DomainCredentialsProvider': {
                    'SecretsManagerCredentialsProvider': {
                        'SecretId': 'string'
                    }
                },
                'DomainIpv4List': [
                    'string',
                ],
                'DomainName': 'string',
                'DomainNetworkSettings': {
                    'Subnets': [
                        'string',
                    ]
                }
            },
            'ActiveDirectoryType': 'SELF_MANAGED'|'AWS_MANAGED',
            'DirectoryId': 'string'
        }
    },
    InstanceId='string',
    InstanceUserArn='string',
    Username='string'
)

Parameters:

Domain (string) – The domain name of the Active Directory that contains information for the user to disassociate.
IdentityProvider (dict) –
An object that specifies details for the Active Directory 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.
InstanceId (string) – The ID of the EC2 instance which provides user-based subscriptions.
InstanceUserArn (string) – The Amazon Resource Name (ARN) of the user to disassociate from the EC2 instance.
Username (string) – The user name from the Active Directory identity provider for the user.

Return type:

dict

Returns:

Response Syntax

{
    'InstanceUserSummary': {
        'AssociationDate': 'string',
        'DisassociationDate': 'string',
        'Domain': 'string',
        'IdentityProvider': {
            'ActiveDirectoryIdentityProvider': {
                'ActiveDirectorySettings': {
                    'DomainCredentialsProvider': {
                        'SecretsManagerCredentialsProvider': {
                            'SecretId': 'string'
                        }
                    },
                    'DomainIpv4List': [
                        'string',
                    ],
                    'DomainName': 'string',
                    'DomainNetworkSettings': {
                        'Subnets': [
                            'string',
                        ]
                    }
                },
                'ActiveDirectoryType': 'SELF_MANAGED'|'AWS_MANAGED',
                'DirectoryId': 'string'
            }
        },
        'InstanceId': 'string',
        'InstanceUserArn': '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 Active Directory that contains the user information for the product subscription.
  - IdentityProvider (dict) –
    
    The IdentityProvider resource specifies details about 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.
  - InstanceId (string) –
    
    The ID of the EC2 instance that provides user-based subscriptions.
  - InstanceUserArn (string) –
    
    The Amazon Resource Name (ARN) that identifies the instance user.
  - 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

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