GetDataSet - AWS Data Exchange

GetDataSet

This operation returns information about a data set.

Request Syntax

GET /v1/data-sets/DataSetId HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

DataSetId

The unique identifier for a data set.

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "Arn": "string", "AssetType": "string", "CreatedAt": "string", "Description": "string", "Id": "string", "Name": "string", "Origin": "string", "OriginDetails": { "ProductId": "string" }, "SourceId": "string", "Tags": { "string" : "string" }, "UpdatedAt": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

Arn

The ARN for the data set.

Type: String

AssetType

The type of asset that is added to a data set.

Type: String

Valid Values: S3_SNAPSHOT | REDSHIFT_DATA_SHARE | API_GATEWAY_API | S3_DATA_ACCESS | LAKE_FORMATION_DATA_PERMISSION

CreatedAt

The date and time that the data set was created, in ISO 8601 format.

Type: Timestamp

Description

The description for the data set.

Type: String

Id

The unique identifier for the data set.

Type: String

Name

The name of the data set.

Type: String

Origin

A property that defines the data set as OWNED by the account (for providers) or ENTITLED to the account (for subscribers).

Type: String

Valid Values: OWNED | ENTITLED

OriginDetails

If the origin of this data set is ENTITLED, includes the details for the product on AWS Marketplace.

Type: OriginDetails object

SourceId

The data set ID of the owned data set corresponding to the entitled data set being viewed. This parameter is returned when a data set owner is viewing the entitled copy of its owned data set.

Type: String

Tags

The tags for the data set.

Type: String to string map

UpdatedAt

The date and time that the data set was last updated, in ISO 8601 format.

Type: Timestamp

Errors

For information about the errors that are common to all actions, see Common Errors.

InternalServerException

An exception occurred with the service.

HTTP Status Code: 500

ResourceNotFoundException

The resource couldn't be found.

HTTP Status Code: 404

ThrottlingException

The limit on the number of requests per second was exceeded.

HTTP Status Code: 429

ValidationException

The request was invalid.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: