Partager via


Flottes Microsoft.ContainerService

Définition de ressource Bicep

Le type de ressource de flottes peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ContainerService/fleets, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.ContainerService/fleets@2025-08-01-preview' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    hubProfile: {
      agentProfile: {
        subnetId: 'string'
        vmSize: 'string'
      }
      apiServerAccessProfile: {
        enablePrivateCluster: bool
        enableVnetIntegration: bool
        subnetId: 'string'
      }
      dnsPrefix: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valeurs de la propriété

Microsoft.ContainerService/flottes

Nom Descriptif Valeur
identité Identité managée. ManagedServiceIdentity
lieu Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne

Contraintes:
Longueur minimale = 1
Longueur maximale = 63
Modèle = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (obligatoire)
Propriétés Propriétés spécifiques à la ressource pour cette ressource. FleetProperties
portée Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension .
étiquettes Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

Profil de l’agent

Nom Descriptif Valeur
subnetId ID du sous-réseau auquel le nœud Du hub Fleet se joint au démarrage. S’il n’est pas spécifié, un réseau virtuel et un sous-réseau sont générés et utilisés. ficelle
vmTaille Taille de la machine virtuelle du hub Fleet. ficelle

APIServerAccessProfile

Nom Descriptif Valeur
enablePrivateCluster Indique s’il faut créer le hub Fleet en tant que cluster privé ou non. Bool
enableVnetIntegration Indique s’il faut activer l’intégration du réseau virtuel apiserver pour le hub Fleet ou non. Bool
subnetId Sous-réseau à utiliser lorsque l’intégration au réseau virtuel apiserver est activée. Il est nécessaire lors de la création d’une flotte avec un réseau virtuel BYO. ficelle

FleetHubProfile

Nom Descriptif Valeur
agentProfile Profil de l’agent pour le hub Fleet. Profil de l’agent
apiServerAccessProfile Profil d’accès pour le serveur d’API Fleet Hub. APIServerAccessProfile
dnsPréfixe Préfixe DNS utilisé pour créer le nom de domaine complet pour le hub Fleet. chaîne

Contraintes:
Longueur minimale = 1
Longueur maximale = 54
Modèle = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

FleetProperties

Nom Descriptif Valeur
hubProfile FleetHubProfile configure le hub de la flotte. FleetHubProfile

Identité de Service Gérée (ManagedServiceIdentity)

Nom Descriptif Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). « Aucun »
'SystemAssigned'
« SystemAssigned, UserAssigned »
'UserAssigned' (obligatoire)
Identités attribuées par l'utilisateur Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

TrackedResourceTags

Nom Descriptif Valeur

UserAssignedIdentities

Nom Descriptif Valeur

userAssignedIdentity

Nom Descriptif Valeur

Exemples d’utilisation

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Lime biceps Descriptif
Gestionnaire de flotte Azure Kubernetes Déployer une flotte Hubful privée avec Azure Kubernetes Fleet Manager
Gestionnaire de flotte Azure Kubernetes Déployer une flotte Hubful avec Azure Kubernetes Fleet Manager
Gestionnaire de flotte Azure Kubernetes Déployer une flotte sans hub avec Azure Kubernetes Fleet Manager

Définition de ressource de modèle ARM

Le type de ressource de flottes peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ContainerService/fleets, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.ContainerService/fleets",
  "apiVersion": "2025-08-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "hubProfile": {
      "agentProfile": {
        "subnetId": "string",
        "vmSize": "string"
      },
      "apiServerAccessProfile": {
        "enablePrivateCluster": "bool",
        "enableVnetIntegration": "bool",
        "subnetId": "string"
      },
      "dnsPrefix": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valeurs de la propriété

Microsoft.ContainerService/flottes

Nom Descriptif Valeur
apiVersion Version de l’API '2025-08-01-preview'
identité Identité managée. ManagedServiceIdentity
lieu Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne

Contraintes:
Longueur minimale = 1
Longueur maximale = 63
Modèle = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (obligatoire)
Propriétés Propriétés spécifiques à la ressource pour cette ressource. FleetProperties
étiquettes Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.ContainerService/fleets'

Profil de l’agent

Nom Descriptif Valeur
subnetId ID du sous-réseau auquel le nœud Du hub Fleet se joint au démarrage. S’il n’est pas spécifié, un réseau virtuel et un sous-réseau sont générés et utilisés. ficelle
vmTaille Taille de la machine virtuelle du hub Fleet. ficelle

APIServerAccessProfile

Nom Descriptif Valeur
enablePrivateCluster Indique s’il faut créer le hub Fleet en tant que cluster privé ou non. Bool
enableVnetIntegration Indique s’il faut activer l’intégration du réseau virtuel apiserver pour le hub Fleet ou non. Bool
subnetId Sous-réseau à utiliser lorsque l’intégration au réseau virtuel apiserver est activée. Il est nécessaire lors de la création d’une flotte avec un réseau virtuel BYO. ficelle

