LicenseManager / Client / list_received_grants_for_organization



Lists the grants received for all accounts in the organization.

See also: AWS API Documentation

Request Syntax

response = client.list_received_grants_for_organization(
            'Name': 'string',
            'Values': [
  • LicenseArn (string) –


    The Amazon Resource Name (ARN) of the received license.

  • Filters (list) –

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

    • ParentArn

    • GranteePrincipalArn

    • (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:



Response Syntax

    'Grants': [
            'GrantArn': 'string',
            'GrantName': 'string',
            'ParentArn': 'string',
            'LicenseArn': 'string',
            'GranteePrincipalArn': 'string',
            'HomeRegion': 'string',
            'StatusReason': 'string',
            'Version': 'string',
            'GrantedOperations': [
            'Options': {
                'ActivationOverrideBehavior': 'DISTRIBUTED_GRANTS_ONLY'|'ALL_GRANTS_PERMITTED_BY_ISSUER'
    'NextToken': 'string'

Response Structure

  • (dict) –

    • Grants (list) –

      Lists the grants the organization has received.

      • (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.


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


            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.


  • 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