Partilhar via


Frotas Microsoft.ContainerService

Definição de recursos do bíceps

O tipo de recurso de frotas pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.ContainerService/fleets, adicione o seguinte Bicep ao seu modelo.

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 propriedade

Microsoft.ContainerService/frotas

Nome Descrição Valor
identidade Identidade gerenciada. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 63
Padrão = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (obrigatório)
propriedades As propriedades específicas do recurso para este recurso. FrotaPropriedades
âmbito Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

Perfil do agente

Nome Descrição Valor
subnetId A ID da sub-rede à qual o nó do hub do Fleet ingressará na inicialização. Se isso não for especificado, uma vnet e uma sub-rede serão geradas e usadas. cadeia (de caracteres)
vmTamanho O tamanho da máquina virtual do hub Fleet. cadeia (de caracteres)

APIServerAccessProfile

Nome Descrição Valor
enablePrivateCluster Criar o hub Fleet como um cluster privado ou não. Bool
enableVnetIntegration Se deve ou não ativar a integração do apiserver vnet para o hub do Fleet. Bool
subnetId A sub-rede a ser usada quando a integração apiserver vnet estiver habilitada. É necessário ao criar uma nova frota com vnet BYO. cadeia (de caracteres)

FleetHubProfile

Nome Descrição Valor
agentProfile O perfil do agente para o hub da Frota. AgentProfile
apiServerAccessProfile O perfil de acesso para o servidor de API do hub do Fleet. APIServerAccessProfile
dnsPrefix Prefixo DNS usado para criar o FQDN para o hub Fleet. cadeia de caracteres

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 54
Padrão = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

FrotaPropriedades

Nome Descrição Valor
hubProfile O FleetHubProfile configura o hub da Frota. FleetHubProfile

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
identidades atribuídas pelo utilizador O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

IdentidadeAtribuídaPeloUtilizador

Nome Descrição Valor

Exemplos de uso

Exemplos de início rápido do Azure

Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
Azure Kubernetes Fleet Manager Implantar uma frota Hubful privada com o Azure Kubernetes Fleet Manager
Azure Kubernetes Fleet Manager Implantar uma frota Hubful com o Azure Kubernetes Fleet Manager
Azure Kubernetes Fleet Manager Implantar uma frota sem hub com o Azure Kubernetes Fleet Manager

Definição de recurso de modelo ARM

O tipo de recurso de frotas pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.ContainerService/fleets, adicione o seguinte JSON ao seu modelo.

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

Microsoft.ContainerService/frotas

Nome Descrição Valor
Versão da API A versão api '2025-08-01-pré-visualização'
identidade Identidade gerenciada. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 63
Padrão = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (obrigatório)
propriedades As propriedades específicas do recurso para este recurso. FrotaPropriedades
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.ContainerService/frotas'

Perfil do agente

Nome Descrição Valor
subnetId A ID da sub-rede à qual o nó do hub do Fleet ingressará na inicialização. Se isso não for especificado, uma vnet e uma sub-rede serão geradas e usadas. cadeia (de caracteres)
vmTamanho O tamanho da máquina virtual do hub Fleet. cadeia (de caracteres)

APIServerAccessProfile

Nome Descrição Valor
enablePrivateCluster Criar o hub Fleet como um cluster privado ou não. Bool
enableVnetIntegration Se deve ou não ativar a integração do apiserver vnet para o hub do Fleet. Bool
subnetId A sub-rede a ser usada quando a integração apiserver vnet estiver habilitada. É necessário ao criar uma nova frota com vnet BYO. cadeia (de caracteres)

FleetHubProfile

Nome Descrição Valor
agentProfile O perfil do agente para o hub da Frota. AgentProfile
apiServerAccessProfile O perfil de acesso para o servidor de API do hub do Fleet. APIServerAccessProfile
dnsPrefix Prefixo DNS usado para criar o FQDN para o hub Fleet. cadeia de caracteres

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 54
Padrão = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

FrotaPropriedades

Nome Descrição Valor
hubProfile O FleetHubProfile configura o hub da Frota. FleetHubProfile

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
identidades atribuídas pelo utilizador O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

IdentidadeAtribuídaPeloUtilizador

Nome Descrição Valor

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

Template Descrição
Azure Kubernetes Fleet Manager

Implantar no Azure
Implantar uma frota Hubful privada com o Azure Kubernetes Fleet Manager
Azure Kubernetes Fleet Manager

Implantar no Azure
Implantar uma frota Hubful com o Azure Kubernetes Fleet Manager
Azure Kubernetes Fleet Manager

Implantar no Azure
Implantar uma frota sem hub com o Azure Kubernetes Fleet Manager

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso de frotas pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.ContainerService/fleets, adicione o seguinte Terraform ao seu modelo.

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 propriedade

Microsoft.ContainerService/frotas

Nome Descrição Valor
identidade Identidade gerenciada. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 63
Padrão = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
propriedades As propriedades específicas do recurso para este recurso. FrotaPropriedades
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.ContainerService/fleets@2025-08-01-preview"

Perfil do agente

Nome Descrição Valor
subnetId A ID da sub-rede à qual o nó do hub do Fleet ingressará na inicialização. Se isso não for especificado, uma vnet e uma sub-rede serão geradas e usadas. cadeia (de caracteres)
vmTamanho O tamanho da máquina virtual do hub Fleet. cadeia (de caracteres)

APIServerAccessProfile

Nome Descrição Valor
enablePrivateCluster Criar o hub Fleet como um cluster privado ou não. Bool
enableVnetIntegration Se deve ou não ativar a integração do apiserver vnet para o hub do Fleet. Bool
subnetId A sub-rede a ser usada quando a integração apiserver vnet estiver habilitada. É necessário ao criar uma nova frota com vnet BYO. cadeia (de caracteres)

FleetHubProfile

Nome Descrição Valor
agentProfile O perfil do agente para o hub da Frota. AgentProfile
apiServerAccessProfile O perfil de acesso para o servidor de API do hub do Fleet. APIServerAccessProfile
dnsPrefix Prefixo DNS usado para criar o FQDN para o hub Fleet. cadeia de caracteres

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 54
Padrão = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

FrotaPropriedades

Nome Descrição Valor
hubProfile O FleetHubProfile configura o hub da Frota. FleetHubProfile

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
identidades atribuídas pelo utilizador O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

IdentidadeAtribuídaPeloUtilizador

Nome Descrição Valor

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação do 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 = {}
  }
}