Compartilhar via


Frotas do Microsoft.ContainerService

Definição de recurso do Bicep

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

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

Formato de recurso

Para criar um recurso Microsoft.ContainerService/fleets, adicione o Bicep a seguir 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/fleets

Nome Descrição Valor
identidade Identidade gerenciada. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (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 esse recurso. FleetProperties
escopo 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 Marcas em modelos

AgentProfile

Nome Descrição Valor
ID da sub-rede A ID da sub-rede na qual o nó do Hub fleet ingressará na inicialização. Se isso não for especificado, uma rede virtual e uma sub-rede serão geradas e usadas. cadeia
vmSize O tamanho da máquina virtual do Hub fleet. cadeia

APIServerAccessProfile

Nome Descrição Valor
ativarPrivateCluster Se o Hub fleet deve ser criado como um cluster privado ou não. Bool
enableVnetIntegration Se deseja habilitar a integração de vnet do apiserver para o Hub fleet ou não. Bool
ID da sub-rede A sub-rede a ser usada quando a integração de vnet do apiserver estiver habilitada. Ele é necessário ao criar uma nova Frota com vnet BYO. cadeia

Perfil do FleetHub

Nome Descrição Valor
agentProfile O perfil do agente para o Hub fleet. AgentProfile
apiServerAccessProfile O perfil de acesso para o servidor de API do Hub fleet. APIServerAccessProfile
dnsPrefixo 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]$

FleetProperties

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 (em que os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhum'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
Identidades Atribuídas pelo Usuário O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor

Exemplos de uso

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
Gerenciador de Frota de Kubernetes do Azure Implantar uma Frota Hubful privada com o Gerenciador de Frotas do Kubernetes do Azure
Gerenciador de Frota de Kubernetes do Azure Implantar uma Frota Hubful com o Gerenciador de Frotas do Kubernetes do Azure
Gerenciador de Frota de Kubernetes do Azure Implantar uma Frota Hubless com o Gerenciador de Frotas do Kubernetes do Azure

Definição de recurso de modelo do ARM

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

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

Formato de recurso

Para criar um recurso Microsoft.ContainerService/fleets, adicione o JSON a seguir 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/fleets

Nome Descrição Valor
apiVersion A versão da API '2025-08-01-preview'
identidade Identidade gerenciada. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (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 esse recurso. FleetProperties
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.ContainerService/fleets'

AgentProfile

Nome Descrição Valor
ID da sub-rede A ID da sub-rede na qual o nó do Hub fleet ingressará na inicialização. Se isso não for especificado, uma rede virtual e uma sub-rede serão geradas e usadas. cadeia
vmSize O tamanho da máquina virtual do Hub fleet. cadeia

APIServerAccessProfile

Nome Descrição Valor
ativarPrivateCluster Se o Hub fleet deve ser criado como um cluster privado ou não. Bool
enableVnetIntegration Se deseja habilitar a integração de vnet do apiserver para o Hub fleet ou não. Bool
ID da sub-rede A sub-rede a ser usada quando a integração de vnet do apiserver estiver habilitada. Ele é necessário ao criar uma nova Frota com vnet BYO. cadeia

Perfil do FleetHub

Nome Descrição Valor
agentProfile O perfil do agente para o Hub fleet. AgentProfile
apiServerAccessProfile O perfil de acesso para o servidor de API do Hub fleet. APIServerAccessProfile
dnsPrefixo 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]$

FleetProperties

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 (em que os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhum'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
Identidades Atribuídas pelo Usuário O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Template Descrição
Gerenciador de Frota de Kubernetes do Azure

Implantar no Azure
Implantar uma Frota Hubful privada com o Gerenciador de Frotas do Kubernetes do Azure
Gerenciador de Frota de Kubernetes do Azure

Implantar no Azure
Implantar uma Frota Hubful com o Gerenciador de Frotas do Kubernetes do Azure
Gerenciador de Frota de Kubernetes do Azure

Implantar no Azure
Implantar uma Frota Hubless com o Gerenciador de Frotas do Kubernetes do Azure

Definição de recurso do Terraform (provedor de AzAPI)

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

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

Formato de recurso

Para criar um recurso Microsoft.ContainerService/fleets, adicione o Terraform a seguir 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/fleets

Nome Descrição Valor
identidade Identidade gerenciada. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (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. cadeia de caracteres (obrigatório)
propriedades As propriedades específicas do recurso para esse recurso. FleetProperties
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.ContainerService/fleets@2025-08-01-preview"

AgentProfile

Nome Descrição Valor
ID da sub-rede A ID da sub-rede na qual o nó do Hub fleet ingressará na inicialização. Se isso não for especificado, uma rede virtual e uma sub-rede serão geradas e usadas. cadeia
vmSize O tamanho da máquina virtual do Hub fleet. cadeia

APIServerAccessProfile

Nome Descrição Valor
ativarPrivateCluster Se o Hub fleet deve ser criado como um cluster privado ou não. Bool
enableVnetIntegration Se deseja habilitar a integração de vnet do apiserver para o Hub fleet ou não. Bool
ID da sub-rede A sub-rede a ser usada quando a integração de vnet do apiserver estiver habilitada. Ele é necessário ao criar uma nova Frota com vnet BYO. cadeia

Perfil do FleetHub

Nome Descrição Valor
agentProfile O perfil do agente para o Hub fleet. AgentProfile
apiServerAccessProfile O perfil de acesso para o servidor de API do Hub fleet. APIServerAccessProfile
dnsPrefixo 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]$

FleetProperties

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 (em que os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhum'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
Identidades Atribuídas pelo Usuário O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor

Exemplos de uso

Exemplos do 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 = {}
  }
}