次の方法で共有

azcopy copy

  • [アーティクル]

ソース データをコピー先の場所にコピーします。

Note

AzCopy では、転送中にソースまたは宛先がアクティブに変更されるシナリオはサポートされていません。

構文

ソース データをコピー先の場所にコピーします。 サポートされている方向は次のとおりです。

  • ローカル <-> Azure BLOB (SAS または OAuth 認証)
  • ローカル <-> Azure Files (共有/ディレクトリ SAS 認証または OAuth 認証)
  • ローカル <-> Azure Data Lake Storage (SAS、OAuth、または SharedKey 認証)
  • Azure BLOB (SAS またはパブリック) -> Azure BLOB (SAS または OAuth 認証)
  • Azure Data Lake Storage (SAS またはパブリック) -> Azure Data Lake Storage (SAS または OAuth 認証)
  • Azure Blob (SAS または OAuth 認証) <-> Azure Blob (SAS または OAuth 認証) - ガイドラインに関するページを参照してください。
  • Azure Data Lake Storage (SAS または OAuth 認証) <-> Azure Data Lake Storage (SAS または OAuth 認証)
  • Azure Data Lake Storage (SAS または OAuth 認証) <-> Azure BLOB (SAS または OAuth 認証)
  • Azure BLOB (SAS またはパブリック) -> Azure Files (SAS)
  • Azure File (SAS または OAuth 認証) <-> Azure File (SAS または OAuth 認証)
  • Azure Files (SAS) -> Azure BLOB (SAS または OAuth 認証)
  • AWS S3 (アクセス キー) -> Azure ブロック BLOB (SAS または OAuth 認証)
  • Google Cloud Storage (サービス アカウント キー) -> Azure ブロック Blob (SAS または OAuth 認証)

詳しくは、例を参照してください。

詳細設定

AzCopy は、ファイルの拡張子またはコンテンツ (拡張子が指定されていない場合) に基づいて、ローカル ディスクからアップロードするときにファイルのコンテンツの種類を自動的に検出します。

組み込みのルックアップ テーブルは小さいですが、Unix では、次の 1 つ以上の名前において使用可能な場合は、ローカル システムの mime.types ファイルによって拡張されます。

  • /etc/mime.types
  • /etc/apache2/mime.types
  • /etc/apache/mime.types

Windows では、MIME の種類はレジストリから抽出されます。 この機能は、フラグを使用して無効にできます。 フラグに関するセクションを参照してください。

コマンド ラインを使用して環境変数を設定した場合、その変数はコマンド ラインの履歴で読み取ることができます。 資格情報を含む変数をコマンド ラインの履歴から消去することを検討してください。 変数が履歴に表示されないようにするために、ユーザーに資格情報の入力を要求し、環境変数を設定するためのスクリプトを使用できます。

azcopy copy [source] [destination] [flags]

例

OAuth 認証を使用して 1 つのファイルをアップロードします。 AzCopy にまだログインしていない場合は、次のコマンドを実行する前に azcopy login コマンドを実行してください。

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"

上記と同じですが、今度はファイル コンテンツの MD5 ハッシュも計算し、BLOB の Content-MD5 プロパティとして保存します。

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5

SAS トークンを使用して 1 つのファイルをアップロードします。

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

SAS トークンとパイプを使用して 1 つのファイルをアップロードします (ブロック BLOB のみ)。

cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob

OAuth とパイプを使用して 1 つのファイルをアップロードします (ブロック BLOB のみ)。

cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob

SAS トークンを使用してディレクトリ全体をアップロードします。

azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

or

azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --put-md5

SAS トークンとワイルドカード文字 (*) を使用して、一連のファイルをアップロードします。

azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"

SAS トークンとワイルドカード文字 (*) を使用して、ファイルとディレクトリをアップロードします。

azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

