az storage blob copy

Note

このコマンド グループには、Azure CLIと少なくとも 1 つの拡張機能の両方で定義されているコマンドがあります。 各拡張機能をインストールして、拡張機能を活用します。 拡張機能の詳細については、 を参照してください。

BLOB コピー操作を管理します。 az storage blob show を使用して、BLOB の状態を確認します。

コマンド

Name 説明 型 状態
az storage blob copy cancel

進行中のコピー操作を中止します。

 Core GA
az storage blob copy start

BLOB を非同期的にコピーします。 az storage blob show を使用して、BLOB の状態を確認します。

 Core GA
az storage blob copy start (storage-blob-preview 拡張機能)

コピー BLOB ジョブを開始します。

 Extension GA
az storage blob copy start-batch

複数の BLOB を BLOB コンテナーにコピーします。 az storage blob show を使用して、BLOB の状態を確認します。

 Core GA

az storage blob copy cancel

編集

進行中のコピー操作を中止します。

これにより、コピー先 BLOB は長さ 0、完全なメタデータは残ります。 コピー操作が既に終了している場合は、エラーが発生します。

az storage blob copy cancel --copy-id
                            --destination-blob
                            --destination-container
                            [--account-key]
                            [--account-name]
                            [--acquire-policy-token]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--change-reference]
                            [--connection-string]
                            [--lease-id]
                            [--sas-token]
                            [--timeout]

必須パラメーター

--copy-id

中止するコピー操作。 ID 文字列または BlobProperties のインスタンスを指定できます。

--destination-blob -b

宛先 BLOB の名前。 存在する場合は上書きされます。

--destination-container -c

コンテナー名。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--account-key

ストレージ アカウント キー。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_KEY。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--account-name

ストレージ アカウント名。 関連する環境変数: AZURE_STORAGE_ACCOUNT。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 どちらも存在しない場合、コマンドは、認証されたAzure アカウントを使用してストレージ アカウント キーのクエリを試みます。 多数のストレージ コマンドが実行されると、API クォータに達する可能性があります。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--auth-mode

コマンドを実行するモード。 "ログイン" モードでは、認証にログイン資格情報が直接使用されます。 従来の "キー" モードでは、アカウントの認証パラメーターが指定されていない場合、アカウント キーのクエリが試行されます。 環境変数: AZURE_STORAGE_AUTH_MODE。

プロパティ 値
指定可能な値: key, login
--blob-endpoint

ストレージ データ サービス エンドポイント。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 az storage account showを使用して各サービス プライマリ エンドポイントを見つけることができます。 環境変数: AZURE_STORAGE_SERVICE_ENDPOINT。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--connection-string

ストレージ アカウントの接続文字列。 環境変数: AZURE_STORAGE_CONNECTION_STRING。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--lease-id

ターゲット BLOB にアクティブな無限リースがある場合に必要です。

--sas-token

共有アクセス署名 (SAS) ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az storage blob copy start

編集

BLOB を非同期的にコピーします。 az storage blob show を使用して、BLOB の状態を確認します。

