Microsoft. ContainerRegistries/connectedRegistries 2026-09-01-preview

Bicep-resursdefinition

Resurstypen register/anslutna register kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Användningsexempel

Bicep exempel

Ett grundläggande exempel på distribution av Container Connected Registry.

param resourceName string = 'acctest0001'
param location string = 'westus'

resource registry 'Microsoft.ContainerRegistry/registries@2023-11-01-preview' = {
  name: '${resourceName}registry'
  location: location
  sku: {
    name: 'Premium'
  }
  properties: {
    adminUserEnabled: false
    anonymousPullEnabled: false
    dataEndpointEnabled: true
    networkRuleBypassOptions: 'AzureServices'
    policies: {
      exportPolicy: {
        status: 'enabled'
      }
      quarantinePolicy: {
        status: 'disabled'
      }
      retentionPolicy: {}
      trustPolicy: {}
    }
    publicNetworkAccess: 'Enabled'
    zoneRedundancy: 'Disabled'
  }
}

resource connectedRegistry 'Microsoft.ContainerRegistry/registries/connectedRegistries@2023-11-01-preview' = {
  name: '${resourceName}connectedregistry'
  parent: registry
  properties: {
    logging: {
      auditLogStatus: 'Disabled'
      logLevel: 'None'
    }
    mode: 'ReadWrite'
    parent: {
      syncProperties: {
        messageTtl: 'P1D'
        schedule: '* * * * *'
        syncWindow: ''
        tokenId: token.id
      }
    }
  }
}

resource scopeMap 'Microsoft.ContainerRegistry/registries/scopeMaps@2023-11-01-preview' = {
  name: '${resourceName}scopemap'
  parent: registry
  properties: {
    actions: [
      'repositories/hello-world/content/delete'
      'repositories/hello-world/content/read'
      'repositories/hello-world/content/write'
      'repositories/hello-world/metadata/read'
      'repositories/hello-world/metadata/write'
      'gateway/${resourceName}connectedregistry/config/read'
      'gateway/${resourceName}connectedregistry/config/write'
      'gateway/${resourceName}connectedregistry/message/read'
      'gateway/${resourceName}connectedregistry/message/write'
    ]
    description: ''
  }
}

resource token 'Microsoft.ContainerRegistry/registries/tokens@2023-11-01-preview' = {
  name: '${resourceName}token'
  parent: registry
  properties: {
    scopeMapId: scopeMap.id
    status: 'enabled'
  }
}

Resursformat

Om du vill skapa en Microsoft.ContainerRegistry/registries/connectedRegistries-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.ContainerRegistry/registries/connectedRegistries@2026-09-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  name: 'string'
  properties: {
    clientTokenIds: [
      'string'
    ]
    garbageCollection: {
      enabled: bool
      schedule: 'string'
    }
    logging: {
      auditLogStatus: 'string'
      logLevel: 'string'
    }
    loginServer: {}
    mode: 'string'
    notificationsList: [
      'string'
    ]
    parent: {
      id: 'string'
      syncProperties: {
        authType: 'string'
        messageTtl: 'string'
        schedule: 'string'
        syncWindow: 'string'
        tokenId: 'string'
      }
    }
    registrySyncResult: {
      lastSuccessfulSyncEndTime: 'string'
      lastSyncEndTime: 'string'
      lastSyncStartTime: 'string'
    }
  }
}

Egenskapsvärden

Microsoft.ContainerRegistry/registries/connectedRegistries

Name Description Value
identity Den användartilldelade hanterade identiteten som används av det lokala registret för att autentisera sig med molnregistret för synkroniseringsoperationer. Kräver att authType är ManagedIdentity. ManagedServiceIdentity (HanteradServiceIdentitet)
Namn Resursnamnet string

Begränsningar:
Minsta längd = 5
Maximal längd = 50
Mönster = ^[a-zA-Z0-9]*$ (krävs)
parent I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen.

Mer information finns i Underordnad resurs utanför den överordnade resursen.
Symboliskt namn för resurs av typen: register
properties Egenskaperna för det anslutna registret. ConnectedRegistryProperties (på engelska)

