Registos Microsoft.ContainerRegistry

Definição de recursos do bíceps

O tipo de recurso de registros pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Exemplos de uso

Amostras de bíceps

Um exemplo básico de implementação do Azure Container Registry.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource registry 'Microsoft.ContainerRegistry/registries@2021-08-01-preview' = {
  name: resourceName
  location: location
  sku: {
    name: 'Standard'
    tier: 'Standard'
  }
  properties: {
    adminUserEnabled: false
    anonymousPullEnabled: false
    dataEndpointEnabled: false
    encryption: {
      status: 'disabled'
    }
    networkRuleBypassOptions: 'AzureServices'
    policies: {
      exportPolicy: {
        status: 'enabled'
      }
      quarantinePolicy: {
        status: 'disabled'
      }
      retentionPolicy: {
        status: 'disabled'
      }
      trustPolicy: {
        status: 'disabled'
      }
    }
    publicNetworkAccess: 'Enabled'
    zoneRedundancy: 'Disabled'
  }
}

Módulos verificados do Azure

Os seguintes Azure Módulos Verificados podem ser usados para implementar este tipo de recurso.

Módulo Descrição
Registo de Contêineres do Azure (ACR) AVM Resource Module for Azure Container Registry (ACR)

Exemplos de início rápido do Azure

Os seguintes modelos Azure Quickstart contêm amostras de Bicep para a implementação deste tipo de recurso.

Arquivo Bicep Descrição
AKS Cluster com um NAT Gateway e um Application Gateway Este exemplo mostra como implementar um cluster AKS com NAT Gateway para ligações de saída e um Application Gateway para ligações de entrada.
AKS com o controlador Application Gateway Ingress Este exemplo mostra como implementar um cluster AKS com Application Gateway, Application Gateway Ingress Controller, Azure Container Registry, Log Analytics e Key Vault
Azure AI Foundry configuração básica Este conjunto de modelos demonstra como configurar o Azure AI Foundry com a configuração básica, ou seja, com acesso público à internet ativado, chaves geridas pela Microsoft para encriptação e configuração de identidade gerida pela Microsoft para o recurso de IA.
Azure AI Foundry configuração básica Este conjunto de modelos demonstra como configurar o Azure AI Foundry com a configuração básica, ou seja, com acesso público à internet ativado, chaves geridas pela Microsoft para encriptação e configuração de identidade gerida pela Microsoft para o recurso de IA.
Azure AI Foundry Rede Restrita Este conjunto de modelos demonstra como configurar o Azure AI Foundry com o private link and egress desativado, usando chaves geridas pela Microsoft para encriptação e configuração de identidade gerida pela Microsoft para o recurso de IA.
Azure AI Foundry com autenticação Microsoft Entra ID Este conjunto de modelos demonstra como configurar o Azure AI Foundry com autenticação Microsoft Entra ID para recursos dependentes, como Azure AI Services e Armazenamento do Azure.
Azure AI Studio configuração básica Este conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com acesso público à internet ativado, chaves geridas pela Microsoft para encriptação e configuração de identidade gerida pela Microsoft para o recurso de IA.
Azure Rede AI Studio Restrita Este conjunto de modelos demonstra como configurar o Azure AI Studio com o private link and egress desativado, usando chaves geridas pela Microsoft para encriptação e configuração de identidade gerida pela Microsoft para o recurso de IA.
Azure Container Registry com Modelo de Geo-replicação Um modelo para criar um novo Azure Container Registry com geo-replicação
Azure Container Registry com Políticas e Diagnósticos Azure Container Registry with Policies and Diagnostics (bíceps)
Azure Machine Learning configuração segura de ponta a ponta Este conjunto de modelos Bicep demonstra como configurar o Azure Machine Learning de ponta a ponta numa configuração segura. Esta implementação de referência inclui o espaço de trabalho, um cluster de computação, instância de computação e cluster AKS privado anexado.
Azure Machine Learning configuração segura de ponta a ponta (legacy) Este conjunto de modelos Bicep demonstra como configurar o Azure Machine Learning de ponta a ponta numa configuração segura. Esta implementação de referência inclui o espaço de trabalho, um cluster de computação, instância de computação e cluster AKS privado anexado.
Build imagens de contentores com ACR Tasks Este modelo usa DeploymentScript para orquestrar o ACR para criar sua imagem de contêiner a partir do repositório de código.
Criar um destino de computação AKS com um endereço IP privado Este modelo cria um alvo de computação AKS num dado espaço de trabalho do serviço Azure Machine Learning com um endereço IP privado.
Criar um espaço de trabalho de Azure Machine Learning serviço Este modelo de implementação especifica um espaço de trabalho Azure Machine Learning e os seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicação Azure Insights e Azure Container Registry. Esta configuração descreve o conjunto mínimo de recursos que necessita para get started com o Azure Machine Learning.
Criar um espaço de trabalho de Azure Machine Learning serviços (CMK) Este modelo de implementação especifica como criar um espaço de trabalho Azure Machine Learning com encriptação do lado do serviço usando as suas chaves de encriptação.
Criar um espaço de trabalho de Azure Machine Learning serviços (CMK) Este modelo de implementação especifica um espaço de trabalho Azure Machine Learning e os seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicação Azure Insights e Azure Container Registry. O exemplo mostra como configurar o Azure Machine Learning para encriptação com uma chave de encriptação gerida pelo cliente.
Criar um espaço de trabalho de Azure Machine Learning serviço (legacy) Este modelo de implementação especifica um espaço de trabalho Azure Machine Learning e os seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicação Azure Insights e Azure Container Registry. Esta configuração descreve o conjunto de recursos de que necessita para get started com Azure Machine Learning numa configuração isolada em rede.
Criar um espaço de trabalho de Azure Machine Learning serviço (vnet) Este modelo de implementação especifica um espaço de trabalho Azure Machine Learning e os seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicação Azure Insights e Azure Container Registry. Esta configuração descreve o conjunto de recursos de que necessita para get started com Azure Machine Learning numa configuração isolada em rede.
Cria uma aplicação de contentor e um ambiente com Registry Crie um Ambiente de Aplicação Container com uma Aplicação Container básica a partir de um Azure Container Registry. Ele também implanta um espaço de trabalho do Log Analytics para armazenar logs.
Cria uma aplicação de Servicebus pub-sub Dapr usando Aplicações Container Crie um aplicativo de barramento de serviço pub-sub Dapr usando Aplicativos de Contêiner.
Deploy Secure AI Foundry com um virtual network Este modelo cria um ambiente Azure AI Foundry seguro, com restrições robustas de segurança de rede e identidade.
Importar Imagens de Contentores para ACR Este modelo utiliza o módulo Import ACR do registo bicep para importar imagens de contentores públicos para um Azure Container Registry.
Modelo Azure Container Registry simples Um modelo para criar um novo Azure Container Registry.

