次の方法で共有

az storage file copy

  • リファレンス

Note

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

ファイル コピー操作を管理します。

コマンド

名前 説明 型 状態
az storage file copy cancel

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

 コア GA
az storage file copy cancel (storage-preview 拡張機能)

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

 拡張子 GA
az storage file copy start

ファイルを非同期的にコピーします。

 コア GA
az storage file copy start (storage-preview 拡張機能)

ファイルを非同期的にコピーします。

 拡張子 GA
az storage file copy start-batch

複数のファイルまたは BLOB をファイル共有にコピーします。

 コア GA
az storage file copy start-batch (storage-preview 拡張機能)

複数のファイルまたは BLOB をファイル共有にコピーします。

 拡張子 GA

az storage file copy cancel

編集

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

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

az storage file copy cancel --copy-id
                            --destination-path
                            --destination-share
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--backup-intent]
                            [--connection-string]
                            [--disallow-trailing-dot {false, true}]
                            [--file-endpoint]
                            [--sas-token]
                            [--timeout]

必須のパラメーター

--copy-id

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

--destination-path -p

ファイル共有内のファイルへのパス。

--destination-share -s

宛先共有の名前。 共有が存在する必要があります。

省略可能のパラメーター

--account-key

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

--account-name

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

--auth-mode

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

指定可能な値: key, login
--backup-intent --enable-file-backup-request-intent

ファイルの OAuth (Azure AD) 認証で使用するために必要なパラメーター。 これにより、ファイル/ディレクトリ レベルのアクセス許可チェックがバイパスされ、許可されたデータ アクションに基づいて、それらのファイル/ディレクトリに ACL が設定されている場合でも、アクセスが許可されます。

規定値: False
--connection-string

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

--disallow-trailing-dot

true の場合、末尾のドットはターゲット URI からトリミングされます。 既定値は False です。

指定可能な値: false, true
規定値: False
--file-endpoint

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

--sas-token

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

--timeout

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

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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az storage file copy cancel (storage-preview 拡張機能)

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

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

az storage file copy cancel --copy-id
                            --destination-path
                            --destination-share
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--backup-intent]
                            [--connection-string]
                            [--disallow-trailing-dot {false, true}]
                            [--sas-token]
                            [--timeout]

必須のパラメーター

--copy-id

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

--destination-path -p

ファイル共有内のファイルへのパス。

--destination-share -s

宛先共有の名前。 共有が存在する必要があります。

省略可能のパラメーター

--account-key

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

--account-name

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

--auth-mode

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

指定可能な値: key, login
--backup-intent --enable-file-backup-request-intent

ファイルの OAuth (Azure AD) 認証で使用するために必要なパラメーター。 これにより、ファイル/ディレクトリ レベルのアクセス許可チェックがバイパスされ、許可されたデータ アクションに基づいて、それらのファイル/ディレクトリに ACL が設定されている場合でも、アクセスが許可されます。

規定値: False
--connection-string

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

--disallow-trailing-dot

true の場合、末尾のドットはターゲット URI からトリミングされます。 既定値は False です。

指定可能な値: false, true
規定値: False
--sas-token

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

--timeout

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

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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az storage file copy start

編集

ファイルを非同期的にコピーします。

az storage file copy start --destination-path
                           --destination-share
                           [--account-key]
                           [--account-name]
                           [--auth-mode {key, login}]
                           [--backup-intent]
                           [--connection-string]
                           [--disallow-source-trailing-dot {false, true}]
                           [--disallow-trailing-dot {false, true}]
                           [--file-endpoint]
                           [--file-snapshot]
                           [--metadata]
                           [--sas-token]
                           [--source-account-key]
                           [--source-account-name]
                           [--source-blob]
                           [--source-container]
                           [--source-path]
                           [--source-sas]
                           [--source-share]
                           [--source-snapshot]
                           [--source-uri]
                           [--timeout]

例

ファイルを非同期的にコピーします。

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --account-key 00000000

sas トークンを使用して、ソース URI から宛先ストレージ アカウントにファイルを非同期的にコピーします。

az storage file copy start --source-uri "https://srcaccount.file.core.windows.net/myshare/mydir/myfile?<sastoken>" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

