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

**********************
create_license_version
**********************



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

  

  Creates a new version of the specified license.

  

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


  **Request Syntax**
  ::

    response = client.create_license_version(
        LicenseArn='string',
        LicenseName='string',
        ProductName='string',
        Issuer={
            'Name': 'string',
            'SignKey': 'string'
        },
        HomeRegion='string',
        Validity={
            'Begin': 'string',
            'End': 'string'
        },
        LicenseMetadata=[
            {
                'Name': 'string',
                'Value': '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
            }
        },
        Status='AVAILABLE'|'PENDING_AVAILABLE'|'DEACTIVATED'|'SUSPENDED'|'EXPIRED'|'PENDING_DELETE'|'DELETED',
        ClientToken='string',
        SourceVersion='string'
    )
    
  :type LicenseArn: string
  :param LicenseArn: **[REQUIRED]** 

    Amazon Resource Name (ARN) of the license.

    

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

    License name.

    

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

    Product name.

    

  
  :type Issuer: dict
  :param Issuer: **[REQUIRED]** 

    License issuer.

    

  
    - **Name** *(string) --* **[REQUIRED]** 

      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.

      

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

    Home Region of the license.

    

  
  :type Validity: dict
  :param Validity: **[REQUIRED]** 

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

    

  
    - **Begin** *(string) --* **[REQUIRED]** 

      Start of the time range.

      

    
    - **End** *(string) --* 

      End of the time range.

      

    
  
  :type LicenseMetadata: list
  :param LicenseMetadata: 

    Information about the license.

    

  
    - *(dict) --* 

      Describes key/value pairs.

      

    
      - **Name** *(string) --* 

        The key name.

        

      
      - **Value** *(string) --* 

        The value.

        

      
    

  :type Entitlements: list
  :param Entitlements: **[REQUIRED]** 

    License entitlements.

    

  
    - *(dict) --* 

      Describes a resource entitled for use with a license.

      

    
      - **Name** *(string) --* **[REQUIRED]** 

        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) --* **[REQUIRED]** 

        Entitlement unit.

        

      
      - **AllowCheckIn** *(boolean) --* 

        Indicates whether check-ins are allowed.

        

      
    

  :type ConsumptionConfiguration: dict
  :param ConsumptionConfiguration: **[REQUIRED]** 

    Configuration for consumption of the license. Choose a provisional configuration for workloads running with continuous connectivity. Choose a borrow configuration for workloads with offline usage.

    

  
    - **RenewType** *(string) --* 

      Renewal frequency.

      

    
    - **ProvisionalConfiguration** *(dict) --* 

      Details about a provisional configuration.

      

    
      - **MaxTimeToLiveInMinutes** *(integer) --* **[REQUIRED]** 

        Maximum time for the provisional configuration, in minutes.

        

      
    
    - **BorrowConfiguration** *(dict) --* 

      Details about a borrow configuration.

      

    
      - **AllowEarlyCheckIn** *(boolean) --* **[REQUIRED]** 

        Indicates whether early check-ins are allowed.

        

      
      - **MaxTimeToLiveInMinutes** *(integer) --* **[REQUIRED]** 

        Maximum time for the borrow configuration, in minutes.

        

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

    License status.

    

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

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

    

  
  :type SourceVersion: string
  :param SourceVersion: 

    Current version of the license.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'LicenseArn': 'string',
          'Version': 'string',
          'Status': 'AVAILABLE'|'PENDING_AVAILABLE'|'DEACTIVATED'|'SUSPENDED'|'EXPIRED'|'PENDING_DELETE'|'DELETED'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **LicenseArn** *(string) --* 

        License ARN.

        
      

      - **Version** *(string) --* 

        New version of the license.

        
      

      - **Status** *(string) --* 

        License status.

        
  
  **Exceptions**
  
  *   :py:class:`LicenseManager.Client.exceptions.ValidationException`

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

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

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

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

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

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

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

  