LicenseManagerUserSubscriptions / Client / associate_user
associate_user#
- LicenseManagerUserSubscriptions.Client.associate_user(**kwargs)#
Associates the user to an EC2 instance to utilize user-based subscriptions.
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.associate_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', Tags={ 'string': 'string' }, Username='string' )
- Parameters:
Domain (string) – The domain name of the Active Directory that contains information for the user to associate.
IdentityProvider (dict) –
[REQUIRED]
The identity provider for the user.
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) –
[REQUIRED]
The ID of the EC2 instance that provides the user-based subscription.
Tags (dict) –
The tags that apply for the user association.
(string) –
(string) –
Username (string) –
[REQUIRED]
The user name from the identity provider.
- 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 setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_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 setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_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