ファイルとディレクトリを Azure Storage アカウントにアップロードし、クエリ文字列でエンコードされたタグを BLOB に設定します。

  • タグ {key = "bla bla", val = "foo"} および {key = "bla bla 2", val = "bar"} を設定するには、次の構文を使います。
  • azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"
  • キーと値は URL でエンコードされ、キーと値のペアはアンパサンド ('&') で区切られます
  • BLOB にタグを設定するとき、SAS には追加のアクセス許可 (タグを表す 't') があります。これがないと、サービスから認可エラーが返されます。

OAuth 認証を使用して 1 つのファイルをダウンロードします。 AzCopy にまだログインしていない場合は、次のコマンドを実行する前に azcopy login コマンドを実行してください。

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"

SAS トークンを使用して 1 つのファイルをダウンロードします。

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"

SAS トークンを使用し、次に出力をファイルにパイプして、1 つのファイルをダウンロードします (ブロック BLOB のみ)。

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"

OAuth を使ってから出力をファイルにパイプすることで、1 つのファイルをダウンロードします (ブロック BLOB のみ)。

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"

SAS トークンを使用してディレクトリ全体をダウンロードします。

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true

URL でのワイルドカード文字 (*) の使用に関する注意事項:

URL でワイルドカード文字を使用するには、2 つの方法のみがサポートされます。

  • URL の最後のスラッシュ (/) の直後に 1 つ使用できます。 これにより、ディレクトリ内のすべてのファイルが、サブディレクトリに配置されることなく、宛先に直接コピーされます。

  • URL が、BLOB ではなく、コンテナーのみを参照している場合は、コンテナーの名前で 1 つ使用することもできます。 この方法を使用して、コンテナーのサブセットからファイルを取得できます。

格納しているディレクトリ自体をコピーせずに、ディレクトリの内容をダウンロードします。

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"

ストレージ アカウント全体をダウンロードします。

azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive

コンテナー名にワイルドカード記号 (*) を使用して、ストレージ アカウント内のコンテナーのサブセットをダウンロードします。

azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive

テキスト ファイル (例: versionidsFile) に記載されている Azure Storage からローカル ディレクトリに BLOB のすべてのバージョンをダウンロードします。 ソースが有効な BLOB であり、コピー先がローカル フォルダーであり、 versionidsFile が各バージョンが別々の行に書き込まれるテキスト ファイルであることを確認します。 指定されたすべてのバージョンを、指定されたコピー先フォルダーにダウンロードします。

azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/another/path/to/dir/[versionidsFile]"

SAS トークンを使用して、1 つの BLOB を別の BLOB にコピーします。

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

SAS トークンと OAuth トークンを使用して、1 つの BLOB を別の BLOB にコピーします。

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"

SAS トークンを使用して、1 つの BLOB 仮想ディレクトリを別の BLOB 仮想ディレクトリにコピーします。

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

SAS トークンを使用して、すべての BLOB コンテナー、ディレクトリ、BLOB をストレージ アカウントから別のストレージ アカウントにコピーします。

azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

アクセス キーと SAS トークンを使用して、アマゾン ウェブ サービス (AWS) S3 から Blob Storage に 1 つのオブジェクトをコピーします。 最初に、AWS S3 ソースの環境変数 AWS_ACCESS_KEY_ID と AWS_SECRET_ACCESS_KEY を設定します。

azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

アクセス キーと SAS トークンを使用して、AWS S3 から Blob Storage にディレクトリ全体をコピーします。 最初に、AWS S3 ソースの環境変数 AWS_ACCESS_KEY_ID と AWS_SECRET_ACCESS_KEY を設定します。

azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

[folder] プレースホルダーをさらによく理解するには、 https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html を参照してください。

アクセス キーと SAS トークンを使用して、アマゾン ウェブ サービス (AWS) から Blob Storage にすべてのバケットをコピーします。 最初に、AWS S3 ソースの環境変数 AWS_ACCESS_KEY_ID と AWS_SECRET_ACCESS_KEY を設定します。

azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