ConnectedRegistryProperties (på engelska)

Name Description Value
clientTokenIds Listan över resurs-ID:t för ACR-token som används för att autentisera klienter till det anslutna registret. string[]
skräpSamling Egenskaperna för skräpinsamling för det anslutna registret. GarbageCollectionProperties
logging Loggningsegenskaperna för det anslutna registret. LoggningEgenskaper
loginServer Inloggningsserveregenskaperna för det anslutna registret. LoginServerEgenskaper
mode Läget för den anslutna registerresursen som anger registrets behörigheter. "Spegel"
'ReadOnly'
"Skriv upp"
"Register" (krävs)
anmälningarLista över anmälningar Listan över prenumerationsinformation för meddelanden för det anslutna registret. string[]
parent Överordnat för det anslutna registret. ParentProperties (krävs)
registrySyncResult Resultatet av den anslutna registrets senaste synkronisering med dess förälder. RegistrySyncResult

GarbageCollectionProperties

Name Description Value
Aktiverad Anger om skräpinsamling är aktiverat för det anslutna registret. bool
schedule Cron-uttrycket som anger schemat som det anslutna registret ska köra skräpinsamling. string

LoggningEgenskaper

Name Description Value
auditLogStatus Anger om granskningsloggar är aktiverade i det anslutna registret. "Inaktiverad"
"Aktiverad"
logLevel Utförligheten i loggarna bevarades i det anslutna registret. 'Debug'
"Fel"
"Information"
"Ingen"
"Varning"

LoginServerEgenskaper

Name Description Value

ManagedServiceIdentity

Name Description Value
type Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts). "Ingen"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (krävs)
userAssignedIdentities Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden. ManagedServiceIdentityUserAssignedIdentiteter

ManagedServiceIdentityUserAssignedIdentiteter

Name Description Value

ParentProperties (ParentProperties)

Name Description Value
id Resurs-ID för det överordnade som det anslutna registret ska associeras till. string
syncProperties Synkroniseringsegenskaperna för det anslutna registret med dess överordnade. SyncProperties (krävs)

RegistrySyncResult

Name Description Value
lastFramgångsriktSynkSlutTid Tiden då den anslutna registryens senaste lyckade synkronisering avslutades. string
lastSyncEndTime Tiden då den anslutna registrets senaste synkronisering avslutades. string
lastSyncStartTime Den tid då den anslutna registrets senaste synkronisering startade. string

SyncProperties (Synkronisera) Egenskaper

Name Description Value
authType Den autentiseringstyp som används för att det anslutna registret ska synka med dess förälder. 'ManagedIdentity'
'SyncToken'
meddelandeTtl Den tidsperiod för vilken ett meddelande är tillgängligt för synkronisering innan det har upphört att gälla. Ange varaktigheten med formatet P[n]Y[n]M[n]DT[n]H[n]M[n]S enligt ISO8601. sträng (krävs)
schedule Cron-uttrycket som anger schemat som det anslutna registret ska synkronisera med dess överordnade. string
syncWindow (synkroniserat) Tidsperioden då synkronisering är aktiverad för varje schemaförekomst. Ange varaktigheten med formatet P[n]Y[n]M[n]DT[n]H[n]M[n]S enligt ISO8601. string
token-id Resurs-ID:t för den ACR-token som används för att autentisera det anslutna registret till dess överordnade under synkroniseringen. string

UserAssignedIdentity

Name Description Value

Resursdefinition för ARM-mall

Resurstypen register/anslutna register kan distribueras med åtgärder som mål:

Användningsexempel

Resursformat

Om du vill skapa en Microsoft.ContainerRegistry/registries/connectedRegistries-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.ContainerRegistry/registries/connectedRegistries",
  "apiVersion": "2026-09-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "properties": {
    "clientTokenIds": [ "string" ],
    "garbageCollection": {
      "enabled": "bool",
      "schedule": "string"
    },
    "logging": {
      "auditLogStatus": "string",
      "logLevel": "string"
    },
    "loginServer": {
    },
    "mode": "string",
    "notificationsList": [ "string" ],
    "parent": {
      "id": "string",
      "syncProperties": {
        "authType": "string",
        "messageTtl": "string",
        "schedule": "string",
        "syncWindow": "string",
        "tokenId": "string"
      }
    },
    "registrySyncResult": {
      "lastSuccessfulSyncEndTime": "string",
      "lastSyncEndTime": "string",
      "lastSyncStartTime": "string"
    }
  }
}

