Cloud-basierte Dateiverwaltung für Excel – Eine effiziente und sichere Lösung für die Speicherung und intelligente Organisation von Excel-Dateien

Aspose.Cells Cloud stellt eine umfassende Reihe von Hilfsfunktionen für die Arbeit mit Dateien bereit, die im Aspose.Cells Cloud-Speicher oder in einer beliebigen third‑party Cloud‑Speicherlösung Ihrer Wahl gespeichert sind. Für Unterstützung bei der Einrichtung eines third‑party Speichers verweisen wir auf die Aspose Cloud UI Hilfethemen.

Aspose.Cells Cloud bietet eine Reihe von APIs für Datei-, Ordner- und Speicheroperationen.

Hinweis: Alle API-Aufrufe müssen HTTPS verwenden. Details zum Beziehen eines JWT-Tokens finden Sie im Authentifizierungsleitfaden.

Voraussetzungen: Um diese APIs nutzen zu können, benötigen Sie einen gültigen Aspose Cloud-Account, ein JWT-Zugriffstoken sowie einen konfigurierten Speicherort (entweder Aspose Cloud Storage oder ein verbundener third‑party Speicher).

Zuletzt aktualisiert: 2024‑12‑01

So laden Sie eine Datei hoch

API-Informationen zum Hochladen einer Datei

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
path	string	path	Pfad zur hochzuladenden Datei, einschließlich Dateiname und Erweiterung (z. B. `/Ordner1/Report.xlsx`).
file	file	formData	Die hochzuladende Datei.
storageName	string	query	Name des zu verwendenden Speichers.

HTTP-Antworten

Code	Beschreibung
200	Datei erfolgreich hochgeladen.
400	Ungültige Anforderung – fehlende oder ungültige Parameter.
401	Nicht autorisiert – ungültiges oder fehlendes JWT-Token.
404	Speicher nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zum Hochladen einer Datei

Sie können das cURL-Befehlszeilentool verwenden, um problemlos auf Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie eine Datei mit cURL hochgeladen wird.

Anforderung

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

Antwort

{
  "Uploaded": [
    "MeinOrdner/Report.xlsx"
  ],
  "Errors": []
}

Hinweis: Die maximale Dateigröße für den Upload beträgt 100 MB. Rate-Limits können gelten.

So laden Sie eine Datei herunter

API-Informationen zum Herunterladen einer Datei

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
path	string	path	Dateipfad (z. B. `/Ordner/Report.xlsx`).
storageName	string	query	Name des zu verwendenden Speichers.
versionId	string	query	ID der herunterzuladenden Dateiversion (optional).

HTTP-Antworten

Code	Beschreibung
200	Datei erfolgreich heruntergeladen; Binärstrom wird zurückgegeben.
400	Ungültige Anforderung – ungültige Parameter.
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
404	Datei nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zum Herunterladen einer Datei

Anforderung

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

Antwort

{
  "Stream": "<binäre Daten>"
}

Hinweis: Die Antwort enthält den Binärstrom der Datei. Speichern Sie die Ausgabe mit cURL (-o filename.xlsx) in einer Datei.

So löschen Sie eine Datei

API-Informationen zum Löschen einer Datei

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
path	string	path	Dateipfad (z. B. `/Ordner/Report.xlsx`).
storageName	string	query	Name des zu verwendenden Speichers.
versionId	string	query	ID der zu löschenden Dateiversion (optional).

HTTP-Antworten

Code	Beschreibung
200	Datei erfolgreich gelöscht.
400	Ungültige Anforderung – fehlende oder ungültige Parameter.
401	Nicht autorisiert – ungültiges JWT-Token.
404	Datei nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zum Löschen einer Datei

Anforderung

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

Antwort

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

Hinweis: Das Löschen einer Datei ist dauerhaft; stellen Sie sicher, dass Sie bei Bedarf ein Backup besitzen.

So kopieren Sie eine Datei

API-Informationen zum Kopieren einer Datei

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
srcPath	string	path	Quellpfad der Datei (z. B. `/Ordner/Quelle.xlsx`).
destPath	string	query	Ziel Pfad der Datei (z. B. `/Ordner/Ziel.xlsx`).
srcStorageName	string	query	Name des Quellspeichers (optional).
destStorageName	string	query	Name des Ziel-speichers (optional).
versionId	string	query	ID der zu kopierenden Dateiversion (optional).

HTTP-Antworten

Code	Beschreibung
200	Datei erfolgreich kopiert.
400	Ungültige Anforderung – ungültige Parameter.
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
404	Quelldatei nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zum Kopieren einer Datei

Anforderung

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

Antwort

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

Hinweis: Der Kopiervorgang entfernt die Quelldatei nicht.

So verschieben Sie eine Datei

API-Informationen zum Verschieben einer Datei

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
srcPath	string	path	Quellpfad der Datei (z. B. `/Ordner/Quelle.xlsx`).
destPath	string	query	Ziel-Pfad der Datei (z. B. `/Ordner/Ziel.xlsx`).
srcStorageName	string	query	Name des Quellspeichers (optional).
destStorageName	string	query	Name des Ziel-speichers (optional).
versionId	string	query	ID der zu verschiebenden Dateiversion (optional).

HTTP-Antworten

Code	Beschreibung
200	Datei erfolgreich verschoben.
400	Ungültige Anforderung – ungültige Parameter.
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
404	Quelldatei nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zum Verschieben einer Datei

Anforderung

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

Antwort

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

Hinweis: Beim Verschieben einer Datei bleibt deren Versionsverlauf erhalten.

So erstellen Sie einen Ordner

API-Informationen zum Erstellen eines Ordners

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
path	string	path	Pfad des zu erstellenden Ordners (z. B. `ordner1/ordner2/`).
storageName	string	query	Name des zu verwendenden Speichers.

