data_set_revisions

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

Overview

Name	data_set_revisions
Type	Resource
Id	aws.dataexchange.data_set_revisions

Fields

The following fields are returned by SELECT queries:

list_data_set_revisions

Name	Datatype	Description
arn	string	The ARN for the revision.
comment	string	An optional comment about the revision.
created_at	string (date-time)	The date and time that the revision was created, in ISO 8601 format.
data_set_id	string	The unique identifier for the data set associated with the data set revision. (pattern: <code>[a-zA-Z0-9]{30,40}</code>)
finalized	boolean	To publish a revision to a data set in a product, the revision must first be finalized. Finalizing a revision tells AWS Data Exchange that your changes to the assets in the revision are complete. After it's in this read-only state, you can publish the revision to your products. Finalized revisions can be published through the AWS Data Exchange console or the AWS Marketplace Catalog API, using the StartChangeSet AWS Marketplace Catalog API action. When using the API, revisions are uniquely identified by their ARN.
id	string	The unique identifier for the revision. (pattern: <code>[a-zA-Z0-9]{30,40}</code>)
revocation_comment	string	A required comment to inform subscribers of the reason their access to the revision was revoked.
revoked	boolean	A status indicating that subscribers' access to the revision was revoked.
revoked_at	string (date-time)	The date and time that the revision was revoked, in ISO 8601 format.
source_id	string	The revision ID of the owned revision corresponding to the entitled revision being viewed. This parameter is returned when a revision owner is viewing the entitled copy of its owned revision. (pattern: <code>[a-zA-Z0-9]{30,40}</code>)
updated_at	string (date-time)	The date and time that the revision was last updated, in ISO 8601 format.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_data_set_revisions	select	data_set_id, region	maxResults, nextToken	This operation lists a data set's revisions sorted by CreatedAt in descending order.

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
data_set_id	string	The unique identifier for a data set.
region	string	AWS region (default: us-east-1)
maxResults	integer	The maximum number of results returned by a single call.
nextToken	string	The token value retrieved from a previous call to access the next page of results.

SELECT examples

list_data_set_revisions

This operation lists a data set's revisions sorted by CreatedAt in descending order.

SELECT
arn,
comment,
created_at,
data_set_id,
finalized,
id,
revocation_comment,
revoked,
revoked_at,
source_id,
updated_at
FROM aws.dataexchange.data_set_revisions
WHERE data_set_id = '{{ data_set_id }}' -- required
AND region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;