Aspose.Cells Cloud fornisce un insieme completo di funzioni di supporto per la gestione dei file archiviati nello storage di Aspose.Cells Cloud o in qualsiasi servizio di archiviazione cloud di terze parti a tua scelta. Per assistenza nella configurazione di uno storage di terze parti, consulta gli Argomenti della Guida dell’interfaccia utente di Aspose Cloud.

Aspose.Cells Cloud offre una serie di API per operazioni su file, cartelle e storage.

Nota: Tutte le chiamate API devono utilizzare HTTPS. Per maggiori dettagli su come ottenere un token JWT, consulta la Guida all’autenticazione.

Prerequisiti: Per utilizzare queste API devi disporre di un account Aspose Cloud valido, aver ottenuto un token di accesso JWT e aver configurato una posizione di storage (sia lo storage di Aspose Cloud che uno storage di terze parti connesso).

Ultimo aggiornamento: 2024-12-01

Come caricare un file

Informazioni sull’API per il caricamento di file

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
path string path Percorso di destinazione per il file da caricare, incluso nome e estensione (es. /cartella1/Report.xlsx).
file file formData File da caricare.
storageName string query Nome dello storage da utilizzare.

Risposte HTTP

Codice Descrizione
200 File caricato correttamente.
400 Richiesta non valida – parametri mancanti o non validi.
401 Non autorizzato – token JWT non valido o mancante.
404 Storage non trovato.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di caricamento file

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come caricare un file con cURL.

Nota: La dimensione massima del file caricabile è di 100 MB. Possono essere applicati limiti di frequenza.

Come scaricare un file

Informazioni sull’API per lo scaricamento di file

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
path string path Percorso del file (es. /cartella/Report.xlsx).
storageName string query Nome dello storage da utilizzare.
versionId string query Identificatore della versione del file da scaricare (opzionale).

Risposte HTTP

Codice Descrizione
200 File scaricato; viene restituito uno stream binario.
400 Richiesta non valida – parametri non validi.
401 Non autorizzato – token JWT mancante o non valido.
404 File non trovato.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di scaricamento file

Nota: La risposta contiene lo stream binario del file. Quando utilizzi cURL, salva l’output in un file (-o filename.xlsx).

Come eliminare un file

Informazioni sull’API per l’eliminazione di file

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
path string path Percorso del file (es. /cartella/Report.xlsx).
storageName string query Nome dello storage da utilizzare.
versionId string query Identificatore della versione del file da eliminare (opzionale).

Risposte HTTP

Codice Descrizione
200 File eliminato correttamente.
400 Richiesta non valida – parametri mancanti o non validi.
401 Non autorizzato – token JWT non valido.
404 File non trovato.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di eliminazione file

Nota: L’eliminazione di un file è irreversibile; assicurati di disporre di un backup qualora necessario.

Come copiare un file

Informazioni sull’API per la copia di file

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
srcPath string path Percorso del file sorgente (es. /cartella/Sorgente.xlsx).
destPath string query Percorso di destinazione del file (es. /cartella/Destinazione.xlsx).
srcStorageName string query Nome dello storage sorgente (opzionale).
destStorageName string query Nome dello storage di destinazione (opzionale).
versionId string query ID della versione del file da copiare (opzionale).

Risposte HTTP

Codice Descrizione
200 File copiato correttamente.
400 Richiesta non valida – parametri non validi.
401 Non autorizzato – token JWT mancante o non valido.
404 File sorgente non trovato.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di copia file

Nota: L’operazione di copia non rimuove il file sorgente.

Come spostare un file

Informazioni sull’API per lo spostamento di file

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
srcPath string path Percorso del file sorgente (es. /cartella/Sorgente.xlsx).
destPath string query Percorso di destinazione del file (es. /cartella/Destinazione.xlsx).
srcStorageName string query Nome dello storage sorgente (opzionale).
destStorageName string query Nome dello storage di destinazione (opzionale).
versionId string query ID della versione del file da spostare (opzionale).

Risposte HTTP

Codice Descrizione
200 File spostato correttamente.
400 Richiesta non valida – parametri non validi.
401 Non autorizzato – token JWT mancante o non valido.
404 File sorgente non trovato.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di spostamento file

Nota: Lo spostamento di un file conserva la cronologia delle versioni del file.

Come creare una cartella

Informazioni sull’API per la creazione di cartelle

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
path string path Percorso della cartella da creare (es. cartella1/cartella2/).
storageName string query Nome dello storage da utilizzare.

Risposte HTTP

