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

az acr manifest

此命令组处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

管理 Azure 容器注册表中的项目清单。

命令

名称	说明	类型	Status
az acr manifest delete	删除Azure 容器注册表中的清单。	核心	预览
az acr manifest list	列出Azure 容器注册表存储库中的清单。	核心	预览
az acr manifest list-deleted	列出Azure 容器注册表存储库中的软删除清单。	核心	预览
az acr manifest list-deleted-tags	列出Azure 容器注册表存储库中的软删除标记。	核心	预览
az acr manifest list-metadata	列出Azure 容器注册表存储库中清单的元数据。	核心	预览
az acr manifest list-referrers	列出Azure 容器注册表中清单的引用者。	核心	预览版
az acr manifest metadata	管理 Azure 容器注册表中的项目清单元数据。	核心	预览和弃用
az acr manifest metadata list	列出Azure 容器注册表存储库中清单的元数据。	核心	预览和弃用
az acr manifest metadata show	获取Azure 容器注册表中的项目的元数据。	核心	预览和弃用
az acr manifest metadata update	更新Azure 容器注册表中项目的清单元数据。	核心	预览和弃用
az acr manifest restore	还原Azure 容器注册表中的软删除项目和标记。	核心	预览版
az acr manifest show	获取Azure 容器注册表中的清单。	核心	预览
az acr manifest show-metadata	获取Azure 容器注册表中的项目的元数据。	核心	预览
az acr manifest update-metadata	更新Azure 容器注册表中项目的清单元数据。	核心	预览版

az acr manifest delete

预览

命令组“acr 清单”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

删除Azure 容器注册表中的清单。

az acr manifest delete [--name]
                       [--password]
                       [--registry]
                       [--suffix]
                       [--username]
                       [--yes]
                       [<MANIFEST_ID>]

示例

删除项目“hello-world：latest”的清单。

az acr manifest delete -r myregistry -n hello-world:latest

删除项目“hello-world：latest”的清单。

az acr manifest delete myregistry.azurecr.io/hello-world:latest

删除摘要“hello-world@sha256：abc123”引用的项目清单。

az acr manifest delete -r myregistry -n hello-world@sha256:abc123

可选参数

--name -n

项目的名称。 可以包含格式为“name：tag”的标记，或格式为“name@digest”的摘要。

--password -p

用于登录到容器注册表的密码。

--registry -r

容器注册表的名称。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

--suffix

注册表登录服务器中的租户后缀。 如果注册表登录服务器的格式为“registry-tenant.azurecr.io”，则可以指定“--suffix tenant”。 如果从其他订阅访问注册表，或者你有权访问映像，但无权管理注册表资源，则适用。

--username -u

用于登录到容器注册表的用户名。

--yes -y

不提示确认。

默认值: False

<MANIFEST_ID>

完全限定的清单说明符，例如“myregistry.azurecr.io/hello-world:latest”。

全局参数

--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 acr manifest list

预览

命令组“acr 清单”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

列出Azure 容器注册表存储库中的清单。

az acr manifest list [--name]
                     [--orderby {time_asc, time_desc}]
                     [--password]
                     [--registry]
                     [--suffix]
                     [--top]
                     [--username]
                     [<REPO_ID>]

示例

列出存储库“hello-world”的清单。

az acr manifest list -r myregistry -n hello-world

列出存储库“hello-world”的清单。

az acr manifest list myregistry.azurecr.io/hello-world

可选参数

--name -n

存储库的名称。

--orderby

对结果中的项进行排序。 默认为名称的字母顺序。

接受的值: time_asc, time_desc

--password -p

用于登录到容器注册表的密码。

--registry -r

容器注册表的名称。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

--suffix

注册表登录服务器中的租户后缀。 如果注册表登录服务器的格式为“registry-tenant.azurecr.io”，则可以指定“--suffix tenant”。 如果从其他订阅访问注册表，或者你有权访问映像，但无权管理注册表资源，则适用。

--top

限制结果中的项数。

--username -u

用于登录到容器注册表的用户名。

<REPO_ID>

