create-cname-token

更新时间:
复制 MD 格式

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,取值为truefalse。对于Agentic Bucket,必须显式指定truefalse,不允许缺省;普通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"
      }
    }
说明

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

使用示例

  1. 创建存储空间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\"}}"
  1. Agentic Bucketmy-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