全部产品
Search
文档中心

对象存储 OSS:list-cname

更新时间:Sep 18, 2026

list-cname用于查询某个存储空间(Bucket)下绑定的所有的自定义域名(Cname)列表。

注意事项

阿里云账号默认拥有查询某个Bucket下绑定的所有的自定义域名(Cname)列表的权限。如果您需要通过RAM用户或者STS的方式进行查询,您必须拥有oss:ListCname权限。具体操作,请参见为RAM用户授予自定义的权限策略。

命令格式

ossutil api list-cname --bucket value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

说明
  • 对于Agentic Bucket,list-cname命令的使用方式与普通Bucket相同;其响应中可能包含泛域名CNAME条目,该类条目通过IsWildCard节点标识。

  • list-cname命令对应API接口ListCname。关于API中的具体参数含义,请参见ListCname。

  • 关于支持的全局命令行选项,请参见支持的全局命令行选项。

使用示例

  • 获取存储空间examplebucket的所有的自定义域名列表。

    ossutil api list-cname --bucket examplebucket
  • 获取存储空间examplebucket的所有的自定义域名列表,以JSON格式显示。

    ossutil api list-cname --bucket examplebucket --output-format json
  • 获取存储空间examplebucket的所有的自定义域名列表,以YAML格式显示。

    ossutil api list-cname --bucket examplebucket --output-format yaml