Strumenti per i file
Scrivi e leggi file e conosci gli effetti del caricamento di un archivio.
In questa pagina
Scrivi file nella bozza, carica un archivio o leggi file esistenti.
Nota
Il collegamento vale per lo Space. Ne sei membro e lo Space non è bloccato.
Per tutti e cinque gli strumenti occorre Proprietario, Amministratore o Utente, anche per leggere file.
Attenzione
Una nuova bozza inizia vuota e non contiene una copia della versione pubblicata. hosting_deploy pubblica soltanto il suo contenuto; occorre un file index.html nella cartella principale.
Nessuno strumento di questa pagina richiede una frase di conferma; è l’applicazione a decidere se chiederti prima il consenso.
Che relazione c’è tra bozza, app e registro?
Un progetto ha al massimo una bozza. L’interfaccia dell’app scrive nella stessa bozza degli strumenti. Il registro del progetto annota l’apertura di una nuova bozza; non annota la scrittura e l’eliminazione dei file.
hosting_put_files Write files
modifica datielimina, sovrascrive o modifica ciò che è visibile
Scrive nella bozza esistente o in una nuova. I percorsi uguali vengono sovrascritti; i file non indicati restano.
Una chiamata consente 200 file e 3 MB. Percorsi non validi fanno rifiutare l’intera chiamata; se le pubblicazioni sono esaurite o lo spazio di archiviazione è pieno, non viene creato nulla.
| Parametro | Tipo | Indicazione | Descrizione |
|---|---|---|---|
space | Numero intero | obbligatorio | L’ID dello Space di dieci cifre. |
project | Numero intero | obbligatorio | Il numero del progetto ottenuto da hosting_list_projects. |
files | Elenco di oggetti | obbligatorio | Da 1 a 200 oggetti con path e content. I percorsi rispettano le regole per i percorsi; encoding è facoltativo: utf8 (predefinito) oppure base64 per i file binari. |
hosting_create_upload Create upload link
modifica datielimina, sovrascrive o modifica ciò che è visibile
Restituisce un indirizzo per caricare un archivio ZIP, TAR o TAR.GZ tramite HTTP PUT.
Attenzione
Il caricamento sostituisce l’intera bozza con i file dell’archivio. Se l’archivio non viene elaborato correttamente, il contenuto precedente resta.
- La chiamata apre una bozza se necessario e sostituisce un precedente indirizzo di caricamento. Dopo il caricamento la bozza resta aperta finché non la pubblichi.
- L’indirizzo vale una sola volta e per 15 minuti.
expires_atindica la scadenza,max_bytesla dimensione consentita; al massimo 200 MB. - Se il piano non consente un’altra pubblicazione o lo spazio di archiviazione è pieno, TEISENDA rifiuta la chiamata e non crea nulla.
| Parametro | Tipo | Indicazione | Descrizione |
|---|---|---|---|
space | Numero intero | obbligatorio | L’ID dello Space di dieci cifre. |
project | Numero intero | obbligatorio | Il numero del progetto ottenuto da hosting_list_projects. |
hosting_delete_files Delete files
modifica datielimina, sovrascrive o modifica ciò che è visibile
Elimina dalla bozza fino a 200 percorsi di file. Le versioni finalizzate restano invariate.
Con un percorso non valido la chiamata si interrompe; i file indicati prima possono essere già stati eliminati.
| Parametro | Tipo | Indicazione | Descrizione |
|---|---|---|---|
space | Numero intero | obbligatorio | L’ID dello Space di dieci cifre. |
project | Numero intero | obbligatorio | Il numero del progetto ottenuto da hosting_list_projects. |
paths | Elenco di testi | obbligatorio | Un elenco da 1 a 200 percorsi: i file che lo strumento elimina dalla bozza. Valgono le regole per i percorsi. |
hosting_list_files List files
legge soltanto
Elenca i file di una versione in ordine di percorso.
La risposta contiene al massimo 100 file; continua con next_offset.
| Parametro | Tipo | Indicazione | Descrizione |
|---|---|---|---|
space | Numero intero | obbligatorio | L’ID dello Space di dieci cifre. |
project | Numero intero | obbligatorio | Il numero del progetto ottenuto da hosting_list_projects. |
deploy | Numero intero | facoltativo | Il numero di una versione di questo progetto. Se manca, lo strumento usa la bozza, altrimenti la versione pubblicata. |
offset | Numero intero | facoltativo | Quanti file lo strumento salta. Il valore predefinito è 0; continua con next_offset della risposta precedente. |
limit | Numero intero | facoltativo | Il numero massimo di file nella risposta. Valore predefinito e massimo: 100. |
hosting_read_file Read file
legge soltanto
Legge il contenuto di un file.
- File fino a 200 KB, al massimo 40.000 caratteri per chiamata. Continua con
next_offset. - I contenuti dei file sono contrassegnati come dati; l’applicazione non dovrebbe seguire le istruzioni che contengono.
| Parametro | Tipo | Indicazione | Descrizione |
|---|---|---|---|
space | Numero intero | obbligatorio | L’ID dello Space di dieci cifre. |
project | Numero intero | obbligatorio | Il numero del progetto ottenuto da hosting_list_projects. |
path | Testo | obbligatorio | Il percorso del file, al massimo 240 caratteri; valgono le regole per i percorsi. hosting_list_files mostra i percorsi di una versione. |
deploy | Numero intero | facoltativo | Il numero di una versione di questo progetto. Se manca, lo strumento usa la bozza, altrimenti la versione pubblicata. |
offset | Numero intero | facoltativo | Dove inizia la lettura, in caratteri. Il valore predefinito è 0; continua con next_offset della risposta precedente. |
length | Numero intero | facoltativo | Il numero massimo di caratteri nella risposta. Valore predefinito e massimo: 40.000. |
Regole per i percorsi
Queste regole valgono per hosting_put_files, hosting_delete_files e hosting_read_file:
- Il percorso è relativo e usa barre oblique. Non contiene barre rovesciate né caratteri di controllo.
- Ha al massimo 240 caratteri e 12 livelli.
- Ogni nome al suo interno ha al massimo 100 caratteri e nessuno spazio bianco all’inizio o alla fine.
- Nessun nome inizia con un punto. Fa eccezione la cartella
.well-knownnella cartella principale.
In un archivio TEISENDA salta le voci che violano queste regole.
Controlla i limiti dei file e del piano
Valgono i limiti dei file del Connector e i limiti del piano. Lo spazio di archiviazione comprende tutte le versioni, bozze e copie di sicurezza; le versioni eliminate non contano più.
Una versione troppo grande viene scartata durante la finalizzazione; le versioni precedenti restano. I pacchetti di spazio di archiviazione sono disponibili con un abbonamento Max acquistato.
Se qualcosa non funziona
Quando una soluzione indica uno strumento, chiedi all’applicazione di chiamarlo. Se un messaggio rimanda a Piani, segui il percorso per il piano nelle impostazioni dello Space.
Il piano di questo Space consente … deployment, … sono già utilizzati. Non è stato caricato nulla e non è stata creata alcuna versione. Il piano di questo Space è indicato in TEISENDA, in Impostazioni › Piani.
Il piano dello Space non consente un’altra pubblicazione; con Free sono tre in totale. TEISENDA rifiuta hosting_put_files e hosting_create_upload, non carica nulla e non crea nulla. Ripubblicare una versione già pubblicata non consuma una pubblicazione e resta possibile: con hosting_rollback oppure con hosting_deploy e il suo numero. Max consente altre pubblicazioni; vedi Piani Free e Max.
La capacità di archiviazione di questo Space è esaurita: … di … in uso. Non è stato caricato nulla e non è stata creata alcuna versione. Elimina prima versioni o backup. Il piano di questo Space è indicato in TEISENDA, in Impostazioni › Piani.
Lo spazio di archiviazione dello Space è pieno, anche considerando quello che una nuova versione libererebbe. TEISENDA rifiuta hosting_put_files, hosting_create_upload e hosting_deploy. Elimina versioni o copie di sicurezza in TEISENDA. Max e i suoi pacchetti offrono più spazio; vedi Piani Free e Max e Acquistare e disdire pacchetti.
L'argomento … manca o non ha la forma prevista.
Un argomento manca o non ha la forma prevista; il messaggio lo indica. Lo stesso messaggio appare con:
- più di 200 file per
hosting_put_files(argomentofiles), - più di 200 percorsi per
hosting_delete_files(argomentopaths), - un percorso di oltre 240 caratteri per
hosting_read_file(argomentopath), - un elenco vuoto.
Richiama lo strumento con l’argomento nella forma indicata dalla sua descrizione.
Non c'è nessuna versione aperta. Carica prima dei file con hosting_put_files.
Il progetto non ha una bozza da cui hosting_delete_files possa eliminare file. Scrivi prima file con hosting_put_files.
La versione … non esiste in questo progetto.
Il progetto non ha una versione con il numero indicato dall’argomento deploy. Controlla le versioni del progetto con hosting_list_deploys.
Un percorso non è consentito. I percorsi sono relativi, usano / e non iniziano con un punto.
Un percorso di file viola le regole per i percorsi. In questo caso hosting_put_files non ha scritto nulla. hosting_delete_files ha già eliminato i file indicati prima del percorso rifiutato. Correggi il percorso e richiama lo strumento; dopo hosting_delete_files controlla con hosting_list_files cosa resta.
È troppo per una sola chiamata. Suddividi i file in più chiamate.
Una chiamata a hosting_put_files contiene più di 3 MB di file. Distribuisci i file su più chiamate oppure carica un archivio tramite hosting_create_upload.
Il file è troppo grande per essere letto qui.
Il file è più grande di 200 KB. Un file del genere non può essere letto tramite il Connector.
Un file è troppo grande.
Un singolo file è più grande di 25 MB. Riduci la dimensione del file.
La versione nel suo insieme è troppo grande.
La versione supera complessivamente 300 MB. Riduci la dimensione del sito.
La versione contiene troppi file.
La versione contiene più di 5.000 file. Riduci il numero di file.
Il progetto ha raggiunto il numero massimo di deployment. Elimina prima uno più vecchio in TEISENDA.
Il nodo di hosting non apre un’altra versione perché conserva già 20 versioni di questo progetto, comprese quelle eliminate in TEISENDA ma non ancora rimosse dal nodo. Se hai appena eliminato versioni, attendi qualche minuto e riprova. Altrimenti elimina una versione precedente nell’app, nell’elenco delle versioni sulla pagina del progetto. Nessuno strumento del Connector elimina direttamente una singola versione.
Il progetto è offline.
Il progetto è offline. Il nodo di hosting non restituisce quindi un indirizzo di caricamento. Lo stesso messaggio appare per ogni progetto di uno Space sospeso da TEISENDA dopo la fine di un abbonamento, anche se l’interruttore del progetto non è impostato su offline; vedi Gli strumenti continuano a funzionare in uno Space sospeso. Se l’interruttore del progetto è su offline, riportalo online con hosting_set_offline. Questo non risolve la sospensione dello Space.
Il progetto non è ancora stato trasferito al nodo di hosting.
TEISENDA non ha ancora trasmesso il progetto al nodo di hosting e non può quindi ricevere file. Controlla con hosting_project_status e riprova quando il nodo ha ricevuto le impostazioni.
Il nodo di hosting l'ha rifiutato.
Il nodo di hosting ha rifiutato qualcosa per cui TEISENDA non ha un messaggio specifico. Così hosting_deploy_status e hosting_list_deploys mostrano anche il problema di una versione dopo un archivio inutilizzabile. In quel caso richiama hosting_create_upload: la chiamata usa la stessa versione e restituisce un nuovo indirizzo. Altrimenti controlla lo stato con hosting_project_status; se il problema persiste, contatta il supporto.
Questo file non esiste nella versione.
La versione non contiene un file con il percorso che hosting_read_file deve leggere. Controlla i percorsi con hosting_list_files.
L'offset … è oltre la fine dell'elenco (file nella versione: …).
L’offset per hosting_list_files si trova oltre la fine dell’elenco. Ricomincia da offset 0 oppure continua con next_offset della risposta precedente.
L'offset … è oltre la fine del file (caratteri nel file: …).
L’offset per hosting_read_file si trova oltre la fine del file. Ricomincia da offset 0 oppure continua con next_offset della risposta precedente.
I messaggi su Space e numero del progetto sono descritti negli strumenti per Spaces e progetti. Tutti gli altri che possono apparire con qualsiasi strumento sono in Risolvere i problemi del Connector.