Formato do recurso

Para criar um recurso Microsoft.ContainerRegistry/registries , adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.ContainerRegistry/registries@2026-09-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    adminUserEnabled: bool
    anonymousPullEnabled: bool
    autoGeneratedDomainNameLabelScope: 'string'
    dataEndpointEnabled: bool
    encryption: {
      keyVaultProperties: {
        identity: 'string'
        keyIdentifier: 'string'
      }
      status: 'string'
    }
    endpointProtocol: 'string'
    metadataSearch: 'string'
    networkRuleBypassAllowedForTasks: bool
    networkRuleBypassOptions: 'string'
    networkRuleSet: {
      defaultAction: 'string'
      ipRules: [
        {
          action: 'string'
          value: 'string'
        }
      ]
      virtualNetworkRules: [
        {
          action: 'string'
          virtualNetworkSubnetResourceId: 'string'
        }
      ]
    }
    policies: {
      azureADAuthenticationAsArmPolicy: {
        status: 'string'
      }
      exportPolicy: {
        status: 'string'
      }
      quarantinePolicy: {
        status: 'string'
      }
      retentionPolicy: {
        days: int
        status: 'string'
      }
      softDeletePolicy: {
        retentionDays: int
        status: 'string'
      }
      trustPolicy: {
        status: 'string'
        type: 'string'
      }
    }
    publicNetworkAccess: 'string'
    regionalEndpoints: 'string'
    roleAssignmentMode: 'string'
    writableCacheRepos: 'string'
    zoneRedundancy: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.ContainerRegistry/registries

Nome Descrição Valor
identidade A identidade do registro de contêiner. IdentityProperties
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 5
Comprimento máximo = 50
Padrão = ^[a-zA-Z0-9]*$ (obrigatório)
propriedades As propriedades do registro de contêiner. RegistryProperties
SKU A SKU do registro de contêiner. Sku (obrigatório)
etiquetas Tags de recursos Dicionário de nomes e valores de tags. Ver etiquetas nos modelos

AzureADAuthenticationAsArmPolicy

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

EncryptionProperty

Nome Descrição Valor
keyVaultPropriedades Propriedades do cofre de chaves. KeyVaultProperties
estado Indica se a criptografia está habilitada ou não para o registro de contêiner. 'deficientes'
'habilitado'

