Redshift / Client / authorize_data_share

authorize_data_share#

Redshift.Client.authorize_data_share(**kwargs)#

From a data producer account, authorizes the sharing of a datashare with one or more consumer accounts or managing entities. To authorize a datashare for a data consumer, the producer account must have the correct access permissions.

See also: AWS API Documentation

Request Syntax

response = client.authorize_data_share(
    DataShareArn='string',
    ConsumerIdentifier='string',
    AllowWrites=True|False
)
Parameters:

  • DataShareArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the datashare that producers are to authorize sharing for.

  • ConsumerIdentifier (string) –

    [REQUIRED]

    The identifier of the data consumer that is authorized to access the datashare. This identifier is an Amazon Web Services account ID or a keyword, such as ADX.

  • AllowWrites (boolean) – If set to true, allows write operations for a datashare.

Return type:

dict

Returns:

Response Syntax

{
    'DataShareArn': 'string',
    'ProducerArn': 'string',
    'AllowPubliclyAccessibleConsumers': True|False,
    'DataShareAssociations': [
        {
            'ConsumerIdentifier': 'string',
            'Status': 'ACTIVE'|'PENDING_AUTHORIZATION'|'AUTHORIZED'|'DEAUTHORIZED'|'REJECTED'|'AVAILABLE',
            'ConsumerRegion': 'string',
            'CreatedDate': datetime(2015, 1, 1),
            'StatusChangeDate': datetime(2015, 1, 1),
            'ProducerAllowedWrites': True|False,
            'ConsumerAcceptedWrites': True|False
        },
    ],
    'ManagedBy': 'string'
}

Response Structure

  • (dict) –

    • DataShareArn (string) –

      An Amazon Resource Name (ARN) that references the datashare that is owned by a specific namespace of the producer cluster. A datashare ARN is in the arn:aws:redshift:{region}:{account-id}:{datashare}:{namespace-guid}/{datashare-name} format.

    • ProducerArn (string) –

      The Amazon Resource Name (ARN) of the producer.

    • AllowPubliclyAccessibleConsumers (boolean) –

      A value that specifies whether the datashare can be shared to a publicly accessible cluster.

    • DataShareAssociations (list) –

      A value that specifies when the datashare has an association between producer and data consumers.

      • (dict) –

        The association of a datashare from a producer account with a data consumer.

        • ConsumerIdentifier (string) –

          The name of the consumer accounts that have an association with a producer datashare.

        • Status (string) –

          The status of the datashare that is associated.

        • ConsumerRegion (string) –

          The Amazon Web Services Region of the consumer accounts that have an association with a producer datashare.

        • CreatedDate (datetime) –

          The creation date of the datashare that is associated.

        • StatusChangeDate (datetime) –

          The status change data of the datashare that is associated.

        • ProducerAllowedWrites (boolean) –

          Specifies whether write operations were allowed during data share authorization.

        • ConsumerAcceptedWrites (boolean) –

          Specifies whether write operations were allowed during data share association.

    • ManagedBy (string) –

      The identifier of a datashare to show its managing entity.

Exceptions

  • Redshift.Client.exceptions.InvalidDataShareFault