アクセス キーと SAS トークンを使用して、アマゾン ウェブ サービス (AWS) のリージョンから Blob Storage にすべてのバケットをコピーします。 最初に、AWS S3 ソースの環境変数 AWS_ACCESS_KEY_ID と AWS_SECRET_ACCESS_KEY を設定します。

azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

バケット名にワイルドカード記号 (*) を使用して、バケットのサブセットをコピーします。 前の例と同様に、アクセス キーと SAS トークンが必要です。 AWS S3 ソースの環境変数 AWS_ACCESS_KEY_ID と AWS_SECRET_ACCESS_KEY を設定していることを確認します。

azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

異なる BLOB ストレージ間で BLOB をコピーし、ソースからタグを保持します。 タグを保持するには、次の構文を使います。

azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --s2s-preserve-blob-tags=true

ファイルとディレクトリを Azure Storage アカウントに転送し、指定されたクエリ文字列でエンコードされたタグを BLOB に設定します。

  • タグ {key = "bla bla", val = "foo"} および {key = "bla bla 2", val = "bar"} を設定するには、次の構文を使います。

    azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"

  • キーと値は URL でエンコードされ、キーと値のペアはアンパサンド ('&') で区切られます

  • BLOB にタグを設定するときに、SAS に追加のアクセス許可 (タグ用に 't') があります。これがないと、サービスから認可エラーが返されます。

サービス アカウント キーと SAS トークンを使って、Google Cloud Storage (GCS) から Blob Storage に 1 つのオブジェクトをコピーします。 最初に、GCS ソースの環境変数 GOOGLE_APPLICATION_CREDENTIALS を設定します。

azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

サービス アカウント キーと SAS トークンを使用して、Google Cloud Storage (GCS) から Blob Storage にディレクトリ全体をコピーします。 最初に、GCS ソースの環境変数 GOOGLE_APPLICATION_CREDENTIALS を設定します。

azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

サービス アカウント キーと SAS トークンを使用して、Google Cloud Storage (GCS) から Blob Storage にバケット全体をコピーします。 最初に、GCS ソースの環境変数 GOOGLE_APPLICATION_CREDENTIALS を設定します。

azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

サービス アカウント キーと SAS トークンを使用して、Google Cloud Storage (GCS) から Blob Storage にすべてのバケットをコピーします。 最初に、GCS ソースの環境変数 GOOGLE_APPLICATION_CREDENTIALS と GOOGLE_CLOUD_PROJECT=<project-id> を設定します

azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

Google Cloud Storage (GCS) のバケット名にワイルドカード記号 (*) を指定し、サービス アカウント キーと宛先の SAS トークンを使用して、バケットのサブセットをコピーします。 最初に、GCS ソースの環境変数 GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id> を設定します

azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

AzCopy ジョブの開始前または開始後に変更されたファイルをコピーするために、AzCopy はジョブ ログに日付と時刻をISO8601形式で提供します (ジョブ ログで 'ISO 8601 START TIME' を検索します)。この形式は、 --include-after フラグと --include-before フラグで使用できます。以下の例を参照してください。 これは増分コピーに役立ちます。

include-after フラグを使用して、指定した日時以降に変更されたファイルのサブセット (ISO8601形式) をコンテナーにコピーします。

azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-after="2020-08-19T15:04:00Z"

include-before フラグを使用して、(ISO8601形式で) 指定された日時以前に変更されたファイルのサブセットをコンテナーにコピーします。

azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-before="2020-08-19T15:04:00Z"

[オプション]

--as-subdir 既定では true です。 フォルダー ソースをサブディレクトリとしてコピー先の下に配置します。 (既定値は true)

--backup アップロード向けに Windows の SeBackupPrivilege、またはダウンロード向けに SeRestorePrivilege を有効にし、AzCopy ですべてのファイルの読み取りを表示し、ファイル システムのアクセス許可に関係なく、あらゆるアクセス許可を復元できるようにします。 AzCopy を実行しているアカウントには、既にこれらのアクセス許可がなくてはなりません (たとえば、管理者権限を持っている、または「Backup Operators」グループのメンバーであるなど)。 このフラグは、アカウントに既に含まれている特権をアクティブ化します