Política de Exportação

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

IdentityProperties

Nome Descrição Valor
tipo O tipo de identidade. 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
identidades atribuídas pelo utilizador A lista de identidades de usuário associadas ao recurso. A identidade do usuário
as referências de chave de dicionário serão ids de recurso ARM no formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.		 IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Nome Descrição Valor

IPRule

Nome Descrição Valor
ação A ação da regra ACL IP. 'Permitir'
valor Especifica o IP ou intervalo de IP no formato CIDR. Apenas o endereço IPV4 é permitido. string (obrigatório)

KeyVaultProperties

Nome Descrição Valor
identidade O ID do cliente da identidade que será usado para access key vault. cadeia (de caracteres)
keyIdentifier Key vault URI para acesso à chave de encriptação. cadeia (de caracteres)

NetworkRuleSet

Nome Descrição Valor
defaultAction A ação padrão de permitir ou negar quando nenhuma outra regra corresponder. 'Permitir'
'Negar' (obrigatório)
ipRegras As regras de ACL IP. IPRule[]
virtualNetworkRules A virtual network domina. VirtualNetworkRule []

Políticas

Nome Descrição Valor
azureADAuthenticationAsArmPolicy A política para usar Azure Resource Manager token de audiência para um registo de contentores. AzureADAuthenticationAsArmPolicy
exportPolicy A política de exportação para um registro de contêiner. Política de Exportação
quarentenaPolítica A política de quarentena para um registro de contêiner. QuarentenaPolítica
retençãoPolítica A política de retenção para um registro de contêiner. Política de retenção
softDeletePolítica A política de exclusão suave para um registro de contêiner. SoftDeletePolicy
Política de confiança A política de confiança de conteúdo para um registro de contêiner. Política de Confiança

QuarentenaPolítica

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

RegistryProperties

Nome Descrição Valor
adminUserEnabled O valor que indica se o usuário administrador está habilitado. Bool
anônimoPullEnabled Permite a extração em todo o Registro de clientes não autenticados. Bool
autoGeneratedDomainNameLabelScope Determina o escopo de reutilização do rótulo do nome de domínio. 'NoReuse'
'ResourceGroupReuse'
'SubscriptionReuse'
'InquilinoReutilização'
'Inseguro'
dataEndpointEnabled Habilite um único ponto de extremidade de dados por região para servir dados. Bool
cifragem As configurações de criptografia do registro de contêiner. EncryptionProperty
endpointProtocol O protocolo de conectividade para o registo, como IPv4 ou dual stack (IPv4 e IPv6). 'IPv4'
'IPv4AndIPv6'
metadadosPesquisa Determina se os artefacts do registo estão indexados para pesquisa de metadados. 'Desativado'
'Habilitado'
networkRuleBypassAllowedForTasks Se as Tarefas têm ou não permissão para ignorar as regras de rede para este registro de contêiner. Bool
networkRuleBypassOptions Se permitir que serviços Azure confiáveis tenham acesso a um registo restrito à rede. 'AzureServices'
'Nenhuma'
networkRuleSet A regra de rede definida para um registro de contêiner. NetworkRuleSet
Políticas As políticas para um registro de contêiner. Políticas
acesso à rede pública Se o acesso público à rede é permitido ou não para o registo de contentores. 'Desativado'
'Habilitado'
Extremos regionais Ative endpoints por região para aceder ao registo. 'Desativado'
'Habilitado'
roleAssignmentMode Determina o modo de atribuição de função do Registro. 'AbacRepositoryPermissions'
'LegacyRegistryPermissions'
writableCacheRepos Se deve permitir operações de cache que escrevem em repositórios deste registo. 'Desativado'
'Habilitado'
zonaRedundância Se a redundância de zona está ou não habilitada para este registro de contêiner 'Desativado'
'Habilitado'

Política de retenção

Nome Descrição Valor
Dias O número de dias para reter um manifesto não marcado após o qual ele é limpo. Int
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

Referência

Nome Descrição Valor
nome O nome SKU do registro de contêiner. Necessário para a criação do registro. 'Básico'
'Clássico'
'Premium'
'Standard' (obrigatório)

SoftDeletePolicy

Nome Descrição Valor
retentionDays O número de dias após os quais um item excluído suavemente é excluído permanentemente. Int
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

TrackedResourceTags

Nome Descrição Valor

Política de Confiança

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'
tipo O tipo de política de confiança. «Notariado»

UserIdentityProperties

Nome Descrição Valor

VirtualNetworkRule

