Excel İçin Bulut Dosya Yönetimi – Excel Dosyası Depolama ve Akıllı Düzenleme İçin Verimli ve Güvenli Bir Çözüm

Aspose.Cells Cloud, Aspose.Cells Cloud Depolama’da veya tercih ettiğiniz herhangi bir üçüncü taraf bulut depolama alanında saklanan dosyalarla çalışmak için kapsamlı bir dizi yardımcı işlev sağlar. Üçüncü taraf depolama kurulumu konusunda yardım için lütfen Aspose Cloud UI Yardım Konuları sayfasına bakın.

Aspose.Cells Cloud, dosya, klasör ve depolama işlemi API’leri sunar.

Not: Tüm API çağrıları HTTPS protokolünü kullanmalıdır. JWT jetonu alma hakkında ayrıntılı bilgi için Kimlik Doğrulama Kılavuzu sayfasına bakın.

Önkoşullar: Bu API’leri kullanmak için geçerli bir Aspose Cloud hesabınızın olması, bir JWT erişim jetonu elde etmeniz ve bir depolama konumunun yapılandırılmış (Aspose Cloud Depolama veya bağlanmış bir üçüncü taraf depolama) olması gerekir.

Son güncelleme tarihi: 2024‑12‑01

Dosya Nasıl Yüklenebilir?

Dosya Yükleme API Bilgileri

PUT https://api.aspose.cloud/v3.0/cells/storage/file/{path}

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
path	string	path	Dosyanın yükleneceği yol, dosya adı ve uzantı dahil (örneğin `/klasör1/Rapor.xlsx`).
file	file	formData	Yüklenecek dosya.
storageName	string	query	Kullanılacak depolama adı.

HTTP Yanıtları

Kod	Açıklama
200	Dosya başarıyla yüklendi.
400	Geçersiz istek – eksik veya geçersiz parametreler.
401	Yetkisiz erişim – geçersiz veya eksik JWT jetonu.
404	Depolama bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Dosya Yükleme Örneği

Aspose.Cells web hizmetlerine kolayca erişmek için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, cURL ile bir dosya nasıl yükleneceğini göstermektedir.

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/MyFolder/Rapor.xlsx" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>" \
  -F "File=@Rapor.xlsx"

Yanıt

{
  "Uploaded": [
    "MyFolder/Rapor.xlsx"
  ],
  "Errors": []
}

Not: Yükleme için maksimum dosya boyutu 100 MB’dir. Oran sınırlamaları uygulanabilir.

Dosya Nasıl İndirilebilir?

Dosya İndirme API Bilgileri

GET https://api.aspose.cloud/v3.0/cells/storage/file/{path}

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
path	string	path	Dosya yolu (örneğin `/klasör/Rapor.xlsx`).
storageName	string	query	Kullanılacak depolama adı.
versionId	string	query	İndirilecek dosya sürümünün tanımlayıcısı (isteğe bağlı).

HTTP Yanıtları

Kod	Açıklama
200	Dosya indirildi; ikili akış döndürüldü.
400	Geçersiz istek – geçersiz parametreler.
401	Yetkisiz erişim – eksik veya geçersiz JWT.
404	Dosya bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Dosya İndirme Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/MyFolder/Rapor.xlsx" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Stream": "<ikili veri>"
}

Not: Yanıt, dosyanın ikili akışını içerir. cURL kullanırken çıktıyı bir dosyaya kaydedin (-o dosyaadı.xlsx).

Dosya Nasıl Silinebilir?

Dosya Silme API Bilgileri

DELETE https://api.aspose.cloud/v3.0/cells/storage/file/{path}

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
path	string	path	Dosya yolu (örneğin `/klasör/Rapor.xlsx`).
storageName	string	query	Kullanılacak depolama adı.
versionId	string	query	Silinecek dosya sürümünün tanımlayıcısı (isteğe bağlı).

HTTP Yanıtları

Kod	Açıklama
200	Dosya başarıyla silindi.
400	Geçersiz istek – eksik veya geçersiz parametreler.
401	Yetkisiz erişim – geçersiz JWT jetonu.
404	Dosya bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Dosya Silme Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/MyFolder/EskiRapor.xlsx" \
  -X DELETE \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Code": 200,
  "Status": "OK"
}

Not: Dosya silme işlemi kalıcıdır; gerekirse yedek aldığınızdan emin olun.

Dosya Nasıl Kopyalanabilir?

Dosya Kopyalama API Bilgileri

PUT https://api.aspose.cloud/v3.0/cells/storage/file/copy/{srcPath}

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
srcPath	string	path	Kaynak dosya yolu (örneğin `/klasör/Kaynak.xlsx`).
destPath	string	query	Hedef dosya yolu (örneğin `/klasör/Hedef.xlsx`).
srcStorageName	string	query	Kaynak depolama adı (isteğe bağlı).
destStorageName	string	query	Hedef depolama adı (isteğe bağlı).
versionId	string	query	Kopyalanacak dosya sürümü tanımlayıcısı (isteğe bağlı).

