Tüm Ürünler
Search

Bu Ürün

    Object Storage Service:DeleteDirectory

    Belge Merkezi

    Object Storage Service:DeleteDirectory

    Son Güncelleme:Oct 01, 2026

    Bir dizini siler. Bu işlem yalnızca hiyerarşik ad alanı özelliği etkinleştirilmiş paketlerde desteklenir.

    Kullanım notları

    • Dizinleri iki farklı yöntemle silebilirsiniz:

      • Özyinelemeli silme: Dizindeki tüm nesneleri ve alt dizinleri siler.

      • Özyinelemesiz silme: Yalnızca boş dizinleri siler.

    • Gerekli izinler kullandığınız silme yöntemine göre değişir:

      • Özyinelemeli silme için hedef dizinin ve bu dizin içindeki tüm nesneler ile alt dizinlerin üzerinde DeleteObject izni gerekir.

        Örneğin, desktop/osstest dizinini özyinelemeli olarak silmek için desktop/osstest dizini ve içeriğindeki tüm öğeler üzerinde DeleteObject iznine sahip olmanız gerekir.

      • Özyinelemesiz silme için yalnızca hedef dizin üzerinde DeleteObject izni gerekir.

        Örneğin, desktop/dir dizinini silmek için desktop/dir dizini üzerinde DeleteObject iznine sahip olmanız gerekir.

    • Dizine eş zamanlı yazma istekleri gönderildiğinde özyinelemeli silme işlemi başarısız olabilir.

    İstek yapısı

    POST /objectName?x-oss-delete HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    İstek üst bilgileri

    Header

    Type

    Required

    Description

    x-oss-delete-recursive

    String

    No

    Bir dizinin özyinelemeli olarak silinip silinmeyeceğini belirtir.

    • x-oss-delete-recursive parametresini belirtmezseniz veya bu parametreyi false olarak ayarlarsanız özyinelemesiz silme yöntemi kullanılır. Bu durumda yalnızca boş dizinleri silebilirsiniz.

    • x-oss-delete-recursive parametresini true olarak ayarlarsanız özyinelemeli silme yöntemi kullanılır. Bu durumda dizindeki tüm nesneler ve alt dizinler silinir.

    Varsayılan değer: false

    x-oss-delete-token

    String

    No

    Sonraki silme işleminin başlayacağı nesne veya dizin adıdır. Bu başlık yalnızca x-oss-delete-recursive değeri true olarak ayarlandığında geçerlidir.

    İlk DeleteDirectory isteğinde bu başlığı boş bırakın.

    Bu API işlemine Host ve Date gibi ortak istek üst bilgilerini de eklemeniz gerekir. Ortak istek üst bilgileri hakkında daha fazla bilgi için bkz. Ortak istek üst bilgileri.

    Yanıt üst bilgileri

    Bu API işlemindeki yanıt üst bilgileri yalnızca ortak yanıt üst bilgilerini içerir. Bu API işlemindeki ortak yanıt üst bilgileri hakkında daha fazla bilgi için bkz. Ortak yanıt üst bilgileri.

    Yanıt öğeleri


    Element


    Type


    Description


    DeleteDirectoryResult


    Container

    Dizin silme sonucunu içeren kapsayıcı.

    Üst düğümler: yok


    DirectoryName


    String

    Silinen dizinin adı.

    Üst düğümler: DeleteDirectoryResult


    DeleteNumber


    String

    Silinen nesne ve dizin sayısı.

    Üst düğümler: DeleteDirectoryResult


    NextDeleteToken


    String

    Silme işleminin devam edeceği sonraki nesne veya dizinin adı.

    Üst düğümler: DeleteDirectoryResult

    Örnekler

    • Özyinelemesiz silme

      Örnek istek

      POST /desktop/osstest/a?x-oss-delete HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 29 Apr 2021 05:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Örnek yanıt

      HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
Date: Thu, 29 Apr 2021 05:21:12 GMT
Connection: keep-alive
Server: AliyunOSS
<DeleteDirectoryResult>
    <DirectoryName>desktop/osstest/a</DirectoryName>
    <DeleteNumber>1</DeleteNumber>
</DeleteDirectoryResult>

    • Özyinelemeli silme

      Örnek istek

      POST /desktop/osstest/a?x-oss-delete HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 29 Apr 2021 05:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-delete-recursive: true

      Örnek yanıt

      HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
Date: Thu, 29 Apr 2021 05:21:12 GMT
Connection: keep-alive
Server: AliyunOSS
<DeleteDirectoryResult>
    <DirectoryName>desktop/osstest/a</DirectoryName>
    <DeleteNumber>100</DeleteNumber>
    <NextDeleteToken>Cg9kZXNrdG9wL29zcy9hLzk-</NextDeleteToken>
</DeleteDirectoryResult>

    OSS SDK'ları

    Aşağıdaki OSS SDK'ları DeleteDirectory işlemini destekler:

    Hata kodları

    Error code

    HTTP status code

    Description

    AccessDenied

    403

    Olası nedenler:

    • Belirtilen pakete erişim izniniz bulunmuyor.

    • Dizini silme izniniz bulunmuyor.

    NoSuchKey

    404

    Belirtilen dizin mevcut değil.

    FileAlreadyExists

    409

    Olası nedenler:

    • Dizin boş değil (özyinelemesiz silme).

    • Eş zamanlı yazma istekleri özyinelemeli silme işlemiyle çakışıyor.

    InvalidArgument

    400

    x-oss-delete-token değer biçimi geçersiz.