Microsoft. NetworkCloud kubernetesClusters 2026-01-01-preview

Bicep-resourcedefinitie

Het resourcetype kubernetesClusters kan worden geïmplementeerd met bewerkingen die zijn gericht op:

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

Resource-indeling

Als u een Resource Microsoft.NetworkCloud/kubernetesClusters wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.NetworkCloud/kubernetesClusters@2026-01-01-preview' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    aadConfiguration: {
      adminGroupObjectIds: [
        'string'
      ]
    }
    administratorConfiguration: {
      adminUsername: 'string'
      sshPublicKeys: [
        {
          keyData: 'string'
        }
      ]
    }
    controlPlaneNodeConfiguration: {
      administratorConfiguration: {
        adminUsername: 'string'
        sshPublicKeys: [
          {
            keyData: 'string'
          }
        ]
      }
      availabilityZones: [
        'string'
      ]
      count: int
      vmSkuName: 'string'
    }
    initialAgentPoolConfigurations: [
      {
        administratorConfiguration: {
          adminUsername: 'string'
          sshPublicKeys: [
            {
              keyData: 'string'
            }
          ]
        }
        agentOptions: {
          hugepagesCount: int
          hugepagesSize: 'string'
        }
        attachedNetworkConfiguration: {
          l2Networks: [
            {
              networkId: 'string'
              pluginType: 'string'
            }
          ]
          l3Networks: [
            {
              ipamEnabled: 'string'
              networkId: 'string'
              pluginType: 'string'
            }
          ]
          trunkedNetworks: [
            {
              networkId: 'string'
              pluginType: 'string'
            }
          ]
        }
        availabilityZones: [
          'string'
        ]
        count: int
        labels: [
          {
            key: 'string'
            value: 'string'
          }
        ]
        mode: 'string'
        name: 'string'
        taints: [
          {
            key: 'string'
            value: 'string'
          }
        ]
        upgradeSettings: {
          drainTimeout: int
          maxSurge: 'string'
          maxUnavailable: 'string'
        }
        vmSkuName: 'string'
      }
    ]
    kubernetesVersion: 'string'
    managedResourceGroupConfiguration: {
      location: 'string'
      name: 'string'
    }
    networkConfiguration: {
      attachedNetworkConfiguration: {
        l2Networks: [
          {
            networkId: 'string'
            pluginType: 'string'
          }
        ]
        l3Networks: [
          {
            ipamEnabled: 'string'
            networkId: 'string'
            pluginType: 'string'
          }
        ]
        trunkedNetworks: [
          {
            networkId: 'string'
            pluginType: 'string'
          }
        ]
      }
      bgpServiceLoadBalancerConfiguration: {
        bgpAdvertisements: [
          {
            advertiseToFabric: 'string'
            communities: [
              'string'
            ]
            ipAddressPools: [
              'string'
            ]
            peers: [
              'string'
            ]
          }
        ]
        bgpPeers: [
          {
            bfdEnabled: 'string'
            bgpMultiHop: 'string'
            holdTime: 'string'
            keepAliveTime: 'string'
            myAsn: int
            name: 'string'
            password: 'string'
            peerAddress: 'string'
            peerAsn: int
            peerPort: int
          }
        ]
        fabricPeeringEnabled: 'string'
        ipAddressPools: [
          {
            addresses: [
              'string'
            ]
            autoAssign: 'string'
            name: 'string'
            onlyUseHostIps: 'string'
          }
        ]
      }
      cloudServicesNetworkId: 'string'
      cniNetworkId: 'string'
      dnsServiceIp: 'string'
      l2ServiceLoadBalancerConfiguration: {
        ipAddressPools: [
          {
            addresses: [
              'string'
            ]
            autoAssign: 'string'
            name: 'string'
            onlyUseHostIps: 'string'
          }
        ]
      }
      podCidrs: [
        'string'
      ]
      serviceCidrs: [
        'string'
      ]
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschapswaarden

Microsoft.NetworkCloud/kubernetesClusters

Naam Beschrijving Waarde
extendedLocation De uitgebreide locatie van de bron. Deze eigenschap is vereist bij het creëren van de bron. AzureResourceManagerCommonTypesExtendedLocation (vereist)
plaats De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
naam De resourcenaam string

Beperkingen:
Patroon = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (vereist)
eigenschappen De lijst met resource-eigenschappen. KubernetesClusterProperties (vereist)
etiketten Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

Aad-configuratie

Naam Beschrijving Waarde
adminGroupObjectIds De lijst van Azure Active Directory-groepsobject-ID's die een administratieve rol zullen hebben op het Kubernetes-cluster. tekenreeks[] (vereist)

Administrator Configuratie

Naam Beschrijving Waarde
adminUsername De gebruikersnaam voor de beheerder die wordt toegepast op de besturingssystemen waarop Kubernetes-knooppunten worden uitgevoerd. Indien niet opgegeven, wordt een gebruikersnaam gekozen door de service. touw
sshPublicKeys De SSH-configuratie voor de besturingssystemen waarop de knooppunten in het Kubernetes-cluster worden uitgevoerd. In sommige gevallen kan specificatie van openbare sleutels vereist zijn om een werkomgeving te produceren. SshPublicKey

Opties voor agenten

Naam Beschrijving Waarde
enormepagina'sAantal Het aantal enorme pagina's dat moet worden toegewezen. int (vereist)
enorme pagina'sSize De grootte van de enorme pagina's die moeten worden toegewezen. '1G'
'2M'

AgentPoolUpgradeSettings

Naam Beschrijving Waarde
afvoerTime-out De maximale tijd in seconden die is toegestaan voor het leegmaken van een knooppunt voordat u doorgaat met de upgrade van de agentgroep. Als deze niet is opgegeven tijdens het maken, wordt een waarde van 1800 seconden gebruikt. int

Beperkingen:
Minimumwaarde = 60
Maximumwaarde = 86400
maxSurge Het maximum aantal knooppunten of het maximumpercentage van knooppunten dat tijdens de upgrade is overgegaan. Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als deze niet is opgegeven tijdens het maken, wordt een waarde van 1 gebruikt. Een van MaxSurge en MaxUnavailable moet groter zijn dan 0. touw
maxUnavailable Het maximum aantal of het percentage knooppunten dat niet beschikbaar is tijdens de upgrade. Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als dit niet is opgegeven tijdens het maken, wordt een waarde van 0 gebruikt. Een van MaxSurge en MaxUnavailable moet groter zijn dan 0. touw

BijgevoegdeNetwerkConfiguratie

Naam Beschrijving Waarde
l2Networks De lijst met Laag 2-netwerken en gerelateerde configuratie voor bijlage. L2NetworkAttachmentConfiguration[]
l3Networks De lijst met Laag 3-netwerken en gerelateerde configuratie voor bijlage. L3NetworkAttachmentConfiguration[]
trunk-netwerken De lijst met Trunked Networks en gerelateerde configuratie voor bijlage. TrunkedNetworkAttachmentConfiguration[]

AzureResourceManagerCommonTypesExtendedLocation

Naam Beschrijving Waarde
naam De naam van de uitgebreide locatie. tekenreeks (vereist)
soort Het type van de uitgebreide locatie. 'Aangepaste locatie'
'EdgeZone' (verplicht)

BgpAdvertentie

Naam Beschrijving Waarde
adverterenToFabric De indicator van of deze advertentie ook wordt gemaakt in de netwerkinfrastructuur die is gekoppeld aan het netwerkcloudcluster. Dit veld wordt genegeerd als fabricPeeringEnabled is ingesteld op False. 'Onwaar'
'Waar'
Gemeenschappen De namen van de BGP-community's die aan de aankondiging moeten worden gekoppeld, waarbij gebruik wordt gemaakt van een BGP-communitytekenreeks in de indeling 1234:1234. string[]
ipAddressPools De namen van de IP-adresgroepen die aan deze aankondiging zijn gekoppeld. tekenreeks[] (vereist)
Collega 's De namen van de BGP-peers om deze advertentie te beperken. Als er geen waarden worden opgegeven, ontvangen alle BGP-peers deze advertentie. string[]

BgpServiceLoadBalancerConfiguratie

Naam Beschrijving Waarde
bgpAdvertenties De koppeling van IP-adresgroepen aan de community's en peers, waardoor ip-adressen kunnen worden aangekondigd. BgpAdvertentie
bgpPeers De lijst met aanvullende BgpPeer-entiteiten waarmee het Kubernetes-cluster wordt gekoppeld. Alle peering moet expliciet worden gedefinieerd. ServiceLoadBalancerBgpPeer
geschikt voor fabricPeering De indicator die moet worden opgegeven als de load balancer peert met de netwerkinfrastructuur. 'Onwaar'
'Waar'
ipAddressPools De lijst met groepen IP-adressen die kunnen worden toegewezen aan load balancer-services. IpAddressPool

ControlPlaneNodeConfiguration

Naam Beschrijving Waarde
administratorConfiguratie De beheerdersreferenties die moeten worden gebruikt voor de knooppunten in het besturingsvlak. AdministratorConfiguration-
availabilityZones De lijst met beschikbaarheidszones van het netwerkcloudcluster dat moet worden gebruikt voor het inrichten van knooppunten in het besturingsvlak. Als dit niet is opgegeven, worden alle beschikbaarheidszones gebruikt. string[]
aantal Het aantal virtuele machines dat deze configuratie gebruikt. int

Beperkingen:
Minimumwaarde = 1 (vereist)
vmSkuNaam De naam van de VM-SKU die tijdens het maken is opgegeven. tekenreeks (vereist)

InitialAgentPoolConfiguration

Naam Beschrijving Waarde
administratorConfiguratie De beheerdersreferenties die moeten worden gebruikt voor de knooppunten in deze agentgroep. AdministratorConfiguration-
agentOpties De configuraties die worden toegepast op elke agent in deze agentgroep. AgentOptions-
bijgevoegdNetwerkConfiguratie De configuratie van netwerken die aan de agentgroep worden gekoppeld voor gebruik door de workloads die worden uitgevoerd op dit Kubernetes-cluster. AttachedNetworkConfiguration-
availabilityZones De lijst met beschikbaarheidszones van het netwerkcloudcluster dat wordt gebruikt voor het inrichten van knooppunten in deze agentgroep. Als dit niet is opgegeven, worden alle beschikbaarheidszones gebruikt. string[]
aantal Het aantal virtuele machines dat deze configuratie gebruikt. int (vereist)
labels De labels die zijn toegepast op de knooppunten in deze agentgroep. KubernetesLabel[]
modus De selectie van hoe deze agentgroep wordt gebruikt, hetzij als een systeemgroep of een gebruikersgroep. Systeemgroepen voeren de functies en essentiële services voor het Kubernetes-cluster uit, terwijl gebruikersgroepen zijn toegewezen aan gebruikersworkloads. Elk Kubernetes-cluster moet ten minste één systeemknooppuntgroep met ten minste één knooppunt bevatten. 'NotApplicable'
'System'
Gebruiker (vereist)
naam De naam die wordt gebruikt voor de resource van de agentgroep die deze agentpool vertegenwoordigt. string

Beperkingen:
Patroon = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (vereist)
Smetten De taints die zijn toegepast op de knooppunten in deze agentpool. KubernetesLabel[]
upgradeSettings De configuratie van de agentgroep. AgentPoolUpgradeSettings
vmSkuNaam De naam van de VM-SKU die de grootte bepaalt van de resources die zijn toegewezen voor knooppunt-VM's. tekenreeks (vereist)

IpAddressPool

Naam Beschrijving Waarde
addresses De lijst met IP-adresbereiken. Elk bereik kan een subnet in CIDR-indeling of een expliciet begin-endbereik van IP-adressen zijn. Voor een load balancer-configuratie van de BGP-service wordt alleen de CIDR-indeling ondersteund en worden de voorvoegsels /32 (IPv4) en /128 (IPv6) uitgesloten. tekenreeks[] (vereist)
automatisch toewijzen De indicator om te bepalen of automatische toewijzing van de pool moet plaatsvinden. 'Onwaar'
'Waar'
naam De naam die wordt gebruikt om deze IP-adresgroep te identificeren voor koppeling met een BGP-advertentie. string

Beperkingen:
Patroon = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (vereist)
alleen UseHostIps De indicator om te voorkomen dat IP-adressen worden gebruikt die eindigen op .0 en .255 voor deze groep. Als u deze optie inschakelt, worden alleen IP-adressen gebruikt tussen .1 en .254. 'Onwaar'
'Waar'

KubernetesClusterEigenschappen

Naam Beschrijving Waarde
aadConfiguration De eigenschappen van Azure Active Directory Integration. AadConfiguration-
administratorConfiguratie De beheerdersreferenties die worden toegepast op de knooppunten van het besturingsvlak en agentpool die geen eigen waarden opgeven. AdministratorConfiguration-
controlPlaneNodeConfiguration De definiërende kenmerken van het besturingsvlak voor dit Kubernetes-cluster. ControlPlaneNodeConfiguration- (vereist)
initialAgentPoolConfigurations De agentgroepen die zijn gemaakt met dit Kubernetes-cluster voor het uitvoeren van kritieke systeemservices en workloads. Deze gegevens in dit veld worden alleen gebruikt tijdens het maken en het veld is leeg na het maken van het Kubernetes-cluster. Na het maken wordt het beheer van agentpools uitgevoerd met behulp van de subresource agentPools. InitialAgentPoolConfiguration[] (vereist)
kubernetesVersion De Kubernetes-versie voor dit cluster. tekenreeks (vereist)
managedResourceGroupConfiguration De configuratie van de beheerde resourcegroep die is gekoppeld aan de resource. ManagedResourceGroupConfiguration-
networkConfiguration De configuratie van het Kubernetes-clusternetwerk, inclusief de bijlage van netwerken die het cluster omvatten. NetworkConfiguration- (vereist)

KubernetesEtiket

Naam Beschrijving Waarde
sleutel De naam van het label of de taint. tekenreeks (vereist)
value De waarde van het label of de taint. tekenreeks (vereist)

L2NetworkAttachmentConfiguration

Naam Beschrijving Waarde
netwerk-ID De resource-id van het netwerk dat wordt geconfigureerd voor bijlage. tekenreeks (vereist)
plug-in Type De indicator van hoe dit netwerk wordt gebruikt door het Kubernetes-cluster. 'DPDK'
"IPVLAN"
'MACVLAN'
'OSDevice'
"SRIOV"

L2ServiceLoadBalancerConfiguratie

Naam Beschrijving Waarde
ipAddressPools De lijst met groepen IP-adressen die kunnen worden toegewezen aan load balancer-services. IpAddressPool

L3NetworkAttachmentConfiguration

Naam Beschrijving Waarde
ipamIngeschakeld De indicatie of dit netwerk IP-adresbeheer wel of niet uitvoert en IP-adressen toewijst wanneer deze is gekoppeld. 'Onwaar'
'Waar'
netwerk-ID De resource-id van het netwerk dat wordt geconfigureerd voor bijlage. tekenreeks (vereist)
plug-in Type De indicator van hoe dit netwerk wordt gebruikt door het Kubernetes-cluster. 'DPDK'
"IPVLAN"
'MACVLAN'
'OSDevice'
"SRIOV"

Beheerde resourcegroepconfiguratie

Naam Beschrijving Waarde
plaats De locatie van de beheerde resourcegroep. Als dit niet is opgegeven, wordt de locatie van de bovenliggende resource gekozen. touw
naam De naam voor de beheerde resourcegroep. Als dit niet is opgegeven, wordt de unieke naam automatisch gegenereerd. string

Beperkingen:
Maximale lengte = 75

NetworkConfiguration

Naam Beschrijving Waarde
bijgevoegdNetwerkConfiguratie De configuratie van netwerken die aan het cluster worden gekoppeld voor gebruik door de workloads die op dit Kubernetes-cluster worden uitgevoerd. AttachedNetworkConfiguration-
bgpServiceLoadBalancerConfiguratie De configuratie van de load balancer van de BGP-service voor dit Kubernetes-cluster. Er kan maximaal één service load balancer worden opgegeven, laag 2 of BGP. BgpServiceLoadBalancerConfiguration-
cloudServicesNetworkId De resource-id van het gekoppelde Cloud Services-netwerk. tekenreeks (vereist)
cniNetworkId De resource-id van het Laag 3-netwerk dat wordt gebruikt voor het maken van het netwerk containernetwerken. tekenreeks (vereist)
dnsServiceIp Het IP-adres dat is toegewezen aan de Kubernetes DNS-service. Deze moet zich binnen het Kubernetes-serviceadresbereik bevinden dat is opgegeven in service-CIDR. touw
l2ServiceLoadBalancerConfiguratie De configuratie van de Load Balancer van de Laag 2-service voor dit Kubernetes-cluster. Er kan maximaal één service load balancer worden opgegeven, laag 2 of BGP. L2ServiceLoadBalancerConfiguration-
podCidrs Het IP-adres van de CIDR-notatie varieert van waaruit pod-IP-adressen moeten worden toegewezen. Er wordt één IPv4-CIDR verwacht voor netwerken met één stack. Twee CIDR's, één voor elke IP-familie (IPv4/IPv6), wordt verwacht voor dual-stack-netwerken. string[]
serviceCidrs Het IP-adres van de CIDR-notatie varieert van waaruit service-IP-adressen moeten worden toegewezen. Er wordt één IPv4-CIDR verwacht voor netwerken met één stack. Twee CIDR's, één voor elke IP-familie (IPv4/IPv6), wordt verwacht voor dual-stack-netwerken. string[]

ServiceLoadBalancerBgpPeer

Naam Beschrijving Waarde
bfdIngeschakeld De indicator van BFD-activering voor deze BgpPeer. 'Onwaar'
'Waar'
bgpMultiHop De indicator om ondersteuning voor peering met meerdere hops in te schakelen. 'Onwaar'
'Waar'
wachttijd Veld afgeschaft. Het veld was eerder optioneel, nu het geen gedefinieerd gedrag heeft en wordt genegeerd. De aangevraagde BGP-bewaringstijdwaarde. In dit veld wordt een ISO 8601-duurindeling gebruikt, bijvoorbeeld P1H. touw
houd AliveTime Veld afgeschaft. Het veld was eerder optioneel, nu het geen gedefinieerd gedrag heeft en wordt genegeerd. De aangevraagde BGP-keepalive-tijdwaarde. In dit veld wordt een ISO 8601-duurindeling gebruikt, bijvoorbeeld P1H. touw
myAsn Het autonome systeemnummer dat wordt gebruikt voor het lokale einde van de BGP-sessie. int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 4294967295
naam De naam die wordt gebruikt om deze BGP-peer te identificeren voor koppeling met een BGP-advertentie. string

Beperkingen:
Patroon = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (vereist)
password Het verificatiewachtwoord voor routers die geverifieerde TCP MD5-sessies afdwingen. string

Beperkingen:
Maximale lengte = 80
Gevoelige waarde. Doorgeven als een beveiligde parameter.
Patroon = ^[a-zA-Z0-9]{0,80}$
peer-adres Het IPv4- of IPv6-adres dat wordt gebruikt om deze BGP-sessie te verbinden. tekenreeks (vereist)
peerAsn Het autonome systeemnummer dat wordt verwacht vanaf het externe einde van de BGP-sessie. int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 4294967295 (vereist)
peerPort De poort die wordt gebruikt om deze BGP-sessie te verbinden. int

SshPublicKey

Naam Beschrijving Waarde
kerngegevens De openbare SSH-sleutelgegevens. string

Beperkingen:
Minimale lengte = 1 (vereist)

Gevolgde brontags

Naam Beschrijving Waarde

TrunkedNetworkAttachmentConfiguration

Naam Beschrijving Waarde
netwerk-ID De resource-id van het netwerk dat wordt geconfigureerd voor bijlage. tekenreeks (vereist)
plug-in Type De indicator van hoe dit netwerk wordt gebruikt door het Kubernetes-cluster. 'DPDK'
"IPVLAN"
'MACVLAN'
'OSDevice'
"SRIOV"

Resourcedefinitie van ARM-sjabloon

Het resourcetype kubernetesClusters kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Gebruiksvoorbeelden

Resource-indeling

Als u een Resource Microsoft.NetworkCloud/kubernetesClusters wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

{
  "type": "Microsoft.NetworkCloud/kubernetesClusters",
  "apiVersion": "2026-01-01-preview",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "aadConfiguration": {
      "adminGroupObjectIds": [ "string" ]
    },
    "administratorConfiguration": {
      "adminUsername": "string",
      "sshPublicKeys": [
        {
          "keyData": "string"
        }
      ]
    },
    "controlPlaneNodeConfiguration": {
      "administratorConfiguration": {
        "adminUsername": "string",
        "sshPublicKeys": [
          {
            "keyData": "string"
          }
        ]
      },
      "availabilityZones": [ "string" ],
      "count": "int",
      "vmSkuName": "string"
    },
    "initialAgentPoolConfigurations": [
      {
        "administratorConfiguration": {
          "adminUsername": "string",
          "sshPublicKeys": [
            {
              "keyData": "string"
            }
          ]
        },
        "agentOptions": {
          "hugepagesCount": "int",
          "hugepagesSize": "string"
        },
        "attachedNetworkConfiguration": {
          "l2Networks": [
            {
              "networkId": "string",
              "pluginType": "string"
            }
          ],
          "l3Networks": [
            {
              "ipamEnabled": "string",
              "networkId": "string",
              "pluginType": "string"
            }
          ],
          "trunkedNetworks": [
            {
              "networkId": "string",
              "pluginType": "string"
            }
          ]
        },
        "availabilityZones": [ "string" ],
        "count": "int",
        "labels": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "mode": "string",
        "name": "string",
        "taints": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "upgradeSettings": {
          "drainTimeout": "int",
          "maxSurge": "string",
          "maxUnavailable": "string"
        },
        "vmSkuName": "string"
      }
    ],
    "kubernetesVersion": "string",
    "managedResourceGroupConfiguration": {
      "location": "string",
      "name": "string"
    },
    "networkConfiguration": {
      "attachedNetworkConfiguration": {
        "l2Networks": [
          {
            "networkId": "string",
            "pluginType": "string"
          }
        ],
        "l3Networks": [
          {
            "ipamEnabled": "string",
            "networkId": "string",
            "pluginType": "string"
          }
        ],
        "trunkedNetworks": [
          {
            "networkId": "string",
            "pluginType": "string"
          }
        ]
      },
      "bgpServiceLoadBalancerConfiguration": {
        "bgpAdvertisements": [
          {
            "advertiseToFabric": "string",
            "communities": [ "string" ],
            "ipAddressPools": [ "string" ],
            "peers": [ "string" ]
          }
        ],
        "bgpPeers": [
          {
            "bfdEnabled": "string",
            "bgpMultiHop": "string",
            "holdTime": "string",
            "keepAliveTime": "string",
            "myAsn": "int",
            "name": "string",
            "password": "string",
            "peerAddress": "string",
            "peerAsn": "int",
            "peerPort": "int"
          }
        ],
        "fabricPeeringEnabled": "string",
        "ipAddressPools": [
          {
            "addresses": [ "string" ],
            "autoAssign": "string",
            "name": "string",
            "onlyUseHostIps": "string"
          }
        ]
      },
      "cloudServicesNetworkId": "string",
      "cniNetworkId": "string",
      "dnsServiceIp": "string",
      "l2ServiceLoadBalancerConfiguration": {
        "ipAddressPools": [
          {
            "addresses": [ "string" ],
            "autoAssign": "string",
            "name": "string",
            "onlyUseHostIps": "string"
          }
        ]
      },
      "podCidrs": [ "string" ],
      "serviceCidrs": [ "string" ]
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschapswaarden

Microsoft.NetworkCloud/kubernetesClusters

Naam Beschrijving Waarde
apiVersion De API-versie '2026-01-01-preview'
extendedLocation De uitgebreide locatie van de bron. Deze eigenschap is vereist bij het creëren van de bron. AzureResourceManagerCommonTypesExtendedLocation (vereist)
plaats De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
naam De resourcenaam string

Beperkingen:
Patroon = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (vereist)
eigenschappen De lijst met resource-eigenschappen. KubernetesClusterProperties (vereist)
etiketten Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
soort Het brontype 'Microsoft.NetworkCloud/kubernetesClusters'

Aad-configuratie

Naam Beschrijving Waarde
adminGroupObjectIds De lijst van Azure Active Directory-groepsobject-ID's die een administratieve rol zullen hebben op het Kubernetes-cluster. tekenreeks[] (vereist)

Administrator Configuratie

Naam Beschrijving Waarde
adminUsername De gebruikersnaam voor de beheerder die wordt toegepast op de besturingssystemen waarop Kubernetes-knooppunten worden uitgevoerd. Indien niet opgegeven, wordt een gebruikersnaam gekozen door de service. touw
sshPublicKeys De SSH-configuratie voor de besturingssystemen waarop de knooppunten in het Kubernetes-cluster worden uitgevoerd. In sommige gevallen kan specificatie van openbare sleutels vereist zijn om een werkomgeving te produceren. SshPublicKey

Opties voor agenten

Naam Beschrijving Waarde
enormepagina'sAantal Het aantal enorme pagina's dat moet worden toegewezen. int (vereist)
enorme pagina'sSize De grootte van de enorme pagina's die moeten worden toegewezen. '1G'
'2M'

AgentPoolUpgradeSettings

Naam Beschrijving Waarde
afvoerTime-out De maximale tijd in seconden die is toegestaan voor het leegmaken van een knooppunt voordat u doorgaat met de upgrade van de agentgroep. Als deze niet is opgegeven tijdens het maken, wordt een waarde van 1800 seconden gebruikt. int

Beperkingen:
Minimumwaarde = 60
Maximumwaarde = 86400
maxSurge Het maximum aantal knooppunten of het maximumpercentage van knooppunten dat tijdens de upgrade is overgegaan. Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als deze niet is opgegeven tijdens het maken, wordt een waarde van 1 gebruikt. Een van MaxSurge en MaxUnavailable moet groter zijn dan 0. touw
maxUnavailable Het maximum aantal of het percentage knooppunten dat niet beschikbaar is tijdens de upgrade. Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als dit niet is opgegeven tijdens het maken, wordt een waarde van 0 gebruikt. Een van MaxSurge en MaxUnavailable moet groter zijn dan 0. touw

BijgevoegdeNetwerkConfiguratie

Naam Beschrijving Waarde
l2Networks De lijst met Laag 2-netwerken en gerelateerde configuratie voor bijlage. L2NetworkAttachmentConfiguration[]
l3Networks De lijst met Laag 3-netwerken en gerelateerde configuratie voor bijlage. L3NetworkAttachmentConfiguration[]
trunk-netwerken De lijst met Trunked Networks en gerelateerde configuratie voor bijlage. TrunkedNetworkAttachmentConfiguration[]

AzureResourceManagerCommonTypesExtendedLocation

Naam Beschrijving Waarde
naam De naam van de uitgebreide locatie. tekenreeks (vereist)
soort Het type van de uitgebreide locatie. 'Aangepaste locatie'
'EdgeZone' (verplicht)

BgpAdvertentie

Naam Beschrijving Waarde
adverterenToFabric De indicator van of deze advertentie ook wordt gemaakt in de netwerkinfrastructuur die is gekoppeld aan het netwerkcloudcluster. Dit veld wordt genegeerd als fabricPeeringEnabled is ingesteld op False. 'Onwaar'
'Waar'
Gemeenschappen De namen van de BGP-community's die aan de aankondiging moeten worden gekoppeld, waarbij gebruik wordt gemaakt van een BGP-communitytekenreeks in de indeling 1234:1234. string[]
ipAddressPools De namen van de IP-adresgroepen die aan deze aankondiging zijn gekoppeld. tekenreeks[] (vereist)
Collega 's De namen van de BGP-peers om deze advertentie te beperken. Als er geen waarden worden opgegeven, ontvangen alle BGP-peers deze advertentie. string[]

BgpServiceLoadBalancerConfiguratie

Naam Beschrijving Waarde
bgpAdvertenties De koppeling van IP-adresgroepen aan de community's en peers, waardoor ip-adressen kunnen worden aangekondigd. BgpAdvertentie
bgpPeers De lijst met aanvullende BgpPeer-entiteiten waarmee het Kubernetes-cluster wordt gekoppeld. Alle peering moet expliciet worden gedefinieerd. ServiceLoadBalancerBgpPeer
geschikt voor fabricPeering De indicator die moet worden opgegeven als de load balancer peert met de netwerkinfrastructuur. 'Onwaar'
'Waar'
ipAddressPools De lijst met groepen IP-adressen die kunnen worden toegewezen aan load balancer-services. IpAddressPool

ControlPlaneNodeConfiguration

Naam Beschrijving Waarde
administratorConfiguratie De beheerdersreferenties die moeten worden gebruikt voor de knooppunten in het besturingsvlak. AdministratorConfiguration-
availabilityZones De lijst met beschikbaarheidszones van het netwerkcloudcluster dat moet worden gebruikt voor het inrichten van knooppunten in het besturingsvlak. Als dit niet is opgegeven, worden alle beschikbaarheidszones gebruikt. string[]
aantal Het aantal virtuele machines dat deze configuratie gebruikt. int

Beperkingen:
Minimumwaarde = 1 (vereist)
vmSkuNaam De naam van de VM-SKU die tijdens het maken is opgegeven. tekenreeks (vereist)

InitialAgentPoolConfiguration

Naam Beschrijving Waarde
administratorConfiguratie De beheerdersreferenties die moeten worden gebruikt voor de knooppunten in deze agentgroep. AdministratorConfiguration-
agentOpties De configuraties die worden toegepast op elke agent in deze agentgroep. AgentOptions-
bijgevoegdNetwerkConfiguratie De configuratie van netwerken die aan de agentgroep worden gekoppeld voor gebruik door de workloads die worden uitgevoerd op dit Kubernetes-cluster. AttachedNetworkConfiguration-
availabilityZones De lijst met beschikbaarheidszones van het netwerkcloudcluster dat wordt gebruikt voor het inrichten van knooppunten in deze agentgroep. Als dit niet is opgegeven, worden alle beschikbaarheidszones gebruikt. string[]
aantal Het aantal virtuele machines dat deze configuratie gebruikt. int (vereist)
labels De labels die zijn toegepast op de knooppunten in deze agentgroep. KubernetesLabel[]
modus De selectie van hoe deze agentgroep wordt gebruikt, hetzij als een systeemgroep of een gebruikersgroep. Systeemgroepen voeren de functies en essentiële services voor het Kubernetes-cluster uit, terwijl gebruikersgroepen zijn toegewezen aan gebruikersworkloads. Elk Kubernetes-cluster moet ten minste één systeemknooppuntgroep met ten minste één knooppunt bevatten. 'NotApplicable'
'System'
Gebruiker (vereist)
naam De naam die wordt gebruikt voor de resource van de agentgroep die deze agentpool vertegenwoordigt. string

Beperkingen:
Patroon = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (vereist)
Smetten De taints die zijn toegepast op de knooppunten in deze agentpool. KubernetesLabel[]
upgradeSettings De configuratie van de agentgroep. AgentPoolUpgradeSettings
vmSkuNaam De naam van de VM-SKU die de grootte bepaalt van de resources die zijn toegewezen voor knooppunt-VM's. tekenreeks (vereist)

IpAddressPool

Naam Beschrijving Waarde
addresses De lijst met IP-adresbereiken. Elk bereik kan een subnet in CIDR-indeling of een expliciet begin-endbereik van IP-adressen zijn. Voor een load balancer-configuratie van de BGP-service wordt alleen de CIDR-indeling ondersteund en worden de voorvoegsels /32 (IPv4) en /128 (IPv6) uitgesloten. tekenreeks[] (vereist)
automatisch toewijzen De indicator om te bepalen of automatische toewijzing van de pool moet plaatsvinden. 'Onwaar'
'Waar'
naam De naam die wordt gebruikt om deze IP-adresgroep te identificeren voor koppeling met een BGP-advertentie. string

Beperkingen:
Patroon = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (vereist)
alleen UseHostIps De indicator om te voorkomen dat IP-adressen worden gebruikt die eindigen op .0 en .255 voor deze groep. Als u deze optie inschakelt, worden alleen IP-adressen gebruikt tussen .1 en .254. 'Onwaar'
'Waar'

KubernetesClusterEigenschappen

Naam Beschrijving Waarde
aadConfiguration De eigenschappen van Azure Active Directory Integration. AadConfiguration-
administratorConfiguratie De beheerdersreferenties die worden toegepast op de knooppunten van het besturingsvlak en agentpool die geen eigen waarden opgeven. AdministratorConfiguration-
controlPlaneNodeConfiguration De definiërende kenmerken van het besturingsvlak voor dit Kubernetes-cluster. ControlPlaneNodeConfiguration- (vereist)
initialAgentPoolConfigurations De agentgroepen die zijn gemaakt met dit Kubernetes-cluster voor het uitvoeren van kritieke systeemservices en workloads. Deze gegevens in dit veld worden alleen gebruikt tijdens het maken en het veld is leeg na het maken van het Kubernetes-cluster. Na het maken wordt het beheer van agentpools uitgevoerd met behulp van de subresource agentPools. InitialAgentPoolConfiguration[] (vereist)
kubernetesVersion De Kubernetes-versie voor dit cluster. tekenreeks (vereist)
managedResourceGroupConfiguration De configuratie van de beheerde resourcegroep die is gekoppeld aan de resource. ManagedResourceGroupConfiguration-
networkConfiguration De configuratie van het Kubernetes-clusternetwerk, inclusief de bijlage van netwerken die het cluster omvatten. NetworkConfiguration- (vereist)

KubernetesEtiket

Naam Beschrijving Waarde
sleutel De naam van het label of de taint. tekenreeks (vereist)
value De waarde van het label of de taint. tekenreeks (vereist)

L2NetworkAttachmentConfiguration

Naam Beschrijving Waarde
netwerk-ID De resource-id van het netwerk dat wordt geconfigureerd voor bijlage. tekenreeks (vereist)
plug-in Type De indicator van hoe dit netwerk wordt gebruikt door het Kubernetes-cluster. 'DPDK'
"IPVLAN"
'MACVLAN'
'OSDevice'
"SRIOV"

L2ServiceLoadBalancerConfiguratie

Naam Beschrijving Waarde
ipAddressPools De lijst met groepen IP-adressen die kunnen worden toegewezen aan load balancer-services. IpAddressPool

L3NetworkAttachmentConfiguration

Naam Beschrijving Waarde
ipamIngeschakeld De indicatie of dit netwerk IP-adresbeheer wel of niet uitvoert en IP-adressen toewijst wanneer deze is gekoppeld. 'Onwaar'
'Waar'
netwerk-ID De resource-id van het netwerk dat wordt geconfigureerd voor bijlage. tekenreeks (vereist)
plug-in Type De indicator van hoe dit netwerk wordt gebruikt door het Kubernetes-cluster. 'DPDK'
"IPVLAN"
'MACVLAN'
'OSDevice'
"SRIOV"

Beheerde resourcegroepconfiguratie

Naam Beschrijving Waarde
plaats De locatie van de beheerde resourcegroep. Als dit niet is opgegeven, wordt de locatie van de bovenliggende resource gekozen. touw
naam De naam voor de beheerde resourcegroep. Als dit niet is opgegeven, wordt de unieke naam automatisch gegenereerd. string

Beperkingen:
Maximale lengte = 75

NetworkConfiguration

Naam Beschrijving Waarde
bijgevoegdNetwerkConfiguratie De configuratie van netwerken die aan het cluster worden gekoppeld voor gebruik door de workloads die op dit Kubernetes-cluster worden uitgevoerd. AttachedNetworkConfiguration-
bgpServiceLoadBalancerConfiguratie De configuratie van de load balancer van de BGP-service voor dit Kubernetes-cluster. Er kan maximaal één service load balancer worden opgegeven, laag 2 of BGP. BgpServiceLoadBalancerConfiguration-
cloudServicesNetworkId De resource-id van het gekoppelde Cloud Services-netwerk. tekenreeks (vereist)
cniNetworkId De resource-id van het Laag 3-netwerk dat wordt gebruikt voor het maken van het netwerk containernetwerken. tekenreeks (vereist)
dnsServiceIp Het IP-adres dat is toegewezen aan de Kubernetes DNS-service. Deze moet zich binnen het Kubernetes-serviceadresbereik bevinden dat is opgegeven in service-CIDR. touw
l2ServiceLoadBalancerConfiguratie De configuratie van de Load Balancer van de Laag 2-service voor dit Kubernetes-cluster. Er kan maximaal één service load balancer worden opgegeven, laag 2 of BGP. L2ServiceLoadBalancerConfiguration-
podCidrs Het IP-adres van de CIDR-notatie varieert van waaruit pod-IP-adressen moeten worden toegewezen. Er wordt één IPv4-CIDR verwacht voor netwerken met één stack. Twee CIDR's, één voor elke IP-familie (IPv4/IPv6), wordt verwacht voor dual-stack-netwerken. string[]
serviceCidrs Het IP-adres van de CIDR-notatie varieert van waaruit service-IP-adressen moeten worden toegewezen. Er wordt één IPv4-CIDR verwacht voor netwerken met één stack. Twee CIDR's, één voor elke IP-familie (IPv4/IPv6), wordt verwacht voor dual-stack-netwerken. string[]

ServiceLoadBalancerBgpPeer

Naam Beschrijving Waarde
bfdIngeschakeld De indicator van BFD-activering voor deze BgpPeer. 'Onwaar'
'Waar'
bgpMultiHop De indicator om ondersteuning voor peering met meerdere hops in te schakelen. 'Onwaar'
'Waar'
wachttijd Veld afgeschaft. Het veld was eerder optioneel, nu het geen gedefinieerd gedrag heeft en wordt genegeerd. De aangevraagde BGP-bewaringstijdwaarde. In dit veld wordt een ISO 8601-duurindeling gebruikt, bijvoorbeeld P1H. touw
houd AliveTime Veld afgeschaft. Het veld was eerder optioneel, nu het geen gedefinieerd gedrag heeft en wordt genegeerd. De aangevraagde BGP-keepalive-tijdwaarde. In dit veld wordt een ISO 8601-duurindeling gebruikt, bijvoorbeeld P1H. touw
myAsn Het autonome systeemnummer dat wordt gebruikt voor het lokale einde van de BGP-sessie. int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 4294967295
naam De naam die wordt gebruikt om deze BGP-peer te identificeren voor koppeling met een BGP-advertentie. string

Beperkingen:
Patroon = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (vereist)
password Het verificatiewachtwoord voor routers die geverifieerde TCP MD5-sessies afdwingen. string

Beperkingen:
Maximale lengte = 80
Gevoelige waarde. Doorgeven als een beveiligde parameter.
Patroon = ^[a-zA-Z0-9]{0,80}$
peer-adres Het IPv4- of IPv6-adres dat wordt gebruikt om deze BGP-sessie te verbinden. tekenreeks (vereist)
peerAsn Het autonome systeemnummer dat wordt verwacht vanaf het externe einde van de BGP-sessie. int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 4294967295 (vereist)
peerPort De poort die wordt gebruikt om deze BGP-sessie te verbinden. int

SshPublicKey

Naam Beschrijving Waarde
kerngegevens De openbare SSH-sleutelgegevens. string

Beperkingen:
Minimale lengte = 1 (vereist)

Gevolgde brontags

Naam Beschrijving Waarde

TrunkedNetworkAttachmentConfiguration

Naam Beschrijving Waarde
netwerk-ID De resource-id van het netwerk dat wordt geconfigureerd voor bijlage. tekenreeks (vereist)
plug-in Type De indicator van hoe dit netwerk wordt gebruikt door het Kubernetes-cluster. 'DPDK'
"IPVLAN"
'MACVLAN'
'OSDevice'
"SRIOV"

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype kubernetesClusters kan worden geïmplementeerd met bewerkingen die zijn gericht op:

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

Resource-indeling

Als u een Microsoft.NetworkCloud/kubernetesClusters-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.NetworkCloud/kubernetesClusters@2026-01-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      aadConfiguration = {
        adminGroupObjectIds = [
          "string"
        ]
      }
      administratorConfiguration = {
        adminUsername = "string"
        sshPublicKeys = [
          {
            keyData = "string"
          }
        ]
      }
      controlPlaneNodeConfiguration = {
        administratorConfiguration = {
          adminUsername = "string"
          sshPublicKeys = [
            {
              keyData = "string"
            }
          ]
        }
        availabilityZones = [
          "string"
        ]
        count = int
        vmSkuName = "string"
      }
      initialAgentPoolConfigurations = [
        {
          administratorConfiguration = {
            adminUsername = "string"
            sshPublicKeys = [
              {
                keyData = "string"
              }
            ]
          }
          agentOptions = {
            hugepagesCount = int
            hugepagesSize = "string"
          }
          attachedNetworkConfiguration = {
            l2Networks = [
              {
                networkId = "string"
                pluginType = "string"
              }
            ]
            l3Networks = [
              {
                ipamEnabled = "string"
                networkId = "string"
                pluginType = "string"
              }
            ]
            trunkedNetworks = [
              {
                networkId = "string"
                pluginType = "string"
              }
            ]
          }
          availabilityZones = [
            "string"
          ]
          count = int
          labels = [
            {
              key = "string"
              value = "string"
            }
          ]
          mode = "string"
          name = "string"
          taints = [
            {
              key = "string"
              value = "string"
            }
          ]
          upgradeSettings = {
            drainTimeout = int
            maxSurge = "string"
            maxUnavailable = "string"
          }
          vmSkuName = "string"
        }
      ]
      kubernetesVersion = "string"
      managedResourceGroupConfiguration = {
        location = "string"
        name = "string"
      }
      networkConfiguration = {
        attachedNetworkConfiguration = {
          l2Networks = [
            {
              networkId = "string"
              pluginType = "string"
            }
          ]
          l3Networks = [
            {
              ipamEnabled = "string"
              networkId = "string"
              pluginType = "string"
            }
          ]
          trunkedNetworks = [
            {
              networkId = "string"
              pluginType = "string"
            }
          ]
        }
        bgpServiceLoadBalancerConfiguration = {
          bgpAdvertisements = [
            {
              advertiseToFabric = "string"
              communities = [
                "string"
              ]
              ipAddressPools = [
                "string"
              ]
              peers = [
                "string"
              ]
            }
          ]
          bgpPeers = [
            {
              bfdEnabled = "string"
              bgpMultiHop = "string"
              holdTime = "string"
              keepAliveTime = "string"
              myAsn = int
              name = "string"
              password = "string"
              peerAddress = "string"
              peerAsn = int
              peerPort = int
            }
          ]
          fabricPeeringEnabled = "string"
          ipAddressPools = [
            {
              addresses = [
                "string"
              ]
              autoAssign = "string"
              name = "string"
              onlyUseHostIps = "string"
            }
          ]
        }
        cloudServicesNetworkId = "string"
        cniNetworkId = "string"
        dnsServiceIp = "string"
        l2ServiceLoadBalancerConfiguration = {
          ipAddressPools = [
            {
              addresses = [
                "string"
              ]
              autoAssign = "string"
              name = "string"
              onlyUseHostIps = "string"
            }
          ]
        }
        podCidrs = [
          "string"
        ]
        serviceCidrs = [
          "string"
        ]
      }
    }
  }
}