Nome Descrição Valor
ação A ação da regra de rede virtual. 'Permitir'
virtualNetworkSubnetResourceId ID de recurso de uma sub-rede, por exemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}. string (obrigatório)

Definição de recurso de modelo ARM

O tipo de recurso de registros pode ser implantado com operações que visam:

Exemplos de uso

Modelos de Início Rápido do Azure

Os seguintes modelos Azure Quickstart implementam este tipo de recurso.

Modelo Descrição
AKS Cluster com um NAT Gateway e um Application Gateway

Implementar para Azure 		Este exemplo mostra como implementar um cluster AKS com NAT Gateway para ligações de saída e um Application Gateway para ligações de entrada.
AKS com o controlador Application Gateway Ingress

Implementar para Azure 		Este exemplo mostra como implementar um cluster AKS com Application Gateway, Application Gateway Ingress Controller, Azure Container Registry, Log Analytics e Key Vault
Azure AI Foundry configuração básica

Implementar para Azure 		Este conjunto de modelos demonstra como configurar o Azure AI Foundry com a configuração básica, ou seja, com acesso público à internet ativado, chaves geridas pela Microsoft para encriptação e configuração de identidade gerida pela Microsoft para o recurso de IA.
Azure AI Foundry configuração básica

Implementar para Azure 		Este conjunto de modelos demonstra como configurar o Azure AI Foundry com a configuração básica, ou seja, com acesso público à internet ativado, chaves geridas pela Microsoft para encriptação e configuração de identidade gerida pela Microsoft para o recurso de IA.
Azure AI Foundry Rede Restrita

Implementar para Azure 		Este conjunto de modelos demonstra como configurar o Azure AI Foundry com o private link and egress desativado, usando chaves geridas pela Microsoft para encriptação e configuração de identidade gerida pela Microsoft para o recurso de IA.
Azure AI Foundry com autenticação Microsoft Entra ID

Implementar para Azure 		Este conjunto de modelos demonstra como configurar o Azure AI Foundry com autenticação Microsoft Entra ID para recursos dependentes, como Azure AI Services e Armazenamento do Azure.
Azure AI Studio configuração básica

Implementar para Azure 		Este conjunto de modelos demonstra como configurar o Azure AI Studio com a configuração básica, ou seja, com acesso público à internet ativado, chaves geridas pela Microsoft para encriptação e configuração de identidade gerida pela Microsoft para o recurso de IA.
Azure Rede AI Studio Restrita

Implementar para Azure 		Este conjunto de modelos demonstra como configurar o Azure AI Studio com o private link and egress desativado, usando chaves geridas pela Microsoft para encriptação e configuração de identidade gerida pela Microsoft para o recurso de IA.
Azure Container Registry com Modelo de Geo-replicação

Implementar para Azure 		Um modelo para criar um novo Azure Container Registry com geo-replicação
Azure Container Registry com Políticas e Diagnósticos

Implementar para Azure 		Azure Container Registry with Policies and Diagnostics (bíceps)
Azure Machine Learning configuração segura de ponta a ponta

Implementar para Azure 		Este conjunto de modelos Bicep demonstra como configurar o Azure Machine Learning de ponta a ponta numa configuração segura. Esta implementação de referência inclui o espaço de trabalho, um cluster de computação, instância de computação e cluster AKS privado anexado.
Azure Machine Learning configuração segura de ponta a ponta (legacy)

Implementar para Azure 		Este conjunto de modelos Bicep demonstra como configurar o Azure Machine Learning de ponta a ponta numa configuração segura. Esta implementação de referência inclui o espaço de trabalho, um cluster de computação, instância de computação e cluster AKS privado anexado.
Build imagens de contentores com ACR Tasks

Implementar para Azure 		Este modelo usa DeploymentScript para orquestrar o ACR para criar sua imagem de contêiner a partir do repositório de código.
CI/CD usando Jenkins no Azure Container Service (AKS)

Implementar para Azure 		Os contêineres facilitam muito a criação e a implantação contínuas de seus aplicativos. Ao orquestrar a implementação desses contentores usando o Kubernetes no Azure Container Service, pode obter clusters de containers replicáveis e geríveis. Ao configurar uma compilação contínua para produzir suas imagens de contêiner e orquestração, você pode aumentar a velocidade e a confiabilidade de sua implantação.
Crie um Cluster AKS privado com uma Zona DNS Pública

Implementar para Azure 		Este exemplo mostra como implantar um cluster AKS privado com uma zona DNS pública.
Criar um destino de computação AKS com um endereço IP privado

