Object Storage Service:DeleteObject

Kullanım notları

• Bir paket için veri çoğaltma kuralları yapılandırılmış ve tüm veri değişikliklerini (Ekleme/Silme/Değiştirme) senkronize edecek şekilde ayarlanmışsa depolanan nesneleri silmek üzere DeleteObject işlemi çağrıldığında bu nesnelerin kopyaları da çoğaltma ilkesiyle ilişkili hedef paketten silinir. Ayrıca söz konusu paket için sürüm oluşturma özelliği etkinleştirilmişse DeleteObject işlemini çağırdığınızda kaynak pakette silinen nesneler için silme işaretçileri oluşturulur ve bu işaretçiler hedef pakete de çoğaltılır.

• Silinen nesneler geri alınamaz. Dikkatli olun. Nesne silme hakkında daha fazla bilgi için bkz. Nesne silme.

• Nesnenin var olup olmadığından bağımsız olarak DeleteObject işlemi başarılı olduğunda HTTP 204 durum kodu döndürülür.

• Silmek istediğiniz nesne bir sembolik bağlantı ise DeleteObject işlemi yalnızca sembolik bağlantıyı siler; bağlantının işaret ettiği nesneyi silmez.

• Hiyerarşik ad alanı özelliği etkinleştirilmiş bir paketteki dizinleri silmek için DeleteObject işlemi kullanılamaz.

Sürüm oluşturma

Sürüm oluşturulmuş bir paketten nesne silmek üzere DeleteObject işlemini çağırırken istekte bir sürüm kimliği belirtip belirtmeyeceğinize karar vermeniz gerekir.

• Sürüm kimliği belirtmeden nesne silme (geçici silme)

  Silmek istediğiniz nesnenin sürüm kimliğini istekte belirtmezseniz OSS nesnenin mevcut sürümünü silmez; bunun yerine nesneye yeni bir sürüm olarak bir silme işaretçisi ekler. Ayrıca yanıt, x-oss-delete-marker = true üst bilgisini ve oluşturulan silme işaretçisinin sürüm kimliğini belirten x-oss-version-id üst bilgisini içerir.

  x-oss-delete-marker değeri true ise x-oss-version-id değeri silme işaretçisinin sürüm kimliğidir.

  Not

  Sürüm oluşturma askıya alınmış bir pakette nesne sürüm kimliği belirtmeden sildiğinizde ve nesne zaten null bir sürüme sahipse OSS mevcut null sürümün üzerine yazmak için sürüm kimliği null olan bir silme işaretçisi ekler. Bir nesnenin sürüm kimliği null olan en fazla bir sürümü olabilir.

• Sürüm kimliği belirterek nesne silme (kalıcı silme)

  İsteğin params bölümünde versionId belirtirseniz OSS belirtilen sürümü siler. Null bir sürümü silmek istiyorsanız params içinde params['versionId'] = "null" ifadesini dahil edin. OSS "null" dizesini silinecek sürümün kimliği olarak tanımlar ve null sürümü siler.

İzinler

Varsayılan olarak bir Alibaba Cloud hesabı tam izinlere sahiptir. Bir Alibaba Cloud hesabı altındaki RAM kullanıcıları veya RAM rolleri varsayılan olarak hiçbir izne sahip değildir. Alibaba Cloud hesabı veya hesap yöneticisi RAM ilkeleri veya Paket İlkesi aracılığıyla işlem izinleri vermelidir.

İstek sözdizimi

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

İstek üst bilgileri

DescribeRegions yalnızca ortak istek üst bilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üst bilgileri.

Yanıt üst bilgileri

Bu isteğin yanıtı ortak yanıt üst bilgilerini içerir. Ortak yanıt üst bilgileri hakkında daha fazla bilgi için bkz. Ortak yanıt üst bilgileri.

Örnekler

• Sürüm oluşturulmamış bir paketten nesne silin.

  Örnek istek

  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

  Örnek yanıt

  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

• Sürüm oluşturulmuş bir paketten sürüm kimliği belirtmeden nesne silin.

  Bu durumda OSS nesneye bir silme işaretçisi ekler ve yanıtta x-oss-delete-marker=true üst bilgisini dahil eder.

  Örnek istek

  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

  Örnek yanıt

  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

• Sürüm oluşturulmuş bir paketten nesnenin belirli bir sürümünü sürüm kimliğini belirterek silin.

  Bu durumda nesnenin belirtilen sürümü kalıcı olarak silinir.

  Örnek istek

  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

  Örnek yanıt

  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

• Sürüm oluşturulmuş bir paketten silme işaretçisini silme işaretçisinin sürüm kimliğini belirterek silin.

  Aşağıdaki örnekte belirtilen sürüm bir silme işaretçisidir. Yanıtta x-oss-delete-marker=true üst bilgisi yer alır.

  Örnek istek

  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

  Örnek yanıt

  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

DeleteObject işlemini çağırmak için aşağıdaki programlama dillerine yönelik OSS SDK'larını kullanabilirsiniz:

• Java

• Python V2

• PHP

• Go V2

• C

• .NET

• Android

• iOS

• Node.js

• Browser.js

ossutil

DeleteObject işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. delete-object.

Başvuru Kaynakları

• Birden çok nesneyi aynı anda silmek için çağırabileceğiniz API işlemi hakkında bilgi için bkz. DeleteMultipleObjects.

• Nesnelerin otomatik olarak nasıl silineceği hakkında bilgi için bkz. Yaşam döngüsü.

Hata kodları