AWS Resource Access Manager
API Reference (API Version 2018-01-04)

DisassociateResourceShare

Disassociates the specified principals or resources from the specified resource share.

Request Syntax

POST /disassociateresourceshare HTTP/1.1 Content-type: application/json { "clientToken": "string", "principals": [ "string" ], "resourceArns": [ "string" ], "resourceShareArn": "string" }

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

clientToken

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

Type: String

Required: No

principals

The principals.

Type: Array of strings

Required: No

resourceArns

The Amazon Resource Names (ARN) of the resources.

Type: Array of strings

Required: No

resourceShareArn

The Amazon Resource Name (ARN) of the resource share.

Type: String

Required: Yes

Response Syntax

HTTP/1.1 200 Content-type: application/json { "clientToken": "string", "resourceShareAssociations": [ { "associatedEntity": "string", "associationType": "string", "creationTime": number, "external": boolean, "lastUpdatedTime": number, "resourceShareArn": "string", "status": "string", "statusMessage": "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.

clientToken

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

Type: String

resourceShareAssociations

Information about the associations.

Type: Array of ResourceShareAssociation objects

Errors

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

IdempotentParameterMismatchException

A client token input parameter was reused with an operation, but at least one of the other input parameters is different from the previous call to the operation.

HTTP Status Code: 400

InvalidClientTokenException

A client token is not valid.

HTTP Status Code: 400

InvalidParameterException

A parameter is not valid.

HTTP Status Code: 400

InvalidStateTransitionException

The requested state transition is not valid.

HTTP Status Code: 400

MalformedArnException

The format of an Amazon Resource Name (ARN) is not valid.

HTTP Status Code: 400

OperationNotPermittedException

The requested operation is not permitted.

HTTP Status Code: 400

ResourceShareLimitExceededException

The requested resource share exceeds the limit for your account.

HTTP Status Code: 400

ServerInternalException

The service could not respond to the request due to an internal problem.

HTTP Status Code: 500

ServiceUnavailableException

The service is not available.

HTTP Status Code: 503

UnknownResourceException

A specified resource was not found.

HTTP Status Code: 400

See Also

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