Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Bicep-resourcedefinitie
Het resourcetype kubernetesClusters kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen
Zie logboek wijzigenvoor 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-08-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 |
|---|---|---|
| uitgebreidLocatie | 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 | snaar 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) |
| Tags | Resourcetags | Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen |
Aad-configuratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| adminGroupObjectIds | De lijst met azure Active Directory-groepsobject-id's die een beheerdersrol hebben in het Kubernetes-cluster. | tekenreeks[] (vereist) |
Administrator Configuratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| beheerderGebruikersnaam | 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. | snaar |
| 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' |
AgentPoolUpgradeInstellingen
| 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. | snaar |
| maxNiet beschikbaar | 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. | snaar |
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[] |
| trunkedNetworks | 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. | tekenreeks[] |
| 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. | tekenreeks[] |
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- |
| beschikbaarheidszones | 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. | tekenreeks[] |
| tellen | 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- |
| beschikbaarheidszones | 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. | tekenreeks[] |
| tellen | Het aantal virtuele machines dat deze configuratie gebruikt. | int (vereist) |
| etiketten | De labels die zijn toegepast op de knooppunten in deze agentgroep. | KubernetesLabel[] |
| wijze | 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. | 'Niet van toepassing' 'Systeem' Gebruiker (vereist) |
| naam | De naam die wordt gebruikt voor de resource van de agentgroep die deze agentpool vertegenwoordigt. | snaar 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[] |
| upgrade-instellingen | De configuratie van de agentgroep. | AgentPoolUpgradeInstellingen |
| 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 |
|---|---|---|
| Adressen | 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. | snaar 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-integratie. | 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) |
| kubernetesVersie | De Kubernetes-versie voor dit cluster. | tekenreeks (vereist) |
| BeheerdeResourceGroepConfiguratie | De configuratie van de beheerde resourcegroep die is gekoppeld aan de resource. | ManagedResourceGroupConfiguration- |
| netwerkConfiguratie | 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) |
| waarde | 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. | snaar |
| naam | De naam voor de beheerde resourcegroep. Als dit niet is opgegeven, wordt de unieke naam automatisch gegenereerd. | snaar Beperkingen: Maximale lengte = 75 |
Netwerk configuratie
| 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. | snaar |
| 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. | tekenreeks[] |
| 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. | tekenreeks[] |
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. | snaar |
| 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. | snaar |
| 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. | snaar Beperkingen: Patroon = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (vereist) |
| wachtwoord | Het verificatiewachtwoord voor routers die geverifieerde TCP MD5-sessies afdwingen. | snaar 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. | snaar 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:
- Resourcegroepen - Zie resource group deployment-commando's Voor een lijst van gewijzigde eigenschappen in elke API-versie, zie wijzigingslogboek.
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-08-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-08-01-preview' |
| uitgebreidLocatie | 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 | snaar 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) |
| Tags | Resourcetags | Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen |
| soort | Het resourcetype | 'Microsoft.NetworkCloud/kubernetesClusters' |
Aad-configuratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| adminGroupObjectIds | De lijst met azure Active Directory-groepsobject-id's die een beheerdersrol hebben in het Kubernetes-cluster. | tekenreeks[] (vereist) |
Administrator Configuratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| beheerderGebruikersnaam | 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. | snaar |
| 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' |
AgentPoolUpgradeInstellingen
| 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. | snaar |
| maxNiet beschikbaar | 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. | snaar |
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[] |
| trunkedNetworks | 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. | tekenreeks[] |
| 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. | tekenreeks[] |
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- |
| beschikbaarheidszones | 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. | tekenreeks[] |
| tellen | 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- |
| beschikbaarheidszones | 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. | tekenreeks[] |
| tellen | Het aantal virtuele machines dat deze configuratie gebruikt. | int (vereist) |
| etiketten | De labels die zijn toegepast op de knooppunten in deze agentgroep. | KubernetesLabel[] |
| wijze | 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. | 'Niet van toepassing' 'Systeem' Gebruiker (vereist) |
| naam | De naam die wordt gebruikt voor de resource van de agentgroep die deze agentpool vertegenwoordigt. | snaar 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[] |
| upgrade-instellingen | De configuratie van de agentgroep. | AgentPoolUpgradeInstellingen |
| 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 |
|---|---|---|
| Adressen | 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. | snaar 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-integratie. | 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) |
| kubernetesVersie | De Kubernetes-versie voor dit cluster. | tekenreeks (vereist) |
| BeheerdeResourceGroepConfiguratie | De configuratie van de beheerde resourcegroep die is gekoppeld aan de resource. | ManagedResourceGroupConfiguration- |
| netwerkConfiguratie | 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) |
| waarde | 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. | snaar |
| naam | De naam voor de beheerde resourcegroep. Als dit niet is opgegeven, wordt de unieke naam automatisch gegenereerd. | snaar Beperkingen: Maximale lengte = 75 |
Netwerk configuratie
| 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. | snaar |
| 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. | tekenreeks[] |
| 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. | tekenreeks[] |
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. | snaar |
| 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. | snaar |
| 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. | snaar Beperkingen: Patroon = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (vereist) |
| wachtwoord | Het verificatiewachtwoord voor routers die geverifieerde TCP MD5-sessies afdwingen. | snaar 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. | snaar 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-08-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 |
|---|---|---|
| uitgebreidLocatie | 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 | snaar 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) |
| Tags | Resourcetags | Woordenlijst met tagnamen en -waarden. |
| soort | Het resourcetype | "Microsoft. NetworkCloud/kubernetesClusters@2026-08-01-preview" |
Aad-configuratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| adminGroupObjectIds | De lijst met azure Active Directory-groepsobject-id's die een beheerdersrol hebben in het Kubernetes-cluster. | tekenreeks[] (vereist) |
Administrator Configuratie
| Naam | Beschrijving | Waarde |
|---|---|---|
| beheerderGebruikersnaam | 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. | snaar |
| 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' |
AgentPoolUpgradeInstellingen
| 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. | snaar |
| maxNiet beschikbaar | 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. | snaar |
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[] |
| trunkedNetworks | 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. | tekenreeks[] |
| 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. | tekenreeks[] |
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- |
| beschikbaarheidszones | 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. | tekenreeks[] |
| tellen | 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- |
| beschikbaarheidszones | 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. | tekenreeks[] |
| tellen | Het aantal virtuele machines dat deze configuratie gebruikt. | int (vereist) |
| etiketten | De labels die zijn toegepast op de knooppunten in deze agentgroep. | KubernetesLabel[] |
| wijze | 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. | 'Niet van toepassing' 'Systeem' Gebruiker (vereist) |
| naam | De naam die wordt gebruikt voor de resource van de agentgroep die deze agentpool vertegenwoordigt. | snaar 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[] |
| upgrade-instellingen | De configuratie van de agentgroep. | AgentPoolUpgradeInstellingen |
| 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 |
|---|---|---|
| Adressen | 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. | snaar 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-integratie. | 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) |
| kubernetesVersie | De Kubernetes-versie voor dit cluster. | tekenreeks (vereist) |
| BeheerdeResourceGroepConfiguratie | De configuratie van de beheerde resourcegroep die is gekoppeld aan de resource. | ManagedResourceGroupConfiguration- |
| netwerkConfiguratie | 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) |
| waarde | 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. | snaar |
| naam | De naam voor de beheerde resourcegroep. Als dit niet is opgegeven, wordt de unieke naam automatisch gegenereerd. | snaar Beperkingen: Maximale lengte = 75 |
Netwerk configuratie
| 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. | snaar |
| 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. | tekenreeks[] |
| 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. | tekenreeks[] |
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. | snaar |
| 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. | snaar |
| 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. | snaar Beperkingen: Patroon = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (vereist) |
| wachtwoord | Het verificatiewachtwoord voor routers die geverifieerde TCP MD5-sessies afdwingen. | snaar 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. | snaar 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" |