文档首页/ 对象存储服务 OBS/ API参考/ API/ 桶的高级配置/ 删除桶的自定义域名-DeleteBucketCustomdomain
更新时间:2025-12-18 GMT+08:00
分享

删除桶的自定义域名-DeleteBucketCustomdomain

功能介绍

OBS使用DELETE操作来删除桶的自定义域名。

要使用该接口,使用者要求必须是桶的所有者,或者是桶所有者的子用户且具有删除自定义域名的权限。

授权信息

您必须是桶拥有者或拥有删除桶的自定义域名的权限,才能调用本接口,建议使用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.cn-north-4.myhuaweicloud.com 
Accept: */*
Date: date
Authorization: authorization string

请求参数

表1 请求消息参数

参数

是否必选

参数类型

描述

customdomain

String

参数解释:

需要删除的自定义域名。

约束限制:

不涉及

取值范围:

长度为0~256的字符串。

默认取值:

不涉及

请求消息头

该请求使用公共消息头,具体参见表3

请求消息元素

此请求消息中不使用消息元素。

响应消息样式

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

响应消息头

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

响应消息元素

该请求的响应消息中不带有响应元素。

错误响应消息

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

请求示例

1
2
3
4
5
6
DELETE /?customdomain=obs.ccc.com HTTP/1.1
User-Agent: curl/7.29.0
Host: bucketname.obs.cn-north-4.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

相关文档