文档首页/ 对象存储服务 OBS/ API参考/ 桶API/ 自定义域名/ 删除桶的自定义域名
更新时间：2026-04-16 GMT+08:00
查看PDF
分享

删除桶的自定义域名

功能介绍

桶设置了自定义域名后，可以通过本接口删除桶的自定义域名。了解更多桶自定义域名相关信息，请参见通过自定义域名访问桶。

接口约束

表1 约束与限制

限制类别

具体限制

桶版本限制

桶版本号为3.0及以上的桶支持配置自定义域名。桶版本号可以在OBS管理控制台上，进入桶概览页后，在“基本信息”中查看。

域名数量限制

每个桶默认最多配置100个自定义域名。

功能限制
  • 一个自定义域名只能配置到一个桶域名上。
  • 暂不支持配置中文域名。
  • 配置的自定义域名后缀目前支持的范围为2~63个英文大小写字母。
  • 按照工信部要求，您配置自定义域名的桶所属区域如果为中国区域，那么需要提前完成ICP备案。
  • 自定义域名通常用于公网访问OBS桶，内网访问OBS建议使用桶默认域名（bucketName.obs.endpoint.myhuaweicloud.com）
说明：

如果使用了加速域名，为防止访问OBS桶中对象变成强制下载，配置自定义域名和加速域名后还需要参考CDN加速场景下访问OBS桶内对象变成强制下载进行处理。

授权信息

您必须是桶拥有者或拥有删除桶的自定义域名的权限，才能调用本接口，建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。

  • 如果使用IAM授权，那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种，并配置相应权限：
    • 如果使用角色与策略授权（旧版IAM，即IAM v3接口），需具备obs:bucket:DeleteBucketCustomDomainConfiguration权限，授权操作请参见创建IAM自定义策略。
    • 如果使用身份策略授权（新版IAM，即IAM v5接口），如下表所示，需具备obs:bucket:deleteBucketCustomDomainConfiguration权限，授权操作请参见创建IAM自定义身份策略。

      授权项

      Action

      访问级别

      Access Level

      资源类型（*为必须）

      Resource Type (*: required)

      条件键

      Condition Key

      别名

      Alias

      依赖的授权项

      Dependencies

      obs:bucket:deleteBucketCustomDomainConfiguration

      Write

      bucket *

      -

      -

      -
      • obs:EpochTime
      • obs:SourceIp
      • obs:TlsVersion
      • obs:CustomDomain
  • 如果使用桶策略进行授权，需具备obs:bucket:deleteBucketCustomDomainConfiguration权限，具体操作请参见自定义创建桶策略。

请求消息样式

1
2
3
4
5
6
 
DELETE /?customdomain=domainname HTTP/1.1
User-Agent: curl/7.29.0
Host: bucketname.obs.region.myhuaweicloud.com 
Accept: */*
Date: date
Authorization: authorization string

URI参数（URI Parameters）

表2 URI参数

参数

是否必选

参数类型

描述

customdomain

是

String

参数解释：

需要删除的自定义域名。

约束限制：

不涉及

取值范围：

长度为0~256的字符串。

默认取值：

不涉及

请求头参数（Request headers）

该请求使用公共请求头，具体参见表3。

请求体参数（Request body）

该请求消息中不带请求体参数。

响应消息样式

1
2
3
4
5
 
HTTP/1.1 204 No Content
Server: OBS
x-obs-request-id: request id
x-obs-id-2: id
Date: date

响应头 (Response Headers)

该请求的响应消息使用公共响应头，具体请参考表1。

响应体 (Response Body)

本接口的响应消息中不携带响应体。

错误响应消息

无特殊错误，所有错误已经包含在表2中。

请求示例

1
2
3
4
5
6
 
DELETE /?customdomain=obs.ccc.com HTTP/1.1
User-Agent: curl/7.29.0
Host: bucketname.obs.region.myhuaweicloud.com 
Accept: */*
Date: Mon, 14 Jan 2019 08:27:50 +0000
Authorization: OBS UDSIAMSTUBTEST000094:ACgHHA1z+dqZhqS7D2SbU8ugluw=

响应示例

1
2
3
4
5
 
HTTP/1.1 204 No Content
Server: OBS
x-obs-request-id: 000001697694073F80E9D3D43BB10B8F
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSyjWyXNRPSnFymJW0AI59GKpW0Qm9UJ
Date: Wed, 13 Mar 2019 10:23:26 GMT

相关文档

父主题： 自定义域名