FSx / Client / describe_s3_access_point_attachments
describe_s3_access_point_attachments¶
- FSx.Client.describe_s3_access_point_attachments(**kwargs)¶
Describes one or more S3 access points attached to Amazon FSx volumes.
The requester requires the following permission to perform this action:
fsx:DescribeS3AccessPointAttachments
See also: AWS API Documentation
Request Syntax
response = client.describe_s3_access_point_attachments( Names=[ 'string', ], Filters=[ { 'Name': 'file-system-id'|'volume-id'|'type', 'Values': [ 'string', ] }, ], MaxResults=123, NextToken='string' )
- Parameters:
Names (list) –
The names of the S3 access point attachments whose descriptions you want to retrieve.
(string) –
Filters (list) –
Enter a filter Name and Values pair to view a select set of S3 access point attachments.
(dict) –
A set of Name and Values pairs used to view a select set of S3 access point attachments.
Name (string) –
The name of the filter.
Values (list) –
The values of the filter.
(string) –
MaxResults (integer) – The maximum number of resources to return in the response. This value must be an integer greater than zero.
NextToken (string) – (Optional) Opaque pagination token returned from a previous operation (String). If present, this token indicates from what point you can continue processing the request, where the previous
NextToken
value left off.
- Return type:
dict
- Returns:
Response Syntax
{ 'S3AccessPointAttachments': [ { 'Lifecycle': 'AVAILABLE'|'CREATING'|'DELETING'|'UPDATING'|'FAILED', 'LifecycleTransitionReason': { 'Message': 'string' }, 'CreationTime': datetime(2015, 1, 1), 'Name': 'string', 'Type': 'OPENZFS', 'OpenZFSConfiguration': { 'VolumeId': 'string', 'FileSystemIdentity': { 'Type': 'POSIX', 'PosixUser': { 'Uid': 123, 'Gid': 123, 'SecondaryGids': [ 123, ] } } }, 'S3AccessPoint': { 'ResourceARN': 'string', 'Alias': 'string', 'VpcConfiguration': { 'VpcId': 'string' } } }, ], 'NextToken': 'string' }
Response Structure
(dict) –
S3AccessPointAttachments (list) –
Array of S3 access point attachments returned after a successful
DescribeS3AccessPointAttachments
operation.(dict) –
An S3 access point attached to an Amazon FSx volume.
Lifecycle (string) –
The lifecycle status of the S3 access point attachment. The lifecycle can have the following values:
AVAILABLE - the S3 access point attachment is available for use
CREATING - Amazon FSx is creating the S3 access point and attachment
DELETING - Amazon FSx is deleting the S3 access point and attachment
FAILED - The S3 access point attachment is in a failed state. Delete and detach the S3 access point attachment, and create a new one.
UPDATING - Amazon FSx is updating the S3 access point attachment
LifecycleTransitionReason (dict) –
Describes why a resource lifecycle state changed.
Message (string) –
A detailed error message.
CreationTime (datetime) –
The time that the resource was created, in seconds (since 1970-01-01T00:00:00Z), also known as Unix time.
Name (string) –
The name of the S3 access point attachment; also used for the name of the S3 access point.
Type (string) –
The type of Amazon FSx volume that the S3 access point is attached to.
OpenZFSConfiguration (dict) –
The OpenZFSConfiguration of the S3 access point attachment.
VolumeId (string) –
The ID of the FSx for OpenZFS volume that the S3 access point is attached to.
FileSystemIdentity (dict) –
The file system identity used to authorize file access requests made using the S3 access point.
Type (string) –
Specifies the FSx for OpenZFS user identity type, accepts only
POSIX
.PosixUser (dict) –
Specifies the UID and GIDs of the file system POSIX user.
Uid (integer) –
The UID of the file system user.
Gid (integer) –
The GID of the file system user.
SecondaryGids (list) –
The list of secondary GIDs for the file system user.
(integer) –
S3AccessPoint (dict) –
The S3 access point configuration of the S3 access point attachment.
ResourceARN (string) –
he S3 access point’s ARN.
Alias (string) –
The S3 access point’s alias.
VpcConfiguration (dict) –
The S3 access point’s virtual private cloud (VPC) configuration.
VpcId (string) –
Specifies the virtual private cloud (VPC) for the S3 access point VPC configuration, if one exists.
NextToken (string) –
(Optional) Opaque pagination token returned from a previous operation (String). If present, this token indicates from what point you can continue processing the request, where the previous
NextToken
value left off.
Exceptions