完全限定的存储库说明符，例如“myregistry.azurecr.io/hello-world”。

全局参数

--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 acr manifest list-deleted

预览

命令组“acr 清单”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

列出Azure 容器注册表存储库中的软删除清单。

az acr manifest list-deleted [--name]
                             [--password]
                             [--registry]
                             [--suffix]
                             [--username]
                             [<REPO_ID>]

示例

列出存储库“hello-world”中的软删除清单。

az acr manifest list-deleted -r myregistry -n hello-world

列出存储库“hello-world”中的软删除清单。

az acr manifest list-deleted myregistry.azurecr.io/hello-world

可选参数

--name -n

存储库的名称。

--password -p

用于登录到容器注册表的密码。

--registry -r

容器注册表的名称。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

--suffix

注册表登录服务器中的租户后缀。 如果注册表登录服务器的格式为“registry-tenant.azurecr.io”，则可以指定“--suffix tenant”。 如果从其他订阅访问注册表，或者你有权访问映像，但无权管理注册表资源，则适用。

--username -u

用于登录到容器注册表的用户名。

<REPO_ID>

完全限定的存储库说明符，例如“myregistry.azurecr.io/hello-world”。

全局参数

--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 acr manifest list-deleted-tags

预览

命令组“acr 清单”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

列出Azure 容器注册表存储库中的软删除标记。

az acr manifest list-deleted-tags [--name]
                                  [--password]
                                  [--registry]
                                  [--suffix]
                                  [--username]
                                  [<PERM_REPO_ID>]

示例

列出存储库“hello-world”中的软删除标记。

az acr manifest list-deleted-tags -r myregistry -n hello-world

列出存储库“hello-world”中的软删除标记。

az acr manifest list-deleted-tags myregistry.azurecr.io/hello-world

列出与存储库“hello-world”中的标记“latest”匹配的软删除标记。

az acr manifest list-deleted-tags -r myregistry -n hello-world:latest

列出与存储库“hello-world”中的标记“latest”匹配的软删除标记。

az acr manifest list-deleted-tags myregistry.azurecr.io/hello-world:latest

可选参数

--name -n

存储库的名称。 可以包含格式为“name：tag”的标记。

--password -p

用于登录到容器注册表的密码。

--registry -r

容器注册表的名称。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

--suffix

注册表登录服务器中的租户后缀。 如果注册表登录服务器的格式为“registry-tenant.azurecr.io”，则可以指定“--suffix tenant”。 如果从其他订阅访问注册表，或者你有权访问映像，但无权管理注册表资源，则适用。

--username -u

用于登录到容器注册表的用户名。

<PERM_REPO_ID>

完全限定的存储库说明符，例如“myregistry.azurecr.io/hello-world”。 可能包括一个标记，例如 myregistry.azurecr.io/hello-world:latest。

全局参数

--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 acr manifest list-metadata

预览

命令组“acr 清单”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

列出Azure 容器注册表存储库中清单的元数据。

az acr manifest list-metadata [--name]
                              [--orderby {time_asc, time_desc}]
                              [--password]
                              [--registry]
                              [--suffix]
                              [--top]
                              [--username]
                              [<REPO_ID>]

示例

列出存储库“hello-world”中清单的元数据。

az acr manifest list-metadata -r myregistry -n hello-world

列出存储库“hello-world”中清单的元数据。

az acr manifest list-metadata myregistry.azurecr.io/hello-world

可选参数

--name -n

存储库的名称。

--orderby

对结果中的项进行排序。 默认为名称的字母顺序。

接受的值: time_asc, time_desc

--password -p

用于登录到容器注册表的密码。

--registry -r

容器注册表的名称。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

--suffix

注册表登录服务器中的租户后缀。 如果注册表登录服务器的格式为“registry-tenant.azurecr.io”，则可以指定“--suffix tenant”。 如果从其他订阅访问注册表，或者你有权访问映像，但无权管理注册表资源，则适用。

--top

限制结果中的项数。

--username -u

用于登录到容器注册表的用户名。

<REPO_ID>

完全限定的存储库说明符，例如“myregistry.azurecr.io/hello-world”。

