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

az containerapp registry

参考

注释

此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。安装每个扩展，使其受益于其扩展功能。了解更多关于扩展的相关信息。

用于管理容器注册表信息的命令。

命令

名称	说明	类型	Status
az containerapp registry list	列出容器应用中配置的容器注册表。	核心	GA
az containerapp registry remove	删除容器注册表的详细信息。	核心	GA
az containerapp registry set	添加或更新容器注册表的详细信息。	核心	GA
az containerapp registry set (containerapp 扩展)	添加或更新容器注册表的详细信息。	扩展	预览
az containerapp registry show	显示容器注册表的详细信息。	核心	GA

az containerapp registry list

编辑

列出容器应用中配置的容器注册表。

az containerapp registry list --name
                              --resource-group

示例

列出容器应用中配置的容器注册表。

az containerapp registry list -n my-containerapp -g MyResourceGroup

必需参数

--name -n

Containerapp 的名称。名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--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 containerapp registry remove

编辑

删除容器注册表的详细信息。

az containerapp registry remove --server
                                [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

示例

从 Containerapp 中删除注册表。

az containerapp registry remove -n my-containerapp -g MyResourceGroup --server MyContainerappRegistry.azurecr.io

必需参数

--server

容器注册表服务器，例如 myregistry.azurecr.io。

可选参数

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--name -n

Containerapp 的名称。名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--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 containerapp registry set

编辑

添加或更新容器注册表的详细信息。

az containerapp registry set --server
                             [--identity]
                             [--ids]
                             [--name]
                             [--password]
                             [--resource-group]
                             [--subscription]
                             [--username]

示例

将容器应用配置为使用注册表。

az containerapp registry set -n my-containerapp -g MyResourceGroup \
    --server MyExistingContainerappRegistry.azurecr.io --username MyRegistryUsername --password MyRegistryPassword

必需参数

--server

容器注册表服务器，例如 myregistry.azurecr.io。

可选参数

--identity

要向Azure 容器注册表（而不是用户名/密码）进行身份验证的托管标识。将“system”用于系统定义的标识或用户定义的标识的资源 ID。在部署之前，应为托管标识分配 ACR 的 acrpull 权限（使用“az role assignment create --role acrpull ...”）。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--name -n

Containerapp 的名称。名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--password

注册表的密码。如果使用 Azure 容器注册表，我们将尝试推断凭据（如果未提供）。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--username

注册表的用户名。如果使用 Azure 容器注册表，我们将尝试推断凭据（如果未提供）。

全局参数

--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 containerapp registry set (containerapp 扩展)

预览

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

添加或更新容器注册表的详细信息。

az containerapp registry set --server
                             [--identity]
                             [--ids]
                             [--name]
                             [--password]
                             [--resource-group]
                             [--subscription]
                             [--username]

示例

将容器应用配置为使用注册表。

az containerapp registry set -n my-containerapp -g MyResourceGroup \
    --server MyExistingContainerappRegistry.azurecr.io --username MyRegistryUsername --password MyRegistryPassword

将容器应用配置为使用环境系统分配的托管标识对 Azure 容器注册表进行身份验证。

az containerapp registry set -n my-containerapp -g MyResourceGroup \
    --server MyExistingContainerappRegistry.azurecr.io --identity system-environment

必需参数

--server

容器注册表服务器，例如 myregistry.azurecr.io。

可选参数

--identity

要向Azure 容器注册表（而不是用户名/密码）进行身份验证的托管标识。对系统定义的标识使用“system”，对环境级别系统定义标识使用“system-environment”，或者为用户定义的环境/containerapp 级别标识使用资源 ID。在部署之前，应为托管标识分配 ACR 的 acrpull 权限（使用“az role assignment create --role acrpull ...”）。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--name -n

Containerapp 的名称。名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--password

注册表的密码。如果使用 Azure 容器注册表，我们将尝试推断凭据（如果未提供）。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--username

注册表的用户名。如果使用 Azure 容器注册表，我们将尝试推断凭据（如果未提供）。

全局参数

--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 containerapp registry show

编辑

显示容器注册表的详细信息。

az containerapp registry show --server
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

示例

显示容器注册表的详细信息。

az containerapp registry show -n my-containerapp -g MyResourceGroup --server MyContainerappRegistry.azurecr.io

必需参数

--server

容器注册表服务器，例如 myregistry.azurecr.io。

可选参数

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--name -n

Containerapp 的名称。名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--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 containerapp registry

命令

az containerapp registry list

示例

必需参数

az containerapp registry remove

示例

必需参数

可选参数

az containerapp registry set

示例

必需参数

可选参数

az containerapp registry set (containerapp 扩展)

示例

必需参数

可选参数

az containerapp registry show

示例

必需参数

可选参数

其他资源