get_external_data_view_access_details

FinSpaceData.Client.get_external_data_view_access_details(**kwargs)

Returns the credentials to access the external Dataview from an S3 location. To call this API:

  • You must retrieve the programmatic credentials.
  • You must be a member of a FinSpace user group, where the dataset that you want to access has Read Dataset Data permissions.

See also: AWS API Documentation

Request Syntax

response = client.get_external_data_view_access_details(
    dataViewId='string',
    datasetId='string'
)
Parameters
  • dataViewId (string) --

    [REQUIRED]

    The unique identifier for the Dataview that you want to access.

  • datasetId (string) --

    [REQUIRED]

    The unique identifier for the Dataset.

Return type

dict

Returns

Response Syntax

{
    'credentials': {
        'accessKeyId': 'string',
        'secretAccessKey': 'string',
        'sessionToken': 'string',
        'expiration': 123
    },
    's3Location': {
        'bucket': 'string',
        'key': 'string'
    }
}

Response Structure

  • (dict) --

    • credentials (dict) --

      The credentials required to access the external Dataview from the S3 location.

      • accessKeyId (string) --

        The unique identifier for the security credentials.

      • secretAccessKey (string) --

        The secret access key that can be used to sign requests.

      • sessionToken (string) --

        The token that users must pass to use the credentials.

      • expiration (integer) --

        The Epoch time when the current credentials expire.

    • s3Location (dict) --

      The location where the external Dataview is stored.

      • bucket (string) --

        The name of the S3 bucket.

      • key (string) --

        The path of the folder, within the S3 bucket that contains the Dataset.

Exceptions

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