az storage blob copy start --destination-blob
                           --destination-container
                           [--account-key]
                           [--account-name]
                           [--acquire-policy-token]
                           [--auth-mode {key, login}]
                           [--blob-endpoint]
                           [--change-reference]
                           [--connection-string]
                           [--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
                           [--destination-if-match]
                           [--destination-if-modified-since]
                           [--destination-if-none-match]
                           [--destination-if-unmodified-since]
                           [--destination-lease-id]
                           [--destination-tags-condition]
                           [--metadata]
                           [--rehydrate-priority]
                           [--requires-sync {false, true}]
                           [--sas-token]
                           [--source-account-key]
                           [--source-account-name]
                           [--source-blob]
                           [--source-container]
                           [--source-if-match]
                           [--source-if-modified-since]
                           [--source-if-none-match]
                           [--source-if-unmodified-since]
                           [--source-lease-id]
                           [--source-path]
                           [--source-sas]
                           [--source-share]
                           [--source-snapshot]
                           [--source-tags-condition]
                           [--source-uri]
                           [--tags]
                           [--tier]
                           [--timeout]

例

BLOB を非同期的にコピーします。 "az storage blob show" を使用して、BLOB の状態を確認します。

az storage blob copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos

BLOB を非同期的にコピーします。 "az storage blob show" を使用して、BLOB の状態を確認します。

az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --sas-token $sas --source-uri https://storage.blob.core.windows.net/photos

BLOB 固有のバージョンをコピーする

az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://my-account.blob.core.windows.net/my-container/my-blob?versionId=2022-03-21T18:28:44.4431011Z --auth-mode login

必須パラメーター

--destination-blob -b

宛先 BLOB の名前。 存在する場合は上書きされます。

--destination-container -c

コンテナー名。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--account-key

ストレージ アカウント キー。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_KEY。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--account-name

ストレージ アカウント名。 関連する環境変数: AZURE_STORAGE_ACCOUNT。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 どちらも存在しない場合、コマンドは、認証されたAzure アカウントを使用してストレージ アカウント キーのクエリを試みます。 多数のストレージ コマンドが実行されると、API クォータに達する可能性があります。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--auth-mode

コマンドを実行するモード。 "ログイン" モードでは、認証にログイン資格情報が直接使用されます。 従来の "キー" モードでは、アカウントの認証パラメーターが指定されていない場合、アカウント キーのクエリが試行されます。 環境変数: AZURE_STORAGE_AUTH_MODE。

プロパティ 値
指定可能な値: key, login
--blob-endpoint

ストレージ データ サービス エンドポイント。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 az storage account showを使用して各サービス プライマリ エンドポイントを見つけることができます。 環境変数: AZURE_STORAGE_SERVICE_ENDPOINT。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--connection-string

ストレージ アカウントの接続文字列。 環境変数: AZURE_STORAGE_CONNECTION_STRING。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--destination-blob-type

転送先の BLOB の種類を定義します。 "Detect" の値は、ソース BLOB の種類に基づいて型を決定します。

プロパティ 値
指定可能な値: AppendBlob, BlockBlob, Detect, PageBlob
--destination-if-match

ETag 値、またはワイルドカード文字 (*)。 リソースの ETag が指定された値と一致する場合にのみ、このヘッダーを指定して操作を実行します。

プロパティ 値
パラメーター グループ: Precondition Arguments
--destination-if-modified-since

DateTime 値。 Azureは、渡された日付値が UTC であると想定しています。 タイムゾーンが含まれている場合、UTC 以外の日時は UTC に変換されます。 タイムゾーン情報なしで日付が渡された場合、UTC と見なされます。 指定した日付/時刻以降にコピー先 BLOB が変更された場合にのみ、BLOB をコピーするには、この条件付きヘッダーを指定します。 宛先 BLOB が変更されていない場合、BLOB サービスは状態コード 412 (前提条件に失敗) を返します。

プロパティ 値
パラメーター グループ: Precondition Arguments
--destination-if-none-match

ETag 値、またはワイルドカード文字 ()。リソースの ETag が指定された値と一致しない場合にのみ、このヘッダーを指定して操作を実行します。ワイルドカード文字 () を指定して、リソースが存在しない場合にのみ操作を実行し、存在する場合は操作を失敗させます。

プロパティ 値
パラメーター グループ: Precondition Arguments
--destination-if-unmodified-since

DateTime 値。 Azureは、渡された日付値が UTC であると想定しています。 タイムゾーンが含まれている場合、UTC 以外の日時は UTC に変換されます。 タイムゾーン情報なしで日付が渡された場合、UTC と見なされます。 この条件付きヘッダーを指定して BLOB をコピーするのは、指定した日付/時刻以降にコピー先 BLOB が変更されていない場合のみです。 宛先 BLOB が変更された場合、BLOB サービスは状態コード 412 (前提条件に失敗) を返します。

プロパティ 値
パラメーター グループ: Precondition Arguments
--destination-lease-id

このヘッダーに指定するリース ID は、宛先 BLOB のリース ID と一致している必要があります。 要求にリース ID が含まれていないか、有効でない場合、操作は状態コード 412 (前提条件に失敗) で失敗します。

--destination-tags-condition

一致する値を持つ BLOB でのみ動作するように、BLOB タグに対して SQL where 句を指定します。

プロパティ 値
パラメーター グループ: Precondition Arguments
--metadata

スペース区切りのキーと値のペアのメタデータ。 これにより、既存のメタデータが上書きされます。

--rehydrate-priority -r

アーカイブされた BLOB のリハイドレートに使用する優先度を指定します。

--requires-sync

コピーが完了するまでサービスが応答を返さないことを強制します。

プロパティ 値
指定可能な値: false, true
--sas-token

共有アクセス署名 (SAS) ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--source-account-key

ソース BLOB のストレージ アカウント キー。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-account-name

ソース BLOB のストレージ アカウント名。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-blob

ソース ストレージ アカウントの BLOB 名。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-container

ソース ストレージ アカウントのコンテナー名。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-if-match

ETag 値、またはワイルドカード文字 (*)。 リソースの ETag が指定された値と一致する場合にのみ、このヘッダーを指定して操作を実行します。

プロパティ 値
パラメーター グループ: Pre-condition Arguments
--source-if-modified-since

DateTime 値。 Azureは、渡された日付値が UTC であると想定しています。 タイムゾーンが含まれている場合、UTC 以外の日時は UTC に変換されます。 タイムゾーン情報なしで日付が渡された場合、UTC と見なされます。 指定した日付/時刻以降にソース BLOB が変更された場合にのみ、この条件付きヘッダーを指定して BLOB をコピーします。

プロパティ 値
パラメーター グループ: Pre-condition Arguments
--source-if-none-match

ETag 値、またはワイルドカード文字 ()。リソースの ETag が指定された値と一致しない場合にのみ、このヘッダーを指定して操作を実行します。ワイルドカード文字 () を指定して、リソースが存在しない場合にのみ操作を実行し、存在する場合は操作を失敗させます。

プロパティ 値
パラメーター グループ: Pre-condition Arguments
--source-if-unmodified-since

DateTime 値。 Azureは、渡された日付値が UTC であると想定しています。 タイムゾーンが含まれている場合、UTC 以外の日時は UTC に変換されます。 タイムゾーン情報なしで日付が渡された場合、UTC と見なされます。 指定した日付/時刻以降にソース BLOB が変更されていない場合にのみ、この条件付きヘッダーを指定して BLOB をコピーします。

プロパティ 値
パラメーター グループ: Pre-condition Arguments
--source-lease-id

指定されたリース ID がソース BLOB のアクティブなリース ID と一致する場合にのみ、BLOB のコピー操作を実行するように指定します。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-path

ソース ストレージ アカウントのファイル パス。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-sas

ソース ストレージ アカウントの Shared Access Signature。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-share

ソース ストレージ アカウントの共有名。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-snapshot

ソース ストレージ アカウントの BLOB スナップショット。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-tags-condition

一致する値を持つ BLOB でのみ動作するように、BLOB タグに対して SQL where 句を指定します。

プロパティ 値
パラメーター グループ: Precondition Arguments
--source-uri -u

Azure ファイルまたは BLOB を指定する最大 2 KB の長さの URL。 値は、要求 URI に表示されるように URL エンコードする必要があります。 ソースが別のアカウントにある場合、ソースはパブリックであるか、共有アクセス署名を使用して認証される必要があります。 ソースがパブリックの場合、認証は必要ありません。 例: https://myaccount.blob.core.windows.net/mycontainer/myblob、https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>、https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

--tier

BLOB を設定する層の値。 ページ BLOB の場合、層は BLOB のサイズと許可される IOPS の数に関連付けられます。 指定できる値は P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80 であり、これは Premium Storage アカウント上のページ BLOB にのみ適用されます。ブロック BLOB の場合、指定できる値はアーカイブ、コールド、クール、ホットです。 これは、Standard ストレージ アカウントのブロック BLOB にのみ適用されます。

--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az storage blob copy start (storage-blob-preview 拡張機能)

コピー BLOB ジョブを開始します。

az storage blob copy start --destination-blob
                           --destination-container
                           [--account-key]
                           [--account-name]
                           [--acquire-policy-token]
                           [--auth-mode {key, login}]
                           [--blob-endpoint]
                           [--change-reference]
                           [--connection-string]
                           [--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
                           [--destination-if-match]
                           [--destination-if-modified-since]
                           [--destination-if-none-match]
                           [--destination-if-unmodified-since]
                           [--destination-lease-id]
                           [--destination-tags-condition]
                           [--metadata]
                           [--rehydrate-priority]
                           [--requires-sync {false, true}]
                           [--sas-token]
                           [--source-account-key]
                           [--source-account-name]
                           [--source-blob]
                           [--source-container]
                           [--source-if-match]
                           [--source-if-modified-since]
                           [--source-if-none-match]
                           [--source-if-unmodified-since]
                           [--source-lease-id]
                           [--source-path]
                           [--source-sas]
                           [--source-share]
                           [--source-snapshot]
                           [--source-tags-condition]
                           [--source-uri]
                           [--tags]
                           [--tier]
                           [--timeout]

例

BLOB を非同期的にコピーします。 "az storage blob show" を使用して、BLOB の状態を確認します。

az storage blob copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos

BLOB を非同期的にコピーします。 "az storage blob show" を使用して、BLOB の状態を確認します。

az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --sas-token $sas --source-uri https://storage.blob.core.windows.net/photos

必須パラメーター

--destination-blob -b

宛先 BLOB の名前。 存在する場合は上書きされます。

--destination-container -c

コンテナー名。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--account-key

ストレージ アカウント キー。 ストレージ アカウント名と組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_KEY。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--account-name

ストレージ アカウント名。 関連する環境変数: AZURE_STORAGE_ACCOUNT。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 どちらも存在しない場合、コマンドは、認証されたAzure アカウントを使用してストレージ アカウント キーのクエリを試みます。 多数のストレージ コマンドが実行されると、API クォータに達する可能性があります。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--auth-mode

コマンドを実行するモード。 "ログイン" モードでは、認証にログイン資格情報が直接使用されます。 従来の "キー" モードでは、アカウントの認証パラメーターが指定されていない場合、アカウント キーのクエリが試行されます。 環境変数: AZURE_STORAGE_AUTH_MODE。

プロパティ 値
指定可能な値: key, login
--blob-endpoint

ストレージ データ サービス エンドポイント。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 az storage account showを使用して各サービス プライマリ エンドポイントを見つけることができます。 環境変数: AZURE_STORAGE_SERVICE_ENDPOINT。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--connection-string

ストレージ アカウントの接続文字列。 環境変数: AZURE_STORAGE_CONNECTION_STRING。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--destination-blob-type

転送先の BLOB の種類を定義します。 "Detect" の値は、ソース BLOB の種類に基づいて型を決定します。

プロパティ 値
指定可能な値: AppendBlob, BlockBlob, Detect, PageBlob
--destination-if-match

ETag 値、またはワイルドカード文字 (*)。 リソースの ETag が指定された値と一致する場合にのみ、このヘッダーを指定して操作を実行します。

プロパティ 値
パラメーター グループ: Precondition Arguments
--destination-if-modified-since

DateTime 値。 Azureは、渡された日付値が UTC であると想定しています。 タイムゾーンが含まれている場合、UTC 以外の日時は UTC に変換されます。 タイムゾーン情報なしで日付が渡された場合、UTC と見なされます。 指定した日付/時刻以降にコピー先 BLOB が変更された場合にのみ、BLOB をコピーするには、この条件付きヘッダーを指定します。 宛先 BLOB が変更されていない場合、BLOB サービスは状態コード 412 (前提条件に失敗) を返します。

プロパティ 値
パラメーター グループ: Precondition Arguments
--destination-if-none-match

ETag 値、またはワイルドカード文字 ()。リソースの ETag が指定された値と一致しない場合にのみ、このヘッダーを指定して操作を実行します。ワイルドカード文字 () を指定して、リソースが存在しない場合にのみ操作を実行し、存在する場合は操作を失敗させます。

プロパティ 値
パラメーター グループ: Precondition Arguments
--destination-if-unmodified-since

DateTime 値。 Azureは、渡された日付値が UTC であると想定しています。 タイムゾーンが含まれている場合、UTC 以外の日時は UTC に変換されます。 タイムゾーン情報なしで日付が渡された場合、UTC と見なされます。 この条件付きヘッダーを指定して BLOB をコピーするのは、指定した日付/時刻以降にコピー先 BLOB が変更されていない場合のみです。 宛先 BLOB が変更された場合、BLOB サービスは状態コード 412 (前提条件に失敗) を返します。

プロパティ 値
パラメーター グループ: Precondition Arguments
--destination-lease-id

このヘッダーに指定するリース ID は、estination BLOB のリース ID と一致する必要があります。 要求にリース ID が含まれていないか、有効でない場合、操作は状態コード 412 (前提条件に失敗) で失敗します。

--destination-tags-condition

一致する値を持つ BLOB でのみ動作するように、BLOB タグに対して SQL where 句を指定します。

プロパティ 値
パラメーター グループ: Precondition Arguments
--metadata

スペース区切りのキーと値のペアのメタデータ。 これにより、既存のメタデータが上書きされます。

--rehydrate-priority -r

アーカイブされた BLOB のリハイドレートに使用する優先度を指定します。

--requires-sync

コピーが完了するまでサービスが応答を返さないことを強制します。

プロパティ 値
指定可能な値: false, true
--sas-token

共有アクセス署名 (SAS) ストレージ アカウント名と組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--source-account-key

ソース BLOB のストレージ アカウント キー。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-account-name

ソース BLOB のストレージ アカウント名。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-blob

ソース ストレージ アカウントの BLOB 名。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-container

ソース ストレージ アカウントのコンテナー名。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-if-match

ETag 値、またはワイルドカード文字 (*)。 リソースの ETag が指定された値と一致する場合にのみ、このヘッダーを指定して操作を実行します。

プロパティ 値
パラメーター グループ: Pre-condition Arguments
--source-if-modified-since

DateTime 値。 Azureは、渡された日付値が UTC であると想定しています。 タイムゾーンが含まれている場合、UTC 以外の日時は UTC に変換されます。 タイムゾーン情報なしで日付が渡された場合、UTC と見なされます。 指定した日付/時刻以降にソース BLOB が変更された場合にのみ、この条件付きヘッダーを指定して BLOB をコピーします。

プロパティ 値
パラメーター グループ: Pre-condition Arguments
--source-if-none-match

ETag 値、またはワイルドカード文字 ()。リソースの ETag が指定された値と一致しない場合にのみ、このヘッダーを指定して操作を実行します。ワイルドカード文字 () を指定して、リソースが存在しない場合にのみ操作を実行し、存在する場合は操作を失敗させます。

プロパティ 値
パラメーター グループ: Pre-condition Arguments
--source-if-unmodified-since

DateTime 値。 Azureは、渡された日付値が UTC であると想定しています。 タイムゾーンが含まれている場合、UTC 以外の日時は UTC に変換されます。 タイムゾーン情報なしで日付が渡された場合、UTC と見なされます。 指定した日付/時刻以降にソース BLOB が変更されていない場合にのみ、この条件付きヘッダーを指定して BLOB をコピーします。

プロパティ 値
パラメーター グループ: Pre-condition Arguments
--source-lease-id

指定されたリース ID がソース BLOB のアクティブなリース ID と一致する場合にのみ、BLOB のコピー操作を実行するように指定します。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-path

ソース ストレージ アカウントのファイル パス。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-sas

ソース ストレージ アカウントの Shared Access Signature。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-share

ソース ストレージ アカウントの共有名。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-snapshot

ソース ストレージ アカウントの BLOB スナップショット。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-tags-condition

一致する値を持つ BLOB でのみ動作するように、BLOB タグに対して SQL where 句を指定します。

プロパティ 値
パラメーター グループ: Precondition Arguments
--source-uri -u

Azure ファイルまたは BLOB を指定する最大 2 KB の長さの URL。 値は、要求 URI に表示されるように URL エンコードする必要があります。 ソースが別のアカウントにある場合、ソースはパブリックであるか、共有アクセス署名を使用して認証される必要があります。 ソースがパブリックの場合、認証は必要ありません。 例: https://myaccount.blob.core.windows.net/mycontainer/myblob、https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>、https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--tags

スペース区切りのタグ: key[=value] [key[=value] ...]タグでは大文字と小文字が区別されます。 タグ セットには、最大 10 個のタグを含むことができます。 タグ キーは 1 ~ 128 文字、タグ値は 0 ~ 256 文字にする必要があります。 有効なタグ キーと値の文字には、小文字と大文字、数字 (0 から 9)、スペース ( )、プラス (+)、マイナス (-)、ピリオド (.)、solidus (/)、コロン (:)、等しい (=)、アンダースコア (_) があります。

--tier

BLOB を設定する層の値。 ページ BLOB の場合、層は BLOB のサイズと許可される IOPS の数に関連付けられます。 指定できる値は P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80 であり、これは Premium Storage アカウント上のページ BLOB にのみ適用されます。ブロック BLOB の場合、指定できる値はアーカイブ、コールド、クール、ホットです。 これは、Standard ストレージ アカウントのブロック BLOB にのみ適用されます。

--timeout

要求タイムアウト (秒単位)。 サービスへの各呼び出しに適用されます。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az storage blob copy start-batch

編集

複数の BLOB を BLOB コンテナーにコピーします。 az storage blob show を使用して、BLOB の状態を確認します。

az storage blob copy start-batch [--account-key]
                                 [--account-name]
                                 [--acquire-policy-token]
                                 [--auth-mode {key, login}]
                                 [--blob-endpoint]
                                 [--change-reference]
                                 [--connection-string]
                                 [--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
                                 [--destination-container]
                                 [--destination-path]
                                 [--dryrun]
                                 [--pattern]
                                 [--rehydrate-priority]
                                 [--sas-token]
                                 [--source-account-key]
                                 [--source-account-name]
                                 [--source-container]
                                 [--source-sas]
                                 [--source-share]
                                 [--source-uri]
                                 [--tier]

例

複数の BLOB を BLOB コンテナーにコピーします。 "az storage blob show" を使用して、BLOB の状態を確認します。 (autogenerated)

az storage blob copy start-batch --account-key 00000000 --account-name MyAccount --destination-container MyDestinationContainer --source-account-key MySourceKey --source-account-name MySourceAccount --source-container MySourceContainer

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--account-key

ストレージ アカウント キー。 ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_KEY。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--account-name

ストレージ アカウント名。 関連する環境変数: AZURE_STORAGE_ACCOUNT。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 どちらも存在しない場合、コマンドは、認証されたAzure アカウントを使用してストレージ アカウント キーのクエリを試みます。 多数のストレージ コマンドが実行されると、API クォータに達する可能性があります。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--auth-mode

コマンドを実行するモード。 "ログイン" モードでは、認証にログイン資格情報が直接使用されます。 従来の "キー" モードでは、アカウントの認証パラメーターが指定されていない場合、アカウント キーのクエリが試行されます。 環境変数: AZURE_STORAGE_AUTH_MODE。

プロパティ 値
指定可能な値: key, login
--blob-endpoint

ストレージ データ サービス エンドポイント。 ストレージ アカウント キーまたは SAS トークンと組み合わせて使用する必要があります。 az storage account showを使用して各サービス プライマリ エンドポイントを見つけることができます。 環境変数: AZURE_STORAGE_SERVICE_ENDPOINT。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--connection-string

ストレージ アカウントの接続文字列。 環境変数: AZURE_STORAGE_CONNECTION_STRING。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--destination-blob-type

転送先の BLOB の種類を定義します。 "Detect" の値は、ソース BLOB の種類に基づいて型を決定します。

プロパティ 値
指定可能な値: AppendBlob, BlockBlob, Detect, PageBlob
--destination-container -c

選択したソース ファイルまたは BLOB のコピー先となる BLOB コンテナー。

--destination-path

BLOB 名の前に付加される宛先パス。

--dryrun

アップロードするファイルまたは BLOB を一覧表示します。 実際のデータ転送は行われません。

プロパティ 値
規定値: False
--pattern

ソース内のファイルまたは BLOB のグロービングに使用されるパターン。 サポートされているパターンは、'*'、'?'、'[seq]'、および '[!seq]' です。 詳細については、https://docs.python.org/3/library/fnmatch.htmlを参照してください。

--pattern で '*' を使用すると、ディレクトリ区切り記号 '/' を含む任意の文字と一致します。

--rehydrate-priority -r

アーカイブされた BLOB のリハイドレートに使用する優先度を指定します。

--sas-token

共有アクセス署名 (SAS) ストレージ アカウント名またはサービス エンドポイントと組み合わせて使用する必要があります。 環境変数: AZURE_STORAGE_SAS_TOKEN。

プロパティ 値
パラメーター グループ: Storage Account Arguments
--source-account-key

ソース ストレージ アカウントのアカウント キー。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-account-name

ファイルまたは BLOB がコピー先にコピーされるソース ストレージ アカウント。 省略すると、宛先アカウントが使用されます。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-container

BLOB のコピー元のソース コンテナー。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-sas

ソース ストレージ アカウントの Shared Access Signature。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-share

ファイルのコピー元のソース共有。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--source-uri

ファイルまたは BLOB のコピー元のファイル共有または BLOB コンテナーを指定する URI。

ソースが別のアカウントにある場合、ソースはパブリックであるか、Shared Access Signature を使用して認証されている必要があります。

プロパティ 値
パラメーター グループ: Copy Source Arguments
--tier

BLOB を設定する層の値。 ページ BLOB の場合、層は BLOB のサイズと許可される IOPS の数に関連付けられます。 指定できる値は P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80 であり、これは Premium Storage アカウント上のページ BLOB にのみ適用されます。ブロック BLOB の場合、指定できる値はアーカイブ、コールド、クール、ホットです。 これは、Standard ストレージ アカウントのブロック BLOB にのみ適用されます。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False