Object Storage Service:DeleteObject

Notes d'utilisation

• Si un bucket dispose de règles de réplication des données configurées pour synchroniser toutes les modifications (ajout/suppression/modification), y compris la création, la modification et la suppression d'objets, l'appel de l'opération DeleteObject pour supprimer des objets stockés entraîne également la suppression des objets répliqués dans le bucket de destination associé à la stratégie de réplication. Par ailleurs, si le versioning est activé pour ce bucket, des marqueurs de suppression sont créés pour les objets supprimés dans le bucket source et répliqués vers le bucket de destination lorsque vous appelez l'opération DeleteObject.

• Les objets supprimés ne peuvent pas être récupérés. Agissez avec prudence. Pour plus d'informations sur la suppression d'objets, consultez la rubrique Supprimer des objets.

• Un code d'état HTTP 204 est renvoyé en cas de succès de l'opération DeleteObject, que l'objet existe ou non.

• Si l'objet que vous souhaitez supprimer est un lien symbolique, l'opération DeleteObject supprime uniquement le lien symbolique, et non l'objet ciblé par ce lien.

• L'opération DeleteObject ne permet pas de supprimer des répertoires dans un bucket pour lequel la fonctionnalité de namespace hiérarchique est activée.

Versioning

Lorsque vous appelez DeleteObject pour supprimer un objet d'un bucket versionné, vous devez déterminer s'il convient de spécifier un ID de version dans la requête.

• Supprimer un objet sans spécifier d'ID de version (suppression temporaire)

  Si vous ne spécifiez pas l'ID de version de l'objet à supprimer dans la requête, OSS ne supprime pas la version actuelle de l'objet, mais ajoute un marqueur de suppression en tant que nouvelle version. De plus, la réponse inclut l'en-tête x-oss-delete-marker = true ainsi que l'en-tête x-oss-version-id indiquant l'ID de version du marqueur de suppression créé.

  Si la valeur de x-oss-delete-marker est true, la valeur de x-oss-version-id correspond à l'ID de version du marqueur de suppression.

  Remarque

  Si vous supprimez un objet sans spécifier son ID de version dans un bucket dont le versioning est suspendu et que l'objet possède déjà une version null, OSS ajoute un marqueur de suppression avec un ID de version null pour écraser la version null existante. Un objet ne peut avoir qu'une seule version dont l'ID de version est null.

• Supprimer un objet en spécifiant un ID de version (suppression définitive)

  Si vous spécifiez versionId dans params de la requête, OSS supprime la version spécifiée. Pour supprimer une version null, incluez params['versionId'] = "null" dans params. OSS identifie la chaîne « null » comme l'ID de la version à supprimer et supprime la version null.

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'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.

Syntaxe de la requête

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

En-têtes de requête

DescribeRegions utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la rubrique En-têtes de requête communs.

En-têtes de réponse

La réponse à cette requête contient des en-têtes de réponse communs. Pour plus d'informations sur les en-têtes de réponse communs, consultez la rubrique En-têtes de réponse communs.

Exemples

• Supprimer un objet d'un bucket non versionné.

  Exemple de requête

  DELETE /AK.txt HTTP/1.1
  Host: test.oss-cn-zhangjiakou.aliyuncs.com
  Accept-Encoding: identity
  User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0)
  Accept: text/html
  Connection: keep-alive
  Date: Wed, 02 Jan 2019 13:28:38 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: Wed, 02 Jan 2019 13:28:38 GMT
  Content-Length: 0
  Connection: keep-alive
  x-oss-request-id: 5C2CBC8653718B5511EF4535
  x-oss-server-time: 134

• Supprimer un objet d'un bucket versionné sans spécifier d'ID de version.

  Dans ce cas, OSS ajoute un marqueur de suppression à l'objet et inclut l'en-tête x-oss-delete-marker=true dans la réponse.

  Exemple de requête

  DELETE /example HTTP/1.1
  Host: versioning-delete.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 04:08:23 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  Exemple de réponse

  HTTP/1.1 204 NoContent
  x-oss-delete-marker: true
  x-oss-version-id: CAEQMxiBgIDh3ZCB0BYiIGE4YjIyMjExZDhhYjQxNzZiNGUyZTI4ZjljZDcz****
  x-oss-request-id: 5CAC1AB7B7AEADE01700****
  Date: Tue, 09 Apr 2019 04:08:23 GMT
  Connection: keep-alive
  Server: AliyunOSS

• Supprimer une version d'un objet d'un bucket versionné en spécifiant l'ID de version.

  Dans ce cas, la version spécifiée de l'objet est supprimée de manière définitive.

  Exemple de requête

  DELETE /example?versionId=CAEQOBiBgIDNlJeB0BYiIDAwYjJlNDQ4YjJkMzQxMmY5NTM5N2UzZWNiZTQ2**** HTTP/1.1
  Host: versioning-delete.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 04:11:54 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  Exemple de réponse

  HTTP/1.1 204 No Content
  x-oss-version-id: CAEQOBiBgIDNlJeB0BYiIDAwYjJlNDQ4YjJkMzQxMmY5NTM5N2UzZWNiZTQ2****
  x-oss-request-id: 5CAC1B8AB7AEADE01700****
  Date: Tue, 09 Apr 2019 04:11:54 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

• Supprimer un marqueur de suppression d'un bucket versionné en spécifiant l'ID de version du marqueur de suppression.

  Dans l'exemple suivant, la version spécifiée est un marqueur de suppression. L'en-tête x-oss-delete-marker=true est inclus dans la réponse.

  Exemple de requête

  DELETE /example?versionId=CAEQOBiBgIDNlJeB0BYiIDAwYjJlNDQ4YjJkMzQxMmY5NTM5N2UzZWNiZTQ2**** HTTP/1.1
  Host: versioning-delete.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 04:16:25 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  Exemple de réponse

  HTTP/1.1 204 No Content
  x-oss-delete-marker: true
  x-oss-version-id: CAEQNhiBgIDFtp.B0BYiIDk4NzgwMmU4NDMyOTQyM2NiMDQxOTcxYWNhMjc1****
  x-oss-request-id: 5CAC1C99B7AEADE01700****
  Date: Tue, 09 Apr 2019 04:16:25 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

SDK

Vous pouvez utiliser les SDK OSS pour les langages de programmation suivants afin d'appeler DeleteObject :

• Java

• Python V2

• PHP

• Go V2

• C

• .NET

• Android

• iOS

• Node.js

• Browser.js

ossutil

Pour obtenir des informations sur la commande ossutil correspondant à l'opération DeleteObject, consultez la rubrique delete-object.

Références

• Pour obtenir des informations sur l'opération API permettant de supprimer plusieurs objets simultanément, consultez la rubrique DeleteMultipleObjects.

• Pour savoir comment supprimer automatiquement des objets, consultez la rubrique Cycle de vie.

Codes d'erreur