URL から範囲を入力する
Put Range From URL 操作では、URL から内容が読み取られるファイルの一部としてコミットされる新しい範囲が作成されます。 この操作は、SMB プロトコルが有効なファイル共有ではバージョン 2019-02-02 以降でサポートされ、NFS プロトコルが有効なファイル共有ではバージョン 2025-05-05 以降でサポートされています。
プロトコルの可用性
| 有効なファイル共有プロトコル | 利用できる |
|---|---|
| SMB |
|
| NFS |
|
依頼
Put Range From URL 要求は次のように構成されます。 HTTPS を使用することをお勧めします。
| 方式 | 要求 URI | HTTP バージョン |
|---|---|---|
| 置く | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=range |
HTTP/1.1 |
次のように、要求 URI に表示されているパス コンポーネントを独自のコンポーネントに置き換えます。
| パス コンポーネント | 形容 |
|---|---|
myaccount |
ストレージ アカウントの名前。 |
myshare |
ファイル共有の名前。 |
mydirectorypath |
随意。 親ディレクトリへのパス。 |
myfile |
ファイルの名前。 |
パスの名前付けの制限については、「名前と参照共有、ディレクトリ、ファイル、およびメタデータのを参照してください。
URI パラメーター
| パラメーター | 形容 |
|---|---|
timeout |
随意。
timeout パラメーターは秒単位で表されます。 詳細については、「Azure Files 操作のタイムアウトを設定する」を参照してください。 |
要求ヘッダー
必須および省略可能な要求ヘッダーについては、次の表で説明します。
一般的な要求ヘッダー
| 要求ヘッダー | 形容 |
|---|---|
Authorization |
必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storage への要求を承認する」を参照してください。 |
Date または x-ms-date |
必須。 要求の世界協定時刻 (UTC) を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。 |
x-ms-version |
すべての承認された要求に必要です。 この要求に使用する操作のバージョンを指定します。 この操作は、SMB プロトコルが有効なファイル共有ではバージョン 2019-02-02 以降でサポートされ、NFS プロトコルが有効なファイル共有ではバージョン 2025-05-05 以降でサポートされています。 詳細については、Azure Storage サービス のバージョン管理のに関するページを参照してください。 |
x-ms-copy-source:name |
必須。 ソース ファイルの URL を指定します。 値には、ファイルを指定する最大 2 KiB の長さの URL を指定できます。 値は、要求 URI に表示されるように URL エンコードする必要があります。 ソース ファイルはパブリックであるか、Shared Access Signature を使用して承認されている必要があります。 ソース ファイルがパブリックの場合、操作を実行するための承認は必要ありません。 ソース オブジェクト URL の例を次に示します。
|
x-ms-copy-source-authorization: <scheme> <signature> |
随意。 コピー ソースの承認スキームと署名を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。 Microsoft Entra では、スキーム ベアラーのみがサポートされています。 このヘッダーは、バージョン 2020-10-02 以降でサポートされています。 |
x-ms-write: { update } |
必須。
updateのみを指定する必要があります。
clearで呼び出された場合、要求は失敗します。
update 値は、要求本文で指定されたバイトを指定された範囲に書き込みます。 |
Range または x-ms-range |
必須。
Range または x-ms-range が必要です。書き込むバイトの範囲を指定します。 範囲の開始と終了の両方を指定する必要があります。 このヘッダーは、HTTP/1.1 プロトコル仕様によって定義されます。 更新操作の場合、範囲のサイズは最大 4 MiB です。 Azure Files では、 Range ヘッダーと x-ms-range ヘッダーの 1 バイト範囲のみを受け入れ、バイト範囲は次の形式で指定する必要があります: bytes=startByte-endByte。Range と x-ms-range の両方が指定されている場合、サービスは x-ms-rangeの値を使用します。 詳細については、「Azure Files 操作の範囲ヘッダーを指定する」を参照してください。 |
x-ms-source-range |
必須。 ソースから読み取るバイトの範囲を指定します。 範囲の開始と終了の両方を指定する必要があります。 Azure Files では、 Range ヘッダーと x-ms-range ヘッダーの 1 バイト範囲のみを受け入れ、バイト範囲は次の形式で指定する必要があります: bytes=startByte-endByte。ソース範囲のサイズは最大 4 MiB です。 ソース範囲のサイズが 4 MiB を超える場合、Azure Files は状態コード 413 (要求エンティティが大きすぎる) を返します。 ソース範囲のサイズが範囲 (ターゲット範囲) のサイズと一致しない場合、サービスは状態コード 400 (無効な要求) を返します。 |
Content-Length |
必須。 要求本文で送信されるバイト数を指定します。 このヘッダーの値は 0に設定する必要があります。 長さが 0されていない場合、操作は状態コード 400 (無効な要求) で失敗します。 |
x-ms-client-request-id |
随意。 ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を持つクライアント生成の不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティと、サーバーが受信する要求を関連付けすることを強くお勧めします。 詳細については、「Monitor Azure Files」を参照してください。 |
x-ms-source-content-crc64 |
随意。 URI から指定された範囲の CRC64 ハッシュ。 このハッシュは、URI からのデータの転送中に範囲の整合性を検証するために使用されます。 このヘッダーを指定すると、Azure Files はコピー ソースから到着したコンテンツのハッシュをこのヘッダー値と比較します。 注: この CRC64 ハッシュはファイルと共に格納されません。 2 つのハッシュが一致しない場合、操作はエラー コード 400 (無効な要求) で失敗します。 |
x-ms-source-if-match-crc64 |
随意。 CRC64 チェックサム値。 ソースから読み取られた特定の範囲のチェックサムが指定されたチェックサムと一致する場合にのみ、このヘッダーを指定して操作を実行します。 指定された条件が満たされていない場合、Azure Files は状態コード 412 (前提条件に失敗) を返します。 |
x-ms-source-if-none-match-crc64 |
随意。 CRC64 チェックサム値。 ソースから読み取られた特定の範囲のチェックサムが指定されたチェックサムと異なる場合にのみ、このヘッダーを指定して操作を実行します。 指定された条件が満たされていない場合、Azure Files は状態コード 412 (前提条件に失敗) を返します。 |
x-ms-lease-id: <ID> |
ファイルにアクティブなリースがある場合に必要です。 バージョン 2019-02-02 以降で使用できます。 このヘッダーは、ファイルが NFS プロトコルが有効になっているファイル共有上にあり、ファイル リースをサポートしていない場合は無視されます。 |
x-ms-client-request-id |
随意。 Azure Storage Analytics ログが有効になっているときに分析ログに記録される、1 kibibyte (KiB) 文字制限を持つクライアント生成の不透明な値を提供します。 サーバーが受信した要求とクライアント側のアクティビティを関連付ける場合は、このヘッダーを使用することを強くお勧めします。 詳細については、「Blob Storageの監視」を参照してください。 |
x-ms-file-last-write-time: { now ¦ preserve } |
随意。 バージョン 2021-06-08 以降。 次のいずれかのオプションを指定できます。
|
x-ms-file-request-intent |
ヘッダー Authorization OAuth トークンを指定する場合は必須です。 許容される値は backupです。 このヘッダーは、Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action または Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action が、Authorization ヘッダーを使用して承認された ID に割り当てられた RBAC ポリシーに含まれている場合に付与されるように指定します。 バージョン 2022-11-02 以降で使用できます。 |
x-ms-allow-trailing-dot: { <Boolean> } |
随意。 バージョン 2022-11-02 以降。 ブール値は、要求 URL に存在する末尾のドットをトリミングするかどうかを指定します。 ターゲットが NFS プロトコルが有効なファイル共有上にある場合、このヘッダーは無視され、既定では末尾のドットがサポートされます。 詳細については、「共有、ディレクトリ、ファイル、およびメタデータの名前付けと参照」を参照してください。 |
x-ms-source-allow-trailing-dot: { <Boolean> } |
随意。 バージョン 2022-11-02 以降。 ブール値は、ソース URL に存在する末尾のドットをトリミングするかどうかを指定します。 このヘッダーは、コピー ソースが Azure ファイル共有にある場合にのみ指定する必要があります。 このヘッダーは、他のコピー ソースの種類ではサポートされていません。 コピー ソースが NFS プロトコルが有効なファイル共有上にある場合、このヘッダーは無視されます。既定では末尾のドットがサポートされます。 詳細については、「共有、ディレクトリ、ファイル、およびメタデータの名前付けと参照」を参照してください。 |
SMB のみの要求ヘッダー
何一つ。
NFS 要求ヘッダーのみ
何一つ。
要求本文
要求本文がありません。
要求のサンプル
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/mydir/myfile?comp=range HTTP/1.1
Request Headers:
x-ms-page-write: update
x-ms-copy-source: http://myaccount2.file.core.windows.net/myshare2/mydirectory2/myfile2?sv=2018-11-09&sp=r&sr=s&se=2018-08-22T09%3A59%3A28.2185790Z&sig=Qn6QEET3Gn%2FhCEVcXuwG7ssatIYiYRM5pNIy4Q3N0cQ%3D
x-ms-date: Fri, 22 Aug 2018 01:15:50 GMT
x-ms-version: 2019-02-02
x-ms-range: bytes=100-1023
x-ms-source-range: bytes=200-1123
x-ms-source-content-crc64: 3bedb8b3730fc205
Authorization: SharedKey myaccount:4KdWDiTdA9HmIF9+WF/8WfYOpUrFhieGIT7f0av+GEI=
Content-Length: 0
応答
応答には、HTTP 状態コードと一連の応答ヘッダーが含まれます。
状態コード
操作が成功すると、状態コード 201 (Created) が返されます。 状態コードの詳細については、「状態コードとエラー コードを参照してください。
応答ヘッダー
この操作の応答には、次の表のヘッダーが含まれています。 応答には、追加の標準 HTTP ヘッダーも含まれる場合があります。 すべての標準ヘッダーは、HTTP/1.1 プロトコル仕様に準拠しています。
一般的な応答ヘッダー
| 応答ヘッダー | 形容 |
|---|---|
ETag |
条件付きで操作を実行するために使用できる値が含まれています。 値は引用符で囲まれています。 |
Last-Modified |
ファイルが最後に変更された日時。 日付形式は RFC 1123 に従います。 詳細については、「ヘッダーの日付/時刻値の表現」を参照してください。 ファイルに対する書き込み操作 (ファイルのメタデータまたはプロパティの更新を含む) は、ファイルの最終変更時刻を変更します。 |
x-ms-request-id |
作成された要求を一意に識別し、それを使用して要求のトラブルシューティングを行うことができます。 詳細については、「API 操作のトラブルシューティング」を参照してください。 |
x-ms-version |
要求の実行に使用された FileREST API バージョンを示します。 |
Date |
サービスによって生成される UTC 日付/時刻値。応答が開始された時刻を示します。 |
x-ms-content-crc64 |
クライアントがメッセージ コンテンツの整合性を確認できるように返されます。 このヘッダーの値は、Azure Files によって計算されます。 要求ヘッダーで指定されている値と必ずしも同じではありません。 |
x-ms-client-request-id |
要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、1,024 文字以下の ASCII 文字が含まれている場合、x-ms-client-request-id ヘッダーの値と同じです。
x-ms-client-request-id ヘッダーが要求に存在しない場合、応答には存在しません。 |
x-ms-file-last-write-time |
バージョン 2021-06-08 以降。 ISO 8601 形式のファイルの最後の書き込み時刻 (たとえば、2017-05-10T17:52:33.9551861Z)。 |
SMB のみの応答ヘッダー
何一つ。
NFS のみの応答ヘッダー
何一つ。
応答本文
何一つ。
応答のサンプル
Response Status:
HTTP/1.1 201 Created
Response Headers:
Date: Sun, 22 Aug 2020 01:33:35 GMT
ETag: "0x8CB171BA9E94B0B"
Last-Modified: Wed, 22 Aug 2020 01:13:31 GMT
x-ms-version: 2019-02-02
x-ms-content-crc64: 3bedb8b3730fc205
Content-Length: 0
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
認可
アカウント所有者のみがこの操作を呼び出すことができます。
備考
Put Range From URL 操作は、一連のデータをファイルに書き込みます。これは、Put Range 操作と同様の動作です。 指定したソースに対する Get File 操作を使用して、ソース ファイルのデータ、メタデータ、およびその他のプロパティを読み取ります。 バージョン 2020-10-02 以降では、コピー操作のソースに対して Microsoft Entra 承認がサポートされています。
Put Range From URL 操作は、指定した範囲がファイルに書き込まれた場合にのみ、成功 201 (Created) を返します。
関連項目
ファイル に対する 操作