调用DeleteAgenticBucket接口删除Agentic Bucket

更新时间:
复制 MD 格式

调用DeleteAgenticBucket接口删除指定的Agentic Bucket。删除采用两段式流程:须先将Agentic Bucket状态设置为Disabled,待系统确认删除就绪后再执行删除。

注意事项

  • 删除Agentic Bucket前,必须先调用PutAgenticBucketStatus将其状态设置为Disabled。

  • Agentic Bucket名下仍有Bucket Space时不可删除,须先删除其下所有Bucket Space。

  • Agentic Bucket删除后不可恢复。

请求语法

DELETE /?agenticBucket HTTP/1.1
Host: {prefix}-{uid}-{region}-ab-apsr.oss-{region}.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

两段式删除流程如下:

  1. 调用PutAgenticBucketStatus将Agentic Bucket状态设置为Disabled。

  2. 等待系统确认删除就绪。

  3. 调用DeleteAgenticBucket执行删除。此时可能出现以下结果:

    • Agentic Bucket状态为Enabled:返回AgenticBucketNotDisabled。

    • 系统尚未确认删除就绪:返回AgenticBucketNotReady,请稍后重试。

    • 已就绪但名下仍有Bucket Space:返回AgenticBucketNotEmpty。

    • 已就绪且名下无Bucket Space:删除成功,返回204。

请求头

此接口仅包含公共请求头。更多信息,请参见公共HTTP头定义。

示例

  • 请求示例

    DELETE /?agenticBucket HTTP/1.1
    Host: my-uid-region-ab-apsr.oss-cn-hangzhou.aliyuncs.com
    Date: Thu, 17 Apr 2025 15:39:12 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  • 返回示例

    HTTP/1.1 204 No Content
    x-oss-request-id: 5C1B138A109F4E405B2D
    Date: Mon, 26 Jul 2021 13:08:38 GMT
    Connection: keep-alive
    Server: AliyunOSS

错误码

错误码

HTTP状态码

描述

AgenticBucketNotFound

404

Agentic Bucket不存在。

AgenticBucketNotDisabled

409

Agentic Bucket状态为Enabled,必须先调用PutAgenticBucketStatus将其设置为Disabled。

AgenticBucketNotReady

409

系统尚未确认删除就绪,请稍后重试。

AgenticBucketNotEmpty

409

Agentic Bucket名下仍有Bucket Space,须先删除所有Bucket Space。