设置桶的自定义域名

功能介绍

设置桶的自定义域名。

接口约束

您必须是桶拥有者或拥有设置桶的自定义域名配置的权限，才能设置桶的自定义域名配置。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:SetBucketCustomDomainConfiguration权限，如果使用桶策略则需授予SetBucketCustomDomainConfiguration权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。

命令结构

Windows操作系统

obsutil custom-domain obs://bucket -method=put -cname=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

macOS/Linux操作系统

./obsutil custom-domain obs://bucket -method=put -cname=xxx  [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

以Windows操作系统为例，运行obsutil custom-domain obs://test-bucket -method=put -cname=www.obs-example.com，指定给桶test-bucket绑定www.obs-example.com自定义域名。

obsutil custom-domain obs://test-bucket -method=put -cname=www.obs-example.com 

Start at 2024-09-30 07:59:28.8675681 +0000 UTC

Put customDomain configuration succeed for bucket [test-bucket], customDomain is [www.obs-example.com], requestId is [00000199765243C44018D688E9F5CFF5]

参数说明

参数	约束	描述
bucket	必选	桶名。
method	必选	指定方法，设置桶的自定义域名时该值为put。
cname	必选	指定桶的自定义域名。一个桶最多可以设置30个自定义域名，一个自定义域名只能被一个桶使用。一个桶最多可以设置100个自定义域名，一个自定义域名只能被一个桶使用。绑定证书时，证书的生效时间为60秒。
certificateName	附加参数，可选	指定证书名称，字符长度为3~63位, 请输入英文字符，数字，下划线，中划线，英文句点。
certificateId	附加参数，可选	指定证书ID。
certificate	附加参数，可选	指定证书内容。可包含中间证书及根证书。若certificate_chain字段传入证书链，则该字段只取证书本身。回车换行需要使用转义字符\n或者\r\n替换。
certificateChain	附加参数，可选	指定证书链，可通过certificate字段传入。回车换行需要使用转义字符\n或者\r\n替换。
privateKey	附加参数，可选	指定证书私钥。不能上传带有口令保护的私钥，回车换行需要使用转义字符\n或者\r\n替换。
config	附加参数，可选	运行当前命令时的自定义配置文件。可支持的配置参数请参考配置参数说明。
e	附加参数，可选	指定终端节点。
i	附加参数，可选	指定用户的AK。
k	附加参数，可选	指定用户的SK。
t	附加参数，可选	指定用户的securitytoken。