create-cname-token用于创建域名所有权验证所需的CnameToken。
注意事项
阿里云账号默认拥有创建域名所有权验证所需的CnameToken的权限。如果您需要通过RAM用户或者STS的方式进行创建,您必须拥有oss:CreateCnameToken权限。具体操作,请参见为RAM用户授予自定义的权限策略。
命令格式
ossutil api create-cname-token --bucket value --cname-configuration value --wildcard value [flags]参数 | 类型 | 说明 |
--bucket | string | 要修改的目标Bucket。 |
--cname-configuration | string | Cname配置的容器。 |
--wildcard | string | 是否操作泛域名CNAME,取值为true或false。对于Agentic Bucket,必须显式指定true或false,不允许缺省;普通Bucket可选,缺省为false。 |
create-cname-token命令对应API接口CreateCnameToken。关于API中的具体参数含义,请参见CreateCnameToken。
--wildcard选项用于泛域名CNAME相关操作,请确保您使用的ossutil版本已支持该参数。
--cname-configuration
--cname-configuration配置选项既支持XML语法也支持JSON语法,当选项值包含file://前缀时,表示从文件中读取配置。
XML语法:
<BucketCnameConfiguration> <Cname> <Domain>string</Domain> </Cname> </BucketCnameConfiguration>JSON语法:
{ "Cname": { "Domain": "string" } }
关于支持的全局命令行选项,请参见支持的全局命令行选项。
使用示例
创建存储空间examplebucket的自定义域名example.com所有权验证所需的CnameToken。
使用XML配置文件,cname-configuration.xml内容如下:
<?xml version="1.0" encoding="UTF-8"?> <BucketCnameConfiguration> <Cname> <Domain>example.com</Domain> </Cname> </BucketCnameConfiguration>
命令示例如下:
ossutil api create-cname-token --bucket examplebucket --cname-configuration file://cname-configuration.xml使用JSON配置文件,cname-configuration.json 内容如下:
{ "Cname": { "Domain": "example.com" } }命令示例如下:
ossutil api create-cname-token --bucket examplebucket --cname-configuration file://cname-configuration.json使用JSON配置参数,命令示例如下:
ossutil api create-cname-token --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"
为Agentic Bucket
my-uid-region-ab-apsr创建泛域名CNAMEexample.com(泛域名基础域,不含*.前缀)所有权验证所需的CnameToken。
使用JSON配置参数,命令示例如下:
ossutil api create-cname-token --bucket my-uid-region-ab-apsr --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}" --wildcard true