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\"}}"
文档内容是否对您有帮助?