DisassociateDataShareConsumer - Amazon Redshift

DisassociateDataShareConsumer

From a consumer account, remove association for the specified datashare.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

DataShareArn

The Amazon Resource Name (ARN) of the datashare to remove association for.

Type: String

Length Constraints: Maximum length of 2147483647.

Required: Yes

ConsumerArn

The Amazon Resource Name (ARN) of the consumer that association for the datashare is removed from.

Type: String

Length Constraints: Maximum length of 2147483647.

Required: No

DisassociateEntireAccount

A value that specifies whether association for the datashare is removed from the entire account.

Type: Boolean

Required: No

Response Elements

The following elements are returned by the service.

AllowPubliclyAccessibleConsumers

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

Type: Boolean

DataShareArn

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.

Type: String

Length Constraints: Maximum length of 2147483647.

DataShareAssociations.member.N

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

Type: Array of DataShareAssociation objects

ProducerArn

The Amazon Resource Name (ARN) of the producer.

Type: String

Length Constraints: Maximum length of 2147483647.

Errors

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

InvalidDataShareFault

There is an error with the datashare.

HTTP Status Code: 400

InvalidNamespaceFault

The namespace isn't valid because the namespace doesn't exist. Provide a valid namespace.

HTTP Status Code: 400

Examples

Example

This example illustrates one usage of DisassociateDataShareConsumer.

Sample Request

https://redshift.us-east-2.amazonaws.com/ ?Action=DisassociateDataShareConsumer &DataShareArn=arn%3Aaws%3Aredshift%3Aus-east-1%3A275247490162%3Adatashare%3Afd59653e-4ace-4952-a102-286dad7263ca%2Ftestshare1 &ConsumerArn=arn%3Aaws%3Aredshift%3Aus-east-1%3A275247490162%3Anamespace%3A57beacb3-2f8a-4c22-a3e3-d2d73da7ee6a &DisassociateEntireAccount=false &SignatureMethod=HmacSHA256&SignatureVersion=4 &Version=2012-12-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20190817/us-east-2/redshift/aws4_request &X-Amz-Date=20190825T160000Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=0aa1234bb5cc678ddddd901ee2ff3aa45678b90c12d345e6ff789012345a6b7b

Sample Response

<DisassociateDataShareConsumerResponse xmlns="http://redshift.amazonaws.com/doc/2012-12-01/"> <DisassociateDataShareConsumerResult> <ProducerNamespaceArn>arn:aws:redshift:us-east-1:827630067164:namespace:73ff3b6a-0fab-4122-8ba4-c6613d707a6e</ProducerNamespaceArn> <AllowPubliclyAccessibleConsumers>true</AllowPubliclyAccessibleConsumers> <DataShareArn>arn:aws:redshift:us-east-1:827630067164:datashare:73ff3b6a-0fab-4122-8ba4-c6613d707a6e/share_data</DataShareArn> <DataShareAssociations/> </DisassociateDataShareConsumerResult> <ResponseMetadata> <RequestId>183c52e9-ba40-472c-9b31-66bfd7b20d88</RequestId> </ResponseMetadata> </DisassociateDataShareConsumerResponse>

See Also

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