Eigenschapswaarden

Microsoft.NetworkCloud/kubernetesClusters

Naam Beschrijving Waarde
extendedLocation De uitgebreide locatie van de bron. Deze eigenschap is vereist bij het creëren van de bron. AzureResourceManagerCommonTypesExtendedLocation (vereist)
plaats De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
naam De resourcenaam string

Beperkingen:
Patroon = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (vereist)
eigenschappen De lijst met resource-eigenschappen. KubernetesClusterProperties (vereist)
etiketten Resourcetags Woordenlijst met tagnamen en -waarden.
soort Het brontype "Microsoft.NetworkCloud/kubernetesClusters@2026-01-01-preview"

Aad-configuratie

Naam Beschrijving Waarde
adminGroupObjectIds De lijst van Azure Active Directory-groepsobject-ID's die een administratieve rol zullen hebben op het Kubernetes-cluster. tekenreeks[] (vereist)

Administrator Configuratie

Naam Beschrijving Waarde
adminUsername De gebruikersnaam voor de beheerder die wordt toegepast op de besturingssystemen waarop Kubernetes-knooppunten worden uitgevoerd. Indien niet opgegeven, wordt een gebruikersnaam gekozen door de service. touw
sshPublicKeys De SSH-configuratie voor de besturingssystemen waarop de knooppunten in het Kubernetes-cluster worden uitgevoerd. In sommige gevallen kan specificatie van openbare sleutels vereist zijn om een werkomgeving te produceren. SshPublicKey