全局参数

--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 acr manifest list-referrers

预览

命令组“acr 清单”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

列出Azure 容器注册表中清单的引用者。

az acr manifest list-referrers [--artifact-type]
                               [--name]
                               [--password]
                               [--recursive]
                               [--registry]
                               [--suffix]
                               [--username]
                               [<MANIFEST_ID>]

示例

列出项目“hello-world：latest”清单的引用者。

az acr manifest list-referrers -r myregistry -n hello-world:latest

列出项目“hello-world：latest”清单的引用者。

az acr manifest list-referrers myregistry.azurecr.io/hello-world:latest

列出摘要“hello-world@sha256：abc123”引用的项目清单。

az acr manifest list-referrers -r myregistry -n hello-world@sha256:abc123

可选参数

--artifact-type

基于项目类型筛选引用者。

--name -n

项目的名称。 可以包含格式为“name：tag”的标记，或格式为“name@digest”的摘要。

--password -p

用于登录到容器注册表的密码。

--recursive

以递归方式包含引用器项目。

默认值: False

--registry -r

容器注册表的名称。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

--suffix

注册表登录服务器中的租户后缀。 如果注册表登录服务器的格式为“registry-tenant.azurecr.io”，则可以指定“--suffix tenant”。 如果从其他订阅访问注册表，或者你有权访问映像，但无权管理注册表资源，则适用。

--username -u

用于登录到容器注册表的用户名。

<MANIFEST_ID>

完全限定的清单说明符，例如“myregistry.azurecr.io/hello-world:latest”。

全局参数

--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 acr manifest restore

预览

命令组“acr 清单”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

还原Azure 容器注册表中的软删除项目和标记。

az acr manifest restore [--digest]
                        [--force]
                        [--name]
                        [--password]
                        [--registry]
                        [--suffix]
                        [--username]
                        [--yes]
                        [<MANIFEST_ID>]

示例

使用存储库“hello-world”中的标记“latest”还原清单匹配摘要“sha256：abc123”。

az acr manifest restore -r myregistry -n hello-world:latest -d sha256:abc123

使用存储库“hello-world”中的标记“latest”还原清单匹配摘要“sha256：abc123”。

az acr manifest restore myregistry.azurecr.io/hello-world:latest -d sha256:abc123

还原与存储库“hello-world”中的标记“latest”关联的最近删除的清单。

az acr manifest restore -r myregistry -n hello-world:latest

还原与存储库“hello-world”中的标记“latest”关联的最近删除的清单。

az acr manifest restore myregistry.azurecr.io/hello-world:latest

可选参数

--digest -d

清单的摘要，例如“sha256@abc123”。

--force -f

覆盖现有标记。

默认值: False

--name -n

项目的名称。 可以包含格式为“name：tag”的标记。

--password -p

用于登录到容器注册表的密码。

--registry -r

容器注册表的名称。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

--suffix

注册表登录服务器中的租户后缀。 如果注册表登录服务器的格式为“registry-tenant.azurecr.io”，则可以指定“--suffix tenant”。 如果从其他订阅访问注册表，或者你有权访问映像，但无权管理注册表资源，则适用。

--username -u

用于登录到容器注册表的用户名。

--yes -y

不提示确认。

默认值: False

<MANIFEST_ID>

完全限定的清单说明符，例如“myregistry.azurecr.io/hello-world:latest”。

全局参数

--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 acr manifest show

预览

命令组“acr 清单”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

获取Azure 容器注册表中的清单。

az acr manifest show [--name]
                     [--password]
                     [--raw]
                     [--registry]
                     [--suffix]
                     [--username]
                     [<MANIFEST_ID>]

示例

获取项目“hello-world：latest”的清单。

az acr manifest show -r myregistry -n hello-world:latest

获取项目“hello-world：latest”的清单。

az acr manifest show myregistry.azurecr.io/hello-world:latest

获取摘要“hello-world@sha256：abc123”引用的项目清单。

az acr manifest show -r myregistry -n hello-world@sha256:abc123

获取项目“hello-world：latest”的原始未格式化清单。

