Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 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 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 = {}
}
}