Opties voor agenten

Naam Beschrijving Waarde
enormepagina'sAantal Het aantal enorme pagina's dat moet worden toegewezen. int (vereist)
enorme pagina'sSize De grootte van de enorme pagina's die moeten worden toegewezen. '1G'
'2M'

AgentPoolUpgradeSettings

Naam Beschrijving Waarde
afvoerTime-out De maximale tijd in seconden die is toegestaan voor het leegmaken van een knooppunt voordat u doorgaat met de upgrade van de agentgroep. Als deze niet is opgegeven tijdens het maken, wordt een waarde van 1800 seconden gebruikt. int

Beperkingen:
Minimumwaarde = 60
Maximumwaarde = 86400
maxSurge Het maximum aantal knooppunten of het maximumpercentage van knooppunten dat tijdens de upgrade is overgegaan. Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als deze niet is opgegeven tijdens het maken, wordt een waarde van 1 gebruikt. Een van MaxSurge en MaxUnavailable moet groter zijn dan 0. touw
maxUnavailable Het maximum aantal of het percentage knooppunten dat niet beschikbaar is tijdens de upgrade. Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als dit niet is opgegeven tijdens het maken, wordt een waarde van 0 gebruikt. Een van MaxSurge en MaxUnavailable moet groter zijn dan 0. touw

