Registros Microsoft.ContainerRegistry

Definição de recurso do Bicep

O tipo de recurso de registro pode ser implantado com operações direcionadas:

• Grupos de recursos - Veja grupos de recursos c1

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

Exemplos de uso

Exemplos do Bicep

Um exemplo básico de implantação do Registro de Contêiner do Azure.

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 módulos Azure Verificados podem ser usados para implantar esse tipo de recurso.

Exemplos de Início Rápido do Azure

Os modelos a seguir Azure Quickstart contêm amostras do Bicep para implantar esse tipo de recurso.

Formato de recurso

Para criar um recurso Microsoft.ContainerRegistry/Registries, adicione o Bicep a seguir ao modelo.

resource symbolicname 'Microsoft.ContainerRegistry/registries@2026-03-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 da propriedade

Microsoft.ContainerRegistry/registries

AzureADAuthenticationAsArmPolicy

Propriedade de criptografia

Política de exportação

Propriedades de Identidade

IdentityPropertiesUserAssignedIdentities

IPRule

Propriedades do KeyVault

Conjunto de regras de rede

Políticas

Política de quarentena

Propriedades do Registro

Política de retenção

Sku

SoftDeletePolicy

TrackedResourceTags

Política de confiança

UserIdentityProperties

Regra de Rede Virtual

Definição de recurso de modelo do ARM

O tipo de recurso de registro pode ser implantado com operações direcionadas:

• Grupos de recursos - Veja comandos de implantação de grupos de recursos Para uma lista de propriedades alteradas em cada versão da API, veja registro de alterações.

Exemplos de uso

Modelos de Início Rápido do Azure

Os seguintes modelos Azure Quickstart implantam esse tipo de recurso.

