resource_definition_versions

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

Overview

Name	resource_definition_versions
Type	Resource
Id	aws.greengrass.resource_definition_versions

Fields

The following fields are returned by SELECT queries:

get_resource_definition_version

Name	Datatype	Description
arn	string	Arn of the resource definition version.
creation_timestamp	string	The time, in milliseconds since the epoch, when the resource definition version was created.
definition	object	Information about a resource definition version.
id	string	The ID of the resource definition version.
version	string	The version of the resource definition version.

list_resource_definition_versions

Name	Datatype	Description
arn	string	The ARN of the version.
creation_timestamp	string	The time, in milliseconds since the epoch, when the version was created.
id	string	The ID of the parent definition that the version is associated with.
version	string	The ID of the version.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_resource_definition_version	select	resource_definition_id, resource_definition_version_id, region		Retrieves information about a resource definition version, including which resources are included in the version.
list_resource_definition_versions	select	resource_definition_id, region	MaxResults, NextToken	Lists the versions of a resource definition.
create_resource_definition_version	insert	resource_definition_id, region	X-Amzn-Client-Token	Creates a version of a resource definition that has already been defined.

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)
resource_definition_id	string	The ID of the resource definition.
resource_definition_version_id	string	The ID of the resource definition version. This value maps to the ''Version'' property of the corresponding ''VersionInformation'' object, which is returned by ''ListResourceDefinitionVersions'' requests. If the version is the last one that was associated with a resource definition, the value also maps to the ''LatestVersion'' property of the corresponding ''DefinitionInformation'' object.
MaxResults	string	The maximum number of results to be returned per request.
NextToken	string	The token for the next set of results, or ''null'' if there are no additional results.
X-Amzn-Client-Token	string	A client token used to correlate requests and responses.

SELECT examples

get_resource_definition_version

Retrieves information about a resource definition version, including which resources are included in the version.

SELECT
arn,
creation_timestamp,
definition,
id,
version
FROM aws.greengrass.resource_definition_versions
WHERE resource_definition_id = '{{ resource_definition_id }}' -- required
AND resource_definition_version_id = '{{ resource_definition_version_id }}' -- required
AND region = '{{ region }}' -- required
;

list_resource_definition_versions

Lists the versions of a resource definition.

SELECT
arn,
creation_timestamp,
id,
version
FROM aws.greengrass.resource_definition_versions
WHERE resource_definition_id = '{{ resource_definition_id }}' -- required
AND region = '{{ region }}' -- required
AND MaxResults = '{{ MaxResults }}'
AND NextToken = '{{ NextToken }}'
;

INSERT examples

create_resource_definition_version

Creates a version of a resource definition that has already been defined.

INSERT INTO aws.greengrass.resource_definition_versions (
Resources,
resource_definition_id,
region,
`X-Amzn-Client-Token`
)
SELECT 
'{{ Resources }}',
'{{ resource_definition_id }}',
'{{ region }}',
'{{ X-Amzn-Client-Token }}'
RETURNING
arn,
creation_timestamp,
id,
version
;

Manifest

# Description fields are for documentation purposes
- name: resource_definition_versions
props:
  - name: resource_definition_id
    value: "{{ resource_definition_id }}"
    description: Required parameter for the resource_definition_versions resource.
  - name: region
    value: "{{ region }}"
    description: Required parameter for the resource_definition_versions resource.
  - name: Resources
    value:
      - Id: "{{ Id }}"
        Name: "{{ Name }}"
        ResourceDataContainer:
          LocalDeviceResourceData:
            GroupOwnerSetting:
              AutoAddGroupOwner: {{ AutoAddGroupOwner }}
              GroupOwner: "{{ GroupOwner }}"
            SourcePath: "{{ SourcePath }}"
          LocalVolumeResourceData:
            DestinationPath: "{{ DestinationPath }}"
            GroupOwnerSetting:
              AutoAddGroupOwner: {{ AutoAddGroupOwner }}
              GroupOwner: "{{ GroupOwner }}"
            SourcePath: "{{ SourcePath }}"
          S3MachineLearningModelResourceData:
            DestinationPath: "{{ DestinationPath }}"
            OwnerSetting:
              GroupOwner: "{{ GroupOwner }}"
              GroupPermission: "{{ GroupPermission }}"
            S3Uri: "{{ S3Uri }}"
          SageMakerMachineLearningModelResourceData:
            DestinationPath: "{{ DestinationPath }}"
            OwnerSetting:
              GroupOwner: "{{ GroupOwner }}"
              GroupPermission: "{{ GroupPermission }}"
            SageMakerJobArn: "{{ SageMakerJobArn }}"
          SecretsManagerSecretResourceData:
            ARN: "{{ ARN }}"
            AdditionalStagingLabelsToDownload:
              - "{{ AdditionalStagingLabelsToDownload }}"
  - name: X-Amzn-Client-Token
    value: "{{ X-Amzn-Client-Token }}"
    description: A client token used to correlate requests and responses.
    description: A client token used to correlate requests and responses.