BijgevoegdeNetwerkConfiguratie

Naam Beschrijving Waarde
l2Networks De lijst met Laag 2-netwerken en gerelateerde configuratie voor bijlage. L2NetworkAttachmentConfiguration[]
l3Networks De lijst met Laag 3-netwerken en gerelateerde configuratie voor bijlage. L3NetworkAttachmentConfiguration[]
trunk-netwerken De lijst met Trunked Networks en gerelateerde configuratie voor bijlage. TrunkedNetworkAttachmentConfiguration[]

AzureResourceManagerCommonTypesExtendedLocation

Naam Beschrijving Waarde
naam De naam van de uitgebreide locatie. tekenreeks (vereist)
soort Het type van de uitgebreide locatie. 'Aangepaste locatie'
'EdgeZone' (verplicht)

BgpAdvertentie

Naam Beschrijving Waarde
adverterenToFabric De indicator van of deze advertentie ook wordt gemaakt in de netwerkinfrastructuur die is gekoppeld aan het netwerkcloudcluster. Dit veld wordt genegeerd als fabricPeeringEnabled is ingesteld op False. 'Onwaar'
'Waar'
Gemeenschappen De namen van de BGP-community's die aan de aankondiging moeten worden gekoppeld, waarbij gebruik wordt gemaakt van een BGP-communitytekenreeks in de indeling 1234:1234. string[]
ipAddressPools De namen van de IP-adresgroepen die aan deze aankondiging zijn gekoppeld. tekenreeks[] (vereist)
Collega 's De namen van de BGP-peers om deze advertentie te beperken. Als er geen waarden worden opgegeven, ontvangen alle BGP-peers deze advertentie. string[]

