Compartir a través de


Flotas de Microsoft.ContainerService

Definición de recursos de Bicep

El tipo de recurso fleets se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.ContainerService/fleets, agregue el siguiente bicep a la plantilla.

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

Valores de propiedad

Microsoft.ContainerService/fleets

Nombre Descripción Importancia
identidad Identidad administrada. managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 63
Patrón = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (obligatorio)
Propiedades Propiedades específicas del recurso para este recurso. FleetProperties
scope Use al crear un recurso en un ámbito diferente del ámbito de implementación. Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

AgentProfile

Nombre Descripción Importancia
subnetId Identificador de la subred a la que se unirá el nodo del centro de flotas al iniciarse. Si no se especifica, se generará y usará una red virtual y una subred. cuerda / cadena
vmSize Tamaño de la máquina virtual del centro de flotas. cuerda / cadena

APIServerAccessProfile

Nombre Descripción Importancia
enablePrivateCluster Si se va a crear el centro de flotas como un clúster privado o no. booleano
enableVnetIntegration Si se va a habilitar la integración de la red virtual de apiserver para el centro de flotas o no. booleano
subnetId Subred que se va a usar cuando está habilitada la integración de la red virtual de apiserver. Es necesario al crear una nueva flota con red virtual BYO. cuerda / cadena

Perfil de FleetHubProfile

Nombre Descripción Importancia
agentProfile El perfil del agente para el centro de flotas. AgentProfile de
apiServerAccessProfile Perfil de acceso para el servidor de LA API de Fleet Hub. APIServerAccessProfile
dnsPrefix Prefijo DNS usado para crear el FQDN para el centro de flotas. cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 54
Patrón = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

FleetProperties

Nombre Descripción Importancia
hubProfile FleetHubProfile configura el centro de Fleet. FleetHubProfile

ManagedServiceIdentity

Nombre Descripción Importancia
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'Asignado al sistema, asignado al usuario'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

TrackedResourceTags

Nombre Descripción Importancia

UserAssignedIdentities

Nombre Descripción Importancia

IdentidadAsignadaPorElUsuario

Nombre Descripción Importancia

Ejemplos de uso

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Descripción
Azure Kubernetes Fleet Manager Implementación de una flota privada de Hubful con Azure Kubernetes Fleet Manager
Azure Kubernetes Fleet Manager Implementación de una flota de Hubful con Azure Kubernetes Fleet Manager
Azure Kubernetes Fleet Manager Implementación de una flota sin hub con Azure Kubernetes Fleet Manager

Definición de recursos de plantilla de ARM

El tipo de recurso fleets se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.ContainerService/fleets, agregue el siguiente JSON a la plantilla.

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

Valores de propiedad

Microsoft.ContainerService/fleets

Nombre Descripción Importancia
apiVersion La versión de api '2025-08-01-avance'
identidad Identidad administrada. managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 63
Patrón = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (obligatorio)
Propiedades Propiedades específicas del recurso para este recurso. FleetProperties
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso "Microsoft.ContainerService/fleets"

AgentProfile

Nombre Descripción Importancia
subnetId Identificador de la subred a la que se unirá el nodo del centro de flotas al iniciarse. Si no se especifica, se generará y usará una red virtual y una subred. cuerda / cadena
vmSize Tamaño de la máquina virtual del centro de flotas. cuerda / cadena

APIServerAccessProfile

Nombre Descripción Importancia
enablePrivateCluster Si se va a crear el centro de flotas como un clúster privado o no. booleano
enableVnetIntegration Si se va a habilitar la integración de la red virtual de apiserver para el centro de flotas o no. booleano
subnetId Subred que se va a usar cuando está habilitada la integración de la red virtual de apiserver. Es necesario al crear una nueva flota con red virtual BYO. cuerda / cadena

Perfil de FleetHubProfile

Nombre Descripción Importancia
agentProfile El perfil del agente para el centro de flotas. AgentProfile de
apiServerAccessProfile Perfil de acceso para el servidor de LA API de Fleet Hub. APIServerAccessProfile
dnsPrefix Prefijo DNS usado para crear el FQDN para el centro de flotas. cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 54
Patrón = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

FleetProperties

Nombre Descripción Importancia
hubProfile FleetHubProfile configura el centro de Fleet. FleetHubProfile

ManagedServiceIdentity

Nombre Descripción Importancia
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'Asignado al sistema, asignado al usuario'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

TrackedResourceTags

Nombre Descripción Importancia

UserAssignedIdentities

Nombre Descripción Importancia

IdentidadAsignadaPorElUsuario

Nombre Descripción Importancia

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Template Descripción
Azure Kubernetes Fleet Manager

Implementación en Azure
Implementación de una flota privada de Hubful con Azure Kubernetes Fleet Manager
Azure Kubernetes Fleet Manager

Implementación en Azure
Implementación de una flota de Hubful con Azure Kubernetes Fleet Manager
Azure Kubernetes Fleet Manager

Implementación en Azure
Implementación de una flota sin hub con Azure Kubernetes Fleet Manager

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso fleets se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.ContainerService/fleets, agregue el siguiente terraform a la plantilla.

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

Valores de propiedad

Microsoft.ContainerService/fleets

Nombre Descripción Importancia
identidad Identidad administrada. managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 63
Patrón = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (obligatorio)
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
Propiedades Propiedades específicas del recurso para este recurso. FleetProperties
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.ContainerService/fleets@2025-08-01-preview"

AgentProfile

Nombre Descripción Importancia
subnetId Identificador de la subred a la que se unirá el nodo del centro de flotas al iniciarse. Si no se especifica, se generará y usará una red virtual y una subred. cuerda / cadena
vmSize Tamaño de la máquina virtual del centro de flotas. cuerda / cadena

APIServerAccessProfile

Nombre Descripción Importancia
enablePrivateCluster Si se va a crear el centro de flotas como un clúster privado o no. booleano
enableVnetIntegration Si se va a habilitar la integración de la red virtual de apiserver para el centro de flotas o no. booleano
subnetId Subred que se va a usar cuando está habilitada la integración de la red virtual de apiserver. Es necesario al crear una nueva flota con red virtual BYO. cuerda / cadena

Perfil de FleetHubProfile

Nombre Descripción Importancia
agentProfile El perfil del agente para el centro de flotas. AgentProfile de
apiServerAccessProfile Perfil de acceso para el servidor de LA API de Fleet Hub. APIServerAccessProfile
dnsPrefix Prefijo DNS usado para crear el FQDN para el centro de flotas. cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 54
Patrón = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

FleetProperties

Nombre Descripción Importancia
hubProfile FleetHubProfile configura el centro de Fleet. FleetHubProfile

ManagedServiceIdentity

Nombre Descripción Importancia
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'Asignado al sistema, asignado al usuario'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

TrackedResourceTags

Nombre Descripción Importancia

UserAssignedIdentities

Nombre Descripción Importancia

IdentidadAsignadaPorElUsuario

Nombre Descripción Importancia

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación 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 = {}
  }
}