All Products
Search
Document Center

Object Storage Service:list-access-points

Last Updated:Mar 20, 2026

Lists the access points created for your account or a specific bucket.

Usage notes

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

Syntax

ossutil api list-access-points [flags]

Flags

FlagTypeDescription
--bucketstringThe name of the bucket. Use this flag to filter results to bucket-level access points only.
--continuation-tokenstringThe token used to retrieve the next page of results. Use the value returned in the NextContinuationToken field of a previous response.
--max-keysstringThe maximum number of access points to return per request.
The list-access-points command maps to the ListAccessPoints API operation. For supported global flags, see Command-line options.

Examples

List all access points under your account

ossutil api list-access-points

List access points for a specific bucket

ossutil api list-access-points --bucket examplebucket

Return results in JSON format

ossutil api list-access-points --output-format json

Return results in YAML format

ossutil api list-access-points --output-format yaml

Retrieve the next page of results

ossutil api list-access-points --continuation-token CgJiYw123

Limit the number of results returned

ossutil api list-access-points --max-keys 10