HTTP Yanıtları

Kod	Açıklama
200	Dosya başarıyla kopyalandı.
400	Geçersiz istek – geçersiz parametreler.
401	Yetkisiz erişim – eksik veya geçersiz JWT.
404	Kaynak dosya bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Dosya Kopyalama Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/copy/MyFolder/Rapor.xlsx?destPath=MyFolder/RaporKopya.xlsx" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Code": 200,
  "Status": "OK"
}

Not: Kopyalama işlemi kaynak dosyayı kaldırmaz.

Dosya Nasıl Taşınabilir?

Dosya Taşıma API Bilgileri

PUT https://api.aspose.cloud/v3.0/cells/storage/file/move/{srcPath}

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
srcPath	string	path	Kaynak dosya yolu (örneğin `/klasör/Kaynak.xlsx`).
destPath	string	query	Hedef dosya yolu (örneğin `/klasör/Hedef.xlsx`).
srcStorageName	string	query	Kaynak depolama adı (isteğe bağlı).
destStorageName	string	query	Hedef depolama adı (isteğe bağlı).
versionId	string	query	Taşınacak dosya sürümü tanımlayıcısı (isteğe bağlı).

HTTP Yanıtları

Kod	Açıklama
200	Dosya başarıyla taşındı.
400	Geçersiz istek – geçersiz parametreler.
401	Yetkisiz erişim – eksik veya geçersiz JWT.
404	Kaynak dosya bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Dosya Taşıma Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/move/MyFolder/Rapor.xlsx?destPath=MyFolder/RaporTasinmis.xlsx" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Code": 200,
  "Status": "OK"
}

Not: Dosya taşıma işlemi dosyanın sürüm geçmişi bilgisini korur.

Klasör Nasıl Oluşturulur?

Klasör Oluşturma API Bilgileri

PUT https://api.aspose.cloud/v3.0/cells/storage/folder/{path}

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
path	string	path	Oluşturulacak klasör yolu (örneğin `klasör1/klasör2/`).
storageName	string	query	Kullanılacak depolama adı.

HTTP Yanıtları

Kod	Açıklama
200	Klasör başarıyla oluşturuldu.
400	Geçersiz istek – geçersiz yol veya parametreler.
401	Yetkisiz erişim – eksik veya geçersiz JWT.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Klasör Oluşturma Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/folder/yeniklasör" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Uploaded": [
    "yeniklasör"
  ],
  "Errors": []
}

Not: Klasör yolları büyük/küçük harfe duyarlıdır.

Bir Klasördeki Dosyalar Nasıl Listelenir?

Dosyaları Listeleme API Bilgileri

GET https://api.aspose.cloud/v3.0/cells/storage/folder/{path}

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
path	string	path	Klasör yolu (örneğin `/klasör`).
storageName	string	query	Kullanılacak depolama adı.

HTTP Yanıtları

Kod	Açıklama
200	Dosya ve alt klasör listesi döndürüldü.
400	Geçersiz istek – geçersiz yol.
401	Yetkisiz erişim – eksik veya geçersiz JWT.
404	Klasör bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Dosyaları Listeleme Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/folder/desfolder" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Value": [
    {
      "Name": "Rapor.xlsx",
      "IsFolder": false,
      "ModifiedDate": "2021-12-08T12:38:45.739Z",
      "Size": 102400,
      "Path": "/desfolder/Rapor.xlsx"
    }
  ]
}

Not: Yanıt, belirtilen yoldaki hem dosyaları hem de alt klasörleri listeler.

Klasör Nasıl Silinebilir?

Klasör Silme API Bilgileri

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

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
path	string	path	Klasör yolu (örneğin `/klasör`).
storageName	string	query	Kullanılacak depolama adı.
recursive	boolean	query	Klasörü özyinelemeli olarak silmek için `true` olarak ayarlayın.

HTTP Yanıtları

Kod	Açıklama
200	Klasör başarıyla silindi.
400	Geçersiz istek – geçersiz parametreler.
401	Yetkisiz erişim – eksik veya geçersiz JWT.
404	Klasör bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Klasör Silme Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/folder/desfolder" \
  -X DELETE \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Code": 200,
  "Status": "OK"
}

Not: recursive=true ayarıyla bir klasörün silinmesi, tüm içeriğini kalıcı olarak siler.

Klasör Nasıl Kopyalanabilir?

Klasör Kopyalama API Bilgileri

PUT https://api.aspose.cloud/v3.0/cells/storage/folder/copy/{srcPath}

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
srcPath	string	path	Kaynak klasör yolu (örneğin `/kaynak`).
destPath	string	query	Hedef klasör yolu (örneğin `/hedef`).
srcStorageName	string	query	Kaynak depolama adı (isteğe bağlı).
destStorageName	string	query	Hedef depolama adı (isteğe bağlı).

HTTP Yanıtları

