Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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. | |
| 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. | |
| 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 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 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. | |
| 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 = {}
}
}