Egenskapsvärden

Microsoft.ContainerRegistry/registries/connectedRegistries

Name Description Value
apiVersion API-versionen '2026-09-01-förhandsvisning'
identity Den användartilldelade hanterade identiteten som används av det lokala registret för att autentisera sig med molnregistret för synkroniseringsoperationer. Kräver att authType är ManagedIdentity. ManagedServiceIdentity (HanteradServiceIdentitet)
Namn Resursnamnet string

Begränsningar:
Minsta längd = 5
Maximal längd = 50
Mönster = ^[a-zA-Z0-9]*$ (krävs)
properties Egenskaperna för det anslutna registret. ConnectedRegistryProperties (på engelska)
type Resurstypen "Microsoft.ContainerRegistry/registries/connectedRegistries"

ConnectedRegistryProperties (på engelska)

Name Description Value
clientTokenIds Listan över resurs-ID:t för ACR-token som används för att autentisera klienter till det anslutna registret. string[]
skräpSamling Egenskaperna för skräpinsamling för det anslutna registret. GarbageCollectionProperties
logging Loggningsegenskaperna för det anslutna registret. LoggningEgenskaper
loginServer Inloggningsserveregenskaperna för det anslutna registret. LoginServerEgenskaper
mode Läget för den anslutna registerresursen som anger registrets behörigheter. "Spegel"
'ReadOnly'
"Skriv upp"
"Register" (krävs)
anmälningarLista över anmälningar Listan över prenumerationsinformation för meddelanden för det anslutna registret. string[]
parent Överordnat för det anslutna registret. ParentProperties (krävs)
registrySyncResult Resultatet av den anslutna registrets senaste synkronisering med dess förälder. RegistrySyncResult

GarbageCollectionProperties

Name Description Value
Aktiverad Anger om skräpinsamling är aktiverat för det anslutna registret. bool
schedule Cron-uttrycket som anger schemat som det anslutna registret ska köra skräpinsamling. string

LoggningEgenskaper

Name Description Value
auditLogStatus Anger om granskningsloggar är aktiverade i det anslutna registret. "Inaktiverad"
"Aktiverad"
logLevel Utförligheten i loggarna bevarades i det anslutna registret. 'Debug'
"Fel"
"Information"
"Ingen"
"Varning"

LoginServerEgenskaper

Name Description Value

ManagedServiceIdentity

Name Description Value
type Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts). "Ingen"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (krävs)
userAssignedIdentities Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden. ManagedServiceIdentityUserAssignedIdentiteter

ManagedServiceIdentityUserAssignedIdentiteter

Name Description Value

ParentProperties (ParentProperties)

Name Description Value
id Resurs-ID för det överordnade som det anslutna registret ska associeras till. string
syncProperties Synkroniseringsegenskaperna för det anslutna registret med dess överordnade. SyncProperties (krävs)

RegistrySyncResult

Name Description Value
lastFramgångsriktSynkSlutTid Tiden då den anslutna registryens senaste lyckade synkronisering avslutades. string
lastSyncEndTime Tiden då den anslutna registrets senaste synkronisering avslutades. string
lastSyncStartTime Den tid då den anslutna registrets senaste synkronisering startade. string

SyncProperties (Synkronisera) Egenskaper

Name Description Value
authType Den autentiseringstyp som används för att det anslutna registret ska synka med dess förälder. 'ManagedIdentity'
'SyncToken'
meddelandeTtl Den tidsperiod för vilken ett meddelande är tillgängligt för synkronisering innan det har upphört att gälla. Ange varaktigheten med formatet P[n]Y[n]M[n]DT[n]H[n]M[n]S enligt ISO8601. sträng (krävs)
schedule Cron-uttrycket som anger schemat som det anslutna registret ska synkronisera med dess överordnade. string
syncWindow (synkroniserat) Tidsperioden då synkronisering är aktiverad för varje schemaförekomst. Ange varaktigheten med formatet P[n]Y[n]M[n]DT[n]H[n]M[n]S enligt ISO8601. string
token-id Resurs-ID:t för den ACR-token som används för att autentisera det anslutna registret till dess överordnade under synkroniseringen. string