HTTP-Antworten

Code	Beschreibung
200	Ordner erfolgreich erstellt.
400	Ungültige Anforderung – ungültiger Pfad oder Parameter.
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zum Erstellen eines Ordners

Anforderung

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

Antwort

{
  "Uploaded": [
    "neuerordner"
  ],
  "Errors": []
}

Hinweis: Ordnerpfade unterscheiden zwischen Groß- und Kleinschreibung.

So rufen Sie Dateien in einem Ordner ab

API-Informationen zum Abrufen von Dateien

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
path	string	path	Ordnerpfad (z. B. `/ordner`).
storageName	string	query	Name des zu verwendenden Speichers.

HTTP-Antworten

Code	Beschreibung
200	Liste der Dateien und Unterordner zurückgegeben.
400	Ungültige Anforderung – ungültiger Pfad.
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
404	Ordner nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zum Abrufen von Dateien

Anforderung

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

Antwort

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

Hinweis: Die Antwort listet sowohl Dateien als auch Unterordner im angegebenen Pfad auf.

So löschen Sie einen Ordner

API-Informationen zum Löschen eines Ordners

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
path	string	path	Ordnerpfad (z. B. `/ordner`).
storageName	string	query	Name des zu verwendenden Speichers.
recursive	boolean	query	Auf `true` setzen, um den Ordner rekursiv zu löschen.

HTTP-Antworten

Code	Beschreibung
200	Ordner erfolgreich gelöscht.
400	Ungültige Anforderung – ungültige Parameter.
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
404	Ordner nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zum Löschen eines Ordners

Anforderung

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

Antwort

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

Hinweis: Das Löschen eines Ordners mit recursive=true entfernt dessen gesamten Inhalt dauerhaft.

So kopieren Sie einen Ordner

API-Informationen zum Kopieren eines Ordners

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
srcPath	string	path	Quellpfad des Ordners (z. B. `/quelle`).
destPath	string	query	Ziel-Pfad des Ordners (z. B. `/ziel`).
srcStorageName	string	query	Name des Quellspeichers (optional).
destStorageName	string	query	Name des Ziel-speichers (optional).

HTTP-Antworten

Code	Beschreibung
200	Ordner erfolgreich kopiert.
400	Ungültige Anforderung – ungültige Parameter.
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
404	Quellordner nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zum Kopieren eines Ordners

Anforderung

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

Antwort

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

Hinweis: Der Kopiervorgang erstellt einen neuen Ordner mit denselben Inhalten wie der Quellordner.

So verschieben Sie einen Ordner

API-Informationen zum Verschieben eines Ordners

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
srcPath	string	path	Quellpfad des Ordners (z. B. `/ordner`).
destPath	string	query	Ziel-Pfad des Ordners (z. B. `/ziel`).
srcStorageName	string	query	Name des Quellspeichers (optional).
destStorageName	string	query	Name des Ziel-speichers (optional).

HTTP-Antworten

Code	Beschreibung
200	Ordner erfolgreich verschoben.
400	Ungültige Anforderung – ungültige Parameter.
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
404	Quellordner nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zum Verschieben eines Ordners

Anforderung

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

Antwort

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

Hinweis: Beim Verschieben eines Ordners bleibt dessen interne Struktur und die Dateiversionen erhalten.

So prüfen Sie, ob ein Speicher vorhanden ist

API-Informationen zur Prüfung auf Speichervorhandensein

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
storageName	string	path	Name des zu prüfenden Speichers.

HTTP-Antworten

Code	Beschreibung
200	Vorhandensein des Speichers zurückgegeben (`true` oder `false`).
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
404	Speicher nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zur Prüfung auf Speichervorhandensein

Anforderung

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

Antwort

{
  "Exists": true
}

So prüfen Sie, ob eine Datei oder ein Ordner vorhanden ist

API-Informationen zur Prüfung auf Vorhandensein eines Objekts

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
path	string	path	Datei- oder Ordnerpfad (z. B. `/datei.xlsx` oder `/ordner`).
storageName	string	query	Name des zu prüfenden Speichers.
versionId	string	query	ID der Dateiversion (optional).

HTTP-Antworten

Code	Beschreibung
200	Vorhandenseinsinformationen zurückgegeben.
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
404	Datei oder Ordner nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zur Prüfung auf Vorhandensein eines Objekts

Anforderung

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

Antwort

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

So rufen Sie die Speicherauslastung ab

API-Informationen zur Ermittlung der Speicherauslastung

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
storageName	string	query	Name des abzufragenden Speichers.

HTTP-Antworten

Code	Beschreibung
200	Informationen zur Speicherauslastung zurückgegeben.
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zur Ermittlung der Speicherauslastung

Anforderung

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

Antwort

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

So rufen Sie Dateiversionen ab

API-Informationen zum Abrufen von Dateiversionen

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

Die Anforderungsparameter sind wie folgt aufgelistet:

Parametername	Typ	Ort	Beschreibung
path	string	path	Dateipfad (z. B. `/datei.xlsx`).
storageName	string	query	Name des abzufragenden Speichers.

HTTP-Antworten

Code	Beschreibung
200	Liste der Dateiversionen zurückgegeben.
401	Nicht autorisiert – fehlendes oder ungültiges JWT.
404	Datei nicht gefunden.
500	Interner Serverfehler.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, über die REST-Interaktionen direkt aus einem Webbrowser möglich sind.

Beispiel zum Abrufen von Dateiversionen

Anforderung

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

Antwort

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

Aspose.Cells Cloud Web API – Öffnen- oder Bearbeitungspasswort für Excel-Dateien festlegen / ändern Aspose.Cells Cloud 3.0 Entwicklerhandbuch