Implementar para Azure 		Este modelo cria um alvo de computação AKS num dado espaço de trabalho do serviço Azure Machine Learning com um endereço IP privado.
Criar um espaço de trabalho de Azure Machine Learning serviço

Implementar para Azure 		Este modelo de implementação especifica um espaço de trabalho Azure Machine Learning e os seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicação Azure Insights e Azure Container Registry. Esta configuração descreve o conjunto mínimo de recursos que necessita para get started com o Azure Machine Learning.
Criar um espaço de trabalho de Azure Machine Learning serviços (CMK)

Implementar para Azure 		Este modelo de implementação especifica como criar um espaço de trabalho Azure Machine Learning com encriptação do lado do serviço usando as suas chaves de encriptação.
Criar um espaço de trabalho de Azure Machine Learning serviços (CMK)

Implementar para Azure 		Este modelo de implementação especifica um espaço de trabalho Azure Machine Learning e os seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicação Azure Insights e Azure Container Registry. O exemplo mostra como configurar o Azure Machine Learning para encriptação com uma chave de encriptação gerida pelo cliente.
Criar um espaço de trabalho de Azure Machine Learning serviço (legacy)

Implementar para Azure 		Este modelo de implementação especifica um espaço de trabalho Azure Machine Learning e os seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicação Azure Insights e Azure Container Registry. Esta configuração descreve o conjunto de recursos de que necessita para get started com Azure Machine Learning numa configuração isolada em rede.
Criar um espaço de trabalho de Azure Machine Learning serviço (vnet)

Implementar para Azure 		Este modelo de implementação especifica um espaço de trabalho Azure Machine Learning e os seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicação Azure Insights e Azure Container Registry. Esta configuração descreve o conjunto de recursos de que necessita para get started com Azure Machine Learning numa configuração isolada em rede.
Cria uma aplicação de contentor e um ambiente com Registry

Implementar para Azure 		Crie um Ambiente de Aplicação Container com uma Aplicação Container básica a partir de um Azure Container Registry. Ele também implanta um espaço de trabalho do Log Analytics para armazenar logs.
Cria uma aplicação de Servicebus pub-sub Dapr usando Aplicações Container

Implementar para Azure 		Crie um aplicativo de barramento de serviço pub-sub Dapr usando Aplicativos de Contêiner.
Deploy Secure AI Foundry com um virtual network

Implementar para Azure 		Este modelo cria um ambiente Azure AI Foundry seguro, com restrições robustas de segurança de rede e identidade.
Importar Imagens de Contentores para ACR

Implementar para Azure 		Este modelo utiliza o módulo Import ACR do registo bicep para importar imagens de contentores públicos para um Azure Container Registry.
Modelo Azure Container Registry simples

Implementar para Azure 		Um modelo para criar um novo Azure Container Registry.

Formato do recurso

Para criar um recurso Microsoft.ContainerRegistry/registries , adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.ContainerRegistry/registries",
  "apiVersion": "2026-09-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "adminUserEnabled": "bool",
    "anonymousPullEnabled": "bool",
    "autoGeneratedDomainNameLabelScope": "string",
    "dataEndpointEnabled": "bool",
    "encryption": {
      "keyVaultProperties": {
        "identity": "string",
        "keyIdentifier": "string"
      },
      "status": "string"
    },
    "endpointProtocol": "string",
    "metadataSearch": "string",
    "networkRuleBypassAllowedForTasks": "bool",
    "networkRuleBypassOptions": "string",
    "networkRuleSet": {
      "defaultAction": "string",
      "ipRules": [
        {
          "action": "string",
          "value": "string"
        }
      ],
      "virtualNetworkRules": [
        {
          "action": "string",
          "virtualNetworkSubnetResourceId": "string"
        }
      ]
    },
    "policies": {
      "azureADAuthenticationAsArmPolicy": {
        "status": "string"
      },
      "exportPolicy": {
        "status": "string"
      },
      "quarantinePolicy": {
        "status": "string"
      },
      "retentionPolicy": {
        "days": "int",
        "status": "string"
      },
      "softDeletePolicy": {
        "retentionDays": "int",
        "status": "string"
      },
      "trustPolicy": {
        "status": "string",
        "type": "string"
      }
    },
    "publicNetworkAccess": "string",
    "regionalEndpoints": "string",
    "roleAssignmentMode": "string",
    "writableCacheRepos": "string",
    "zoneRedundancy": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.ContainerRegistry/registries