BgpServiceLoadBalancerConfiguratie

Naam Beschrijving Waarde
bgpAdvertenties De koppeling van IP-adresgroepen aan de community's en peers, waardoor ip-adressen kunnen worden aangekondigd. BgpAdvertentie
bgpPeers De lijst met aanvullende BgpPeer-entiteiten waarmee het Kubernetes-cluster wordt gekoppeld. Alle peering moet expliciet worden gedefinieerd. ServiceLoadBalancerBgpPeer
geschikt voor fabricPeering De indicator die moet worden opgegeven als de load balancer peert met de netwerkinfrastructuur. 'Onwaar'
'Waar'
ipAddressPools De lijst met groepen IP-adressen die kunnen worden toegewezen aan load balancer-services. IpAddressPool

ControlPlaneNodeConfiguration

Naam Beschrijving Waarde
administratorConfiguratie De beheerdersreferenties die moeten worden gebruikt voor de knooppunten in het besturingsvlak. AdministratorConfiguration-
availabilityZones De lijst met beschikbaarheidszones van het netwerkcloudcluster dat moet worden gebruikt voor het inrichten van knooppunten in het besturingsvlak. Als dit niet is opgegeven, worden alle beschikbaarheidszones gebruikt. string[]
aantal Het aantal virtuele machines dat deze configuratie gebruikt. int

