LicenseManager / Client / list_usage_for_license_configuration
list_usage_for_license_configuration#
- LicenseManager.Client.list_usage_for_license_configuration(**kwargs)#
Lists all license usage records for a license configuration, displaying license consumption details by resource at a selected point in time. Use this action to audit the current license consumption for any license inventory and configuration.
See also: AWS API Documentation
Request Syntax
response = client.list_usage_for_license_configuration( LicenseConfigurationArn='string', MaxResults=123, NextToken='string', Filters=[ { 'Name': 'string', 'Values': [ 'string', ] }, ] )
- Parameters:
LicenseConfigurationArn (string) –
[REQUIRED]
Amazon Resource Name (ARN) of the license configuration.
MaxResults (integer) – Maximum number of results to return in a single call.
NextToken (string) – Token for the next set of results.
Filters (list) –
Filters to scope the results. The following filters and logical operators are supported:
resourceArn
- The ARN of the license configuration resource. Logical operators areEQUALS
|NOT_EQUALS
.resourceType
- The resource type (EC2_INSTANCE
|EC2_HOST
|EC2_AMI
|SYSTEMS_MANAGER_MANAGED_INSTANCE
). Logical operators areEQUALS
|NOT_EQUALS
.resourceAccount
- The ID of the account that owns the resource. Logical operators areEQUALS
|NOT_EQUALS
.
(dict) –
A filter name and value pair that is used to return more specific results from a describe operation. Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs.
Name (string) –
Name of the filter. Filter names are case-sensitive.
Values (list) –
The value of the filter, which is case-sensitive. You can only specify one value for the filter.
(string) –
- Return type:
dict
- Returns:
Response Syntax
{ 'LicenseConfigurationUsageList': [ { 'ResourceArn': 'string', 'ResourceType': 'EC2_INSTANCE'|'EC2_HOST'|'EC2_AMI'|'RDS'|'SYSTEMS_MANAGER_MANAGED_INSTANCE', 'ResourceStatus': 'string', 'ResourceOwnerId': 'string', 'AssociationTime': datetime(2015, 1, 1), 'ConsumedLicenses': 123 }, ], 'NextToken': 'string' }
Response Structure
(dict) –
LicenseConfigurationUsageList (list) –
Information about the license configurations.
(dict) –
Details about the usage of a resource associated with a license configuration.
ResourceArn (string) –
Amazon Resource Name (ARN) of the resource.
ResourceType (string) –
Type of resource.
ResourceStatus (string) –
Status of the resource.
ResourceOwnerId (string) –
ID of the account that owns the resource.
AssociationTime (datetime) –
Time when the license configuration was initially associated with the resource.
ConsumedLicenses (integer) –
Number of licenses consumed by the resource.
NextToken (string) –
Token for the next set of results.
Exceptions
LicenseManager.Client.exceptions.InvalidParameterValueException
LicenseManager.Client.exceptions.FilterLimitExceededException
LicenseManager.Client.exceptions.ServerInternalException
LicenseManager.Client.exceptions.AuthorizationException
LicenseManager.Client.exceptions.AccessDeniedException
LicenseManager.Client.exceptions.RateLimitExceededException