license_conversion_tasks

Creates, updates, deletes, gets or lists a license_conversion_tasks resource.

Overview

Name	license_conversion_tasks
Type	Resource
Id	aws.license_manager.license_conversion_tasks

Fields

The following fields are returned by SELECT queries:

get_license_conversion_task

Name	Datatype	Description
destination_license_context	object	Information about the license type converted to.
end_time	string (date-time)	Time at which the license type conversion task was completed.
license_conversion_task_id	string	ID of the license type conversion task. (pattern: <code>^lct-[a-zA-Z0-9]*</code>)
license_conversion_time	string (date-time)	Amount of time to complete the license type conversion.
resource_arn	string	Amazon Resource Names (ARN) of the resources the license conversion task is associated with.
source_license_context	object	Information about the license type converted from.
start_time	string (date-time)	Time at which the license type conversion task was started .
status	string	Status of the license type conversion task. (IN_PROGRESS, SUCCEEDED, FAILED)
status_message	string	The status message for the conversion task.

list_license_conversion_tasks

Name	Datatype	Description
license_conversion_tasks	array	Information about the license configuration tasks for your account.
next_token	string	Token for the next set of results.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_license_conversion_task	select	region		Gets information about the specified license type conversion task.
list_license_conversion_tasks	select	region		Lists the license type conversion tasks for your account.
create_license_conversion_task_for_resource	insert	region, ResourceArn, SourceLicenseContext, DestinationLicenseContext		Creates a new license conversion task.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)

SELECT examples

get_license_conversion_task

Gets information about the specified license type conversion task.

SELECT
destination_license_context,
end_time,
license_conversion_task_id,
license_conversion_time,
resource_arn,
source_license_context,
start_time,
status,
status_message
FROM aws.license_manager.license_conversion_tasks
WHERE region = '{{ region }}' -- required
;

list_license_conversion_tasks

Lists the license type conversion tasks for your account.

SELECT
license_conversion_tasks,
next_token
FROM aws.license_manager.license_conversion_tasks
WHERE region = '{{ region }}' -- required
;

INSERT examples

create_license_conversion_task_for_resource

Creates a new license conversion task.

INSERT INTO aws.license_manager.license_conversion_tasks (
ResourceArn,
SourceLicenseContext,
DestinationLicenseContext,
region
)
SELECT 
'{{ ResourceArn }}' /* required */,
'{{ SourceLicenseContext }}' /* required */,
'{{ DestinationLicenseContext }}' /* required */,
'{{ region }}'
RETURNING
license_conversion_task_id
;

Manifest

# Description fields are for documentation purposes
- name: license_conversion_tasks
props:
  - name: region
    value: "{{ region }}"
    description: Required parameter for the license_conversion_tasks resource.
  - name: ResourceArn
    value: "{{ ResourceArn }}"
    description: |
      Amazon Resource Name (ARN) of the resource you are converting the license type for.
  - name: SourceLicenseContext
    description: |
      Information that identifies the license type you are converting from. For the structure of the source license, see Convert a license type using the CLI in the License Manager User Guide.
    value:
      UsageOperation: "{{ UsageOperation }}"
      ProductCodes:
        - ProductCodeId: "{{ ProductCodeId }}"
          ProductCodeType: "{{ ProductCodeType }}"
  - name: DestinationLicenseContext
    description: |
      Information that identifies the license type you are converting to. For the structure of the destination license, see Convert a license type using the CLI in the License Manager User Guide.
    value:
      UsageOperation: "{{ UsageOperation }}"
      ProductCodes:
        - ProductCodeId: "{{ ProductCodeId }}"
          ProductCodeType: "{{ ProductCodeType }}"