sas トークンを使用して、ファイル スナップショットからコピー先ストレージ アカウントに非同期的にファイルをコピーします。

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --file-snapshot "2020-03-02T13:51:54.0000000Z" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

必須のパラメーター

--destination-path -p

ファイル共有内のファイルへのパス。

--destination-share -s

宛先共有の名前。 共有が存在する必要があります。

省略可能のパラメーター

--account-key

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

--account-name

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

--auth-mode

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

指定可能な値: key, login
--backup-intent --enable-file-backup-request-intent

ファイルの OAuth (Azure AD) 認証で使用するために必要なパラメーター。 これにより、ファイル/ディレクトリ レベルのアクセス許可チェックがバイパスされ、許可されたデータ アクションに基づいて、それらのファイル/ディレクトリに ACL が設定されている場合でも、アクセスが許可されます。

規定値: False
--connection-string

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

--disallow-source-trailing-dot --disallow-src-trailing

true の場合、末尾のドットはソース URI からトリミングされます。 既定値は False です。

指定可能な値: false, true
規定値: False
--disallow-trailing-dot

true の場合、末尾のドットはターゲット URI からトリミングされます。 既定値は False です。

指定可能な値: false, true
規定値: False
--file-endpoint

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

--file-snapshot

ソース ストレージ アカウントのファイル スナップショット。

--metadata

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

--sas-token

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

--source-account-key

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

--source-account-name

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

--source-blob

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

--source-container

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

--source-path

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

--source-sas

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

--source-share

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

--source-snapshot

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

--source-uri -u

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

--timeout

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

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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

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

ファイルを非同期的にコピーします。

az storage file copy start --destination-path
                           --destination-share
                           [--account-key]
                           [--account-name]
                           [--auth-mode {key, login}]
                           [--backup-intent]
                           [--connection-string]
                           [--disallow-source-trailing-dot {false, true}]
                           [--disallow-trailing-dot {false, true}]
                           [--file-snapshot]
                           [--metadata]
                           [--sas-token]
                           [--source-account-key]
                           [--source-account-name]
                           [--source-blob]
                           [--source-container]
                           [--source-path]
                           [--source-sas]
                           [--source-share]
                           [--source-snapshot]
                           [--source-uri]
                           [--timeout]

例

ファイルを非同期的にコピーします。

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --account-key 00000000

sas トークンを使用して、ソース URI から宛先ストレージ アカウントにファイルを非同期的にコピーします。

az storage file copy start --source-uri "https://srcaccount.file.core.windows.net/myshare/mydir/myfile?<sastoken>" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

sas トークンを使用して、ファイル スナップショットからコピー先ストレージ アカウントに非同期的にファイルをコピーします。

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --file-snapshot "2020-03-02T13:51:54.0000000Z" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

必須のパラメーター

--destination-path -p

ファイル共有内のファイルへのパス。

--destination-share -s

宛先共有の名前。 共有が存在する必要があります。

省略可能のパラメーター

--account-key

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

--account-name

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

--auth-mode

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

指定可能な値: key, login
--backup-intent --enable-file-backup-request-intent

ファイルの OAuth (Azure AD) 認証で使用するために必要なパラメーター。 これにより、ファイル/ディレクトリ レベルのアクセス許可チェックがバイパスされ、許可されたデータ アクションに基づいて、それらのファイル/ディレクトリに ACL が設定されている場合でも、アクセスが許可されます。

規定値: False
--connection-string

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

--disallow-source-trailing-dot --disallow-src-trailing

true の場合、末尾のドットはソース URI からトリミングされます。 既定値は False です。

指定可能な値: false, true
規定値: False
--disallow-trailing-dot

true の場合、末尾のドットはターゲット URI からトリミングされます。 既定値は False です。

指定可能な値: false, true
規定値: False
--file-snapshot

ソース ストレージ アカウントのファイル スナップショット。

--metadata

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

--sas-token

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

--source-account-key

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

--source-account-name

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

--source-blob

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

--source-container

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

--source-path

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

--source-sas

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

--source-share

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

--source-snapshot

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

--source-uri -u

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

--timeout

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

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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az storage file copy start-batch

編集

複数のファイルまたは BLOB をファイル共有にコピーします。