--blob-tags (string) BLOB に文字列を設定して、ストレージ アカウントのデータを分類します

--blob-type (string) コピー先の BLOB の種類を定義します。 これは、BLOB をアップロードする場合と、アカウント間でコピーする場合に使用されます (既定値は "Detect")。 有効な値としては、"Detect"、"BlockBlob"、"PageBlob"、および "AppendBlob" があります。 アカウント間でコピーする場合、値 "Detect" を使用すると、AzCopy はソース BLOB の種類を使用して、コピー先 BLOB の種類を判断します。 ファイルをアップロードするとき、"Detect" は、ファイル拡張子に基づいて、ファイルが VHD ファイルまたは VHDX ファイルであるかを判断します。 ファイルが VHD ファイルまたは VHDX ファイルの場合、AzCopy はそのファイルをページ BLOB として扱います。 (既定値は "Detect")

--block-blob-tier (string) この BLOB 層を使用して Azure Storage にブロック BLOB をアップロードします。 (既定値は "None")

--block-size-mb (float) Azure Storage にアップロードするとき、および Azure Storage からダウンロードするときに、このブロック サイズ (MiB で指定) を使用します。 既定値は、ファイル サイズに基づいて自動的に計算されます。 小数を使用できます (例:0.25)。 アップロードまたはダウンロードの場合、許可される最大ブロック サイズは 0.75 * AZCOPY_BUFFER_GB です。 詳細については、「メモリ使用を最適化する」を参照してください。

--cache-control (string) cache-control ヘッダーを設定します。 ダウンロード時に返されます。

--check-length 転送後にコピー先のファイルの長さを確認します。 コピー元とコピー先の間に不一致がある場合は、転送に失敗のマークが付けられます。 (既定値は true)

--check-md5 (string) ダウンロード時に MD5 ハッシュをどの程度厳密に検証するかを指定します。 ダウンロード時にのみ使用できます。 使用できるオプションは NoCheck、LogOnly、FailIfDifferent、FailIfDifferentOrMissing です。 (既定値は "FailIfDifferent") (既定値は "FailIfDifferent")

--content-disposition (string) content-disposition ヘッダーを設定します。 ダウンロード時に返されます。

--content-encoding (string) content-encoding ヘッダーを設定します。 ダウンロード時に返されます。

--content-language (string) content-language ヘッダーを設定します。 ダウンロード時に返されます。

--content-type (string) ファイルのコンテンツの種類を指定します。 no-guess-mime-type を暗黙的に示します。 ダウンロード時に返されます。

--cpk-by-name (string) Azure Blob Storage に対して要求を行うクライアントが、要求ごとに暗号化キーを提供できるようにする、名前によるクライアント指定キー。 指定されたキー名は、Azure Key Vault からフェッチされ、データの暗号化に使われます

--cpk-by-value 既定では false です。 クライアントは、Azure Blob Storage に対して要求を行うクライアントが要求ごとに暗号化キーを提供するオプションを許可する、名前で指定されたキーです。 指定されたキーとそのハッシュは環境変数からフェッチされます

--decompress content-encoding が、ファイルが圧縮されていることを示している場合、ダウンロードするときに自動的に圧縮解除します。 サポートされている content-encoding の値は、"gzip" と "deflate" です。 ファイル拡張子 ".gz"/".gzip" または ".zz" は不要です。ある場合は削除されます。

--disable-auto-decoding 既定では false で、Windows 上での無効な文字の自動デコードが有効になります。 true に設定すると、自動デコードを無効にすることができます。

--dry-run 既定では false です。 このコマンドによってコピーされるファイル パスを出力します。 このフラグによって、実際のファイルがコピーされることはありません。 --overwrite フラグは無効です。 --overwrite フラグを false に設定すると、コピー先ディレクトリに同じファイルが存在する場合でも、ソース ディレクトリ内のファイルが一覧表示されます。

