全部产品
Search
文档中心

对象存储 OSS:get-cname-token

更新时间:Sep 17, 2026

get-cname-token用于获取已创建的CnameToken。

注意事项

阿里云账号默认拥有获取已创建的CnameToken的权限。如果您需要通过RAM用户或者STS的方式进行获取,您必须拥有oss:GetCnameToken权限。具体操作,请参见为RAM用户授予自定义的权限策略。

命令格式

ossutil api get-cname-token --bucket value --cname value --wildcard value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

--cname

string

绑定的Cname名称。

--wildcard

string

是否获取泛域名CNAME的CnameToken,取值为true或false。对于Agentic Bucket,必须显式指定true或false,不允许缺省;普通Bucket可选,缺省为false(即精确CNAME)。

说明
  • get-cname-token命令对应API接口GetCnameToken。关于API中的具体参数含义,请参见GetCnameToken。

  • --wildcard选项用于泛域名CNAME相关操作,请确保您使用的ossutil版本已支持该参数。

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

使用示例

  • 获取存储空间examplebucket已创建的域名为 example.com 的CnameToken。

    ossutil api get-cname-token --bucket examplebucket --cname example.com
  • 获取存储空间examplebucket已创建的域名为 example.com 的CnameToken,以JSON格式显示。

    ossutil api get-cname-token --bucket examplebucket --cname example.com --output-format json
  • 获取存储空间examplebucket已创建的域名为 example.com 的CnameToken,以YAML格式显示。

    ossutil api get-cname-token --bucket examplebucket --cname example.com --output-format yaml
  • 获取Agentic Bucketmyab-$uid-$region-ab-apsr已创建的泛域名CNAME基础域名foo.example.com的CnameToken。

    ossutil api get-cname-token --bucket my-uid-region-ab-apsr --cname foo.example.com --wildcard true