获取桶的自定义域名

功能介绍

获取桶的自定义域名。

接口约束

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

命令结构

Windows操作系统

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

macOS/Linux操作系统

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

运行示例

以Windows操作系统为例，运行obsutil custom-domain obs://test-bucket -method=get，获取桶test-bucket的自定义域名配置信息。

obsutil custom-domain obs://test-bucket -method=get

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

DomainName               CreateTime          CertificateId
www.obs-example.com      2025-09-23T11:25:26.860Z


Get customDomain configuration succeed for bucket [test-bucket], requestId is [000001997656E4194011552ACBF0DDDB], count is 1

参数说明

参数	约束	描述
bucket	必选	桶名。
method	必选	指定方法，获取桶的自定义域名时该值为get。
config	附加参数，可选	运行当前命令时的自定义配置文件。可支持的配置参数请参考配置参数说明。
e	附加参数，可选	指定终端节点。
i	附加参数，可选	指定用户的AK。
k	附加参数，可选	指定用户的SK。
t	附加参数，可选	指定用户的securitytoken。