list_licenses

list_licenses(**kwargs)

Lists the licenses for your account.

See also: AWS API Documentation

Request Syntax

response = client.list_licenses(
    LicenseArns=[
        'string',
    ],
    Filters=[
        {
            'Name': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    NextToken='string',
    MaxResults=123
)
Parameters
  • LicenseArns (list) --

    Amazon Resource Names (ARNs) of the licenses.

    • (string) --
  • Filters (list) --

    Filters to scope the results. The following filters are supported:

    • Beneficiary
    • ProductSKU
    • Fingerprint
    • Status
    • (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) --

        Filter values. Filter values are case-sensitive.

        • (string) --
  • NextToken (string) -- Token for the next set of results.
  • MaxResults (integer) -- Maximum number of results to return in a single call.
Return type

dict

Returns

Response Syntax

{
    'Licenses': [
        {
            'LicenseArn': 'string',
            'LicenseName': 'string',
            'ProductName': 'string',
            'ProductSKU': 'string',
            'Issuer': {
                'Name': 'string',
                'SignKey': 'string',
                'KeyFingerprint': 'string'
            },
            'HomeRegion': 'string',
            'Status': 'AVAILABLE'|'PENDING_AVAILABLE'|'DEACTIVATED'|'SUSPENDED'|'EXPIRED'|'PENDING_DELETE'|'DELETED',
            'Validity': {
                'Begin': 'string',
                'End': 'string'
            },
            'Beneficiary': 'string',
            'Entitlements': [
                {
                    'Name': 'string',
                    'Value': 'string',
                    'MaxCount': 123,
                    'Overage': True|False,
                    'Unit': 'Count'|'None'|'Seconds'|'Microseconds'|'Milliseconds'|'Bytes'|'Kilobytes'|'Megabytes'|'Gigabytes'|'Terabytes'|'Bits'|'Kilobits'|'Megabits'|'Gigabits'|'Terabits'|'Percent'|'Bytes/Second'|'Kilobytes/Second'|'Megabytes/Second'|'Gigabytes/Second'|'Terabytes/Second'|'Bits/Second'|'Kilobits/Second'|'Megabits/Second'|'Gigabits/Second'|'Terabits/Second'|'Count/Second',
                    'AllowCheckIn': True|False
                },
            ],
            'ConsumptionConfiguration': {
                'RenewType': 'None'|'Weekly'|'Monthly',
                'ProvisionalConfiguration': {
                    'MaxTimeToLiveInMinutes': 123
                },
                'BorrowConfiguration': {
                    'AllowEarlyCheckIn': True|False,
                    'MaxTimeToLiveInMinutes': 123
                }
            },
            'LicenseMetadata': [
                {
                    'Name': 'string',
                    'Value': 'string'
                },
            ],
            'CreateTime': 'string',
            'Version': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Licenses (list) --

      License details.

      • (dict) --

        Software license that is managed in License Manager.

        • LicenseArn (string) --

          Amazon Resource Name (ARN) of the license.

        • LicenseName (string) --

          License name.

        • ProductName (string) --

          Product name.

        • ProductSKU (string) --

          Product SKU.

        • Issuer (dict) --

          License issuer.

          • Name (string) --

            Issuer name.

          • SignKey (string) --

            Asymmetric KMS key from Key Management Service. The KMS key must have a key usage of sign and verify, and support the RSASSA-PSS SHA-256 signing algorithm.

          • KeyFingerprint (string) --

            Issuer key fingerprint.

        • HomeRegion (string) --

          Home Region of the license.

        • Status (string) --

          License status.

        • Validity (dict) --

          Date and time range during which the license is valid, in ISO8601-UTC format.

          • Begin (string) --

            Start of the time range.

          • End (string) --

            End of the time range.

        • Beneficiary (string) --

          License beneficiary.

        • Entitlements (list) --

          License entitlements.

          • (dict) --

            Describes a resource entitled for use with a license.

            • Name (string) --

              Entitlement name.

            • Value (string) --

              Entitlement resource. Use only if the unit is None.

            • MaxCount (integer) --

              Maximum entitlement count. Use if the unit is not None.

            • Overage (boolean) --

              Indicates whether overages are allowed.

            • Unit (string) --

              Entitlement unit.

            • AllowCheckIn (boolean) --

              Indicates whether check-ins are allowed.

        • ConsumptionConfiguration (dict) --

          Configuration for consumption of the license.

          • RenewType (string) --

            Renewal frequency.

          • ProvisionalConfiguration (dict) --

            Details about a provisional configuration.

            • MaxTimeToLiveInMinutes (integer) --

              Maximum time for the provisional configuration, in minutes.

          • BorrowConfiguration (dict) --

            Details about a borrow configuration.

            • AllowEarlyCheckIn (boolean) --

              Indicates whether early check-ins are allowed.

            • MaxTimeToLiveInMinutes (integer) --

              Maximum time for the borrow configuration, in minutes.

        • LicenseMetadata (list) --

          License metadata.

          • (dict) --

            Describes key/value pairs.

            • Name (string) --

              The key name.

            • Value (string) --

              The value.

        • CreateTime (string) --

          License creation time.

        • Version (string) --

          License version.

    • NextToken (string) --

      Token for the next set of results.

Exceptions

  • LicenseManager.Client.exceptions.ValidationException
  • LicenseManager.Client.exceptions.InvalidParameterValueException
  • LicenseManager.Client.exceptions.AuthorizationException
  • LicenseManager.Client.exceptions.AccessDeniedException
  • LicenseManager.Client.exceptions.RateLimitExceededException
  • LicenseManager.Client.exceptions.ServerInternalException