delete-cname用于删除某个存储空间(Bucket)已绑定的Cname。
注意事项
阿里云账号默认拥有删除某个Bucket已绑定自定义域名的权限。如果您需要通过RAM用户或者STS的方式进行删除,您必须拥有oss:DeleteCname权限。具体操作,请参见为RAM用户授予自定义的权限策略。
命令格式
ossutil api delete-cname --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。 |
delete-cname命令对应API接口DeleteCname。关于API中的具体参数含义,请参见DeleteCname。
--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。
使用XML配置文件,cname-configuration.xml内容如下:
<?xml version="1.0" encoding="UTF-8"?> <BucketCnameConfiguration> <Cname> <Domain>example.com</Domain> </Cname> </BucketCnameConfiguration>
命令示例如下:
ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.xml使用JSON配置文件,cname-configuration.json 内容如下:
{ "Cname": { "Domain": "example.com" } }命令示例如下:
ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.json使用JSON配置参数,命令示例如下:
ossutil api delete-cname --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"
删除Agentic Bucket
my-uid-region-ab-apsr已绑定的泛域名CNAMEexample.com(泛域名基础域,不含*.前缀)。
使用JSON配置参数,命令示例如下:
ossutil api delete-cname --bucket my-uid-region-ab-apsr --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}" --wildcard true