All Products
Search
Document Center

Object Storage Service:list-access-points

Last Updated:Sep 21, 2026

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