Tous les produits
Search
Centre de documentation

Object Storage Service:DeleteBucket

Dernière mise à jour :Aug 08, 2026

Supprime un bucket.

Important
  • Seul le propriétaire du bucket peut le supprimer.

  • OSS ne permet pas de supprimer un bucket non vide.

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM et les rôles RAM associés à un compte Alibaba Cloud n'ont aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via des stratégies RAM ou une stratégie de bucket.

API

Action

Description

DeleteBucket

oss:DeleteBucket

Supprime un bucket.

Syntaxe de la requête

DELETE / HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

En-têtes de requête

Tous les en-têtes d'une requête DeleteBucket sont des en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes de requête communs.

En-têtes de réponse

Tous les en-têtes de la réponse à une requête DeleteBucket sont des en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes de réponse communs.

Exemples

  • Exemple de requête pour supprimer un bucket vide

    DELETE / HTTP/1.1
    Host: test.oss-cn-hangzhou.aliyuncs.com
    Accept-Encoding: identity
    User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0)
    Accept: */*
    Connection: keep-alive
    date: Tue, 15 Jan 2019 08:19:04 GMT
    authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    Content-Length: 0

    Exemple de réponse

    HTTP/1.1 204 No Content
    Server: AliyunOSS
    Date: Tue, 15 Jan 2019 08:19:04 GMT
    Content-Length: 0
    Connection: keep-alive
    x-oss-request-id: 5C3D9778CC1C2AEDF85B****
    x-oss-server-time: 190
  • Exemple de requête pour supprimer un bucket inexistant

    DELETE / HTTP/1.1
    Host: test.oss-cn-hangzhou.aliyuncs.com
    Accept-Encoding: identity
    User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0)
    Accept: */*
    Connection: keep-alive
    date: Tue, 15 Jan 2019 07:53:24 GMT
    authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    Content-Length: 0

    Exemple de réponse

    HTTP/1.1 404 Not Found
    Server: AliyunOSS
    Date: Tue, 15 Jan 2019 07:53:25 GMT
    Content-Type: application/xml
    Content-Length: 288
    Connection: keep-alive
    x-oss-request-id: 5C3D9175B6FC201293AD****
    
    <?xml version="1.0" encoding="UTF-8"?>
    <Error>
      <Code>NoSuchBucket</Code>
      <Message>The specified bucket does not exist.</Message>
      <RequestId>5C3D9175B6FC201293AD****</RequestId>
      <HostId>test.oss-cn-hangzhou.aliyuncs.com</HostId>
      <BucketName>test</BucketName>
      <EC>0015-00000101</EC>
    </Error>
  • Exemple de requête pour supprimer un bucket non vide

    DELETE / HTTP/1.1
    Host: test.oss-cn-hangzhou.aliyuncs.com
    Accept-Encoding: identity
    User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0)
    Accept: */*
    Connection: keep-alive
    date: Thu, 17 Apr 2025 07:35:06 GMT
    authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    Content-Length: 0

    Exemple de réponse

    HTTP/1.1 409 Conflict
    Server: AliyunOSS
    Date: Tue, 15 Jan 2019 07:35:06 GMT
    Content-Type: application/xml
    Content-Length: 296
    Connection: keep-alive
    x-oss-request-id: 5C3D8D2A0ACA54D87B43****
    x-oss-server-time: 16
    
    <?xml version="1.0" encoding="UTF-8"?>
    <Error>
      <Code>BucketNotEmpty</Code>
      <Message>The bucket has objects. Please delete them first.</Message>
      <RequestId>5C3D8D2A0ACA54D87B43****</RequestId>
      <HostId>test.oss-cn-hangzhou.aliyuncs.com</HostId>
      <BucketName>test</BucketName>
      <EC>0015-00000301</EC>
    </Error>

SDK

Appelez DeleteBucket à l'aide des SDK OSS suivants :

ossutil

Pour plus d'informations sur la commande ossutil correspondant à l'opération DeleteBucket, consultez la section delete-bucket.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

AccessDenied

403 Forbidden

Seul le propriétaire du bucket peut supprimer ce dernier.