Versões da API de arquivos
A API de arquivos tem duas versões, 2.0 e 3.0. Para a Files API 2.0, consulte a referência da Files API 2.0. Para a Files API 3.0, consulte a referência da Files API 3.0.
Hostname e prefixo do endpoint
As duas versões enviam solicitações para diferentes hostnames com diferentes prefixos de endpoint:
Versão | Hostname | Prefixo do endpoint |
|---|---|---|
API Files 2.0 | O hostname do seu workspace |
|
API de Arquivos 3.0 | O hostname regional do seu workspace |
|
Para criar o hostname regional para o seu workspace, consulte Usar a API de arquivos com o hostname regional.
Requisitos de rede
A API Files 3.0 tem requisitos de rede adicionais, tanto da sua rede para o Databricks quanto do Databricks para o seu armazenamento. Consulte Conectividade de rede para a API Files.
Novos recursos no 3.0
A Files API 3.0 adiciona os seguintes recursos:
- Upload multipart : faça upload de um arquivo maior que 5000 MiB ou de um arquivo cujo tamanho seja desconhecido quando o upload começa, em partes. Veja Fazer upload de arquivos grandes com multipart upload.
- Solicitações condicionais : A API Files 2.0 suporta
If-Unmodified-Sincesomente em downloads. A API Files 3.0 adicionaIf-Match,If-None-MatcheIf-Modified-Sincee permite que escritas e exclusões dependam doETagde um arquivo. Consulte Usar solicitações condicionais.
Mudanças de comportamento no 3.0
Se você mover o código da API de arquivos 2.0 para 3.0, observe as seguintes alterações:
- Uploads exigem o cabeçalho de solicitação
Content-Length. Se você não souber o tamanho total do arquivo com antecedência, use upload multipart. DELETEé idempotente. Excluir um arquivo que não existe retorna204 No Content. Para obter404de um arquivo que não existe, como na API de Arquivos 2.0, envieIf-Match: *. Veja Exclusões condicionais.- Um upload bem-sucedido (
PUT) retorna200 OKem vez de204 No Content.