你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

azcopy set-properties

给定位置后,更改该存储(blob 或文件)的所有有效系统属性。

摘要

azcopy set-properties [resourceURL] [flags]

设置 Blob 和文件存储的属性。 此命令当前支持的属性包括:

  • Blob -> 层、元数据、标记
  • Data Lake Storage Gen2 -> 层、元数据、标记
  • 文件 -> 元数据

注意

Data Lake Storage Gen2 终结点将替换为 Blob 存储终结点。

有关详细信息,请参阅示例。

示例

将 Blob 层更改为热层:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot

将 Blob 层更改为冷层:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cold

将 Blob 层从热层更改为存档:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=archive

将 Blob 层从存档层更改为冷层,并将解除冻结优先级设置为高:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high

将 blob 层从冷层更改为热层,并将优先级设置为标准:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot --rehydrate-priority=standard

将目录中所有文件的层更改为存档层:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true

更改页 Blob 的层:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --page-blob-tier=[P10/P15/P20/P30/P4/P40/P50/P6]--rehydrate-priority=[Standard/High]

将 blob 的元数据更改为 {key = "abc", val = "def"} 和 {key = "ghi", val = "jkl"}:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=abc=def;ghi=jkl

将目录中所有文件的元数据更改为 {key = "abc", val = "def"} 和 {key = "ghi", val = "jkl"}:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --metadata=abc=def;ghi=jkl --recursive=true

清除 blob 的所有现有元数据:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=clear

清除所有文件中的所有现有元数据:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --recursive --metadata=clear

将 blob 的 blob-tags 更改为 {key = "abc", val = "def"} 和 {key = "ghi", val = "jkl"}:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=abc=def&ghi=jkl

在 blob 上设置标记时,SAS 还有其他权限(标记为“t”)。 如果没有这些标记,服务将返回授权错误。

清除 blob 的所有现有 blob 标记:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear

在 blob 上设置标记时,SAS 还有其他权限(标记为“t”)。 如果没有这些标记,服务将返回授权错误。

选项

--blob-tags 字符串在 Blob 上设置标记以对存储帐户中的数据进行分类(由“&”分隔)

--block-blob-tier 字符串将 blob 的访问层更改为给定层(默认值为“None”)

--dry-run 打印受此命令影响的文件路径。 此标记不会影响实际文件。

--exclude-path 字符串在移除时排除这些路径。 此选项不支持通配符 (*)。 检查相对路径前缀。 例如:myFolder;myFolder/subDirName/file.pdf

--exclude-pattern 字符串排除名称与模式列表相匹配的文件。 例如: .jpg; .pdf;exactName

--from-to 字符串(可选)指定源目标组合。 有效值:BlobNone、FileNone、BlobFSNone

有关 set-properties 的 -h--help 帮助

--include-path 字符串在设置属性时仅包括这些路径。 此选项不支持通配符 (*)。 检查相对路径前缀。 例如:myFolder;myFolder/subDirName/file.pdf

--include-pattern 字符串仅包括名称与模式列表相匹配的文件。 例如: .jpg; .pdf;exactName

--list-of-files 字符串定义文本文件的位置,该文件包含要复制的文件的列表。

--metadata 字符串使用这些键值对(由“;”分隔)将给定位置设置为元数据。

--page-blob-tier 字符串使用此 blob 层将页 blob 上传到 Azure 存储。 (默认值为“None”)。 (默认值为“None”)

--recursive 从本地文件系统上传时以递归方式检查子目录。

--rehydrate-priority 字符串可选标记,用于设置解除冻结的解除冻结优先级。 有效值:Standard、High。 Default- standard(默认“Standard”)

从父命令继承的选项

--cap-mbps float限定传输速率,以 Mbps(兆位/秒)为单位。 瞬间吞吐量可能与上限略有不同。 如果此选项设置为零或被省略,则吞吐量不受限制。

--log-level(字符串)定义日志文件的日志详细程度,可用级别:INFO(所有请求/响应)、WARNING(响应缓慢)、ERROR(仅限失败的请求)和 NONE(无输出日志)。 (默认值为“INFO”)。 (默认值为“INFO”)

--output-type(字符串)命令输出的格式。 选项包括:text、json。 默认值为“text”。 (默认值为“text”)

--output-level(字符串)定义输出详细程度。 可用级别:essential、quiet。 (默认值“default”)

--trusted-microsoft-suffixes(字符串)指定可在其中发送 Microsoft Entra ID 登录令牌的其他域后缀。 默认值为“.core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net”。 此处列出的任何内容都会添加到默认值。 为安全起见,应只在此处放置 Microsoft Azure 域。 用分号分隔多个条目。

另请参阅