Nome Descrição Valor
Versão da API A versão api 'Pré-visualização 2026-09-01'
identidade A identidade do registro de contêiner. IdentityProperties
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 5
Comprimento máximo = 50
Padrão = ^[a-zA-Z0-9]*$ (obrigatório)
propriedades As propriedades do registro de contêiner. RegistryProperties
SKU A SKU do registro de contêiner. Sku (obrigatório)
etiquetas Tags de recursos Dicionário de nomes e valores de tags. Ver etiquetas nos modelos
tipo O tipo de recurso 'Microsoft.ContainerRegistry/registros'

AzureADAuthenticationAsArmPolicy

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

EncryptionProperty

Nome Descrição Valor
keyVaultPropriedades Propriedades do cofre de chaves. KeyVaultProperties
estado Indica se a criptografia está habilitada ou não para o registro de contêiner. 'deficientes'
'habilitado'

Política de Exportação

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

IdentityProperties

Nome Descrição Valor
tipo O tipo de identidade. 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
identidades atribuídas pelo utilizador A lista de identidades de usuário associadas ao recurso. A identidade do usuário
as referências de chave de dicionário serão ids de recurso ARM no formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.		 IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Nome Descrição Valor

IPRule

Nome Descrição Valor
ação A ação da regra ACL IP. 'Permitir'
valor Especifica o IP ou intervalo de IP no formato CIDR. Apenas o endereço IPV4 é permitido. string (obrigatório)

KeyVaultProperties

Nome Descrição Valor
identidade O ID do cliente da identidade que será usado para access key vault. cadeia (de caracteres)
keyIdentifier Key vault URI para acesso à chave de encriptação. cadeia (de caracteres)

NetworkRuleSet

Nome Descrição Valor
defaultAction A ação padrão de permitir ou negar quando nenhuma outra regra corresponder. 'Permitir'
'Negar' (obrigatório)
ipRegras As regras de ACL IP. IPRule[]
virtualNetworkRules A virtual network domina. VirtualNetworkRule []

Políticas

Nome Descrição Valor
azureADAuthenticationAsArmPolicy A política para usar Azure Resource Manager token de audiência para um registo de contentores. AzureADAuthenticationAsArmPolicy
exportPolicy A política de exportação para um registro de contêiner. Política de Exportação
quarentenaPolítica A política de quarentena para um registro de contêiner. QuarentenaPolítica
retençãoPolítica A política de retenção para um registro de contêiner. Política de retenção
softDeletePolítica A política de exclusão suave para um registro de contêiner. SoftDeletePolicy
Política de confiança A política de confiança de conteúdo para um registro de contêiner. Política de Confiança

QuarentenaPolítica

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

RegistryProperties

Nome Descrição Valor
adminUserEnabled O valor que indica se o usuário administrador está habilitado. Bool
anônimoPullEnabled Permite a extração em todo o Registro de clientes não autenticados. Bool
autoGeneratedDomainNameLabelScope Determina o escopo de reutilização do rótulo do nome de domínio. 'NoReuse'
'ResourceGroupReuse'
'SubscriptionReuse'
'InquilinoReutilização'
'Inseguro'
dataEndpointEnabled Habilite um único ponto de extremidade de dados por região para servir dados. Bool
cifragem As configurações de criptografia do registro de contêiner. EncryptionProperty
endpointProtocol O protocolo de conectividade para o registo, como IPv4 ou dual stack (IPv4 e IPv6). 'IPv4'
'IPv4AndIPv6'
metadadosPesquisa Determina se os artefacts do registo estão indexados para pesquisa de metadados. 'Desativado'
'Habilitado'
networkRuleBypassAllowedForTasks Se as Tarefas têm ou não permissão para ignorar as regras de rede para este registro de contêiner. Bool
networkRuleBypassOptions Se permitir que serviços Azure confiáveis tenham acesso a um registo restrito à rede. 'AzureServices'
'Nenhuma'
networkRuleSet A regra de rede definida para um registro de contêiner. NetworkRuleSet
Políticas As políticas para um registro de contêiner. Políticas
acesso à rede pública Se o acesso público à rede é permitido ou não para o registo de contentores. 'Desativado'
'Habilitado'
Extremos regionais Ative endpoints por região para aceder ao registo. 'Desativado'
'Habilitado'
roleAssignmentMode Determina o modo de atribuição de função do Registro. 'AbacRepositoryPermissions'
'LegacyRegistryPermissions'
writableCacheRepos Se deve permitir operações de cache que escrevem em repositórios deste registo. 'Desativado'
'Habilitado'
zonaRedundância Se a redundância de zona está ou não habilitada para este registro de contêiner 'Desativado'
'Habilitado'

Política de retenção