FleetHubProfile

Nom Descriptif Valeur
agentProfile Profil de l’agent pour le hub Fleet. Profil de l’agent
apiServerAccessProfile Profil d’accès pour le serveur d’API Fleet Hub. APIServerAccessProfile
dnsPréfixe Préfixe DNS utilisé pour créer le nom de domaine complet pour le hub Fleet. chaîne

Contraintes:
Longueur minimale = 1
Longueur maximale = 54
Modèle = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

FleetProperties

Nom Descriptif Valeur
hubProfile FleetHubProfile configure le hub de la flotte. FleetHubProfile

Identité de Service Gérée (ManagedServiceIdentity)

Nom Descriptif Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). « Aucun »
'SystemAssigned'
« SystemAssigned, UserAssigned »
'UserAssigned' (obligatoire)
Identités attribuées par l'utilisateur Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

TrackedResourceTags

Nom Descriptif Valeur

UserAssignedIdentities

Nom Descriptif Valeur

userAssignedIdentity

Nom Descriptif Valeur

Exemples d’utilisation

Modèles de démarrage rapide Microsoft Azure

Les modèles de démarrage rapide Azure suivants déploient ce type de ressource.

Template Descriptif
Gestionnaire de flotte Azure Kubernetes

Déployer sur Azure
Déployer une flotte Hubful privée avec Azure Kubernetes Fleet Manager
Gestionnaire de flotte Azure Kubernetes

Déployer sur Azure
Déployer une flotte Hubful avec Azure Kubernetes Fleet Manager
Gestionnaire de flotte Azure Kubernetes

Déployer sur Azure
Déployer une flotte sans hub avec Azure Kubernetes Fleet Manager

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource de flottes peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ContainerService/fleets, ajoutez terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/fleets@2025-08-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      hubProfile = {
        agentProfile = {
          subnetId = "string"
          vmSize = "string"
        }
        apiServerAccessProfile = {
          enablePrivateCluster = bool
          enableVnetIntegration = bool
          subnetId = "string"
        }
        dnsPrefix = "string"
      }
    }
  }
}

Valeurs de la propriété

Microsoft.ContainerService/flottes

Nom Descriptif Valeur
identité Identité managée. ManagedServiceIdentity
lieu Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne

Contraintes:
Longueur minimale = 1
Longueur maximale = 63
Modèle = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
Propriétés Propriétés spécifiques à la ressource pour cette ressource. FleetProperties
étiquettes Balises de ressources Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.ContainerService/fleets@2025-08-01-preview »

Profil de l’agent

Nom Descriptif Valeur
subnetId ID du sous-réseau auquel le nœud Du hub Fleet se joint au démarrage. S’il n’est pas spécifié, un réseau virtuel et un sous-réseau sont générés et utilisés. ficelle
vmTaille Taille de la machine virtuelle du hub Fleet. ficelle

APIServerAccessProfile

Nom Descriptif Valeur
enablePrivateCluster Indique s’il faut créer le hub Fleet en tant que cluster privé ou non. Bool
enableVnetIntegration Indique s’il faut activer l’intégration du réseau virtuel apiserver pour le hub Fleet ou non. Bool
subnetId Sous-réseau à utiliser lorsque l’intégration au réseau virtuel apiserver est activée. Il est nécessaire lors de la création d’une flotte avec un réseau virtuel BYO. ficelle

FleetHubProfile

Nom Descriptif Valeur
agentProfile Profil de l’agent pour le hub Fleet. Profil de l’agent
apiServerAccessProfile Profil d’accès pour le serveur d’API Fleet Hub. APIServerAccessProfile
dnsPréfixe Préfixe DNS utilisé pour créer le nom de domaine complet pour le hub Fleet. chaîne

Contraintes:
Longueur minimale = 1
Longueur maximale = 54
Modèle = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

FleetProperties

Nom Descriptif Valeur
hubProfile FleetHubProfile configure le hub de la flotte. FleetHubProfile

Identité de Service Gérée (ManagedServiceIdentity)

Nom Descriptif Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). « Aucun »
'SystemAssigned'
« SystemAssigned, UserAssigned »
'UserAssigned' (obligatoire)
Identités attribuées par l'utilisateur Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

TrackedResourceTags

Nom Descriptif Valeur

UserAssignedIdentities

Nom Descriptif Valeur

userAssignedIdentity

Nom Descriptif Valeur

Exemples d’utilisation

Échantillons Terraform

Un exemple de base de déploiement de Kubernetes Fleet Manager.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "fleet" {
  type      = "Microsoft.ContainerService/fleets@2024-04-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {}
  }
}