UserAssignedIdentity

Name Description Value

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen register/anslutna register kan distribueras med åtgärder som mål:

  • Resursgrupper För en lista över ändrade egenskaper i varje API-version, se ändringslogg.

Användningsexempel

Terraform-exempel

Ett grundläggande exempel på distribution av Container Connected 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 = "westus"
}

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@2023-11-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}registry"
  location  = var.location
  body = {
    properties = {
      adminUserEnabled         = false
      anonymousPullEnabled     = false
      dataEndpointEnabled      = true
      networkRuleBypassOptions = "AzureServices"
      policies = {
        exportPolicy = {
          status = "enabled"
        }
        quarantinePolicy = {
          status = "disabled"
        }
        retentionPolicy = {}
        trustPolicy     = {}
      }
      publicNetworkAccess = "Enabled"
      zoneRedundancy      = "Disabled"
    }
    sku = {
      name = "Premium"
    }
  }
}

resource "azapi_resource" "scopeMap" {
  type      = "Microsoft.ContainerRegistry/registries/scopeMaps@2023-11-01-preview"
  parent_id = azapi_resource.registry.id
  name      = "${var.resource_name}scopemap"
  body = {
    properties = {
      actions     = ["repositories/hello-world/content/delete", "repositories/hello-world/content/read", "repositories/hello-world/content/write", "repositories/hello-world/metadata/read", "repositories/hello-world/metadata/write", "gateway/${var.resource_name}connectedregistry/config/read", "gateway/${var.resource_name}connectedregistry/config/write", "gateway/${var.resource_name}connectedregistry/message/read", "gateway/${var.resource_name}connectedregistry/message/write"]
      description = ""
    }
  }
}

resource "azapi_resource" "token" {
  type      = "Microsoft.ContainerRegistry/registries/tokens@2023-11-01-preview"
  parent_id = azapi_resource.registry.id
  name      = "${var.resource_name}token"
  body = {
    properties = {
      scopeMapId = azapi_resource.scopeMap.id
      status     = "enabled"
    }
  }
}

resource "azapi_resource" "connectedRegistry" {
  type      = "Microsoft.ContainerRegistry/registries/connectedRegistries@2023-11-01-preview"
  parent_id = azapi_resource.registry.id
  name      = "${var.resource_name}connectedregistry"
  body = {
    properties = {
      clientTokenIds = null
      logging = {
        auditLogStatus = "Disabled"
        logLevel       = "None"
      }
      mode = "ReadWrite"
      parent = {
        syncProperties = {
          messageTtl = "P1D"
          schedule   = "* * * * *"
          syncWindow = ""
          tokenId    = azapi_resource.token.id
        }
      }
    }
  }
}

Resursformat

Om du vill skapa en Microsoft.ContainerRegistry/registries/connectedRegistries-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerRegistry/registries/connectedRegistries@2026-09-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  body = {
    properties = {
      clientTokenIds = [
        "string"
      ]
      garbageCollection = {
        enabled = bool
        schedule = "string"
      }
      logging = {
        auditLogStatus = "string"
        logLevel = "string"
      }
      loginServer = {
      }
      mode = "string"
      notificationsList = [
        "string"
      ]
      parent = {
        id = "string"
        syncProperties = {
          authType = "string"
          messageTtl = "string"
          schedule = "string"
          syncWindow = "string"
          tokenId = "string"
        }
      }
      registrySyncResult = {
        lastSuccessfulSyncEndTime = "string"
        lastSyncEndTime = "string"
        lastSyncStartTime = "string"
      }
    }
  }
}

Egenskapsvärden

Microsoft.ContainerRegistry/registries/connectedRegistries

