ファイルAPIバージョン
Files API には、2.0 と 3.0 の 2 つのバージョンがあります。Files API 2.0 については、Files API 2.0 リファレンスを参照してください。Files API 3.0 については、Files API 3.0 リファレンスを参照してください。
ホスト名とEndpointのプレフィックス
2つのバージョンは、異なるEndpointプレフィックスを持つ異なるホスト名に要求を送信します：
バージョン | ホスト名 | Endpointプレフィックス |
|---|---|---|
Files API 2.0 | ワークスペースのホスト名 |
|
ファイルAPI 3.0 | ワークスペースのリージョンホスト名 |
|
ワークスペースのリージョン ホスト名を構築するには、 「リージョン ホスト名での Files API の使用」を参照してください。
ネットワークの要件
Files API 3.0には、ネットワークからDatabricksへの接続と、Databricksからストレージへの接続の両方で、追加のネットワーク要件があります。「Files APIのネットワーク接続」を参照してください。
3.0 の新機能
Files API 3.0 では、次の機能が追加されています。
- マルチパートupload : 5000 MiBを超えるファイル、またはupload起動時にサイズが不明なファイルをパートごとにuploadします。「Upload large files with multipart upload」を参照してください。
- 条件付きリクエスト : Files API 2.0はdownloadのみ
If-Unmodified-Sinceをサポートします。Files API 3.0ではIf-Match、If-None-Match、If-Modified-Sinceが追加され、書き込みと削除がファイルのETagに依存するようになります。「条件付きリクエストの使用」を参照してください。
3.0の挙動の変更
コードをFiles API 2.0から3.0に移行する場合は、次の変更に注意してください。
- uploadには
Content-Length要求ヘッダーが必要です。ファイル合計サイズが事前にわからない場合は、マルチパートuploadを使用してください。 DELETEはべき等です。存在しないファイルを削除すると、204 No Contentが返されます。Files API 2.0のように存在しないファイルの404を取得するには、If-Match: *を送信します。条件付き削除を参照してください。- uploadが成功 (
PUT) すると、204 No Contentではなく200 OKが返されます。