- Navigation GuideYou are on a Command (operation) page with structural examples. Use the navigation breadcrumb if you would like to return to the Client landing page.
GetReceivedDataGrantCommand
This operation returns information about a received data grant.
Example Syntax
Use a bare-bones client and the command you need to make an API call.
import { DataExchangeClient, GetReceivedDataGrantCommand } from "@aws-sdk/client-dataexchange"; // ES Modules import
// const { DataExchangeClient, GetReceivedDataGrantCommand } = require("@aws-sdk/client-dataexchange"); // CommonJS import
const client = new DataExchangeClient(config);
const input = { // GetReceivedDataGrantRequest
DataGrantArn: "STRING_VALUE", // required
};
const command = new GetReceivedDataGrantCommand(input);
const response = await client.send(command);
// { // GetReceivedDataGrantResponse
// Name: "STRING_VALUE", // required
// SenderPrincipal: "STRING_VALUE",
// ReceiverPrincipal: "STRING_VALUE", // required
// Description: "STRING_VALUE",
// AcceptanceState: "STRING_VALUE", // required
// AcceptedAt: new Date("TIMESTAMP"),
// EndsAt: new Date("TIMESTAMP"),
// GrantDistributionScope: "STRING_VALUE", // required
// DataSetId: "STRING_VALUE", // required
// Id: "STRING_VALUE", // required
// Arn: "STRING_VALUE", // required
// CreatedAt: new Date("TIMESTAMP"), // required
// UpdatedAt: new Date("TIMESTAMP"), // required
// };
GetReceivedDataGrantCommand Input
Parameter | Type | Description |
---|
Parameter | Type | Description |
---|---|---|
DataGrantArn Required | string | undefined | The Amazon Resource Name (ARN) of the data grant. |
GetReceivedDataGrantCommand Output
Parameter | Type | Description |
---|
Parameter | Type | Description |
---|---|---|
$metadata Required | ResponseMetadata | Metadata pertaining to this request. |
AcceptanceState Required | DataGrantAcceptanceState | undefined | The acceptance state of the data grant. |
Arn Required | string | undefined | The Amazon Resource Name (ARN) of the data grant. |
CreatedAt Required | Date | undefined | The timestamp of when the data grant was created. |
DataSetId Required | string | undefined | The ID of the data set associated to the data grant. |
GrantDistributionScope Required | GrantDistributionScope | undefined | The distribution scope for the data grant. |
Id Required | string | undefined | The ID of the data grant. |
Name Required | string | undefined | The name of the data grant. |
ReceiverPrincipal Required | string | undefined | The Amazon Web Services account ID of the data grant receiver. |
UpdatedAt Required | Date | undefined | The timestamp of when the data grant was last updated. |
AcceptedAt | Date | undefined | The timestamp of when the data grant was accepted. |
Description | string | undefined | The description of the data grant. |
EndsAt | Date | undefined | The timestamp of when access to the associated data set ends. |
SenderPrincipal | string | undefined | The Amazon Web Services account ID of the data grant sender. |
Throws
Name | Fault | Details |
---|
Name | Fault | Details |
---|---|---|
AccessDeniedException | client | Access to the resource is denied. |
InternalServerException | server | An exception occurred with the service. |
ResourceNotFoundException | client | The resource couldn't be found. |
ThrottlingException | client | The limit on the number of requests per second was exceeded. |
ValidationException | client | The request was invalid. |
DataExchangeServiceException | Base exception class for all service exceptions from DataExchange service. |