deleteAccessPoint method
Deletes the specified access point.
All Amazon S3 on Outposts REST API requests for this action require an
additional parameter of x-amz-outpost-id
to be passed with
the request and an S3 on Outposts endpoint hostname prefix instead of
s3-control
. For an example of the request syntax for Amazon
S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and
the x-amz-outpost-id
derived using the access point ARN, see
the Examples
section.
The following actions are related to DeleteAccessPoint
:
Parameter accountId
:
The account ID for the account that owns the specified access point.
Parameter name
:
The name of the access point you want to delete.
For using this parameter with Amazon S3 on Outposts with the REST API, you must specify the name and the x-amz-outpost-id as well.
For using this parameter with S3 on Outposts with the AWS SDK and CLI, you
must specify the ARN of the access point accessed in the format
arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>
.
For example, to access the access point reports-ap
through
outpost my-outpost
owned by account 123456789012
in Region us-west-2
, use the URL encoding of
arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/accesspoint/reports-ap
.
The value must be URL encoded.
Implementation
Future<void> deleteAccessPoint({
required String accountId,
required String name,
}) async {
ArgumentError.checkNotNull(accountId, 'accountId');
_s.validateStringLength(
'accountId',
accountId,
0,
64,
isRequired: true,
);
ArgumentError.checkNotNull(name, 'name');
_s.validateStringLength(
'name',
name,
3,
50,
isRequired: true,
);
final headers = <String, String>{
'x-amz-account-id': accountId.toString(),
};
await _protocol.send(
method: 'DELETE',
requestUri: '/v20180820/accesspoint/${Uri.encodeComponent(name)}',
headers: headers,
exceptionFnMap: _exceptionFns,
);
}