Beperkingen:
Minimumwaarde = 1 (vereist)
vmSkuNaam De naam van de VM-SKU die tijdens het maken is opgegeven. tekenreeks (vereist)

InitialAgentPoolConfiguration

Naam Beschrijving Waarde
administratorConfiguratie De beheerdersreferenties die moeten worden gebruikt voor de knooppunten in deze agentgroep. AdministratorConfiguration-
agentOpties De configuraties die worden toegepast op elke agent in deze agentgroep. AgentOptions-
bijgevoegdNetwerkConfiguratie De configuratie van netwerken die aan de agentgroep worden gekoppeld voor gebruik door de workloads die worden uitgevoerd op dit Kubernetes-cluster. AttachedNetworkConfiguration-
availabilityZones De lijst met beschikbaarheidszones van het netwerkcloudcluster dat wordt gebruikt voor het inrichten van knooppunten in deze agentgroep. Als dit niet is opgegeven, worden alle beschikbaarheidszones gebruikt. string[]
aantal Het aantal virtuele machines dat deze configuratie gebruikt. int (vereist)
labels De labels die zijn toegepast op de knooppunten in deze agentgroep. KubernetesLabel[]
modus De selectie van hoe deze agentgroep wordt gebruikt, hetzij als een systeemgroep of een gebruikersgroep. Systeemgroepen voeren de functies en essentiële services voor het Kubernetes-cluster uit, terwijl gebruikersgroepen zijn toegewezen aan gebruikersworkloads. Elk Kubernetes-cluster moet ten minste één systeemknooppuntgroep met ten minste één knooppunt bevatten. 'NotApplicable'
'System'
Gebruiker (vereist)
naam De naam die wordt gebruikt voor de resource van de agentgroep die deze agentpool vertegenwoordigt. string