--exclude-attributes (文字列) (Windows のみ) 属性が属性の一覧と一致するファイルを除外します。 次に例を示します。A;S;R

--exclude-blob-type (string) 必要に応じて、コンテナーまたはアカウントから BLOB をコピーするときに除外する BLOB の種類 (BlockBlob、PageBlob、AppendBlob) を指定します。 このフラグの使用は、Azure 以外のサービスからサービスにデータをコピーする場合には適用されません。 複数の BLOB は ";" で区切る必要があります。

--exclude-container (文字列)アカウントからアカウントのみに転送する場合は、これらのコンテナーを除外します。 複数のコンテナーを ';' で区切ることができます。

--exclude-path (string) コピーするときにこれらのパスを除外します。 このオプションは、ワイルドカード文字 (*) をサポートしていません。 相対パスのプレフィックスを確認します (例: myFolder;myFolder/subDirName/file.pdf)。 アカウント トラバーサルと組み合わせて使用する場合、パスにはコンテナー名は含まれません。

--exclude-pattern (string) コピーするときにこれらのファイルを除外します。 このオプションでは、ワイルドカード文字 (*) がサポートされます。

--exclude-regex (string) 正規表現と一致するファイルのすべての相対パスを除外します。 複数の正規表現は ';' で区切ります。

--follow-symlinks ローカル ファイル システムからアップロードするときにシンボリック リンクに従います。

--force-if-read-only Windows または Azure Files 上の既存のファイルを上書きするときに、既存のファイルに読み取り専用属性が設定されている場合でも、上書きを強制的に実行します

--from-to (string) 必要に応じて、コピー元とコピー先の組み合わせを指定します。 たとえば次のようになります。LocalBlob、BlobLocal、LocalBlobFS。 パイプ: BlobPipe、PipeBlob

-h、--help copy のヘルプ

--include-after (string) 指定した日時以降に変更されたファイルのみが含まれます。 値は、ISO8601 形式で指定する必要があります。 タイムゾーンが指定されていない場合、値は AzCopy を実行しているマシンのローカル タイムゾーンにあると見なされます。 たとえば、UTC 時刻の場合は 2020-08-19T15:04:00Z、ローカル タイムゾーンが深夜 (00:00) の場合は 2020-08-19 になります。 AzCopy 10.5 以降、このフラグはフォルダーにではなくファイルにのみ適用されるため、このフラグを --preserve-smb-info または --preserve-smb-permissions と共に使用した場合、フォルダー プロパティはコピーされません。

--include-attributes (string) (ウィンドウズのみ) 属性が属性の一覧と一致するファイルを含めます。 次に例を示します。A;S;R

--include-before (string) 指定した日時以前に変更されたファイルのみが含まれます。 値は、ISO8601 形式で指定する必要があります。 タイムゾーンが指定されていない場合、値は AzCopy を実行しているマシンのローカル タイムゾーンにあると見なされます。 たとえば、UTC 時刻の場合は 2020-08-19T15:04:00Z、ローカル タイムゾーンが深夜 (00:00) の場合は 2020-08-19 になります。 AzCopy 10.7 以降、このフラグはフォルダーにではなくファイルにのみ適用されるため、このフラグを --preserve-smb-info または --preserve-smb-permissions と共に使用した場合、フォルダー プロパティはコピーされません。

--include-directory-stub 既定では false で、ディレクトリ スタブを無視します。 ディレクトリ スタブは、メタデータ hdi_isfolder:true を持つ BLOB です。 値を true に設定すると、転送中にディレクトリ スタブが保持されます。 既定値を true にしないこのフラグを含めます (例: azcopy copy --include-directory-stub は azcopy copy --include-directory-stub=trueと同じです)。

--include-path (string) コピーするときにこれらのパスのみを含めます。 このオプションは、ワイルドカード文字 (*) をサポートしていません。 相対パスのプレフィックスを確認します (例: myFolder;myFolder/subDirName/file.pdf)。

