DataExchange / Client / get_data_grant

get_data_grant#

DataExchange.Client.get_data_grant(**kwargs)#

This operation returns information about a data grant.

See also: AWS API Documentation

Request Syntax

response = client.get_data_grant(
    DataGrantId='string'
)
Parameters:

DataGrantId (string) –

[REQUIRED]

The ID of the data grant.

Return type:

dict

Returns:

Response Syntax

{
    'Name': 'string',
    'SenderPrincipal': 'string',
    'ReceiverPrincipal': 'string',
    'Description': 'string',
    'AcceptanceState': 'PENDING_RECEIVER_ACCEPTANCE'|'ACCEPTED',
    'AcceptedAt': datetime(2015, 1, 1),
    'EndsAt': datetime(2015, 1, 1),
    'GrantDistributionScope': 'AWS_ORGANIZATION'|'NONE',
    'DataSetId': 'string',
    'SourceDataSetId': 'string',
    'Id': 'string',
    'Arn': 'string',
    'CreatedAt': datetime(2015, 1, 1),
    'UpdatedAt': datetime(2015, 1, 1),
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) –

    • Name (string) –

      The name of the data grant.

    • SenderPrincipal (string) –

      The Amazon Web Services account ID of the data grant sender.

    • ReceiverPrincipal (string) –

      The Amazon Web Services account ID of the data grant receiver.

    • Description (string) –

      The description of the data grant.

    • AcceptanceState (string) –

      The acceptance state of the data grant.

    • AcceptedAt (datetime) –

      The timestamp of when the data grant was accepted.

    • EndsAt (datetime) –

      The timestamp of when access to the associated data set ends.

    • GrantDistributionScope (string) –

      The distribution scope for the data grant.

    • DataSetId (string) –

      The ID of the data set associated to the data grant.

    • SourceDataSetId (string) –

      The ID of the data set used to create the data grant.

    • Id (string) –

      The ID of the data grant.

    • Arn (string) –

      The Amazon Resource Name (ARN) of the data grant.

    • CreatedAt (datetime) –

      The timestamp of when the data grant was created.

    • UpdatedAt (datetime) –

      The timestamp of when the data grant was last updated.

    • Tags (dict) –

      The tags associated to the data grant. A tag is a key-value pair.

      • (string) –

        • (string) –

Exceptions

  • DataExchange.Client.exceptions.ResourceNotFoundException

  • DataExchange.Client.exceptions.ThrottlingException

  • DataExchange.Client.exceptions.AccessDeniedException

  • DataExchange.Client.exceptions.ValidationException

  • DataExchange.Client.exceptions.InternalServerException