Qu’est-ce que l’API Files ?

L'API Files est une API HTTP standard qui vous permet de lire, écrire, répertorier et supprimer des fichiers et des répertoires en faisant référence à leur URI. L'API facilite et optimise le travail avec le contenu des fichiers sous forme d'octets bruts.

L’API prend en charge les volumes du Unity Catalog, où vous spécifiez les fichiers et répertoires à utiliser en utilisant leur chemin d’URI de volume, qui suit le format /Volumes/<catalog_name>/<schema_name>/<volume_name>/<path_to_file>. Le chemin est toujours absolu.

L'API Files possède deux Endpoint distincts : un pour travailler avec les fichiers (/fs/files) et un autre pour travailler avec les répertoires (/fs/directories). Les deux Endpoint utilisent les méthodes HTTP standard GET, HEAD, PUT, DELETE et POST pour gérer les fichiers et les répertoires spécifiés par leur chemin URI. Pour chaque opération et ses parameter, consultez la référence de l’API Files 3.0.

L'utilisation de l'API Files peut entraîner des frais de transfert de données Databricks.

Capacités

Avec l’API Files, vous pouvez :

• upload un fichier jusqu’à 5000 Mio en une seule demande, ou importez un fichier plus volumineux en plusieurs parties avec l’ multi-partie upload.
• download un fichier entier en une seule requête, ou download une partie avec l'en-tête Range. Voir download de gros fichiers avec des requêtes de plage.
• Faites en sorte qu’une lecture, une écriture ou une suppression dépende de l’heure ETag ou Last-Modified actuelle d’un fichier avec des requêtes conditionnelles.

Conditions requises

• Envoyez des requêtes vers le hostname régional de votre workspace. Voir Utiliser l'API Files avec le hostname régional.
• Connectivité réseau vers Databricks et vers votre stockage. Voir Connectivité réseau pour l’API Files.

Versions

L’API Files est disponible en deux versions. Pour savoir ce qui a changé entre elles, consultez Versions de l’API Files.