AWS Data Exchange

2023/10/30 - AWS Data Exchange - 1 new api methods

Changes  We added a new API action: SendDataSetNotification.

SendDataSetNotification (new) Link ΒΆ

The type of event associated with the data set.

See also: AWS API Documentation

Request Syntax

client.send_data_set_notification(
    Scope={
        'LakeFormationTagPolicies': [
            {
                'Database': 'string',
                'Table': 'string'
            },
        ],
        'RedshiftDataShares': [
            {
                'Arn': 'string',
                'Database': 'string',
                'Function': 'string',
                'Table': 'string',
                'Schema': 'string',
                'View': 'string'
            },
        ],
        'S3DataAccesses': [
            {
                'KeyPrefixes': [
                    'string',
                ],
                'Keys': [
                    'string',
                ]
            },
        ]
    },
    ClientToken='string',
    Comment='string',
    DataSetId='string',
    Details={
        'DataUpdate': {
            'DataUpdatedAt': datetime(2015, 1, 1)
        },
        'Deprecation': {
            'DeprecationAt': datetime(2015, 1, 1)
        },
        'SchemaChange': {
            'Changes': [
                {
                    'Name': 'string',
                    'Type': 'ADD'|'REMOVE'|'MODIFY',
                    'Description': 'string'
                },
            ],
            'SchemaChangeAt': datetime(2015, 1, 1)
        }
    },
    Type='DATA_DELAY'|'DATA_UPDATE'|'DEPRECATION'|'SCHEMA_CHANGE'
)
type Scope

dict

param Scope

Affected scope of this notification such as the underlying resources affected by the notification event.

  • LakeFormationTagPolicies (list) --

    Underlying LF resources that will be affected by this notification.

    • (dict) --

      Extra details specific to the affected scope in this LF data set.

      • Database (string) --

        The underlying Glue database that the notification is referring to.

      • Table (string) --

        The underlying Glue table that the notification is referring to.

  • RedshiftDataShares (list) --

    Underlying Redshift resources that will be affected by this notification.

    • (dict) --

      Extra details specific to the affected scope in this Redshift data set.

      • Arn (string) -- [REQUIRED]

        The ARN of the underlying Redshift data share that is being affected by this notification.

      • Database (string) -- [REQUIRED]

        The database name in the Redshift data share that is being affected by this notification.

      • Function (string) --

        A function name in the Redshift database that is being affected by this notification.

      • Table (string) --

        A table name in the Redshift database that is being affected by this notification.

      • Schema (string) --

        A schema name in the Redshift database that is being affected by this notification.

      • View (string) --

        A view name in the Redshift database that is being affected by this notification.

  • S3DataAccesses (list) --

    Underlying S3 resources that will be affected by this notification.

    • (dict) --

      Extra details specific to the affected scope in this S3 Data Access data set.

      • KeyPrefixes (list) --

        A list of the key prefixes affected by this notification. This can have up to 50 entries.

        • (string) --

      • Keys (list) --

        A list of the keys affected by this notification. This can have up to 50 entries.

        • (string) --

type ClientToken

string

param ClientToken

Idempotency key for the notification, this key allows us to deduplicate notifications that are sent in quick succession erroneously.

This field is autopopulated if not provided.

type Comment

string

param Comment

Free-form text field for providers to add information about their notifications.

type DataSetId

string

param DataSetId

[REQUIRED]

Affected data set of the notification.

type Details

dict

param Details

Extra details specific to this notification type.

  • DataUpdate (dict) --

    Extra details specific to a data update type notification.

    • DataUpdatedAt (datetime) --

      A datetime in the past when the data was updated. This typically means that the underlying resource supporting the data set was updated.

  • Deprecation (dict) --

    Extra details specific to a deprecation type notification.

    • DeprecationAt (datetime) -- [REQUIRED]

      A datetime in the future when the data set will be deprecated.

  • SchemaChange (dict) --

    Extra details specific to a schema change type notification.

    • Changes (list) --

      List of schema changes happening in the scope of this notification. This can have up to 100 entries.

      • (dict) --

        Object encompassing information about a schema change to a single, particular field, a notification can have up to 100 of these.

        • Name (string) -- [REQUIRED]

          Name of the changing field. This value can be up to 255 characters long.

        • Type (string) -- [REQUIRED]

          Is the field being added, removed, or modified?

        • Description (string) --

          Description of what's changing about this field. This value can be up to 512 characters long.

    • SchemaChangeAt (datetime) -- [REQUIRED]

      A date in the future when the schema change is taking effect.

type Type

string

param Type

[REQUIRED]

The type of the notification. Describing the kind of event the notification is alerting you to.

rtype

dict

returns

Response Syntax

{}

Response Structure

  • (dict) --