Codice Descrizione
200 Cartella creata correttamente.
400 Richiesta non valida – percorso o parametri non validi.
401 Non autorizzato – token JWT mancante o non valido.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di creazione cartella

Nota: I percorsi delle cartelle sono sensibili alle maiuscole.

Come ottenere l’elenco dei file in una cartella

Informazioni sull’API per l’elenco dei file

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
path string path Percorso della cartella (es. /cartella).
storageName string query Nome dello storage da utilizzare.

Risposte HTTP

Codice Descrizione
200 Elenco di file e sottocartelle restituito.
400 Richiesta non valida – percorso non valido.
401 Non autorizzato – token JWT mancante o non valido.
404 Cartella non trovata.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di elenco dei file

Nota: La risposta elenca sia i file che le sottocartelle presenti nel percorso specificato.

Come eliminare una cartella

Informazioni sull’API per l’eliminazione di cartelle

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
path string path Percorso della cartella (es. /cartella).
storageName string query Nome dello storage da utilizzare.
recursive boolean query Impostare su true per eliminare la cartella in modo ricorsivo.

Risposte HTTP

Codice Descrizione
200 Cartella eliminata correttamente.
400 Richiesta non valida – parametri non validi.
401 Non autorizzato – token JWT mancante o non valido.
404 Cartella non trovata.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di eliminazione cartella

Nota: L’eliminazione di una cartella con recursive=true rimuove permanentemente tutto il suo contenuto.

Come copiare una cartella

Informazioni sull’API per la copia di cartelle

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
srcPath string path Percorso della cartella sorgente (es. /src).
destPath string query Percorso della cartella di destinazione (es. /dst).
srcStorageName string query Nome dello storage sorgente (opzionale).
destStorageName string query Nome dello storage di destinazione (opzionale).

Risposte HTTP

Codice Descrizione
200 Cartella copiata correttamente.
400 Richiesta non valida – parametri non validi.
401 Non autorizzato – token JWT mancante o non valido.
404 Cartella sorgente non trovata.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di copia cartella

Nota: L’operazione di copia crea una nuova cartella con lo stesso contenuto della sorgente.

Come spostare una cartella

Informazioni sull’API per lo spostamento di cartelle

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
srcPath string path Percorso della cartella sorgente (es. /cartella).
destPath string query Percorso della cartella di destinazione (es. /dst).
srcStorageName string query Nome dello storage sorgente (opzionale).
destStorageName string query Nome dello storage di destinazione (opzionale).

Risposte HTTP

Codice Descrizione
200 Cartella spostata correttamente.
400 Richiesta non valida – parametri non validi.
401 Non autorizzato – token JWT mancante o non valido.
404 Cartella sorgente non trovata.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di spostamento cartella

Nota: Lo spostamento di una cartella ne conserva la struttura interna e le versioni dei file.

Come verificare se lo storage esiste

Informazioni sull’API per la verifica dell’esistenza dello storage

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
storageName string path Nome dello storage da verificare.

Risposte HTTP

Codice Descrizione
200 Viene restituita l’esistenza dello storage (true o false).
401 Non autorizzato – token JWT mancante o non valido.
404 Storage non trovato.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di verifica dell’esistenza dello storage

Come verificare se un file o una cartella esiste

Informazioni sull’API per la verifica dell’esistenza di oggetti

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
path string path Percorso del file o della cartella (es. /file.xlsx o /cartella).
storageName string query Nome dello storage da verificare.
versionId string query Identificatore della versione del file (opzionale).

Risposte HTTP

Codice Descrizione
200 Vengono restituite informazioni sull’esistenza.
401 Non autorizzato – token JWT mancante o non valido.
404 File o cartella non trovato.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di verifica dell’esistenza di un oggetto

Come ottenere l’utilizzo dello spazio disco

Informazioni sull’API per l’utilizzo dello spazio disco

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
storageName string query Nome dello storage da interrogare.

Risposte HTTP

Codice Descrizione
200 Vengono restituite informazioni sull’utilizzo dello spazio disco.
401 Non autorizzato – token JWT mancante o non valido.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di utilizzo dello spazio disco

Come ottenere le versioni di un file

Informazioni sull’API per le versioni di un file

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

I parametri della richiesta sono i seguenti:

Nome parametro Tipo Posizione Descrizione
path string path Percorso del file (es. /file.xlsx).
storageName string query Nome dello storage da interrogare.

Risposte HTTP

Codice Descrizione
200 Viene restituito l’elenco delle versioni del file.
401 Non autorizzato – token JWT mancante o non valido.
404 File non trovato.
500 Errore interno del server.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile, che consente interazioni REST direttamente da un browser web.

Esempio di versioni di un file