ファイルのコピー
Copy File 操作では、ストレージ アカウント内のコピー先ファイルに BLOB またはファイルがコピーされます。 この操作は、SMB プロトコルが有効なファイル共有ではバージョン 2015-02-21 以降でサポートされ、NFS プロトコルが有効なファイル共有ではバージョン 2025-05-05 以降でサポートされています。
プロトコルの可用性
| 有効なファイル共有プロトコル | 利用できる |
|---|---|
| SMB |
|
| NFS |
|
依頼
Copy File 要求は次のように構成されます。 HTTPS を使用することをお勧めします。
バージョン 2013-08-15 以降では、コピー先ファイルがソース ファイルと同じアカウントにある場合は、共有アクセス署名を指定できます。 バージョン 2015-04-05 以降では、コピー先ファイルが別のストレージ アカウントにある場合は、共有アクセス署名を指定することもできます。
| 方式 | 要求 URI | HTTP バージョン |
|---|---|---|
| 置く | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
HTTP/1.1 |
次のように、要求 URI に表示されているパス コンポーネントを独自のコンポーネントに置き換えます。
| パス コンポーネント | 形容 |
|---|---|
myaccount |
ストレージ アカウントの名前。 |
myshare |
ファイル共有の名前。 |
mydirectorypath |
随意。 親ディレクトリへのパス。 |
myfile |
ファイルの名前。 |
パスの名前付け制限の詳細については、「共有、ディレクトリ、ファイル、およびメタデータの名前付けと参照」を参照してください。
URI パラメーター
要求 URI には、次の追加パラメーターを指定できます。
| パラメーター | 形容 |
|---|---|
timeout |
随意。
timeout パラメーターは秒単位で表されます。 詳細については、「Azure Files 操作のタイムアウトを設定する」を参照してください。 |
要求ヘッダー
必須および省略可能な要求ヘッダーについては、次の表で説明します。
一般的な要求ヘッダー
| 要求ヘッダー | 形容 |
|---|---|
Authorization |
必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。 |
Date または x-ms-date |
必須。 要求の世界協定時刻 (UTC) を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。 |
x-ms-version |
すべての承認された要求に必要です。 この要求に使用する操作のバージョンを指定します。 この操作は、SMB プロトコルが有効なファイル共有ではバージョン 2015-02-21 以降でサポートされ、NFS プロトコルが有効なファイル共有ではバージョン 2025-05-05 以降でサポートされています。 詳細については、Azure Storage サービス のバージョン管理のに関するページを参照してください。 |
x-ms-meta-name:value |
随意。 ファイルに関連付けられている名前と値のペアをメタデータとして指定します。 名前と値のペアが指定されていない場合、操作はメタデータをソース BLOB またはファイルからコピー先ファイルにコピーします。 1 つ以上の名前と値のペアが指定されている場合、指定したメタデータを使用してコピー先ファイルが作成され、メタデータはソース BLOB またはファイルからコピーされません。 メタデータ名は、C# 識別子の名前付け規則に従う必要があります。 Azure Files を介して指定されたファイル メタデータには、SMB クライアントからアクセスできません。 |
x-ms-copy-source:name |
必須。 ソース ファイルまたは BLOB の URL (最大 2 kibibytes (KiB) の長さを指定します。 同じストレージ アカウント内の別のファイルにファイルをコピーするには、共有キーを使用してソース ファイルを承認します。 別のストレージ アカウントからファイルをコピーする場合、または同じストレージ アカウントまたは別のストレージ アカウントから BLOB をコピーする場合は、共有アクセス署名を使用してソース ファイルまたは BLOB を承認する必要があります。 ソースがパブリック BLOB の場合、コピー操作を実行するための承認は必要ありません。 共有スナップショット内のファイルをコピー ソースとして指定することもできます。 ソース オブジェクト URL の例を次に示します。
|
x-ms-lease-id:<ID> |
コピー先ファイルにアクティブなリースがある場合に必要です。 バージョン 2019-02-02 以降で使用できます。 このヘッダーに指定するリース ID は、宛先ファイルのリース ID と一致する必要があります。 要求にリース ID が含まれていないか、ID が有効でない場合、操作は状態コード 412 (前提条件に失敗) で失敗します。 このヘッダーが指定されていて、コピー先ファイルに現在アクティブなリースがない場合、操作は状態コード 412 (前提条件に失敗) で失敗します。 このヘッダーは、NFS プロトコルが有効になっているファイル共有にコピー先ファイルがある場合は無視され、ファイル リースはサポートされません。 |
x-ms-file-creation-time |
随意。 バージョン 2019-07-07 以降で使用できます。 このヘッダーは、変換先ファイルに設定する作成時刻のプロパティを UTC で指定します。
source の値を使用して、ソース ファイルからコピー先ファイルに作成時刻をコピーできます。 |
x-ms-file-last-write-time |
随意。 バージョン 2019-07-07 以降で使用できます。 このヘッダーは、最終書き込み時刻のプロパティを UTC で指定して、コピー先ファイルに設定します。
source の値を使用して、ソース ファイルからコピー先ファイルに最終書き込み時刻をコピーできます。 |
x-ms-client-request-id |
随意。 ログ記録の構成時にログに記録される 1 KiB 文字の制限を持つ、クライアント生成の不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティと、サーバーが受信する要求を関連付けすることを強くお勧めします。 詳細については、「Monitor Azure Blob Storage」を参照してください。 |
x-ms-file-request-intent |
ヘッダー Authorization OAuth トークンを指定する場合は必須です。 許容される値は backupです。 このヘッダーは、Authorization ヘッダーを使用して承認された ID に割り当てられた RBAC ポリシーに含まれている場合、Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action または Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action を付与するように指定します。 バージョン 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 のみの要求ヘッダー
| 要求ヘッダー | 形容 |
|---|---|
x-ms-file-change-time: { <DateTime> ¦ source } |
随意。 バージョン 2021-06-08 以降。 ISO 8601 形式で書式設定されたファイルの UTC 変更時刻プロパティ。
source 値を使用して、変更時刻をソース ファイルからコピー先ファイルにコピーできます。 既定のタイム スタンプは要求の時刻です。 |
x-ms-file-permission-copy-mode: { source ¦ override } |
随意。 バージョン 2019-07-07 以降で使用できます。 ファイルのセキュリティ記述子のコピー動作を決定します。
|
x-ms-file-permission: { <SDDL> ¦ <binary> } |
x-ms-file-permission-copy-mode が override として指定され、x-ms-file-permission-key が指定されていない場合は必須です。 バージョン 2019-07-07 以降で使用できます。 このアクセス許可は、セキュリティ記述子定義言語 (SDDL) または (バージョン 2025-01-05 以降) base64 でエンコードされたバイナリ セキュリティ記述子形式で指定されたファイルのセキュリティ記述子 。
x-ms-file-permission-format ヘッダーで使用する形式を指定できます。 このヘッダーは、アクセス許可のサイズが 8 kibibytes (KiB) 以下の場合に使用できます。 それ以外の場合は、x-ms-file-permission-keyを使用できます。 指定する場合は、所有者、グループ、および随意アクセス制御リスト (DACL) する必要があります。 指定できるのは、 x-ms-file-permission または x-ms-file-permission-key のいずれか 1 つだけです。 |
x-ms-file-permission-key |
x-ms-file-permission-copy-mode が override として指定され、x-ms-file-permission が指定されていない場合に必要です。 バージョン 2019-07-07 以降で使用できます。 このヘッダーは、ファイルに設定するアクセス許可のキーを指定します。 このキーは、Create Permission 操作を使用して作成できます。指定できるのは、 x-ms-file-permission または x-ms-file-permission-key のいずれか 1 つだけです。 |
x-ms-file-permission-format: { sddl ¦ binary } |
随意。 バージョン 2025-01-05 以降。
x-ms-file-permission で渡される値が SDDL 形式かバイナリ形式かを指定します。 このヘッダーが設定されていない場合は、sddl の既定値が使用されます。 |
x-ms-file-attributes |
随意。 バージョン 2019-07-07 以降で使用できます。 このヘッダーは、宛先ファイルに設定するファイル システム属性を指定します。 使用可能な属性 一覧を参照してください。
source の値を使用して、ソース ファイルからコピー先ファイルに属性をコピーできます。
none の値を使用して、コピー先ファイルのすべての属性をクリアできます。 |
x-ms-file-copy-ignore-readonly |
随意。 バージョン 2019-07-07 以降で使用できます。 このブール値は、既存の宛先ファイルの ReadOnly 属性を尊重するかどうかを指定します。
trueの場合、コピー操作は成功します。 それ以外の場合、ReadOnly 属性が設定されたコピー先の前のファイルでは、コピー操作が失敗します。 |
x-ms-file-copy-set-archive |
随意。 バージョン 2019-07-07 以降で使用できます。 このブール値は、Archive ヘッダー値に関係なく、x-ms-file-attributes 属性を設定するかどうかを指定します。 |
NFS 要求ヘッダーのみ
| 要求ヘッダー | 形容 |
|---|---|
x-ms-file-mode-copy-mode: { source ¦ override } |
随意。 バージョン 2025-05-05 以降。 コピー ソースが NFS プロトコルが有効なファイル共有上にあるファイルである場合にのみ適用されます。 ファイルのモード ビットのコピー動作を決定します。
|
x-ms-mode |
バージョン 2025-05-05 以降。
x-ms-file-mode-copy-mode が overrideとして指定されている場合は必須です。 ファイルに設定するモード ビット。 モードは、12 ビット数値 8 進数形式またはシンボリック 'rwx' 形式で表されます。 POSIX ファイル アクセス許可 (モード)を参照してください。 |
x-ms-file-owner-copy-mode: { source ¦ override } |
随意。 バージョン 2025-05-05 以降。 コピー ソースが NFS プロトコルが有効なファイル共有上にあるファイルである場合にのみ適用されます。 ファイルの所有者ユーザー識別子 (UID) とグループ識別子 (GID) のコピー動作を決定します。
|
x-ms-owner |
バージョン 2025-05-05 以降。 ファイルに設定するファイル所有者のユーザー識別子 (UID)。
x-ms-file-owner-copy-mode が overrideとして指定されている場合は必須です。 |
x-ms-group |
バージョン 2025-05-05 以降。 ファイルに設定するファイル所有者のグループ識別子 (GID)。
x-ms-file-owner-copy-mode が overrideとして指定されている場合は必須です。 |
要求本文
何一つ。
応答
応答には、HTTP 状態コードと一連の応答ヘッダーが含まれます。
状態コード
操作が成功すると、状態コード 202 (Accepted) が返されます。 状態コードの詳細については、「状態コードとエラー コードを参照してください。
応答ヘッダー
この操作の応答には、次の表のヘッダーが含まれています。 応答には、追加の標準 HTTP ヘッダーを含めることもできます。 すべての標準ヘッダーは、HTTP/1.1 プロトコル仕様に準拠しています。
一般的な応答ヘッダー
| 応答ヘッダー | 形容 |
|---|---|
ETag |
コピー操作が完了した場合は、コピー先ファイルの ETag 値が含まれます。 コピー操作が完了していない場合は、操作の開始時に作成された空のファイルの ETag 値が含まれます。 |
Last-Modified |
コピー先ファイルへのコピー操作が完了した日付/時刻を返します。 |
x-ms-request-id |
行われた要求を一意に識別します。 このヘッダーを使用して、要求のトラブルシューティングを行うことができます。 詳細については、「API 操作のトラブルシューティング」を参照してください。 |
x-ms-version |
要求の実行に使用される Azure Files のバージョンを示します。 |
Date |
サービスが応答を送信した時刻を示す UTC 日付/時刻値。 |
x-ms-copy-id: <id> |
このコピー操作の文字列識別子を提供します。
Get File または Get File Properties と共に使用してこのコピー操作の状態を確認するか、Abort Copy File に渡して保留中のコピー操作を取り消します。 |
x-ms-copy-status: <success ¦ pending> |
コピー操作の状態を次の値で示します。 - success: コピー操作が正常に完了しました。- pending: コピー操作はまだ進行中です。 |
x-ms-client-request-id |
要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、その値が最大 1,024 文字の ASCII 文字で表示される場合、x-ms-client-request-id ヘッダーの値と等しくなります。
x-ms-client-request-id ヘッダーが要求に存在しない場合、このヘッダーは応答に存在しません。 |
SMB のみの応答ヘッダー
何一つ。
NFS のみの応答ヘッダー
何一つ。
応答本文
何一つ
応答のサンプル
Response Status:
HTTP/1.1 202 Accepted
Response Headers:
Last-Modified: <date>
ETag: "0x8CEB669D794AFE2"
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402
x-ms-version: 2015-02-21
x-ms-copy-id: 1f812371-a41d-49e6-b123-f4b542e851c5
x-ms-copy-status: pending
Date: <date>
認可
この操作は、アカウント所有者、または宛先ファイルまたはその共有に書き込むアクセス許可を持つ共有アクセス署名を持つクライアントによって呼び出すことができます。 要求で指定された Shared Access Signature は、宛先ファイルにのみ適用されることに注意してください。
ソース ファイルまたは BLOB へのアクセスは、要求ヘッダー x-ms-copy-sourceの詳細で説明されているように、個別に承認されます。
次の表では、Copy File 操作の宛先オブジェクトとソース オブジェクトを承認する方法について説明します。
| ファイル | 共有キーまたは共有キー Lite を使用した承認 | Shared Access Signature を使用した承認 | 承認を必要としないパブリック オブジェクト |
|---|---|---|---|
| 変換先ファイル | はい | はい | 該当なし |
| 同じアカウント内のソース ファイル | はい | はい | 該当なし |
| 別のアカウントのソース ファイル | いいえ | はい | 該当なし |
| 同じアカウントまたは別のアカウント内のソース BLOB | いいえ | はい | はい |
ファイル システム属性
| 属性 | Win32 ファイル属性 | 定義 |
|---|---|---|
ReadOnly |
FILE_ATTRIBUTE_READONLY |
ファイルは読み取り専用です。 アプリケーションはファイルを読み取ることができますが、ファイルに書き込んだり削除したりすることはできません。 |
Hidden |
FILE_ATTRIBUTE_HIDDEN |
ファイルは非表示になっています。 通常のディレクトリ 一覧には含まれません。 |
System |
FILE_ATTRIBUTE_SYSTEM |
オペレーティング システムは、ファイルの一部を使用するか、ファイルのみを使用します。 |
None |
FILE_ATTRIBUTE_NORMAL |
ファイルには他の属性が設定されていません。 この属性は、単独で使用されている場合にのみ有効です。 |
Archive |
FILE_ATTRIBUTE_ARCHIVE |
ファイルはアーカイブ ファイルです。 通常、アプリケーションではこの属性を使用して、バックアップまたは削除のためにファイルをマークします。 |
Temporary |
FILE_ATTRIBUTE_TEMPORARY |
ファイルは一時ストレージに使用されています。 |
Offline |
FILE_ATTRIBUTE_OFFLINE |
ファイルのデータはすぐには使用できません。 このファイル システム属性は、主に Windows との互換性を提供します。 Azure Files では、オフライン ストレージ オプションではサポートされていません。 |
NotContentIndexed |
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED |
コンテンツ インデックス 作成サービスでは、ファイルのインデックスは作成されません。 |
NoScrubData |
FILE_ATTRIBUTE_NO_SCRUB_DATA |
バックグラウンド データ整合性スキャナーは、ユーザー データ ストリームを読み取りません。 このファイル システム属性は、主に Windows との互換性を提供します。 |
POSIX ファイルのアクセス許可 (モード)
POSIX ファイルのアクセス許可は、12 ビット数値 8 進数形式またはシンボリック "rwx" 形式で数値で指定できます。 例：
- "0644" または "rw-r--r--": ユーザー (ファイル所有者) に読み取り、書き込みアクセス許可があります。 グループには読み取りアクセス許可があります。 他のユーザーには読み取りアクセス許可があります。
- "0755" または "rwxr-xr-x": ユーザー (ファイル所有者) に読み取り、書き込み、実行のアクセス許可があります。 グループには読み取りと実行のアクセス許可があります。 他のユーザーには、読み取りと実行のアクセス許可があります。
数値の 8 進数形式
3 つの最下位の 8 進数は、所有者/ユーザー、グループなどのアクセス許可を表し、8 進数 (0 から 7) を使用して示されます。これは、ビットごとの組み合わせの '4' (読み取り)、'2' (書き込み)、'1' (実行) を使用して形成されます。 最上位の 8 進数 (0 から 7) は、'4' (SetUID)、'2' (SetGID)、'1' (StickyBit) のアクセス許可の組み合わせを示すために使用されます。
| 形式 | 許可 |
|---|---|
| 0700 | ユーザー (ファイル所有者) は、読み取り、書き込み、実行のアクセス許可を持っています。 |
| 0400 | ユーザーは読み取りアクセス許可を持っています。 |
| 0200 | ユーザーは書き込みアクセス許可を持っています。 |
| 0100 | ユーザーは実行アクセス許可を持っています。 |
| 0070 | グループには、読み取り、書き込み、実行のアクセス許可があります。 |
| 0040 | グループには読み取りアクセス許可があります。 |
| 0020 | グループには書き込みアクセス許可があります。 |
| 0010 | グループには実行アクセス許可があります。 |
| 0007 | 他のユーザーには、読み取り、書き込み、実行のアクセス許可があります。 |
| 0004 | 他のユーザーには読み取りアクセス許可があります。 |
| 0002 | 他のユーザーには書き込みアクセス許可があります。 |
| 0001 | 他のユーザーには実行アクセス許可があります。 |
| 4000 | ファイルに有効なユーザー ID を設定します。 |
| 2000 | ファイルに有効なグループ ID を設定します。 |
| 1000 | ファイルを削除または名前変更できるのは、ファイル所有者、ディレクトリ所有者、またはルート ユーザーだけです。 |
シンボリック "rwx" 形式
所有者/ユーザー、グループなどのアクセス許可は、'r' (読み取り)、'w' (書き込み)、および 'x' (実行) 文字の組み合わせを使用して示されます。
| 形式 | 許可 |
|---|---|
| rwx------ | ユーザー (ファイル所有者) には、読み取り、書き込み、実行のアクセス許可があります。 |
| r-------- | ユーザーは読み取りアクセス許可を持っています。 |
| -w------- | ユーザーは書き込みアクセス許可を持っています。 |
| --x------ | ユーザーは実行アクセス許可を持っています。 |
| ---rwx--- | グループには、読み取り、書き込み、実行のアクセス許可があります。 |
| ---r----- | グループには読み取りアクセス許可があります。 |
| ----w---- | グループには書き込みアクセス許可があります。 |
| -----x--- | グループには実行アクセス許可があります。 |
| ------rwx | 他のユーザーには、読み取り、書き込み、実行のアクセス許可があります。 |
| ------r-- | 他のユーザーには読み取りアクセス許可があります。 |
| -------w- | 他のユーザーには書き込みアクセス許可があります。 |
| --------x | 他のユーザーには実行アクセス許可があります。 |
備考
Copy File 操作は非同期的に終了できます。
x-ms-copy-id 応答ヘッダーから返されるコピー ID を使用して、コピー操作の状態を確認したり、取り消したりできます。 Azure Files では、ベスト エフォートベースでファイルがコピーされます。
コピー先ファイルが存在する場合は上書きされます。 コピー操作の進行中は、コピー先ファイルを変更できません。
Copy File 操作では、常にソース BLOB またはファイル全体がコピーされます。 バイト範囲またはブロックのセットのコピーはサポートされていません。
Copy File 操作のソースには、共有スナップショットに存在するファイルを指定できます。
Copy File 操作のコピー先は、共有スナップショットに存在するファイルにすることはできません。
コピー操作のソースが ETag 値を提供する場合、操作の進行中にソースに変更がある場合は失敗します。 コピー操作の進行中にコピー先ファイルを変更しようとすると、状態コード 409 (競合) で失敗します。
ETag 操作の開始時に、コピー先ファイルの Copy File 値が変更されます。 コピー操作中も頻繁に変更されます。
プロパティとメタデータのコピー
BLOB またはファイルをコピーすると、次のシステム プロパティが同じ値でコピー先ファイルにコピーされます。
Content-TypeContent-EncodingContent-LanguageContent-LengthCache-ControlContent-MD5Content-Disposition
コピー先ファイルは、常にソース BLOB またはファイルと同じサイズです。 宛先ファイルの Content-Length ヘッダーの値は、ソース BLOB またはファイルのヘッダーの値と一致します。
リースされた BLOB またはファイルをファイルにコピーする
Copy File 操作はソース BLOB またはファイルからのみ読み取るので、ソース オブジェクトのリースは操作に影響しません。
Copy File 操作では、操作の開始時にソース BLOB またはファイルの ETag 値が保存されます。 コピー操作が完了する前に ETag 値が変更されると、操作は失敗します。 コピー操作中にファイルをリースすることで、ファイルのソース BLOB に対する変更を防ぐことができます。
宛先ファイルにアクティブな無限リースがある場合は、Copy File 操作の呼び出しでリース ID を指定する必要があります。 コピー操作が保留中の間、コピー先ファイルのリース操作は状態コード 409 (競合) で失敗します。 コピー操作中にコピー先ファイルの無限リースはロックされます。コピー元とは異なる名前のコピー先ファイルにコピーする場合でも、ソースと同じ名前のコピー先ファイルにコピーする場合でも、この方法でロックされます。 クライアントがまだ存在しないファイルのリース ID を指定すると、Azure Files は状態コード 412 (前提条件に失敗) を返します。
保留中のコピー操作の操作
Copy File 操作では、ファイルの非同期コピーが完了する場合があります。 次の表を使用して、Copy File が返す状態コードに基づいて次の手順を確認します。
| 状態コード | 意味 |
|---|---|
| 202 (承認済み)、x-ms-copy-status: success | コピー操作が正常に完了しました。 |
| 202 (承認済み)、x-ms-copy-status: 保留中 | コピー操作が完了していません。 コピー操作が完了するか失敗するまで、Get File Properties を使用してターゲット BLOB をポーリングして x-ms-copy-status を調べます。 |
| 4xx、500、または 503 | コピー操作に失敗しました。 |
Copy File 操作中および操作後、コピー先ファイルのプロパティには、Copy File 操作のコピー ID と、ソース BLOB またはファイルの URL が含まれます。 操作が完了すると、Azure Files は時刻と結果の値 (success、failed、または aborted) を宛先ファイルのプロパティに書き込みます。 操作に failed 結果がある場合、x-ms-copy-status-description ヘッダーにはエラー詳細文字列が含まれます。
保留中の Copy File 操作には、2 週間のタイムアウトがあります。2 週間後に完了せず、x-ms-copy-status フィールドが failed に設定され、x-ms-status-description フィールドが 500 (OperationCancelled) に設定された空のファイルを残したコピー試行。 コピー操作中に発生する可能性がある断続的で致命的でないエラーは、操作の進行状況を妨げる可能性がありますが、失敗の原因にならない可能性があります。 このような場合、x-ms-copy-status-description は断続的なエラーについて説明します。
コピー操作中にコピー先ファイルを変更しようとすると、状態コード 409 (競合)、"進行中のファイルのコピー" で失敗します。
Abort Copy File 操作を呼び出すと、x-ms-copy-status:aborted ヘッダーが表示されます。 コピー先ファイルには、そのままのメタデータと 0 バイトのファイル長が含まれます。 元の呼び出しを繰り返して Copy File 操作をもう一度試すことができます。
請求
Copy File 操作の宛先アカウントは、操作を開始する 1 つのトランザクションに対して課金されます。 コピー先アカウントでは、コピー操作の状態をキャンセルまたは要求する要求ごとに 1 つのトランザクションも発生します。
ソース ファイルまたは BLOB が別のアカウントにある場合、ソース アカウントにはトランザクション コストが発生します。 さらに、送信元アカウントと移行先アカウントが異なるリージョン (米国北部や米国南部など) に存在する場合、要求の転送に使用する帯域幅はエグレスとして送信元アカウントに課金されます。 同じリージョン内のアカウント間のエグレスは無料です。
関連項目
- ファイル に対する 操作
- Azure Storage への要求を承認する
- 状態とエラー コードの
- Azure Files のエラー コード
- ファイルのコピー の中止