az storage file copy start-batch [--account-key]
                                 [--account-name]
                                 [--connection-string]
                                 [--destination-path]
                                 [--destination-share]
                                 [--disallow-source-trailing-dot {false, true}]
                                 [--disallow-trailing-dot {false, true}]
                                 [--dryrun]
                                 [--file-endpoint]
                                 [--metadata]
                                 [--pattern]
                                 [--sas-token]
                                 [--source-account-key]
                                 [--source-account-name]
                                 [--source-container]
                                 [--source-sas]
                                 [--source-share]
                                 [--source-uri]
                                 [--timeout]

例

ファイル共有内のすべてのファイルを別のストレージ アカウントにコピーします。

az storage file copy start-batch --source-account-name srcaccount --source-account-key 00000000 --source-share srcshare --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --account-key 00000000

ファイル共有内のすべてのファイルを別のストレージ アカウントにコピーします。 sas トークンを使用します。

az storage file copy start-batch --source-uri "https://srcaccount.file.core.windows.net/myshare?<sastoken>" --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

省略可能のパラメーター

--account-key

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

--account-name

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

--connection-string

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

--destination-path

ソース データのコピー先のディレクトリ。 省略すると、データがルート ディレクトリにコピーされます。

--destination-share

ソース データのコピー先のファイル共有。

--disallow-source-trailing-dot --disallow-src-trailing

true の場合、末尾のドットはソース URI からトリミングされます。 既定値は False です。

指定可能な値: false, true
規定値: False
--disallow-trailing-dot

true の場合、末尾のドットはターゲット URI からトリミングされます。 既定値は False です。

指定可能な値: false, true
規定値: False
--dryrun

コピーするファイルと BLOB を一覧表示します。 実際のデータ転送は行われません。

規定値: False
--file-endpoint

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

--metadata

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

--pattern

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

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

--sas-token

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

--source-account-key

ソース ストレージ アカウントのアカウント キー。 省略した場合、アクティブなログインを使用してアカウント キーが決定されます。

--source-account-name

データのコピー元のソース ストレージ アカウント。 省略すると、宛先アカウントが使用されます。

--source-container

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

--source-sas

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

--source-share

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

--source-uri

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

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

--timeout

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

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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

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

複数のファイルまたは BLOB をファイル共有にコピーします。

az storage file copy start-batch [--account-key]
                                 [--account-name]
                                 [--connection-string]
                                 [--destination-path]
                                 [--destination-share]
                                 [--disallow-source-trailing-dot {false, true}]
                                 [--disallow-trailing-dot {false, true}]
                                 [--dryrun]
                                 [--metadata]
                                 [--pattern]
                                 [--sas-token]
                                 [--source-account-key]
                                 [--source-account-name]
                                 [--source-container]
                                 [--source-sas]
                                 [--source-share]
                                 [--source-uri]
                                 [--timeout]

例

ファイル共有内のすべてのファイルを別のストレージ アカウントにコピーします。

az storage file copy start-batch --source-account-name srcaccount --source-account-key 00000000 --source-share srcshare --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --account-key 00000000

ファイル共有内のすべてのファイルを別のストレージ アカウントにコピーします。 sas トークンを使用します。

az storage file copy start-batch --source-uri "https://srcaccount.file.core.windows.net/myshare?<sastoken>" --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

省略可能のパラメーター

--account-key

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

--account-name

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

--connection-string

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

--destination-path

ソース データのコピー先のディレクトリ。 省略すると、データがルート ディレクトリにコピーされます。

--destination-share

ソース データのコピー先のファイル共有。

--disallow-source-trailing-dot --disallow-src-trailing

true の場合、末尾のドットはソース URI からトリミングされます。 既定値は False です。

指定可能な値: false, true
規定値: False
--disallow-trailing-dot

true の場合、末尾のドットはターゲット URI からトリミングされます。 既定値は False です。

指定可能な値: false, true
規定値: False
--dryrun

コピーするファイルと BLOB を一覧表示します。 実際のデータ転送は行われません。

規定値: False
--metadata

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

--pattern

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

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

--sas-token

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

--source-account-key

ソース ストレージ アカウントのアカウント キー。 省略した場合、アクティブなログインを使用してアカウント キーが決定されます。

--source-account-name

データのコピー元のソース ストレージ アカウント。 省略すると、宛先アカウントが使用されます。

--source-container

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

--source-sas

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

--source-share

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

--source-uri

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

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

--timeout

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

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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。