Beperkingen:
Patroon = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (vereist)
Smetten De taints die zijn toegepast op de knooppunten in deze agentpool. KubernetesLabel[]
upgradeSettings De configuratie van de agentgroep. AgentPoolUpgradeSettings
vmSkuNaam De naam van de VM-SKU die de grootte bepaalt van de resources die zijn toegewezen voor knooppunt-VM's. tekenreeks (vereist)

IpAddressPool

Naam Beschrijving Waarde
addresses De lijst met IP-adresbereiken. Elk bereik kan een subnet in CIDR-indeling of een expliciet begin-endbereik van IP-adressen zijn. Voor een load balancer-configuratie van de BGP-service wordt alleen de CIDR-indeling ondersteund en worden de voorvoegsels /32 (IPv4) en /128 (IPv6) uitgesloten. tekenreeks[] (vereist)
automatisch toewijzen De indicator om te bepalen of automatische toewijzing van de pool moet plaatsvinden. 'Onwaar'
'Waar'
naam De naam die wordt gebruikt om deze IP-adresgroep te identificeren voor koppeling met een BGP-advertentie. string

Beperkingen:
Patroon = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (vereist)
alleen UseHostIps De indicator om te voorkomen dat IP-adressen worden gebruikt die eindigen op .0 en .255 voor deze groep. Als u deze optie inschakelt, worden alleen IP-adressen gebruikt tussen .1 en .254. 'Onwaar'
'Waar'

KubernetesClusterEigenschappen

