list-access-points

Updated at:

Lists the created access points.

Usage notes

By default, an Alibaba Cloud account has the permissions to list the created access points. To list the created access points by using a RAM user or Security Token Service (STS), you must have the oss:ListAccessPoints permission. For more information, see Grant a custom policy.

Command syntax

ossutil api list-access-points [flags]

Parameter

Type

Description

--bucket

string

The name of the bucket.

--continuation-token

string

The token from which the list operation must start.

--max-keys

string

The maximum number of access points that can be returned.

Note
  • The list-access-points command corresponds to the ListAccessPoints operation. For more information about the parameters in the ListAccessPoints operation, see ListAccessPoints.

  • For more information about supported global command-line options, see Command-line options.

Examples

  • Run the following command to list access points:

    ossutil api list-access-points
  • Run the following command to list access points and display the list results in the JSON format:

    ossutil api list-access-points --output-format json
  • Run the following command to list access points and display the list results in the YAML format:

    ossutil api list-access-points --output-format yaml
  • Run the following command to list access points whose names are alphabetically after CgJiYw123:

    ossutil api list-access-points --continuation-token CgJiYw123
  • Run the following command to list the first 10 access points:

    ossutil api list-access-points --max-keys 10
  • Run the following command to list bucket-level access points.

    ossutil api list-access-points --bucket examplebucket