LicenseManager / Client / list_received_grants

list_received_grants#

LicenseManager.Client.list_received_grants(**kwargs)#

Lists grants that are received. Received grants are grants created while specifying the recipient as this Amazon Web Services account, your organization, or an organizational unit (OU) to which this member account belongs.

See also: AWS API Documentation

Request Syntax

response = client.list_received_grants(
    GrantArns=[
        'string',
    ],
    Filters=[
        {
            'Name': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    NextToken='string',
    MaxResults=123
)
Parameters:
  • GrantArns (list) –

    Amazon Resource Names (ARNs) of the grants.

    • (string) –

  • Filters (list) –

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

    • ProductSKU

    • LicenseIssuerName

    • LicenseArn

    • GrantStatus

    • GranterAccountId

    • (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) –

  • 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

{
    'Grants': [
        {
            'GrantArn': 'string',
            'GrantName': 'string',
            'ParentArn': 'string',
            'LicenseArn': 'string',
            'GranteePrincipalArn': 'string',
            'HomeRegion': 'string',
            'GrantStatus': 'PENDING_WORKFLOW'|'PENDING_ACCEPT'|'REJECTED'|'ACTIVE'|'FAILED_WORKFLOW'|'DELETED'|'PENDING_DELETE'|'DISABLED'|'WORKFLOW_COMPLETED',
            'StatusReason': 'string',
            'Version': 'string',
            'GrantedOperations': [
                'CreateGrant'|'CheckoutLicense'|'CheckoutBorrowLicense'|'CheckInLicense'|'ExtendConsumptionLicense'|'ListPurchasedLicenses'|'CreateToken',
            ],
            'Options': {
                'ActivationOverrideBehavior': 'DISTRIBUTED_GRANTS_ONLY'|'ALL_GRANTS_PERMITTED_BY_ISSUER'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • Grants (list) –

      Received grant details.

      • (dict) –

        Describes a grant.

        • GrantArn (string) –

          Amazon Resource Name (ARN) of the grant.

        • GrantName (string) –

          Grant name.

        • ParentArn (string) –

          Parent ARN.

        • LicenseArn (string) –

          License ARN.

        • GranteePrincipalArn (string) –

          The grantee principal ARN.

        • HomeRegion (string) –

          Home Region of the grant.

        • GrantStatus (string) –

          Grant status.

        • StatusReason (string) –

          Grant status reason.

        • Version (string) –

          Grant version.

        • GrantedOperations (list) –

          Granted operations.

          • (string) –

        • Options (dict) –

          The options specified for the grant.

          • ActivationOverrideBehavior (string) –

            An activation option for your grant that determines the behavior of activating a grant. Activation options can only be used with granted licenses sourced from the Amazon Web Services Marketplace. Additionally, the operation must specify the value of ACTIVE for the Status parameter.

            • As a license administrator, you can optionally specify an ActivationOverrideBehavior when activating a grant.

            • As a grantor, you can optionally specify an ActivationOverrideBehavior when you activate a grant for a grantee account in your organization.

            • As a grantee, if the grantor creating the distributed grant doesn’t specify an ActivationOverrideBehavior, you can optionally specify one when you are activating the grant.

              DISTRIBUTED_GRANTS_ONLY

            Use this value to activate a grant without replacing any member account’s active grants for the same product.

            ALL_GRANTS_PERMITTED_BY_ISSUER

            Use this value to activate a grant and disable other active grants in any member accounts for the same product. This action will also replace their previously activated grants with this activated grant.

    • NextToken (string) –

      Token for the next set of results.

Exceptions

  • LicenseManager.Client.exceptions.ValidationException

  • LicenseManager.Client.exceptions.InvalidParameterValueException

  • LicenseManager.Client.exceptions.ResourceLimitExceededException

  • LicenseManager.Client.exceptions.ServerInternalException

  • LicenseManager.Client.exceptions.AuthorizationException

  • LicenseManager.Client.exceptions.AccessDeniedException

  • LicenseManager.Client.exceptions.RateLimitExceededException