DetachAndDeleteS3AccessPoint - Amazon FSx
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

DetachAndDeleteS3AccessPoint

Detaches an S3 access point from an Amazon FSx volume and deletes the S3 access point.

The requester requires the following permission to perform this action:

  • fsx:DetachAndDeleteS3AccessPoint

  • s3:DeleteAccessPoint

Request Syntax

{ "ClientRequestToken": "string", "Name": "string" }

Request Parameters

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

The request accepts the following data in JSON format.

ClientRequestToken

(Optional) An idempotency token for resource creation, in a string of up to 63 ASCII characters. This token is automatically filled on your behalf when you use the Amazon Command Line Interface (Amazon CLI) or an Amazon SDK.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 63.

Pattern: [A-za-z0-9_.-]{0,63}$

Required: No

Name

The name of the S3 access point attachment that you want to delete.

Type: String

Length Constraints: Minimum length of 3. Maximum length of 50.

Pattern: ^(?=[a-z0-9])[a-z0-9-]{1,48}[a-z0-9]$

Required: Yes

Response Syntax

{ "Lifecycle": "string", "Name": "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.

Lifecycle

The lifecycle status of the S3 access point attachment.

Type: String

Valid Values: AVAILABLE | CREATING | DELETING | UPDATING | FAILED

Name

The name of the S3 access point attachment being deleted.

Type: String

Length Constraints: Minimum length of 3. Maximum length of 50.

Pattern: ^(?=[a-z0-9])[a-z0-9-]{1,48}[a-z0-9]$

Errors

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

BadRequest

A generic error indicating a failure with a client request.

HTTP Status Code: 400

IncompatibleParameterError

The error returned when a second request is received with the same client request token but different parameters settings. A client request token should always uniquely identify a single request.

HTTP Status Code: 400

InternalServerError

A generic error indicating a server-side failure.

HTTP Status Code: 500

S3AccessPointAttachmentNotFound

The access point specified was not found.

HTTP Status Code: 400

UnsupportedOperation

The requested operation is not supported for this resource or API.

HTTP Status Code: 400

See Also

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