DataZone / Client / list_asset_revisions

list_asset_revisions¶

DataZone.Client.list_asset_revisions(**kwargs)¶

Lists the revisions for the asset.

Prerequisites:

The asset must exist in the domain.
There must be at least one revision of the asset (which happens automatically after creation).
The domain must be valid and active.
User must have permissions on the asset and domain.

Request Syntax

response = client.list_asset_revisions(
    domainIdentifier='string',
    identifier='string',
    maxResults=123,
    nextToken='string'
)

Parameters:

domainIdentifier (string) –
[REQUIRED]

The identifier of the domain.
identifier (string) –
[REQUIRED]

The identifier of the asset.
maxResults (integer) – The maximum number of revisions to return in a single call to ListAssetRevisions. When the number of revisions to be listed is greater than the value of MaxResults, the response contains a NextToken value that you can use in a subsequent call to ListAssetRevisions to list the next set of revisions.
nextToken (string) – When the number of revisions is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of revisions, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListAssetRevisions to list the next set of revisions.

Return type:

dict

Returns:

Response Syntax

{
    'items': [
        {
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'domainId': 'string',
            'id': 'string',
            'revision': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

(dict) –
- items (list) –
  
  The results of the ListAssetRevisions action.
  - (dict) –
    
    The revision of an inventory asset.
    - createdAt (datetime) –
      
      The timestamp of when an inventory asset revison was created.
    - createdBy (string) –
      
      The Amazon DataZone user who created the asset revision.
    - domainId (string) –
      
      The Amazon DataZone user who created the inventory asset.
    - id (string) –
      
      The identifier of the inventory asset revision.
    - revision (string) –
      
      The revision details of the inventory asset.
- nextToken (string) –
  
  When the number of revisions is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of revisions, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListAssetRevisions to list the next set of revisions.

Exceptions

DataZone.Client.exceptions.InternalServerException
DataZone.Client.exceptions.ResourceNotFoundException
DataZone.Client.exceptions.AccessDeniedException
DataZone.Client.exceptions.ThrottlingException
DataZone.Client.exceptions.ValidationException
DataZone.Client.exceptions.UnauthorizedException