LicenseManager / Client / create_grant_version

create_grant_version#

LicenseManager.Client.create_grant_version(**kwargs)#

Creates a new version of the specified grant. For more information, see Granted licenses in License Manager in the License Manager User Guide.

See also: AWS API Documentation

Request Syntax

response = client.create_grant_version(
    ClientToken='string',
    GrantArn='string',
    GrantName='string',
    AllowedOperations=[
        'CreateGrant'|'CheckoutLicense'|'CheckoutBorrowLicense'|'CheckInLicense'|'ExtendConsumptionLicense'|'ListPurchasedLicenses'|'CreateToken',
    ],
    Status='PENDING_WORKFLOW'|'PENDING_ACCEPT'|'REJECTED'|'ACTIVE'|'FAILED_WORKFLOW'|'DELETED'|'PENDING_DELETE'|'DISABLED'|'WORKFLOW_COMPLETED',
    StatusReason='string',
    SourceVersion='string',
    Options={
        'ActivationOverrideBehavior': 'DISTRIBUTED_GRANTS_ONLY'|'ALL_GRANTS_PERMITTED_BY_ISSUER'
    }
)
Parameters:

  • ClientToken (string) –

    [REQUIRED]

    Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

  • GrantArn (string) –

    [REQUIRED]

    Amazon Resource Name (ARN) of the grant.

  • GrantName (string) – Grant name.

  • AllowedOperations (list) –

    Allowed operations for the grant.

    • (string) –

  • Status (string) – Grant status.

  • StatusReason (string) – Grant status reason.

  • SourceVersion (string) – Current version of the grant.

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

Return type:

dict

Returns:

Response Syntax

{
    'GrantArn': 'string',
    'Status': 'PENDING_WORKFLOW'|'PENDING_ACCEPT'|'REJECTED'|'ACTIVE'|'FAILED_WORKFLOW'|'DELETED'|'PENDING_DELETE'|'DISABLED'|'WORKFLOW_COMPLETED',
    'Version': 'string'
}

Response Structure

  • (dict) –

    • GrantArn (string) –

      Grant ARN.

    • Status (string) –

      Grant status.

    • Version (string) –

      New version of the grant.

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