data_set_import_tasks

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

Overview

Name	data_set_import_tasks
Type	Resource
Id	aws.m2.data_set_import_tasks

Fields

The following fields are returned by SELECT queries:

get_data_set_import_task

Name	Datatype	Description
status	string	The status of the task. (Creating, Running, Completed, Failed)
summary	object	A summary of the status of the task.
task_id	string	The task identifier. (pattern: <code>^\S{1,80}$</code>)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_data_set_import_task	select	application_id, task_id, region		Gets the status of a data set import task initiated with the CreateDataSetImportTask operation.
create_data_set_import_task	insert	application_id, region, importConfig		Starts a data set import task for a specific application.

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
application_id	string	The unique identifier of the application for which you want to import data sets.
region	string	AWS region (default: us-east-1)
task_id	string	The task identifier returned by the CreateDataSetImportTask operation.

SELECT examples

get_data_set_import_task

Gets the status of a data set import task initiated with the CreateDataSetImportTask operation.

SELECT
status,
summary,
task_id
FROM aws.m2.data_set_import_tasks
WHERE application_id = '{{ application_id }}' -- required
AND task_id = '{{ task_id }}' -- required
AND region = '{{ region }}' -- required
;

INSERT examples

create_data_set_import_task

Starts a data set import task for a specific application.

INSERT INTO aws.m2.data_set_import_tasks (
clientToken,
importConfig,
application_id,
region
)
SELECT 
'{{ clientToken }}',
'{{ importConfig }}' /* required */,
'{{ application_id }}',
'{{ region }}'
RETURNING
task_id
;

Manifest

# Description fields are for documentation purposes
- name: data_set_import_tasks
props:
  - name: application_id
    value: "{{ application_id }}"
    description: Required parameter for the data_set_import_tasks resource.
  - name: region
    value: "{{ region }}"
    description: Required parameter for the data_set_import_tasks resource.
  - name: clientToken
    value: "{{ clientToken }}"
    description: |
      A client token is a unique, case-sensitive string of up to 128 ASCII characters with ASCII values of 33-126 inclusive. It is generated by the client to ensure idempotent operations, allowing safe retries without unintended side effects.
  - name: importConfig
    description: |
      Identifies one or more data sets you want to import with the CreateDataSetImportTask operation.
    value:
      dataSets:
        - dataSet:
            datasetName: "{{ datasetName }}"
            datasetOrg:
              gdg:
                limit: {{ limit }}
                rollDisposition: "{{ rollDisposition }}"
              po:
                encoding: "{{ encoding }}"
                format_: "{{ format_ }}"
                memberFileExtensions: "{{ memberFileExtensions }}"
              ps:
                encoding: "{{ encoding }}"
                format_: "{{ format_ }}"
              vsam:
                alternateKeys: "{{ alternateKeys }}"
                compressed: {{ compressed }}
                encoding: "{{ encoding }}"
                format_: "{{ format_ }}"
                primaryKey: "{{ primaryKey }}"
            recordLength:
              max: {{ max }}
              min: {{ min }}
            relativePath: "{{ relativePath }}"
            storageType: "{{ storageType }}"
          externalLocation:
            s3Location: "{{ s3Location }}"
      s3Location: "{{ s3Location }}"