Klasör Sil – Aspose.Cells Cloud API

Aspose.Cells Cloud deposundan bir klasörü (ve isteğe bağlı olarak içindeki tüm içerikleri) kaldırın.

Genel Bakış

Klasör Sil işlemi, Aspose.Cells Cloud tarafından kullanılan bir depo hesabından bir klasörü kalıcı olarak kaldırır.
Boş bir klasörü veya recursive bayrağını true olarak ayarlayarak klasörün içerdiği tüm dosya ve alt klasörlerle birlikte silebilirsiniz. Bu uç nokta genellikle temizlik betiklerinde, otomatik iş akışlarında veya geçici dizinlere artık ihtiyaç duyulmadığında kullanılır.

HTTP İsteği

DELETE https://api.aspose.cloud/v4.0/cells/storage/folder/{path}

{path} – Silinecek klasörün tam yolu (URL‑kodlu).

Gerekli HTTP Başlıkları

Başlık Değer Açıklama
Authorization Bearer {access_token} Kimlik doğrulama hizmetinden alınan JWT belirteci.
Accept application/json Beklenen yanıt biçimi.
Content-Type application/json (isteğe bağlı) DELETE için gerekli değildir, ancak gönderilebilir.

Kimlik Doğrulama

Aspose.Cells Cloud, JWT belirteci tabanlı kimlik doğrulama kullanır.
Bir erişim belirteci, kimlik doğrulama uç noktasından alın ve yukarıda gösterildiği gibi Authorization başlığına ekleyin.

-H "Authorization: Bearer {access_token}"

Parametreler

Ad Tür Konum Gerekli Açıklama
path string Yol Evet Silinecek klasörün yolu (URL‑kodlu).
storageName string Sorgu Hayır Klasörü içeren deponun adı. Atlanırsa varsayılan depo kullanılır.
recursive boolean Sorgu Hayır true → klasörü ve tüm içeriğini siler. Varsayılan değer false‘tur.

Örnek sorgu dizisi

?storageName=MyStorage&recursive=true

İstek Örneği (cURL)

curl -X DELETE "https://api.aspose.cloud/v4.0/cells/storage/folder/MyFolder?storageName=MyStorage&recursive=true" \
     -H "Authorization: Bearer {access_token}" \
     -H "Accept: application/json"

Yanıt

Başarılı bir istek, boş bir JSON nesnesiyle birlikte HTTP 200 OK döndürür:

{}

İşlem sonucu ikili olduğu için (klasör silinir veya bir hata döndürülür) ek bir yük sağlanmaz.

HTTP Durum Kodları

Kod Anlam Açıklama
200 OK Süzgeç başarıyla uygulandı; yanıt işlem ayrıntılarını içerir.
400 Bad Request (Hatalı İstek) Eksik veya geçersiz parametreler (örneğin, desteklenmeyen dosya türü).
401 Unauthorized (Yetkisiz) Geçersiz veya eksik JWT belirteci.
413 Payload Too Large (Çok Büyük Yük) Yüklenen dosya boyut sınırını aşıyor.
500 Internal Server Error (İç Sunucu Hatası) Beklenmeyen sunucu hatası.

Bir hata oluştuğunda, gövde code ve message alanlarını içeren bir JSON nesnesiyle birlikte hatayı açıklayacaktır.

SDK Örnek Kodları

Aşağıdaki örnekler, resmi olarak desteklenen SDK’larla Klasör Sil işlemini nasıl çağıracağınızı göstermektedir. {access_token} ve parametre değerlerini kendi değerlerinizle değiştirin.

🟦 C# (dotnet) 
using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Client;
using Aspose.Cells.Cloud.SDK.Model.Requests;

// API istemcisini yapılandır
var config = new Configuration
{
    AccessToken = "{access_token}",
    BasePath = "https://api.aspose.cloud"
};

var folderApi = new FolderApi(config);

// Klasörü sil (özyinelemeli)
var request = new DeleteFolderRequest
{
    Path = "MyFolder",
    StorageName = "MyStorage",
    Recursive = true
};