--include-pattern (string) コピーするときにこれらのファイルのみを含めます。 このオプションでは、ワイルドカード文字 (*) がサポートされます。 ";" を使用してファイルを区切ります。

--include-regex (string) 正規表現と一致するファイルの相対パスのみを含めます。 複数の正規表現は ';' で区切ります。

--list-of-versions (string) 各バージョン ID が個別の行に一覧表示されているファイルを指定します。 ソースが 1 つの BLOB を指している必要があり、このフラグを使用してファイルで指定されたすべてのバージョン ID がソース BLOB のみに属している必要があるため、これを徹底します。 AzCopy は、指定されたバージョンをコピー先フォルダーにダウンロードします。

--metadata (string) これらのキーと値のペアをメタデータとして Azure Storage にアップロードします。

--no-guess-mime-type AzCopy がファイルの拡張子または内容に基づいてコンテンツ タイプを検出しないようにします。

--overwrite (string) このフラグが true に設定されている場合は、コピー先の競合するファイルおよび BLOB を上書きします。 (既定値 は"true") 指定できる値は、"true"、"false"、"prompt"、"ifSourceNewer" です。 このフラグが "true" の場合、または肯定的な応答がプロンプトに返された場合、フォルダーをサポートしているコピー先では、競合するフォルダーレベルのプロパティが上書きされます。 (既定値は "true")

--page-blob-tier (string) この BLOB 層を使用して Azure Storage にページ BLOB をアップロードします。 (既定値は "None")。 (既定値は "None")

--preserve-last-modified-time コピー先がファイル システムの場合にのみ使用できます。

--preserve-owner ダウンロードする際、および --preserve-smb-permissions を使用している場合にのみ影響があります。 true の場合 (既定)、「Owner and Group」ファイルはダウンロードで保持されます。 false に設定されている場合、

--preserve-smb-permissions では引き続き ACL を保持しますが、所有者とグループは AzCopy を実行しているユーザーに基づきます (既定値は true)

--preserve-permissions 既定では false です。 対応するリソース (Windows と Azure Files、または Azure Data Lake Storage から Azure Data Lake Storage) の間で ACL を保持します。 階層型名前空間を持つアカウントの場合、セキュリティ プリンシパルはターゲット コンテナーの所有ユーザーであるか、ターゲット コンテナー、ストレージ アカウント、親リソース グループ、またはサブスクリプションに範囲指定したストレージ BLOB データ所有者ロールが割り当てられている必要があります。 ダウンロードする場合は、--backup フラグを使用して、新しい所有者が AzCopy を実行しているユーザーにならないアクセス許可を復元する必要もあります。 ファイルのみのフィルターが指定されている場合を除き、このフラグはファイルとフォルダーの両方に適用されます (例: include-pattern)。

--preserve-posix-properties 既定では false です。 statまたはstatxから収集されたプロパティ情報をオブジェクト メタデータに保持します。

--preserve-smb-info SMB 対応の場所の場合は、フラグは既定で true に設定されます。 SMB 対応リソース (Windows と Azure Files) 間の SMB プロパティ情報 (最終書き込み時刻、作成時刻、属性ビット) を保持します。 Azure Files によってサポートされる属性ビットのみが転送され、それ以外は無視されます。 ファイルのみのフィルターが指定されている場合を除き、このフラグはファイルとフォルダーの両方に適用されます (例: include-pattern)。 フォルダーに対して保持されない Last Write Time を除き、フォルダーについて転送される情報はファイルと同じです。 (既定値は true)

--preserve-symlinks 有効にした場合、シンボリック リンク先は、シンボリック リンクのもう一方の端にファイルまたはフォルダーをアップロードするのではなく、BLOB コンテンツとして保持されます。

--put-blob-size-mb このサイズ (MiB で指定) をしきい値として使用して、Azure Storage にアップロードするときに BLOB を 1 つの PUT 要求としてアップロードするかどうかを判断します。 既定値は、ファイル サイズに基づいて自動的に計算されます。 小数を使用できます (例:0.25)。

