Versions de l'API Files

L'API Files possède deux versions, 2.0 et 3.0. Pour la Files API 2.0, voir la documentation de la Files API 2.0. Pour l'API Files 3.0, consultez la référence de l'API Files 3.0.

Hostname et préfixe d'endpoint

Les deux versions envoient des requêtes à des Hostname différents avec des préfixes d'Endpoint différents :

Version	Hostname	Préfixe de l'endpoint
Files API 2.0	Le hostname de votre workspace	/api/2.0/fs
Files API 3.0	Hostname régional de votre workspace	/api/3.0/fs

Version	Hostname	Préfixe de l'endpoint
Files API 2.0	Le hostname de votre workspace	/api/2.0/fs
Files API 3.0	Hostname régional de votre workspace	/api/3.0/fs

Pour construire le hostname régional pour votre workspace, voir Utiliser l’API Files avec le hostname régional.

Configuration réseau

Files API 3.0 impose des exigences réseau supplémentaires, à la fois de votre réseau vers Databricks et de Databricks vers votre stockage. Voir Connectivité réseau pour la Files API.

Nouvelles fonctionnalités dans la version 3.0

L'API Files 3.0 ajoute les fonctionnalités suivantes :

• upload en plusieurs parties : upload un fichier de plus de 5000 Mo, ou un fichier dont la taille est inconnue au démarrage du upload, en plusieurs parties. Consultez upload des fichiers volumineux avec le upload en plusieurs parties.
• Demandes conditionnelles : l’API File 2.0 prend en charge If-Unmodified-Since sur les download uniquement. L’API File 3.0 ajoute If-Match, If-None-Match et If-Modified-Since, et permet aux écritures et aux suppressions de dépendre du ETag d’un fichier. Voir Utiliser des demandes conditionnelles.

Changements de comportement dans la version 3.0

Si vous déplacez du code de Files API 2.0 vers 3.0, notez les modifications suivantes :

• Les upload nécessitent l'en-tête de demande Content-Length. Si vous ne connaissez pas la taille totale du fichier à l'avance, utilisez le upload en plusieurs parties.
• DELETE est idempotent. La suppression d'un fichier qui n'existe pas renvoie 204 No Content. Pour obtenir un 404 pour un fichier qui n'existe pas, comme dans l'API Files 2.0, envoyez If-Match: *. Voir Suppressions conditionnelles.
• Un upload réussie (PUT) renvoie 200 OK au lieu de 204 No Content.