通过

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

az acr cache

管理Azure容器注册表中的缓存规则。

命令

名称 说明 类型 Status
az acr cache create

创建缓存规则。

 Core GA
az acr cache delete

删除缓存规则。

 Core GA
az acr cache list

列出Azure 容器注册表中的缓存规则。

 Core GA
az acr cache show

显示缓存规则。

 Core GA
az acr cache update

更新缓存规则上的凭据集。

 Core GA

az acr cache create

编辑

创建缓存规则。

az acr cache create --name
                    --registry
                    --source-repo
                    --target-repo
                    [--acquire-policy-token]
                    [--change-reference]
                    [--cred-set]
                    [--identity]
                    [--resource-group]

示例

创建没有凭据集的缓存规则。

az acr cache create -r myregistry -n MyRule -s docker.io/library/ubuntu -t ubuntu

使用凭据集创建缓存规则。

az acr cache create -r myregistry -n MyRule -s docker.io/library/ubuntu -t ubuntu -c MyCredSet

必需参数

--name -n

缓存规则的名称。

--registry -r

容器注册表的名称。 它应以小写形式指定。 可以使用 az configure --defaults acr=<registry name>配置默认注册表名称。

--source-repo -s

完整的源存储库路径，例如“docker.io/library/ubuntu”。

--target-repo -t

目标存储库命名空间，例如“ubuntu”。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--cred-set -c

凭据集的名称。

--identity

ACR 的用户分配的托管标识资源 ID，用于向上游注册表进行身份验证。 格式：/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft。ManagedIdentity/userAssignedIdentities/{identityName}。

--resource-group -g

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

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az acr cache delete

编辑

删除缓存规则。

az acr cache delete --name
                    --registry
                    [--acquire-policy-token]
                    [--change-reference]
                    [--resource-group]
                    [--yes]

示例

删除缓存规则。

az acr cache delete -r myregistry -n MyRule

必需参数

--name -n

缓存规则的名称。

--registry -r

容器注册表的名称。 它应以小写形式指定。 可以使用 az configure --defaults acr=<registry name>配置默认注册表名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--resource-group -g

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

--yes -y

不要提示确认。

属性 值
默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az acr cache list

编辑

列出Azure 容器注册表中的缓存规则。

az acr cache list --registry
                  [--resource-group]

示例

列出Azure 容器注册表中的缓存规则。

az acr cache list -r myregistry

必需参数

--registry -r

容器注册表的名称。 它应以小写形式指定。 可以使用 az configure --defaults acr=<registry name>配置默认注册表名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--resource-group -g

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

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az acr cache show

编辑

显示缓存规则。

az acr cache show --name
                  --registry
                  [--resource-group]

示例

显示缓存规则。

az acr cache show -r myregistry -n MyRule

必需参数

--name -n

缓存规则的名称。

--registry -r

容器注册表的名称。 它应以小写形式指定。 可以使用 az configure --defaults acr=<registry name>配置默认注册表名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--resource-group -g

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

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az acr cache update

编辑

更新缓存规则上的凭据集。

az acr cache update --name
                    --registry
                    [--acquire-policy-token]
                    [--add]
                    [--change-reference]
                    [--cred-set]
                    [--force-string]
                    [--identity]
                    [--remove]
                    [--remove-cred-set]
                    [--resource-group]
                    [--set]

示例

将凭据集更改或添加到现有缓存规则。

az acr cache update -r myregistry -n MyRule -c NewCredSet

从现有缓存规则中删除凭据集。

az acr cache update -r myregistry -n MyRule --remove-cred-set

必需参数

--name -n

缓存规则的名称。

--registry -r

容器注册表的名称。 它应以小写形式指定。 可以使用 az configure --defaults acr=<registry name>配置默认注册表名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--add

通过指定路径和键值对将对象添加到对象列表。 示例：--add property.listProperty <key=value, string or JSON string>。

属性 值
参数组: Generic Update Arguments
默认值: []
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--cred-set -c

凭据集的名称。

--force-string

使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。

属性 值
参数组: Generic Update Arguments
默认值: False
--identity

ACR 的用户分配的托管标识资源 ID，用于向上游注册表进行身份验证。 格式：/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft。ManagedIdentity/userAssignedIdentities/{identityName}。

--remove

从列表中删除属性或元素。 示例： --remove property.list <indexToRemove> OR --remove propertyToRemove.

属性 值
参数组: Generic Update Arguments
默认值: []
--remove-cred-set

可选布尔值，指示是否从缓存规则中删除凭据集。 默认情况下为 False。

属性 值
默认值: False
--resource-group -g

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

--set

通过指定要设置的属性路径和值来更新对象。 示例：--set property1.property2=<value>。

属性 值
参数组: Generic Update Arguments
默认值: []
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False