Kod	Açıklama
200	Klasör başarıyla kopyalandı.
400	Geçersiz istek – geçersiz parametreler.
401	Yetkisiz erişim – eksik veya geçersiz JWT.
404	Kaynak klasör bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Klasör Kopyalama Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/folder/copy/kaynakklasör?destPath=hedefklasör" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Code": 200,
  "Status": "OK"
}

Not: Kopyalama işlemi, kaynakla aynı içeriğe sahip yeni bir klasör oluşturur.

Klasör Nasıl Taşınabilir?

Klasör Taşıma API Bilgileri

PUT https://api.aspose.cloud/v3.0/cells/storage/folder/move/{srcPath}

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
srcPath	string	path	Kaynak klasör yolu (örneğin `/klasör`).
destPath	string	query	Hedef klasör yolu (örneğin `/hedef`).
srcStorageName	string	query	Kaynak depolama adı (isteğe bağlı).
destStorageName	string	query	Hedef depolama adı (isteğe bağlı).

HTTP Yanıtları

Kod	Açıklama
200	Klasör başarıyla taşındı.
400	Geçersiz istek – geçersiz parametreler.
401	Yetkisiz erişim – eksik veya geçersiz JWT.
404	Kaynak klasör bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Klasör Taşıma Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/folder/move/desfolder?destPath=hedefklasör" \
  -X PUT \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Code": 200,
  "Status": "OK"
}

Not: Klasör taşıma işlemi, klasörün iç yapısını ve dosya sürümlerini korur.

Depolama Var mı Kontrolü Nasıl Yapılır?

Depolama Varlık Kontrolü API Bilgileri

GET https://api.aspose.cloud/v3.0/cells/storage/{storageName}/exist

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
storageName	string	path	Kontrol edilecek depolama adı.

HTTP Yanıtları

Kod	Açıklama
200	Depolama varlık durumu döndürüldü (`true` veya `false`).
401	Yetkisiz erişim – eksik veya geçersiz JWT.
404	Depolama bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Depolama Varlık Kontrolü Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/MyStorage/exist" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Exists": true
}

Dosya veya Klasör Var mı Kontrolü Nasıl Yapılır?

Nesne Varlık Kontrolü API Bilgileri

GET https://api.aspose.cloud/v3.0/cells/storage/exist/{path}

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
path	string	path	Dosya veya klasör yolu (örneğin `/dosya.xlsx` veya `/klasör`).
storageName	string	query	Kontrol edilecek depolama adı.
versionId	string	query	Dosya sürümü tanımlayıcısı (isteğe bağlı).

HTTP Yanıtları

Kod	Açıklama
200	Varlık bilgisi döndürüldü.
401	Yetkisiz erişim – eksik veya geçersiz JWT.
404	Dosya veya klasör bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Nesne Varlık Kontrolü Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/exist/Book1.xlsx" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Exists": true,
  "IsFolder": false
}

Disk Kullanımı Nasıl Görüntülenir?

Disk Kullanımı Görüntüleme API Bilgileri

GET https://api.aspose.cloud/v3.0/cells/storage/disc

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
storageName	string	query	Sorgulanacak depolama adı.

HTTP Yanıtları

Kod	Açıklama
200	Disk kullanımı bilgisi döndürüldü.
401	Yetkisiz erişim – eksik veya geçersiz JWT.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Disk Kullanımı Görüntüleme Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/disc?storageName=MyStorage" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "UsedSize": 12345678,
  "TotalSize": 987654321
}

Dosya Sürümleri Nasıl Görüntülenir?

Dosya Sürümlerini Görüntüleme API Bilgileri

GET https://api.aspose.cloud/v3.0/cells/storage/version/{path}

İstek parametreleri aşağıda listelenmiştir:

Parametre Adı	Tür	Konum	Açıklama
path	string	path	Dosya yolu (örneğin `/dosya.xlsx`).
storageName	string	query	Sorgulanacak depolama adı.

HTTP Yanıtları

Kod	Açıklama
200	Dosya sürüm listesi döndürüldü.
401	Yetkisiz erişim – eksik veya geçersiz JWT.
404	Dosya bulunamadı.
500	İç sunucu hatası.

OpenAPI Spesifikasyonu, doğrudan bir web tarayıcısından REST etkileşimlerini mümkün kılan genel olarak erişilebilir bir programlama arayüzü tanımlar.

Dosya Sürümlerini Görüntüleme Örneği

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/storage/version/Rapor.xlsx?storageName=MyStorage" \
  -X GET \
  -H "accept: application/json" \
  -H "Authorization: Bearer <jwt jetonu>"

Yanıt

{
  "Value": [
    {
      "Name": "Rapor.xlsx",
      "IsFolder": false,
      "ModifiedDate": "2021-12-08T18:57:46.128Z",
      "Size": 102400,
      "Path": "/Rapor.xlsx",
      "VersionId": "1",
      "IsLatest": true
    }
  ]
}

Aspose.Cells Cloud 3.0 Geliştirici Kılavuzu