Name Description Value
identity Den användartilldelade hanterade identiteten som används av det lokala registret för att autentisera sig med molnregistret för synkroniseringsoperationer. Kräver att authType är ManagedIdentity. ManagedServiceIdentity (HanteradServiceIdentitet)
Namn Resursnamnet string

Begränsningar:
Minsta längd = 5
Maximal längd = 50
Mönster = ^[a-zA-Z0-9]*$ (krävs)
parent_id ID för resursen som är överordnad för den här resursen. ID för resurs av typen: register
properties Egenskaperna för det anslutna registret. ConnectedRegistryProperties (på engelska)
type Resurstypen "Microsoft. ContainerRegistry/registries/connectedRegistries@2026-09-01-preview"

ConnectedRegistryProperties (på engelska)

Name Description Value
clientTokenIds Listan över resurs-ID:t för ACR-token som används för att autentisera klienter till det anslutna registret. string[]
skräpSamling Egenskaperna för skräpinsamling för det anslutna registret. GarbageCollectionProperties
logging Loggningsegenskaperna för det anslutna registret. LoggningEgenskaper
loginServer Inloggningsserveregenskaperna för det anslutna registret. LoginServerEgenskaper
mode Läget för den anslutna registerresursen som anger registrets behörigheter. "Spegel"
'ReadOnly'
"Skriv upp"
"Register" (krävs)
anmälningarLista över anmälningar Listan över prenumerationsinformation för meddelanden för det anslutna registret. string[]
parent Överordnat för det anslutna registret. ParentProperties (krävs)
registrySyncResult Resultatet av den anslutna registrets senaste synkronisering med dess förälder. RegistrySyncResult

GarbageCollectionProperties

Name Description Value
Aktiverad Anger om skräpinsamling är aktiverat för det anslutna registret. bool
schedule Cron-uttrycket som anger schemat som det anslutna registret ska köra skräpinsamling. string

LoggningEgenskaper

Name Description Value
auditLogStatus Anger om granskningsloggar är aktiverade i det anslutna registret. "Inaktiverad"
"Aktiverad"
logLevel Utförligheten i loggarna bevarades i det anslutna registret. 'Debug'
"Fel"
"Information"
"Ingen"
"Varning"

LoginServerEgenskaper

Name Description Value

ManagedServiceIdentity

Name Description Value
type Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts). "Ingen"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (krävs)
userAssignedIdentities Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden. ManagedServiceIdentityUserAssignedIdentiteter

ManagedServiceIdentityUserAssignedIdentiteter

Name Description Value

ParentProperties (ParentProperties)

Name Description Value
id Resurs-ID för det överordnade som det anslutna registret ska associeras till. string
syncProperties Synkroniseringsegenskaperna för det anslutna registret med dess överordnade. SyncProperties (krävs)

RegistrySyncResult

Name Description Value
lastFramgångsriktSynkSlutTid Tiden då den anslutna registryens senaste lyckade synkronisering avslutades. string
lastSyncEndTime Tiden då den anslutna registrets senaste synkronisering avslutades. string
lastSyncStartTime Den tid då den anslutna registrets senaste synkronisering startade. string

SyncProperties (Synkronisera) Egenskaper

Name Description Value
authType Den autentiseringstyp som används för att det anslutna registret ska synka med dess förälder. 'ManagedIdentity'
'SyncToken'
meddelandeTtl Den tidsperiod för vilken ett meddelande är tillgängligt för synkronisering innan det har upphört att gälla. Ange varaktigheten med formatet P[n]Y[n]M[n]DT[n]H[n]M[n]S enligt ISO8601. sträng (krävs)
schedule Cron-uttrycket som anger schemat som det anslutna registret ska synkronisera med dess överordnade. string
syncWindow (synkroniserat) Tidsperioden då synkronisering är aktiverad för varje schemaförekomst. Ange varaktigheten med formatet P[n]Y[n]M[n]DT[n]H[n]M[n]S enligt ISO8601. string
token-id Resurs-ID:t för den ACR-token som används för att autentisera det anslutna registret till dess överordnade under synkroniseringen. string

UserAssignedIdentity

Name Description Value