Use describe-regions to query the endpoints of a specific region or all supported regions. The response includes public endpoints, internal endpoints, and acceleration endpoints for each region.
Usage notes
An Alibaba Cloud account can query region endpoints by default. RAM users and Security Token Service (STS) callers require the
oss:DescribeRegionspermission. For details, see Attach a custom policy to a RAM user.Requests must use second-level domains, such as
oss-cn-hangzhou.aliyuncs.com.
Command syntax
ossutil api describe-regions [--regions <region-id>]| Parameter | Type | Required | Description |
|---|---|---|---|
--regions | string | No | Region ID to query, for example, oss-cn-hangzhou. Omit to query all regions. |
Note
describe-regions maps to the DescribeRegions API operation. For supported global flags, see Command-line options.
Examples
Query the endpoints of all supported regions:
ossutil api describe-regionsQuery the endpoints of a specific region, such as China (Hangzhou):
ossutil api describe-regions --regions oss-cn-hangzhou