The command describe-regions is used to query the endpoints of all supported regions or a specific region, including public endpoints, internal endpoints, and acceleration endpoints.
Usage notes
By default, an Alibaba Cloud account has the permissions to query the endpoints of all supported regions or a specific region. Making query requests as a RAM user or by using Security Token Service (STS) requires
oss:DescribeRegionspermissions. For more information, see Attach a custom policy to a RAM user.Requests initiated by calling the DescribeRegions operation can only contain second-level domains, such as oss-cn-hangzhou.aliyuncs.com.
Command syntax
ossutil api describe-regions [flags]Parameter | Type | Description |
--regions | string | Region ID of the request. |
The describe-regions command corresponds to the DescribeRegions operation. For more information about the parameters in the DescribeRegions operation, see DescribeRegions.
For more information about supported global command-line options, see Command-line options.
Examples
Query the endpoints of all supported regions.
ossutil api describe-regionsQuery the endpoint of a specific region, such as the China (Hangzhou) region.
ossutil api describe-regions --regions oss-cn-hangzhou