Microsoft. ContainerRegistry registries/connectedRegistries 2026-09-01-preview

Bicep-resourcedefinitie

Het resourcetype registers/connectedRegistries kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie wijzigingslogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.

Gebruiksvoorbeelden

Voorbeelden van Bicep

Een eenvoudig voorbeeld van het implementeren van 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'
  }
}

Resource-indeling

Als u een Resource Microsoft.ContainerRegistry/registries/connectedRegistries wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

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'
    }
  }
}

Eigenschapswaarden

Microsoft.ContainerRegistry/registers/verbondenRegisters

Naam Beschrijving Value
identity De door gebruikers toegewezen beheerde identiteit wordt gebruikt door het on-premises verbonden register om zich te authenticeren met het cloudregister voor synchronisatieoperaties. AuthType vereist dat ManagedIdentity is. ManagedServiceIdentity-
naam De resourcenaam snaar

Beperkingen:
Minimale lengte = 5
Maximale lengte = 50
Patroon = ^[a-zA-Z0-9]*$ (vereist)
parent In Bicep kunt u de bovenliggende resource voor een onderliggende resource opgeven. U hoeft deze eigenschap alleen toe te voegen wanneer de onderliggende resource buiten de bovenliggende resource wordt gedeclareerd.

Zie onderliggende resource buiten de bovenliggende resourcevoor meer informatie.
Symbolische naam voor resource van het type: registers
properties De eigenschappen van het verbonden register. ConnectedRegistryProperties

ConnectedRegistryProperties

Naam Beschrijving Value
clientTokenIds De lijst met de ACR-tokenresource-id's die worden gebruikt om clients te verifiëren bij het verbonden register. string[]
vuilnis Collectie De eigenschappen van de garbagecollection van het verbonden register. GarbageCollectionEigenschappen
logging De eigenschappen van logboekregistratie van het verbonden register. LoggingProperties-
Inloggen Server De eigenschappen van de aanmeldingsserver van het verbonden register. LoginServerEigenschappen
mode De modus van de verbonden registerresource die de machtigingen van het register aangeeft. 'Spiegel'
'ReadOnly'
'Lezen'
'Register' (vereist)
Lijst met meldingen De lijst met abonnementsgegevens voor meldingen voor het verbonden register. string[]
parent Het bovenliggende item van het verbonden register. ParentProperties (vereist)
registrySyncResult Het resultaat van de meest recente synchronisatie van het verbonden register met zijn ouderregister. RegistrySyncResult

GarbageCollectionEigenschappen

Naam Beschrijving Value
enabled Geeft aan of garbagecollection is ingeschakeld voor het verbonden register. bool
schedule De cron-expressie die het schema aangeeft dat het verbonden register garbagecollection uitvoert. string

LoggingEigenschappen

Naam Beschrijving Value
auditLogStatus Hiermee wordt aangegeven of auditlogboeken zijn ingeschakeld in het verbonden register. 'Uitgeschakeld'
'Ingeschakeld'
logLevel De uitgebreidheid van logboeken die behouden blijven in het verbonden register. 'Debug'
'Fout'
'Informatie'
'Geen'
'Waarschuwing'

LoginServerEigenschappen

Naam Beschrijving Value

ManagedServiceIdentity

Naam Beschrijving Value
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'Geen'
'Systeem toegewezen'
'SystemAssigned, UserAssigned'
'UserAssigned' (verplicht)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Naam Beschrijving Value

Bovenliggende eigenschappen

Naam Beschrijving Value
id De resource-id van het bovenliggende item waaraan het verbonden register wordt gekoppeld. string
syncEigenschappen De synchronisatie-eigenschappen van het verbonden register met het bovenliggende register. SyncProperties (vereist)

RegistrySyncResult

Naam Beschrijving Value
laatsteSuccesSyncEndTime De tijd waarop de meest recente succesvolle synchronisatie van het verbonden register eindigde. string
lastSyncEndTime De tijd waarop de meest recente synchronisatie van het verbonden register eindigde. string
lastSyncStartTime Het moment waarop de meest recente synchronisatie van het verbonden register begon. string

Eigenschappen synchroniseren

Naam Beschrijving Value
authType Het authenticatietype dat wordt gebruikt zodat het verbonden register synchroniseert met de ouder. ManagedIdentity
'SyncToken'
messageTtl De periode waarvoor een bericht kan worden gesynchroniseerd voordat het is verlopen. Geef de duur op met de notatie P[n]Y[n]M[n]DT[n]H[n]M[n]S volgens ISO8601. tekenreeks (vereist)
schedule De cron-expressie die het schema aangeeft dat het verbonden register wordt gesynchroniseerd met het bovenliggende register. string
syncVenster Het tijdvenster waarin synchronisatie is ingeschakeld voor elke planningsuitval. Geef de duur op met de notatie P[n]Y[n]M[n]DT[n]H[n]M[n]S volgens ISO8601. string
tokenId De resource-id van het ACR-token dat wordt gebruikt om het verbonden register tijdens de synchronisatie te verifiëren met het bovenliggende register. string