Nome Descrição Valor
Dias O número de dias para reter um manifesto não marcado após o qual ele é limpo. Int
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

Referência

Nome Descrição Valor
nome O nome SKU do registro de contêiner. Necessário para a criação do registro. 'Básico'
'Clássico'
'Premium'
'Standard' (obrigatório)

SoftDeletePolicy

Nome Descrição Valor
retentionDays O número de dias após os quais um item excluído suavemente é excluído permanentemente. Int
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

TrackedResourceTags

Nome Descrição Valor

Política de Confiança

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'
tipo O tipo de política de confiança. «Notariado»

UserIdentityProperties

Nome Descrição Valor

VirtualNetworkRule

Nome Descrição Valor
ação A ação da regra de rede virtual. 'Permitir'
virtualNetworkSubnetResourceId ID de recurso de uma sub-rede, por exemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}. string (obrigatório)

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso de registros pode ser implantado com operações que visam:

  • Grupos de recursos Para uma lista das propriedades alteradas em cada versão da API, veja registo de alterações.

Exemplos de uso

Amostras Terraform

Um exemplo básico de implementação do Azure Container Registry.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "registry" {
  type      = "Microsoft.ContainerRegistry/registries@2021-08-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      adminUserEnabled     = false
      anonymousPullEnabled = false
      dataEndpointEnabled  = false
      encryption = {
        status = "disabled"
      }
      networkRuleBypassOptions = "AzureServices"
      policies = {
        exportPolicy = {
          status = "enabled"
        }
        quarantinePolicy = {
          status = "disabled"
        }
        retentionPolicy = {
          status = "disabled"
        }
        trustPolicy = {
          status = "disabled"
        }
      }
      publicNetworkAccess = "Enabled"
      zoneRedundancy      = "Disabled"
    }
    sku = {
      name = "Standard"
      tier = "Standard"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Módulos verificados do Azure

Os seguintes Azure Módulos Verificados podem ser usados para implementar este tipo de recurso.

Módulo Descrição
Registo de Contêineres do Azure (ACR) AVM Resource Module for Azure Container Registry (ACR)

Formato do recurso

Para criar um recurso Microsoft.ContainerRegistry/registries , adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerRegistry/registries@2026-09-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      adminUserEnabled = bool
      anonymousPullEnabled = bool
      autoGeneratedDomainNameLabelScope = "string"
      dataEndpointEnabled = bool
      encryption = {
        keyVaultProperties = {
          identity = "string"
          keyIdentifier = "string"
        }
        status = "string"
      }
      endpointProtocol = "string"
      metadataSearch = "string"
      networkRuleBypassAllowedForTasks = bool
      networkRuleBypassOptions = "string"
      networkRuleSet = {
        defaultAction = "string"
        ipRules = [
          {
            action = "string"
            value = "string"
          }
        ]
        virtualNetworkRules = [
          {
            action = "string"
            virtualNetworkSubnetResourceId = "string"
          }
        ]
      }
      policies = {
        azureADAuthenticationAsArmPolicy = {
          status = "string"
        }
        exportPolicy = {
          status = "string"
        }
        quarantinePolicy = {
          status = "string"
        }
        retentionPolicy = {
          days = int
          status = "string"
        }
        softDeletePolicy = {
          retentionDays = int
          status = "string"
        }
        trustPolicy = {
          status = "string"
          type = "string"
        }
      }
      publicNetworkAccess = "string"
      regionalEndpoints = "string"
      roleAssignmentMode = "string"
      writableCacheRepos = "string"
      zoneRedundancy = "string"
    }
    sku = {
      name = "string"
    }
  }
}

Valores de propriedade

Microsoft.ContainerRegistry/registries

Nome Descrição Valor
identidade A identidade do registro de contêiner. IdentityProperties
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 5
Comprimento máximo = 50
Padrão = ^[a-zA-Z0-9]*$ (obrigatório)
propriedades As propriedades do registro de contêiner. RegistryProperties
SKU A SKU do registro de contêiner. Sku (obrigatório)
etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft. ContainerRegistry/registries@2026-09-01-preview"

AzureADAuthenticationAsArmPolicy

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

EncryptionProperty

Nome Descrição Valor
keyVaultPropriedades Propriedades do cofre de chaves. KeyVaultProperties
estado Indica se a criptografia está habilitada ou não para o registro de contêiner. 'deficientes'
'habilitado'

Política de Exportação

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

IdentityProperties

Nome Descrição Valor
tipo O tipo de identidade. 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
identidades atribuídas pelo utilizador A lista de identidades de usuário associadas ao recurso. A identidade do usuário
as referências de chave de dicionário serão ids de recurso ARM no formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.		 IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Nome Descrição Valor

