:doc:`LicenseManager <../../license-manager>` / Client / create_grant_version

********************
create_grant_version
********************



.. py:method:: LicenseManager.Client.create_grant_version(**kwargs)

  

  Creates a new version of the specified grant. For more information, see `Granted licenses in License Manager <https://docs.aws.amazon.com/license-manager/latest/userguide/granted-licenses.html>`__ in the *License Manager User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/license-manager-2018-08-01/CreateGrantVersion>`_  


  **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'
        }
    )
    
  :type ClientToken: string
  :param ClientToken: **[REQUIRED]** 

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

    

  
  :type GrantArn: string
  :param GrantArn: **[REQUIRED]** 

    Amazon Resource Name (ARN) of the grant.

    

  
  :type GrantName: string
  :param GrantName: 

    Grant name.

    

  
  :type AllowedOperations: list
  :param AllowedOperations: 

    Allowed operations for the grant.

    

  
    - *(string) --* 

    

  :type Status: string
  :param Status: 

    Grant status.

    

  
  :type StatusReason: string
  :param StatusReason: 

    Grant status reason.

    

  
  :type SourceVersion: string
  :param SourceVersion: 

    Current version of the grant.

    

  
  :type Options: dict
  :param Options: 

    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.

      

    
  
  
  :rtype: 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**
  
  *   :py:class:`LicenseManager.Client.exceptions.ValidationException`

  
  *   :py:class:`LicenseManager.Client.exceptions.InvalidParameterValueException`

  
  *   :py:class:`LicenseManager.Client.exceptions.ResourceLimitExceededException`

  
  *   :py:class:`LicenseManager.Client.exceptions.ServerInternalException`

  
  *   :py:class:`LicenseManager.Client.exceptions.AuthorizationException`

  
  *   :py:class:`LicenseManager.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`LicenseManager.Client.exceptions.RateLimitExceededException`

  