UserAssignedIdentity

Naam Beschrijving Value

Resourcedefinitie van ARM-sjabloon

Het resourcetype registers/connectedRegistries kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Gebruiksvoorbeelden

Resource-indeling

Als u een resource Microsoft.ContainerRegistry/registries/connectedRegistries wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

{
  "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"
    }
  }
}

Eigenschapswaarden

Microsoft.ContainerRegistry/registers/verbondenRegisters

Naam Beschrijving Value
apiVersion De API-versie '2026-09-01-preview'
identity De door gebruikers toegewezen beheerde identiteit wordt gebruikt door het on-premises verbonden register om zich te authenticeren met het cloudregister voor synchronisatieoperaties. AuthType vereist dat ManagedIdentity is. ManagedServiceIdentity-
naam De resourcenaam snaar

Beperkingen:
Minimale lengte = 5
Maximale lengte = 50
Patroon = ^[a-zA-Z0-9]*$ (vereist)
properties De eigenschappen van het verbonden register. ConnectedRegistryProperties
type Het brontype 'Microsoft.ContainerRegistry/registries/connectedRegistries'

ConnectedRegistryProperties

Naam Beschrijving Value
clientTokenIds De lijst met de ACR-tokenresource-id's die worden gebruikt om clients te verifiëren bij het verbonden register. string[]
vuilnis Collectie De eigenschappen van de garbagecollection van het verbonden register. GarbageCollectionEigenschappen
logging De eigenschappen van logboekregistratie van het verbonden register. LoggingProperties-
Inloggen Server De eigenschappen van de aanmeldingsserver van het verbonden register. LoginServerEigenschappen
mode De modus van de verbonden registerresource die de machtigingen van het register aangeeft. 'Spiegel'
'ReadOnly'
'Lezen'
'Register' (vereist)
Lijst met meldingen De lijst met abonnementsgegevens voor meldingen voor het verbonden register. string[]
parent Het bovenliggende item van het verbonden register. ParentProperties (vereist)
registrySyncResult Het resultaat van de meest recente synchronisatie van het verbonden register met zijn ouderregister. RegistrySyncResult

GarbageCollectionEigenschappen

Naam Beschrijving Value
enabled Geeft aan of garbagecollection is ingeschakeld voor het verbonden register. bool
schedule De cron-expressie die het schema aangeeft dat het verbonden register garbagecollection uitvoert. string

LoggingEigenschappen

Naam Beschrijving Value
auditLogStatus Hiermee wordt aangegeven of auditlogboeken zijn ingeschakeld in het verbonden register. 'Uitgeschakeld'
'Ingeschakeld'
logLevel De uitgebreidheid van logboeken die behouden blijven in het verbonden register. 'Debug'
'Fout'
'Informatie'
'Geen'
'Waarschuwing'

LoginServerEigenschappen

Naam Beschrijving Value

ManagedServiceIdentity

Naam Beschrijving Value
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'Geen'
'Systeem toegewezen'
'SystemAssigned, UserAssigned'
'UserAssigned' (verplicht)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Naam Beschrijving Value

Bovenliggende eigenschappen

Naam Beschrijving Value
id De resource-id van het bovenliggende item waaraan het verbonden register wordt gekoppeld. string
syncEigenschappen De synchronisatie-eigenschappen van het verbonden register met het bovenliggende register. SyncProperties (vereist)

RegistrySyncResult

Naam Beschrijving Value
laatsteSuccesSyncEndTime De tijd waarop de meest recente succesvolle synchronisatie van het verbonden register eindigde. string
lastSyncEndTime De tijd waarop de meest recente synchronisatie van het verbonden register eindigde. string
lastSyncStartTime Het moment waarop de meest recente synchronisatie van het verbonden register begon. string

Eigenschappen synchroniseren

Naam Beschrijving Value
authType Het authenticatietype dat wordt gebruikt zodat het verbonden register synchroniseert met de ouder. ManagedIdentity
'SyncToken'
messageTtl De periode waarvoor een bericht kan worden gesynchroniseerd voordat het is verlopen. Geef de duur op met de notatie P[n]Y[n]M[n]DT[n]H[n]M[n]S volgens ISO8601. tekenreeks (vereist)
schedule De cron-expressie die het schema aangeeft dat het verbonden register wordt gesynchroniseerd met het bovenliggende register. string
syncVenster Het tijdvenster waarin synchronisatie is ingeschakeld voor elke planningsuitval. Geef de duur op met de notatie P[n]Y[n]M[n]DT[n]H[n]M[n]S volgens ISO8601. string
tokenId De resource-id van het ACR-token dat wordt gebruikt om het verbonden register tijdens de synchronisatie te verifiëren met het bovenliggende register. string

UserAssignedIdentity