IPRule

Nome Descrição Valor
ação A ação da regra ACL IP. 'Permitir'
valor Especifica o IP ou intervalo de IP no formato CIDR. Apenas o endereço IPV4 é permitido. string (obrigatório)

KeyVaultProperties

Nome Descrição Valor
identidade O ID do cliente da identidade que será usado para access key vault. cadeia (de caracteres)
keyIdentifier Key vault URI para acesso à chave de encriptação. cadeia (de caracteres)

NetworkRuleSet

Nome Descrição Valor
defaultAction A ação padrão de permitir ou negar quando nenhuma outra regra corresponder. 'Permitir'
'Negar' (obrigatório)
ipRegras As regras de ACL IP. IPRule[]
virtualNetworkRules A virtual network domina. VirtualNetworkRule []

Políticas

Nome Descrição Valor
azureADAuthenticationAsArmPolicy A política para usar Azure Resource Manager token de audiência para um registo de contentores. AzureADAuthenticationAsArmPolicy
exportPolicy A política de exportação para um registro de contêiner. Política de Exportação
quarentenaPolítica A política de quarentena para um registro de contêiner. QuarentenaPolítica
retençãoPolítica A política de retenção para um registro de contêiner. Política de retenção
softDeletePolítica A política de exclusão suave para um registro de contêiner. SoftDeletePolicy
Política de confiança A política de confiança de conteúdo para um registro de contêiner. Política de Confiança

QuarentenaPolítica

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

RegistryProperties

Nome Descrição Valor
adminUserEnabled O valor que indica se o usuário administrador está habilitado. Bool
anônimoPullEnabled Permite a extração em todo o Registro de clientes não autenticados. Bool
autoGeneratedDomainNameLabelScope Determina o escopo de reutilização do rótulo do nome de domínio. 'NoReuse'
'ResourceGroupReuse'
'SubscriptionReuse'
'InquilinoReutilização'
'Inseguro'
dataEndpointEnabled Habilite um único ponto de extremidade de dados por região para servir dados. Bool
cifragem As configurações de criptografia do registro de contêiner. EncryptionProperty
endpointProtocol O protocolo de conectividade para o registo, como IPv4 ou dual stack (IPv4 e IPv6). 'IPv4'
'IPv4AndIPv6'
metadadosPesquisa Determina se os artefacts do registo estão indexados para pesquisa de metadados. 'Desativado'
'Habilitado'
networkRuleBypassAllowedForTasks Se as Tarefas têm ou não permissão para ignorar as regras de rede para este registro de contêiner. Bool
networkRuleBypassOptions Se permitir que serviços Azure confiáveis tenham acesso a um registo restrito à rede. 'AzureServices'
'Nenhuma'
networkRuleSet A regra de rede definida para um registro de contêiner. NetworkRuleSet
Políticas As políticas para um registro de contêiner. Políticas
acesso à rede pública Se o acesso público à rede é permitido ou não para o registo de contentores. 'Desativado'
'Habilitado'
Extremos regionais Ative endpoints por região para aceder ao registo. 'Desativado'
'Habilitado'
roleAssignmentMode Determina o modo de atribuição de função do Registro. 'AbacRepositoryPermissions'
'LegacyRegistryPermissions'
writableCacheRepos Se deve permitir operações de cache que escrevem em repositórios deste registo. 'Desativado'
'Habilitado'
zonaRedundância Se a redundância de zona está ou não habilitada para este registro de contêiner 'Desativado'
'Habilitado'

Política de retenção

Nome Descrição Valor
Dias O número de dias para reter um manifesto não marcado após o qual ele é limpo. Int
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

Referência

Nome Descrição Valor
nome O nome SKU do registro de contêiner. Necessário para a criação do registro. 'Básico'
'Clássico'
'Premium'
'Standard' (obrigatório)

SoftDeletePolicy

Nome Descrição Valor
retentionDays O número de dias após os quais um item excluído suavemente é excluído permanentemente. Int
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'

TrackedResourceTags

Nome Descrição Valor

Política de Confiança

Nome Descrição Valor
estado O valor que indica se a política está habilitada ou não. 'deficientes'
'habilitado'
tipo O tipo de política de confiança. «Notariado»

UserIdentityProperties

Nome Descrição Valor

VirtualNetworkRule

Nome Descrição Valor
ação A ação da regra de rede virtual. 'Permitir'
virtualNetworkSubnetResourceId ID de recurso de uma sub-rede, por exemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}. string (obrigatório)
  • Última atualização a