Amazon Simple Systems Manager (SSM)

2018/03/01 - Amazon Simple Systems Manager (SSM) - 1 updated api methods

Changes  This Inventory release supports the status message details reported by the last sync for the resource data sync API.

ListResourceDataSync (updated) Link ΒΆ
Changes (response)
{'ResourceDataSyncItems': {'LastSyncStatusMessage': 'string'}}

Lists your resource data sync configurations. Includes information about the last time a sync attempted to start, the last sync status, and the last time a sync successfully completed.

The number of sync configurations might be too large to return using a single call to ListResourceDataSync . You can limit the number of sync configurations returned by using the MaxResults parameter. To determine whether there are more sync configurations to list, check the value of NextToken in the output. If there are more sync configurations to list, you can request them by specifying the NextToken returned in the call to the parameter of a subsequent call.

See also: AWS API Documentation

Request Syntax

client.list_resource_data_sync(
    NextToken='string',
    MaxResults=123
)
type NextToken

string

param NextToken

A token to start the list. Use this token to get the next set of results.

type MaxResults

integer

param MaxResults

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

rtype

dict

returns

Response Syntax

{
    'ResourceDataSyncItems': [
        {
            'SyncName': 'string',
            'S3Destination': {
                'BucketName': 'string',
                'Prefix': 'string',
                'SyncFormat': 'JsonSerDe',
                'Region': 'string',
                'AWSKMSKeyARN': 'string'
            },
            'LastSyncTime': datetime(2015, 1, 1),
            'LastSuccessfulSyncTime': datetime(2015, 1, 1),
            'LastStatus': 'Successful'|'Failed'|'InProgress',
            'SyncCreatedTime': datetime(2015, 1, 1),
            'LastSyncStatusMessage': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • ResourceDataSyncItems (list) --

      A list of your current Resource Data Sync configurations and their statuses.

      • (dict) --

        Information about a Resource Data Sync configuration, including its current status and last successful sync.

        • SyncName (string) --

          The name of the Resource Data Sync.

        • S3Destination (dict) --

          Configuration information for the target Amazon S3 bucket.

          • BucketName (string) --

            The name of the Amazon S3 bucket where the aggregated data is stored.

          • Prefix (string) --

            An Amazon S3 prefix for the bucket.

          • SyncFormat (string) --

            A supported sync format. The following format is currently supported: JsonSerDe

          • Region (string) --

            The AWS Region with the Amazon S3 bucket targeted by the Resource Data Sync.

          • AWSKMSKeyARN (string) --

            The ARN of an encryption key for a destination in Amazon S3. Must belong to the same region as the destination Amazon S3 bucket.

        • LastSyncTime (datetime) --

          The last time the configuration attempted to sync (UTC).

        • LastSuccessfulSyncTime (datetime) --

          The last time the sync operations returned a status of SUCCESSFUL (UTC).

        • LastStatus (string) --

          The status reported by the last sync.

        • SyncCreatedTime (datetime) --

          The date and time the configuration was created (UTC).

        • LastSyncStatusMessage (string) --

          The status message details reported by the last sync.

    • NextToken (string) --

      The token for the next set of items to return. Use this token to get the next set of results.