Naam Beschrijving Value

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype registers/connectedRegistries kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • Resourcegroepen Voor een lijst van gewijzigde eigenschappen in elke API-versie, zie wijzigingslogboek.

Gebruiksvoorbeelden

Terraform-voorbeelden

Een eenvoudig voorbeeld van het implementeren van 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
        }
      }
    }
  }
}

Resource-indeling

Als u een Resource Microsoft.ContainerRegistry/registries/connectedRegistries wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

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"
      }
    }
  }
}

Eigenschapswaarden

Microsoft.ContainerRegistry/registers/verbondenRegisters

Naam Beschrijving Value
identity De door gebruikers toegewezen beheerde identiteit wordt gebruikt door het on-premises verbonden register om zich te authenticeren met het cloudregister voor synchronisatieoperaties. AuthType vereist dat ManagedIdentity is. ManagedServiceIdentity-
naam De resourcenaam snaar

Beperkingen:
Minimale lengte = 5
Maximale lengte = 50
Patroon = ^[a-zA-Z0-9]*$ (vereist)
parent_id De id van de resource die het bovenliggende item voor deze resource is. Id voor resource van het type: registers
properties De eigenschappen van het verbonden register. ConnectedRegistryProperties
type Het brontype "Microsoft. ContainerRegistry/registries/connectedRegistries@2026-09-01-preview"

ConnectedRegistryProperties

Naam Beschrijving Value
clientTokenIds De lijst met de ACR-tokenresource-id's die worden gebruikt om clients te verifiëren bij het verbonden register. string[]
vuilnis Collectie De eigenschappen van de garbagecollection van het verbonden register. GarbageCollectionEigenschappen
logging De eigenschappen van logboekregistratie van het verbonden register. LoggingProperties-
Inloggen Server De eigenschappen van de aanmeldingsserver van het verbonden register. LoginServerEigenschappen
mode De modus van de verbonden registerresource die de machtigingen van het register aangeeft. 'Spiegel'
'ReadOnly'
'Lezen'
'Register' (vereist)
Lijst met meldingen De lijst met abonnementsgegevens voor meldingen voor het verbonden register. string[]
parent Het bovenliggende item van het verbonden register. ParentProperties (vereist)
registrySyncResult Het resultaat van de meest recente synchronisatie van het verbonden register met zijn ouderregister. RegistrySyncResult

GarbageCollectionEigenschappen

Naam Beschrijving Value
enabled Geeft aan of garbagecollection is ingeschakeld voor het verbonden register. bool
schedule De cron-expressie die het schema aangeeft dat het verbonden register garbagecollection uitvoert. string

LoggingEigenschappen

Naam Beschrijving Value
auditLogStatus Hiermee wordt aangegeven of auditlogboeken zijn ingeschakeld in het verbonden register. 'Uitgeschakeld'
'Ingeschakeld'
logLevel De uitgebreidheid van logboeken die behouden blijven in het verbonden register. 'Debug'
'Fout'
'Informatie'
'Geen'
'Waarschuwing'

LoginServerEigenschappen

Naam Beschrijving Value

ManagedServiceIdentity

Naam Beschrijving Value
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'Geen'
'Systeem toegewezen'
'SystemAssigned, UserAssigned'
'UserAssigned' (verplicht)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Naam Beschrijving Value

Bovenliggende eigenschappen

Naam Beschrijving Value
id De resource-id van het bovenliggende item waaraan het verbonden register wordt gekoppeld. string
syncEigenschappen De synchronisatie-eigenschappen van het verbonden register met het bovenliggende register. SyncProperties (vereist)

RegistrySyncResult

Naam Beschrijving Value
laatsteSuccesSyncEndTime De tijd waarop de meest recente succesvolle synchronisatie van het verbonden register eindigde. string
lastSyncEndTime De tijd waarop de meest recente synchronisatie van het verbonden register eindigde. string
lastSyncStartTime Het moment waarop de meest recente synchronisatie van het verbonden register begon. string

Eigenschappen synchroniseren

Naam Beschrijving Value
authType Het authenticatietype dat wordt gebruikt zodat het verbonden register synchroniseert met de ouder. ManagedIdentity
'SyncToken'
messageTtl De periode waarvoor een bericht kan worden gesynchroniseerd voordat het is verlopen. Geef de duur op met de notatie P[n]Y[n]M[n]DT[n]H[n]M[n]S volgens ISO8601. tekenreeks (vereist)
schedule De cron-expressie die het schema aangeeft dat het verbonden register wordt gesynchroniseerd met het bovenliggende register. string
syncVenster Het tijdvenster waarin synchronisatie is ingeschakeld voor elke planningsuitval. Geef de duur op met de notatie P[n]Y[n]M[n]DT[n]H[n]M[n]S volgens ISO8601. string
tokenId De resource-id van het ACR-token dat wordt gebruikt om het verbonden register tijdens de synchronisatie te verifiëren met het bovenliggende register. string

UserAssignedIdentity

Naam Beschrijving Value