为某个存储空间Bucket绑定自定义域名_对象存储(OSS)-阿里云帮助中心

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

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

API	Action	说明
PutCname	oss:PutCname	为存储空间（Bucket）绑定自定义域名。
	yundun-cert:DescribeSSLCertificatePrivateKey	为存储空间（Bucket）绑定自定义域名时，如果绑定证书，则需要这三个操作的权限。
	yundun-cert:DescribeSSLCertificatePublicKeyDetail
	yundun-cert:CreateSSLCertificate

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

说明

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

--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\"}}"