put-cname用于为某个存储空间(Bucket)绑定自定义域名。

注意事项

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

命令格式

ossutil api put-cname --bucket value --cname-configuration value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

--cname-configuration

string

Cname配置的容器。

说明

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

--cname-configuration

--cname-configuration配置选项既支持XML语法也支持JSON语法,当选项值包含file://前缀时,表示从文件中读取配置。

  • XML语法:

    <BucketCnameConfiguration>
      <Cname>
        <Domain>string</Domain>
      </Cname>
    </BucketCnameConfiguration>
  • JSON语法:

    {
      "Cname": {
        "Domain": "string"
      }
    }
说明

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

使用示例

为存储空间examplebucket绑定自定义域名example.com

  • 使用XML配置文件,cname-configuration.xml内容如下:

    <?xml version="1.0" encoding="UTF-8"?>
    <BucketCnameConfiguration>
      <Cname>
        <Domain>example.com</Domain>
      </Cname>
    </BucketCnameConfiguration>

命令示例如下:

ossutil api put-cname --bucket examplebucket --cname-configuration file://cname-configuration.xml
  • 使用JSON配置文件,cname-configuration.json 内容如下:

    {
      "Cname": {
        "Domain": "example.com"
      }
    }

    命令示例如下:

    ossutil api put-cname --bucket examplebucket --cname-configuration file://cname-configuration.json
  • 使用JSON配置参数,命令示例如下:

    ossutil api put-cname --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"