All Products
Search

This Product

    Object Storage Service:get-access-point

    Document Center

    Object Storage Service:get-access-point

    Last Updated:Mar 20, 2026

    Retrieves the configuration of a specified access point.

    Usage notes

    By default, an Alibaba Cloud account has the oss:GetAccessPoint permission. RAM users and Security Token Service (STS) identities must be explicitly granted this permission. For details, see Grant custom policy permissions to a RAM user.

    Syntax

    ossutil api get-access-point --bucket <value> --access-point-name <value> [flags]

    Parameters

    ParameterTypeRequiredDescription
    --bucketstringYesName of the bucket.
    --access-point-namestringYesName of the access point.

    For global flags, see Command-line options.

    This command maps to the GetAccessPoint API operation. For details on the parameters, see the API reference.

    Examples

    Get the configuration of access point ap-01 on examplebucket:

    ossutil api get-access-point --bucket examplebucket --access-point-name ap-01

    Get the configuration in JSON format:

    ossutil api get-access-point --bucket examplebucket --access-point-name ap-01 --output-format json

    Get the configuration in YAML format:

    ossutil api get-access-point --bucket examplebucket --access-point-name ap-01 --output-format yaml

    What's next