list_changesets

list_changesets(**kwargs)

Lists the FinSpace Changesets for a Dataset.

See also: AWS API Documentation

Request Syntax

response = client.list_changesets(
    datasetId='string',
    maxResults=123,
    nextToken='string'
)

Parameters

• datasetId (string) --

  [REQUIRED]

  The unique identifier for the FinSpace Dataset to which the Changeset belongs.

• maxResults (integer) -- The maximum number of results per page.
• nextToken (string) -- A token that indicates where a results page should begin.

Return type

dict

Returns

Response Syntax

{
    'changesets': [
        {
            'changesetId': 'string',
            'changesetArn': 'string',
            'datasetId': 'string',
            'changeType': 'REPLACE'|'APPEND'|'MODIFY',
            'sourceParams': {
                'string': 'string'
            },
            'formatParams': {
                'string': 'string'
            },
            'createTime': 123,
            'status': 'PENDING'|'FAILED'|'SUCCESS'|'RUNNING'|'STOP_REQUESTED',
            'errorInfo': {
                'errorMessage': 'string',
                'errorCategory': 'VALIDATION'|'SERVICE_QUOTA_EXCEEDED'|'ACCESS_DENIED'|'RESOURCE_NOT_FOUND'|'THROTTLING'|'INTERNAL_SERVICE_EXCEPTION'|'CANCELLED'|'USER_RECOVERABLE'
            },
            'activeUntilTimestamp': 123,
            'activeFromTimestamp': 123,
            'updatesChangesetId': 'string',
            'updatedByChangesetId': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) -- Response to ListChangesetsResponse. This returns a list of dataset changesets that match the query criteria.

  • changesets (list) --

    List of Changesets found.

    • (dict) --

      A Changeset is unit of data in a Dataset.

      • changesetId (string) --

        The unique identifier for a Changeset.

      • changesetArn (string) --

        The ARN identifier of the Changeset.

      • datasetId (string) --

        The unique identifier for the FinSpace Dataset in which the Changeset is created.

      • changeType (string) --

        Type that indicates how a Changeset is applied to a Dataset.

        • REPLACE – Changeset is considered as a replacement to all prior loaded Changesets.
        • APPEND – Changeset is considered as an addition to the end of all prior loaded Changesets.
        • MODIFY – Changeset is considered as a replacement to a specific prior ingested Changeset.

      • sourceParams (dict) --

        Options that define the location of the data being ingested.

        • (string) --
          • (string) --

      • formatParams (dict) --

        Options that define the structure of the source file(s).

        • (string) --
          • (string) --

      • createTime (integer) --

        The timestamp at which the Changeset was created in FinSpace. The value is determined as epoch time in milliseconds. For example, the value for Monday, November 1, 2021 12:00:00 PM UTC is specified as 1635768000000.

      • status (string) --

        Status of the Changeset ingestion.

        • PENDING – Changeset is pending creation.
        • FAILED – Changeset creation has failed.
        • SUCCESS – Changeset creation has succeeded.
        • RUNNING – Changeset creation is running.
        • STOP_REQUESTED – User requested Changeset creation to stop.

      • errorInfo (dict) --

        The structure with error messages.

        • errorMessage (string) --

          The text of the error message.

        • errorCategory (string) --

          The category of the error.

          • VALIDATION – The inputs to this request are invalid.
          • SERVICE_QUOTA_EXCEEDED – Service quotas have been exceeded. Please contact AWS support to increase quotas.
          • ACCESS_DENIED – Missing required permission to perform this request.
          • RESOURCE_NOT_FOUND – One or more inputs to this request were not found.
          • THROTTLING – The system temporarily lacks sufficient resources to process the request.
          • INTERNAL_SERVICE_EXCEPTION – An internal service error has occurred.
          • CANCELLED – Cancelled.
          • USER_RECOVERABLE – A user recoverable error has occurred.

      • activeUntilTimestamp (integer) --

        Time until which the Changeset is active. The value is determined as epoch time in milliseconds. For example, the value for Monday, November 1, 2021 12:00:00 PM UTC is specified as 1635768000000.

      • activeFromTimestamp (integer) --

        Beginning time from which the Changeset is active. The value is determined as epoch time in milliseconds. For example, the value for Monday, November 1, 2021 12:00:00 PM UTC is specified as 1635768000000.

      • updatesChangesetId (string) --

        The unique identifier of the Changeset that is updated.

      • updatedByChangesetId (string) --

        The unique identifier of the updated Changeset.

  • nextToken (string) --

    A token that indicates where a results page should begin.

Exceptions

• FinSpaceData.Client.exceptions.ResourceNotFoundException
• FinSpaceData.Client.exceptions.InternalServerException
• FinSpaceData.Client.exceptions.ValidationException
• FinSpaceData.Client.exceptions.ThrottlingException
• FinSpaceData.Client.exceptions.AccessDeniedException
• FinSpaceData.Client.exceptions.ConflictException