az acr manifest show -r myregistry -n hello-world:latest --raw

可选参数

--name -n

项目的名称。 可以包含格式为“name：tag”的标记，或格式为“name@digest”的摘要。

--password -p

用于登录到容器注册表的密码。

--raw

输出没有格式的原始清单文本。

--registry -r

容器注册表的名称。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

--suffix

注册表登录服务器中的租户后缀。 如果注册表登录服务器的格式为“registry-tenant.azurecr.io”，则可以指定“--suffix tenant”。 如果从其他订阅访问注册表，或者你有权访问映像，但无权管理注册表资源，则适用。

--username -u

用于登录到容器注册表的用户名。

<MANIFEST_ID>

完全限定的清单说明符，例如“myregistry.azurecr.io/hello-world:latest”。

全局参数

--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 acr manifest show-metadata

预览

命令组“acr 清单”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

获取Azure 容器注册表中的项目的元数据。

az acr manifest show-metadata [--name]
                              [--password]
                              [--registry]
                              [--suffix]
                              [--username]
                              [<MANIFEST_ID>]

示例

获取标记“hello-world：latest”的元数据。

az acr manifest show-metadata -r myregistry -n hello-world:latest

获取标记“hello-world：latest”的元数据。

az acr manifest show-metadata myregistry.azurecr.io/hello-world:latest

获取摘要“hello-world@sha256：abc123”引用的清单的元数据。

az acr manifest show-metadata -r myregistry -n hello-world@sha256:abc123

可选参数

--name -n

项目的名称。 可以包含格式为“name：tag”的标记，或格式为“name@digest”的摘要。

--password -p

用于登录到容器注册表的密码。

--registry -r

容器注册表的名称。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

--suffix

注册表登录服务器中的租户后缀。 如果注册表登录服务器的格式为“registry-tenant.azurecr.io”，则可以指定“--suffix tenant”。 如果从其他订阅访问注册表，或者你有权访问映像，但无权管理注册表资源，则适用。

--username -u

用于登录到容器注册表的用户名。

<MANIFEST_ID>

完全限定的清单说明符，例如“myregistry.azurecr.io/hello-world:latest”。

全局参数

--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 acr manifest update-metadata

预览

命令组“acr 清单”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

更新Azure 容器注册表中项目的清单元数据。

az acr manifest update-metadata [--delete-enabled {false, true}]
                                [--list-enabled {false, true}]
                                [--name]
                                [--password]
                                [--read-enabled {false, true}]
                                [--registry]
                                [--suffix]
                                [--username]
                                [--write-enabled {false, true}]
                                [<MANIFEST_ID>]

示例

更新标记“hello-world：latest”的元数据。

az acr manifest update-metadata -r myregistry -n hello-world:latest --write-enabled false

更新标记“hello-world：latest”的元数据。

az acr manifest update-metadata myregistry.azurecr.io/hello-world:latest --write-enabled false

更新摘要“hello-world@sha256：abc123”引用的项目的元数据。

az acr manifest update-metadata -r myregistry -n hello-world@sha256:abc123 --write-enabled false

可选参数

--delete-enabled

指示是否允许删除操作。

接受的值: false, true

--list-enabled

指示此项是否显示在列表操作结果中。

接受的值: false, true

--name -n

项目的名称。 可以包含格式为“name：tag”的标记，或格式为“name@digest”的摘要。

--password -p

用于登录到容器注册表的密码。

--read-enabled

指示是否允许读取操作。

接受的值: false, true

--registry -r

容器注册表的名称。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

--suffix

注册表登录服务器中的租户后缀。 如果注册表登录服务器的格式为“registry-tenant.azurecr.io”，则可以指定“--suffix tenant”。 如果从其他订阅访问注册表，或者你有权访问映像，但无权管理注册表资源，则适用。

--username -u

用于登录到容器注册表的用户名。

--write-enabled

指示是否允许写入或删除操作。

接受的值: false, true

<MANIFEST_ID>

完全限定的清单说明符，例如“myregistry.azurecr.io/hello-world:latest”。

全局参数

--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 获取完整的调试日志。