Modelo	Descrição
AKS Cluster com um NAT Gateway e um Application Gateway	Este exemplo mostra como implantar um cluster AKS com NAT Gateway para conexões de saída e um Application Gateway para conexões de entrada.
AKS com o controlador Application Gateway Ingress	Este exemplo mostra como implantar um cluster AKS com Application Gateway, Application Gateway Ingress Controller, Registro de Contêiner do Azure, Log Analytics e Key Vault
Fábrica de IA do Azure configuração básica	Este conjunto de modelos demonstra como configurar o Fábrica de IA do Azure com a configuração básica, ou seja, com acesso público à internet habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
Fábrica de IA do Azure configuração básica	Este conjunto de modelos demonstra como configurar o Fábrica de IA do Azure com a configuração básica, ou seja, com acesso público à internet habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
Fábrica de IA do Azure Rede Restrita	Este conjunto de modelos demonstra como configurar o Fábrica de IA do Azure com o private link and egress desativado, usando chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
Fábrica de IA do Azure com Microsoft Entra ID Autenticação	Este conjunto de modelos demonstra como configurar o Fábrica de IA do Azure 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 habilitado, chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada 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 gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
Registro de Contêiner do Azure com Template de Geo-replicação	Um modelo para criar um novo Registro de Contêiner do Azure com geo-replicação
Registro de Contêiner do Azure com Políticas e Diagnósticos	Registro de Contêiner do Azure com Políticas e Diagnóstico (bicep)
Azure Machine Learning configuração segura de ponta a ponta	Este conjunto de templates Bicep demonstra como configurar o Azure Machine Learning de ponta a ponta em uma configuração segura. Essa implementação de referência inclui o Workspace, um cluster de computação, uma instância de computação e um cluster do AKS privado anexado.
Azure Machine Learning configuração segura de ponta a ponta (legacy)	Este conjunto de templates Bicep demonstra como configurar o Azure Machine Learning de ponta a ponta em uma configuração segura. Essa implementação de referência inclui o Workspace, um cluster de computação, uma instância de computação e um cluster do AKS privado anexado.
Build imagens de contêiner com ACR Tasks	Esse 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)	Os contêineres facilitam a criação e a implantação contínua de seus aplicativos. Ao orquestrar a implantação desses containers usando Kubernetes no Azure Container Service, você pode alcançar clusters de containers replicáveis e gerenciáveis. Ao configurar um build contínuo 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	Este exemplo mostra como implantar um cluster do AKS privado com uma Zona DNS Pública.
Crie um alvo de computação AKS com um endereço IP privado	Esse modelo cria um alvo de computação AKS em um dado espaço de trabalho de 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 implantação especifica um espaço de trabalho de Azure Machine Learning e seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicativo Azure Insights e Registro de Contêiner do Azure. Essa configuração descreve o conjunto mínimo de recursos que você precisa para get started com o Azure Machine Learning.
Criar um espaço de trabalho de Azure Machine Learning serviço (CMK)	Este modelo de implantação especifica como criar um espaço de trabalho de Azure Machine Learning com criptografia do lado do serviço usando suas chaves de criptografia.
Criar um espaço de trabalho de Azure Machine Learning serviço (CMK)	Este modelo de implantação especifica um espaço de trabalho de Azure Machine Learning e seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicativo Azure Insights e Registro de Contêiner do Azure. O exemplo mostra como configurar o Azure Machine Learning para criptografia com uma chave de criptografia gerenciada pelo cliente.
Criar um espaço de trabalho de Azure Machine Learning serviço (legado)	Este modelo de implantação especifica um espaço de trabalho de Azure Machine Learning e seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicativo Azure Insights e Registro de Contêiner do Azure. Essa configuração descreve o conjunto de recursos que você precisa para get started com o Azure Machine Learning em uma configuração isolada em rede.
Crie um espaço de trabalho de Azure Machine Learning serviço (vnet)	Este modelo de implantação especifica um espaço de trabalho de Azure Machine Learning e seus recursos associados, incluindo Azure Key Vault, Armazenamento do Azure, Aplicativo Azure Insights e Registro de Contêiner do Azure. Essa configuração descreve o conjunto de recursos que você precisa para get started com o Azure Machine Learning em uma configuração isolada em rede.
Cria um aplicativo e ambiente de contêiner com Registry	Crie um Ambiente de Aplicativo de Contêineres com um Aplicativo de Contêineres básico de um Registro de Contêiner do Azure. Ele também implanta um workspace do Log Analytics para armazenar logs.
Cria um aplicativo de Servicebus pub-sub Dapr usando Apps de Contêineres	Crie um aplicativo dapr pub-sub servicebus usando Aplicativos de Contêiner.
Implante o Secure AI Foundry com um virtual network	Este modelo cria um ambiente seguro do Fábrica de IA do Azure, com restrições robustas de segurança de rede e identidade.
Importar imagens de contêineres para ACR	Esse modelo utiliza o módulo Import ACR do registro bicep para importar imagens públicas de contêineres em um Registro de Contêiner do Azure.
Simples	Um modelo para criar um novo Registro de Contêiner do Azure.

Formato de recurso

Para criar um recurso Microsoft.ContainerRegistry/Registries, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.ContainerRegistry/registries",
  "apiVersion": "2026-03-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 da propriedade

Microsoft.ContainerRegistry/registries

AzureADAuthenticationAsArmPolicy

Propriedade de criptografia

Política de exportação

Propriedades de Identidade

IdentityPropertiesUserAssignedIdentities

IPRule

Propriedades do KeyVault

Conjunto de regras de rede

Políticas

Política de quarentena

Propriedades do Registro

Política de retenção

Sku

SoftDeletePolicy

TrackedResourceTags

Política de confiança

UserIdentityProperties

Regra de Rede Virtual

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de registro pode ser implantado com operações direcionadas:

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

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação do Registro de Contêiner do Azure.

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 módulos Azure Verificados podem ser usados para implantar esse tipo de recurso.

Formato de recurso

Para criar um recurso Microsoft.ContainerRegistry/Registries, adicione o Terraform a seguir ao modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerRegistry/registries@2026-03-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 da propriedade

Microsoft.ContainerRegistry/registries

AzureADAuthenticationAsArmPolicy

Propriedade de criptografia

Política de exportação

Propriedades de Identidade

IdentityPropertiesUserAssignedIdentities

IPRule

Propriedades do KeyVault

Conjunto de regras de rede

Políticas

Política de quarentena

Propriedades do Registro

Política de retenção

Sku

SoftDeletePolicy

TrackedResourceTags

Política de confiança

UserIdentityProperties

Regra de Rede Virtual