Skip to main content

revision_assets

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

Overview

Namerevision_assets
TypeResource
Idaws.dataexchange.revision_assets

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
arnstringThe ARN for the asset.
asset_detailsobjectDetails about the asset.
asset_typestringThe type of asset that is added to a data set. (S3_SNAPSHOT, REDSHIFT_DATA_SHARE, API_GATEWAY_API, S3_DATA_ACCESS, LAKE_FORMATION_DATA_PERMISSION)
created_atstring (date-time)The date and time that the asset was created, in ISO 8601 format.
data_set_idstringThe unique identifier for the data set associated with this asset. (pattern: <code>[a-zA-Z0-9]{30,40}</code>)
idstringThe unique identifier for the asset. (pattern: <code>[a-zA-Z0-9]{30,40}</code>)
namestringThe name of the asset. When importing from Amazon S3, the Amazon S3 object key is used as the asset name. When exporting to Amazon S3, the asset name is used as default target Amazon S3 object key. When importing from Amazon API Gateway API, the API name is used as the asset name. When importing from Amazon Redshift, the datashare name is used as the asset name. When importing from AWS Lake Formation, the static values of "Database(s) included in LF-tag policy" or "Table(s) included in LF-tag policy" are used as the asset name.
revision_idstringThe unique identifier for the revision associated with this asset. (pattern: <code>[a-zA-Z0-9]{30,40}</code>)
source_idstringThe asset ID of the owned asset corresponding to the entitled asset being viewed. This parameter is returned when an asset owner is viewing the entitled copy of its owned asset. (pattern: <code>[a-zA-Z0-9]{30,40}</code>)
updated_atstring (date-time)The date and time that the asset was last updated, in ISO 8601 format.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_revision_assetsselectdata_set_id, revision_id, regionmaxResults, nextTokenThis operation lists a revision's assets sorted alphabetically 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.

NameDatatypeDescription
data_set_idstringThe unique identifier for a data set.
regionstringAWS region (default: us-east-1)
revision_idstringThe unique identifier for a revision.
maxResultsintegerThe maximum number of results returned by a single call.
nextTokenstringThe token value retrieved from a previous call to access the next page of results.

SELECT examples

This operation lists a revision's assets sorted alphabetically in descending order.

SELECT
arn,
asset_details,
asset_type,
created_at,
data_set_id,
id,
name,
revision_id,
source_id,
updated_at
FROM aws.dataexchange.revision_assets
WHERE data_set_id = '{{ data_set_id }}' -- required
AND revision_id = '{{ revision_id }}' -- required
AND region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;