--put-md5各ファイルの MD5 ハッシュを作成し、ハッシュを同期先の BLOB またはファイルの Content-MD5 プロパティとして保存します。 (既定では、ハッシュは作成されません)。アップロード時にのみ使用できます。

--recursive ローカル ファイル システムからアップロードするときにサブディレクトリを再帰的に検索します。

--s2s-detect-source-changed 読み取り中にソース ファイルまたは BLOB が変更されたかどうかを検出します。 対応するチェックがアップロードとダウンロードに対して永続的に有効になっているため、このパラメーターはサービス間のコピーにのみ適用されます。

--s2s-handle-invalid-metadata (string) 無効なメタデータ キーの処理方法を指定します。 使用できるオプションは ExcludeIfInvalid、FailIfInvalid、RenameIfInvalid です。 (既定値は "ExcludeIfInvalid")。 (既定値は "ExcludeIfInvalid")

--s2s-preserve-access-tierサービス間のコピー中にアクセス層を保持します。 「Azure Blob Storage: ホット、クール、アーカイブ アクセス層」を参照して、同期先のストレージ アカウントで、アクセス層の設定がサポートされていることを確認してください。 アクセス層の設定がサポートされていない場合は、s2sPreserveAccessTier=false を使用してアクセス層のコピーをバイパスしてください。 (既定値は true)。 (既定値は true)

--s2s-preserve-blob-tags 既定では false です。 サービス間の BLOB ストレージ間の転送中にインデックス タグを保持する

--s2s-preserve-properties サービス間のコピー中にすべてのプロパティを保持します。 AWS S3 と Azure File の非単一ファイル ソースの場合、リスト操作はオブジェクトとファイルの完全なプロパティを返しません。 完全なプロパティを保持するために、AzCopy では、オブジェクトまたはファイルごとにさらに 1 つの要求を送信する必要があります。 (既定値は true)

--trailing-dot ファイル共有関連の操作を安全な方法で処理するために、既定で有効になっています。 使用可能なオプション: Enable、 Disable。 Disableを選択して、ファイル サービスがパス内の後続のドットをトリミングする、後続のドット ファイルのレガシ (安全でない可能性がある) 処理に戻ります。 転送に、末尾のドットのみが異なる 2 つのパス (たとえば、 mypath と mypath.) が含まれている場合、データが破損する可能性があります。 このフラグが Disable に設定されていて、AzCopy で末尾のドット ファイルが検出された場合、スキャン ログでユーザーに警告が表示されますが、操作の中止は試行されません。 宛先が末尾のドット ファイル (Windows または Blob Storage) をサポートしていない場合、末尾のドット ファイルが転送のルートである場合、AzCopy は失敗し、列挙型中に発生した後続のドット パスはスキップされます。

親コマンドから継承されるオプション

--cap-mbps (float) 転送速度をメガビット/秒で制限します。 瞬間的なスループットは、上限と若干異なる場合があります。 このオプションを 0 に設定した場合や省略した場合は、スループットは制限されません。

--log-level (string) ログ ファイルのログの詳細度を定義します。使用できるレベルは次のとおりです。INFO (すべての要求と応答)、WARNING (遅い応答)、ERROR (失敗した要求のみ)、NONE (出力ログなし)。 (既定値 は"INFO")。 (既定値は "INFO")

--output-type (string) コマンドの出力の形式。 選択肢には、text、json などがあります。 既定値は "text" です。 (既定値は "text")

--trusted-microsoft-suffixes (文字列) Microsoft Entra ログイン トークンを送信できる追加のドメイン サフィックスを指定します。 既定値は ".core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net" です。 ここに記載されているすべてが既定値に追加されます。 セキュリティのために、Microsoft Azure のドメインのみをここに入力してください。 複数のエンティティは、セミコロンで区切ります。

関連項目