Naam Beschrijving Waarde
aadConfiguration De eigenschappen van Azure Active Directory Integration. AadConfiguration-
administratorConfiguratie De beheerdersreferenties die worden toegepast op de knooppunten van het besturingsvlak en agentpool die geen eigen waarden opgeven. AdministratorConfiguration-
controlPlaneNodeConfiguration De definiërende kenmerken van het besturingsvlak voor dit Kubernetes-cluster. ControlPlaneNodeConfiguration- (vereist)
initialAgentPoolConfigurations De agentgroepen die zijn gemaakt met dit Kubernetes-cluster voor het uitvoeren van kritieke systeemservices en workloads. Deze gegevens in dit veld worden alleen gebruikt tijdens het maken en het veld is leeg na het maken van het Kubernetes-cluster. Na het maken wordt het beheer van agentpools uitgevoerd met behulp van de subresource agentPools. InitialAgentPoolConfiguration[] (vereist)
kubernetesVersion De Kubernetes-versie voor dit cluster. tekenreeks (vereist)
managedResourceGroupConfiguration De configuratie van de beheerde resourcegroep die is gekoppeld aan de resource. ManagedResourceGroupConfiguration-
networkConfiguration De configuratie van het Kubernetes-clusternetwerk, inclusief de bijlage van netwerken die het cluster omvatten. NetworkConfiguration- (vereist)

KubernetesEtiket

Naam Beschrijving Waarde
sleutel De naam van het label of de taint. tekenreeks (vereist)
value De waarde van het label of de taint. tekenreeks (vereist)

L2NetworkAttachmentConfiguration

Naam Beschrijving Waarde
netwerk-ID De resource-id van het netwerk dat wordt geconfigureerd voor bijlage. tekenreeks (vereist)
plug-in Type De indicator van hoe dit netwerk wordt gebruikt door het Kubernetes-cluster. 'DPDK'
"IPVLAN"
'MACVLAN'
'OSDevice'
"SRIOV"

L2ServiceLoadBalancerConfiguratie

Naam Beschrijving Waarde
ipAddressPools De lijst met groepen IP-adressen die kunnen worden toegewezen aan load balancer-services. IpAddressPool

L3NetworkAttachmentConfiguration

Naam Beschrijving Waarde
ipamIngeschakeld De indicatie of dit netwerk IP-adresbeheer wel of niet uitvoert en IP-adressen toewijst wanneer deze is gekoppeld. 'Onwaar'
'Waar'
netwerk-ID De resource-id van het netwerk dat wordt geconfigureerd voor bijlage. tekenreeks (vereist)
plug-in Type De indicator van hoe dit netwerk wordt gebruikt door het Kubernetes-cluster. 'DPDK'
"IPVLAN"
'MACVLAN'
'OSDevice'
"SRIOV"

Beheerde resourcegroepconfiguratie

Naam Beschrijving Waarde
plaats De locatie van de beheerde resourcegroep. Als dit niet is opgegeven, wordt de locatie van de bovenliggende resource gekozen. touw
naam De naam voor de beheerde resourcegroep. Als dit niet is opgegeven, wordt de unieke naam automatisch gegenereerd. string

Beperkingen:
Maximale lengte = 75

NetworkConfiguration

Naam Beschrijving Waarde
bijgevoegdNetwerkConfiguratie De configuratie van netwerken die aan het cluster worden gekoppeld voor gebruik door de workloads die op dit Kubernetes-cluster worden uitgevoerd. AttachedNetworkConfiguration-
bgpServiceLoadBalancerConfiguratie De configuratie van de load balancer van de BGP-service voor dit Kubernetes-cluster. Er kan maximaal één service load balancer worden opgegeven, laag 2 of BGP. BgpServiceLoadBalancerConfiguration-
cloudServicesNetworkId De resource-id van het gekoppelde Cloud Services-netwerk. tekenreeks (vereist)
cniNetworkId De resource-id van het Laag 3-netwerk dat wordt gebruikt voor het maken van het netwerk containernetwerken. tekenreeks (vereist)
dnsServiceIp Het IP-adres dat is toegewezen aan de Kubernetes DNS-service. Deze moet zich binnen het Kubernetes-serviceadresbereik bevinden dat is opgegeven in service-CIDR. touw
l2ServiceLoadBalancerConfiguratie De configuratie van de Load Balancer van de Laag 2-service voor dit Kubernetes-cluster. Er kan maximaal één service load balancer worden opgegeven, laag 2 of BGP. L2ServiceLoadBalancerConfiguration-
podCidrs Het IP-adres van de CIDR-notatie varieert van waaruit pod-IP-adressen moeten worden toegewezen. Er wordt één IPv4-CIDR verwacht voor netwerken met één stack. Twee CIDR's, één voor elke IP-familie (IPv4/IPv6), wordt verwacht voor dual-stack-netwerken. string[]
serviceCidrs Het IP-adres van de CIDR-notatie varieert van waaruit service-IP-adressen moeten worden toegewezen. Er wordt één IPv4-CIDR verwacht voor netwerken met één stack. Twee CIDR's, één voor elke IP-familie (IPv4/IPv6), wordt verwacht voor dual-stack-netwerken. string[]

ServiceLoadBalancerBgpPeer

Naam Beschrijving Waarde
bfdIngeschakeld De indicator van BFD-activering voor deze BgpPeer. 'Onwaar'
'Waar'
bgpMultiHop De indicator om ondersteuning voor peering met meerdere hops in te schakelen. 'Onwaar'
'Waar'
wachttijd Veld afgeschaft. Het veld was eerder optioneel, nu het geen gedefinieerd gedrag heeft en wordt genegeerd. De aangevraagde BGP-bewaringstijdwaarde. In dit veld wordt een ISO 8601-duurindeling gebruikt, bijvoorbeeld P1H. touw
houd AliveTime Veld afgeschaft. Het veld was eerder optioneel, nu het geen gedefinieerd gedrag heeft en wordt genegeerd. De aangevraagde BGP-keepalive-tijdwaarde. In dit veld wordt een ISO 8601-duurindeling gebruikt, bijvoorbeeld P1H. touw
myAsn Het autonome systeemnummer dat wordt gebruikt voor het lokale einde van de BGP-sessie. int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 4294967295
naam De naam die wordt gebruikt om deze BGP-peer te identificeren voor koppeling met een BGP-advertentie. string

Beperkingen:
Patroon = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (vereist)
password Het verificatiewachtwoord voor routers die geverifieerde TCP MD5-sessies afdwingen. string

Beperkingen:
Maximale lengte = 80
Gevoelige waarde. Doorgeven als een beveiligde parameter.
Patroon = ^[a-zA-Z0-9]{0,80}$
peer-adres Het IPv4- of IPv6-adres dat wordt gebruikt om deze BGP-sessie te verbinden. tekenreeks (vereist)
peerAsn Het autonome systeemnummer dat wordt verwacht vanaf het externe einde van de BGP-sessie. int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 4294967295 (vereist)
peerPort De poort die wordt gebruikt om deze BGP-sessie te verbinden. int

SshPublicKey

Naam Beschrijving Waarde
kerngegevens De openbare SSH-sleutelgegevens. string

Beperkingen:
Minimale lengte = 1 (vereist)

Gevolgde brontags

Naam Beschrijving Waarde

TrunkedNetworkAttachmentConfiguration

Naam Beschrijving Waarde
netwerk-ID De resource-id van het netwerk dat wordt geconfigureerd voor bijlage. tekenreeks (vereist)
plug-in Type De indicator van hoe dit netwerk wordt gebruikt door het Kubernetes-cluster. 'DPDK'
"IPVLAN"
'MACVLAN'
'OSDevice'
"SRIOV"