登录控制台
Amazon ECR
用户指南 (API 版本 2015-09-21)
AWS 文档 » Amazon EC2 Container Registry » 用户指南 » 映像 » 映像标签可变性
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

映像标签可变性

您可以将存储库配置为不可变，以防止覆盖映像标签。为存储库配置了不可变标签后，如果您尝试推送某个映像但其标签在存储库中已存在时，将返回 ImageTagAlreadyExistsException 错误。

使用 AWS 管理控制台和 AWS CLI 工具，您可以在新存储库的创建期间或者随时为现有存储库设置映像标签的可变性。对于控制台步骤，请参阅创建存储库和编辑存储库。

创建配置有不可变标签的存储库

使用以下命令之一创建配置有不可变标签的新映像存储库。

  • create-repository (AWS CLI) 

    aws ecr create-repository --repository-name name --image-tag-mutability IMMUTABLE --region us-east-2

  • New-ECRRepository (适用于 Windows PowerShell 的 AWS 工具) 

    New-ECRRepository -RepositoryName name -ImageTagMutability IMMUTABLE -Region us-east-2 -Force

更新现有存储库的映像标签可变性设置

使用以下命令之一更新现有存储库的映像标签可变性设置。

  • put-image-tag-mutability (AWS CLI) 

    aws ecr put-image-tag-mutability --repository-name name --image-tag-mutability IMMUTABLE --region us-east-2

  • Write-ECRImageTagMutability (适用于 Windows PowerShell 的 AWS 工具) 

    Write-ECRImageTagMutability -RepositoryName name -ImageTagMutability IMMUTABLE -Region us-east-2 -Force