你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az storage file copy
注意
此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展,使其受益于其扩展功能。 详细了解扩展。
管理文件复制操作。
命令
名称 | 说明 | 类型 | Status |
---|---|---|---|
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
中止正在进行的复制操作。
这会保留长度为零且完整元数据的目标文件。 如果复制操作已结束,则会引发错误。
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]
必需参数
要中止的复制操作。 这可以是 ID,也可以是 FileProperties 的实例。
文件共享中文件的路径。
目标共享的名称。 共享必须存在。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将根据允许的数据操作绕过任何文件/目录级别权限检查并允许访问,即使这些文件/目录存在 ACL。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az storage file copy cancel (storage-preview 扩展)
中止正在进行的复制操作。
这会保留长度为零且完整元数据的目标文件。 如果复制操作已结束,则会引发错误。
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]
必需参数
要中止的复制操作。 这可以是 ID,也可以是 FileProperties 的实例。
文件共享中文件的路径。
目标共享的名称。 共享必须存在。
可选参数
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将根据允许的数据操作绕过任何文件/目录级别权限检查并允许访问,即使这些文件/目录存在 ACL。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。
共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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>
必需参数
文件共享中文件的路径。
目标共享的名称。 共享必须存在。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将根据允许的数据操作绕过任何文件/目录级别权限检查并允许访问,即使这些文件/目录存在 ACL。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
如果为 true,将从源 URI 中剪裁尾随点。 默认值为 False。
如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
源存储帐户的文件快照。
空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
源 Blob 的存储帐户密钥。
源 Blob 的存储帐户名称。
源存储帐户的 Blob 名称。
源存储帐户的容器名称。
源存储帐户的文件路径。
源存储帐户的共享访问签名。
源存储帐户的共享名称。
源存储帐户的 Blob 快照。
最大长度为 2 KB 的 URL,用于指定 Azure 文件或 Blob。 该值应采用 URL 编码,因为它将显示在请求 URI 中。 如果源位于另一个帐户中,则源必须是公共的,或者必须通过共享访问签名进行身份验证。 如果源是公共的,则无需身份验证。 示例: https://myaccount.file.core.windows.net/myshare/mydir/myfile https://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken.
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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>
必需参数
文件共享中文件的路径。
目标共享的名称。 共享必须存在。
可选参数
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将根据允许的数据操作绕过任何文件/目录级别权限检查并允许访问,即使这些文件/目录存在 ACL。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
如果为 true,将从源 URI 中剪裁尾随点。 默认值为 False。
如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。
源存储帐户的文件快照。
空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。
共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
源 Blob 的存储帐户密钥。
源 Blob 的存储帐户名称。
源存储帐户的 Blob 名称。
源存储帐户的容器名称。
源存储帐户的文件路径。
源存储帐户的共享访问签名。
源存储帐户的共享名称。
源存储帐户的 Blob 快照。
最大长度为 2 KB 的 URL,用于指定 Azure 文件或 Blob。 该值应采用 URL 编码,因为它将显示在请求 URI 中。 如果源位于另一个帐户中,则源必须是公共的,或者必须通过共享访问签名进行身份验证。 如果源是公共的,则无需身份验证。 示例: https://myaccount.file.core.windows.net/myshare/mydir/myfile https://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken.
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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>
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
将源数据复制到的目录。 如果省略,数据将复制到根目录。
将源数据复制到的文件共享。
如果为 true,将从源 URI 中剪裁尾随点。 默认值为 False。
如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。
列出要复制的文件和 Blob。 不会发生实际数据传输。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。
用于整理文件和 Blob 的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html。
在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
源存储帐户的帐户密钥。 如果省略,则使用活动登录名来确定帐户密钥。
要从中复制数据的源存储帐户。 如果省略,则使用目标帐户。
源容器 Blob 从中复制。
源存储帐户的共享访问签名。
源共享文件是从中复制的。
指定源文件共享或 Blob 容器的 URI。
如果源位于另一个帐户中,则源必须通过共享访问签名公开或进行身份验证。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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>
可选参数
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
将源数据复制到的目录。 如果省略,数据将复制到根目录。
将源数据复制到的文件共享。
如果为 true,将从源 URI 中剪裁尾随点。 默认值为 False。
如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。
列出要复制的文件和 Blob。 不会发生实际数据传输。
空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。
用于整理文件和 Blob 的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html。
在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。
共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
源存储帐户的帐户密钥。 如果省略,则使用活动登录名来确定帐户密钥。
要从中复制数据的源存储帐户。 如果省略,则使用目标帐户。
源容器 Blob 从中复制。
源存储帐户的共享访问签名。
源共享文件是从中复制的。
指定源文件共享或 Blob 容器的 URI。
如果源位于另一个帐户中,则源必须通过共享访问签名公开或进行身份验证。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。