aws s3control list-access-points

This operation is not supported by directory buckets. AWS CLI reference

2 examples 6 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

Example 1: To retrieve a list of all access points for an account

The following list-access-points example displays a list of all access points attached to buckets owned by account 123456789012.

aws s3control list-access-points --account-id 123456789012Identify

--account-idThe Amazon Web Services account ID for the account that owns the specified access points.

Its output, shortened

{
    "AccessPointList": [
        {
            "Name": "finance-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "amzn-s3-demo-bucket1"
        },
        {
            "Name": "managers-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "amzn-s3-demo-bucket1"
        },
        {
            "Name": "private-network-ap",
            "NetworkOrigin": "VPC",
            "VpcConfiguration": {
                "VpcId": "1a2b3c"
            },
            "Bucket": "amzn-s3-demo-bucket1"
        },
        {
            "Name": "customer-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "amzn-s3-demo-bucket2"
        },
        {
            "Name": "public-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "amzn-s3-demo-bucket2"
        }
… 2 more lines

Example 2: To retrieve a list of all access points for a bucket

The following list-access-points example retrieves a list of all access points attached to the bucket amzn-s3-demo-bucket2 owned by account 123456789012.

aws s3control list-access-points --account-id 123456789012 --bucket amzn-s3-demo-bucket2Identify

--account-idThe Amazon Web Services account ID for the account that owns the specified access points.

--bucketThe name of the bucket whose associated access points you want to list.

Its output

{
    "AccessPointList": [
        {
            "Name": "customer-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "amzn-s3-demo-bucket2"
        },
        {
            "Name": "public-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "amzn-s3-demo-bucket2"
        }
    ]
}

For more information, see Managing Data Access with Amazon S3 Access Points in the Amazon Simple Storage Service Developer Guide.

Options

6 in the AWS CLI reference

--account-idThe Amazon Web Services account ID for the account that owns the specified access points.

--bucketThe name of the bucket whose associated access points you want to list.

--data-source-idThe unique identifier for the data source of the access point.

--data-source-typeThe type of the data source that the access point is attached to.

--max-resultsThe maximum number of access points that you want to include in the list.

--next-tokenA continuation token.