folderApi.DeleteFolder(request);
🟨 Java 
import com.aspose.cloud.cells.api.FolderApi;
import com.aspose.cloud.cells.model.*;
import com.aspose.cloud.cells.model.requests.DeleteFolderRequest;

// API istemcisini başlat
FolderApi folderApi = new FolderApi("{access_token}");

DeleteFolderRequest request = new DeleteFolderRequest()
        .path("MyFolder")
        .storageName("MyStorage")
        .recursive(true);

folderApi.deleteFolder(request);
🟪 PHP 
<?php
require_once 'vendor/autoload.php';

use Aspose\Cells\Cloud\Api\FolderApi;
use Aspose\Cells\Cloud\Configuration;

// Yapılandır
$config = new Configuration();
$config->setAccessToken('{access_token}');
$config->setHost('https://api.aspose.cloud');

$apiInstance = new FolderApi($config);

// Klasörü özyinelemeli olarak sil
try {
    $apiInstance->deleteFolder('MyFolder', 'MyStorage', true);
    echo "Folder deleted.";
} catch (Exception $e) {
    echo 'Exception when calling FolderApi->deleteFolder: ', $e->getMessage(), PHP_EOL;
}
?>
🟧 Ruby 
require 'aspose_cells_cloud'

config = AsposeCellsCloud::Configuration.new
config.access_token = '{access_token}'
config.host = 'https://api.aspose.cloud'

api = AsposeCellsCloud::FolderApi.new

begin
  api.delete_folder('MyFolder', storage_name: 'MyStorage', recursive: true)
  puts 'Folder deleted.'
rescue AsposeCellsCloud::ApiError => e
  puts "Error: #{e.message}"
end
🟢 Node.js (TypeScript) 
import { FolderApi, DeleteFolderRequest } from '@asposecloud/cells-sdk';

const config = {
    accessToken: '{access_token}',
    basePath: 'https://api.aspose.cloud'
};

const folderApi = new FolderApi(config);

const request: DeleteFolderRequest = {
    path: 'MyFolder',
    storageName: 'MyStorage',
    recursive: true
};

folderApi.deleteFolder(request)
    .then(() => console.log('Folder deleted'))
    .catch(err => console.error('Error:', err));
🐍 Python 
from asposecellscloud import FolderApi, DeleteFolderRequest, Configuration

config = Configuration()
config.access_token = '{access_token}'
config.host = 'https://api.aspose.cloud'

folder_api = FolderApi(config)

request = DeleteFolderRequest(
    path='MyFolder',
    storage_name='MyStorage',
    recursive=True
)

folder_api.delete_folder(request)
print("Folder deleted")
🦪 Perl 
use AsposeCellsCloud::FolderApi;
use AsposeCellsCloud::Configuration;

my $config = AsposeCellsCloud::Configuration->new(
    access_token => '{access_token}',
    host => 'https://api.aspose.cloud'
);

my $api = AsposeCellsCloud::FolderApi->new($config);

eval {
    $api->delete_folder(
        path => 'MyFolder',
        storage_name => 'MyStorage',
        recursive => 1
    );
    print "Folder deleted.\n";
};
if ($@) {
    warn "Error deleting folder: $@";
}
🦑 Go 
package main

import (
    "context"
    "fmt"
    cells "github.com/asposecellscloud/aspose-cells-cloud-go/v4"
)

func main() {
    cfg := cells.NewConfiguration()
    cfg.AccessToken = "{access_token}"
    cfg.Host = "https://api.aspose.cloud"

    api := cells.NewFolderApi(cfg)

    req := cells.DeleteFolderRequest{
        Path:        "MyFolder",
        StorageName: "MyStorage",
        Recursive:   true,
    }

    _, err := api.DeleteFolder(context.Background(), req)
    if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }
    fmt.Println("Folder deleted")
}

Ayrıca Bakınız

SEO & Erişilebilirlik Kontrol Listesi (iç)