Versioni dell’API Files

L'API Files ha due versioni, 2.0 e 3.0. Per Files API 2.0, vedi il riferimento Files API 2.0. Per Files API 3.0, consulta il riferimento Files API 3.0.

Nome host e prefisso dell'endpoint

Le due versioni inviano richieste a nomi host diversi con prefissi endpoint differenti:

Versione	Hostname	Prefisso endpoint
API dei file 2.0	Nome host del tuo spazio di lavoro	/api/2.0/fs
Files API 3.0	Il nome host regionale del tuo spazio di lavoro	/api/3.0/fs

Per costruire il nome host regionale per il tuo workspace, vedi Usa la Files API con il nome host regionale.

Requisiti di rete

Files API 3.0 ha requisiti di rete aggiuntivi, sia dalla tua rete verso Azure Databricks sia da Azure Databricks verso lo storage. Vedi connettività di rete per Files API.

Nuove funzionalità della versione 3.0

Files API 3.0 aggiunge le seguenti funzionalità:

• Caricamento multiparte: carica in parti un file superiore a 5000 MiB, o un file la cui dimensione è sconosciuta all'inizio del caricamento. Vedi Caricare file di grandi dimensioni con upload multipart.
• Richieste condizionate: API dei file 2.0 supporta If-Unmodified-Since solo per i download. API dei file 3.0 aggiunge If-Match, If-None-Match e If-Modified-Since e lascia che scritture e cancellazioni dipendano dal file ETag. Vedi Usa richieste condizionali.

Cambiamenti comportamentali nella 3.0

Se sposti codice da Files API 2.0 a 3.0, nota le seguenti modifiche:

• I caricamenti richiedono l'intestazione della richiesta Content-Length. Se non conosci in anticipo la dimensione totale del file, usa il caricamento multiparte.
• DELETE è idempotente. Eliminando un file che non esiste restituisce 204 No Content. Per ottenere un 404 per un file che non esiste, come in Files API 2.0, invia If-Match: *. Vedi Cancellazioni condizionali.
• Un upload riuscito (PUT) restituisce 200 OK invece di 204 No Content.