describe-regions

describe-regions命令用于查询所有支持地域或者指定地域对应的Endpoint信息,包括外网Endpoint、内网Endpoint和传输加速Endpoint。

注意事项

  • 阿里云账号默认拥有查询地域对应的Endpoint信息的权限。如果您需要通过RAM用户或者STS的方式进行查询,您必须拥有oss:DescribeRegions权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 只支持在二级域名(例如oss-cn-hangzhou.aliyuncs.com)上调用DescribeRegions接口。

命令格式

ossutil api describe-regions [flags]

参数

类型

说明

--regions

string

请求的地域ID。

说明

使用示例

  • 查询所有支持地域的Endpoint信息。

    ossutil api describe-regions
  • 查询指定区域的Endpoint信息,例如杭州区域。

    ossutil api describe-regions --regions oss-cn-hangzhou