Udostępnij przez


Floty Microsoft.ContainerService

Definicja zasobu Bicep

Typ zasobu floty można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ContainerService/fleets, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

Microsoft.ContainerService/floty

Nazwa Opis Wartość
tożsamość Tożsamość zarządzana. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 63
Wzorzec = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (wymagane)
właściwości Właściwości specyficzne dla zasobu dla tego zasobu. Właściwości floty
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
Etykiety Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

Profil agenta

Nazwa Opis Wartość
subnetId (identyfikator podsieci) Identyfikator podsieci, do której dołączy węzeł centrum Floty podczas uruchamiania. Jeśli ta wartość nie zostanie określona, zostanie wygenerowana i użyta sieć wirtualna i podsieć. ciąg
Rozmiar maszyny wirtualnej Rozmiar maszyny wirtualnej koncentratora Floty. ciąg

APIServerAccessProfile

Nazwa Opis Wartość
enablePrivateCluster (Klaster prywatny) Czy chcesz utworzyć centrum Floty jako klaster prywatny, czy nie. Bool
enableVnetIntegration (Integracja sieci enableVnetIntegration) Czy włączyć integrację z siecią wirtualną apiserver dla centrum Floty, czy nie. Bool
subnetId (identyfikator podsieci) Podsieć, która ma być używana, gdy jest włączona integracja z siecią wirtualną apiserver. Jest to wymagane podczas tworzenia nowej floty przy użyciu sieci wirtualnej BYO. ciąg

Profil FleetHub

Nazwa Opis Wartość
Profil agenta Profil agenta dla centrum Floty. AgentProfile
apiServerAccessProfile Profil dostępu dla serwera interfejsu API centrum floty. APIServerAccessProfile
dnsPrefiks Prefiks DNS używany do tworzenia nazwy FQDN dla centrum Floty. struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 54
Wzorzec = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

Właściwości floty

Nazwa Opis Wartość
Profil huba Element FleetHubProfile konfiguruje centrum Floty. Profil FleetHub

ManagedServiceIdentity

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

Śledzone tagi zasobów

Nazwa Opis Wartość

UserAssignedIdentities

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

Przykłady użycia

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Opis
Menedżer floty Azure Kubernetes Wdrażanie prywatnej floty Hubful za pomocą usługi Azure Kubernetes Fleet Manager
Menedżer floty Azure Kubernetes Wdrażanie kompleksowej floty za pomocą usługi Azure Kubernetes Fleet Manager
Menedżer floty Azure Kubernetes Wdrażanie floty bez koncentratora za pomocą usługi Azure Kubernetes Fleet Manager

Definicja zasobu szablonu usługi ARM

Typ zasobu floty można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ContainerService/fleets, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

Microsoft.ContainerService/floty

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API "2025-08-01-podgląd"
tożsamość Tożsamość zarządzana. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 63
Wzorzec = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (wymagane)
właściwości Właściwości specyficzne dla zasobu dla tego zasobu. Właściwości floty
Etykiety Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.ContainerService/fleets"

Profil agenta

Nazwa Opis Wartość
subnetId (identyfikator podsieci) Identyfikator podsieci, do której dołączy węzeł centrum Floty podczas uruchamiania. Jeśli ta wartość nie zostanie określona, zostanie wygenerowana i użyta sieć wirtualna i podsieć. ciąg
Rozmiar maszyny wirtualnej Rozmiar maszyny wirtualnej koncentratora Floty. ciąg

APIServerAccessProfile

Nazwa Opis Wartość
enablePrivateCluster (Klaster prywatny) Czy chcesz utworzyć centrum Floty jako klaster prywatny, czy nie. Bool
enableVnetIntegration (Integracja sieci enableVnetIntegration) Czy włączyć integrację z siecią wirtualną apiserver dla centrum Floty, czy nie. Bool
subnetId (identyfikator podsieci) Podsieć, która ma być używana, gdy jest włączona integracja z siecią wirtualną apiserver. Jest to wymagane podczas tworzenia nowej floty przy użyciu sieci wirtualnej BYO. ciąg

Profil FleetHub

Nazwa Opis Wartość
Profil agenta Profil agenta dla centrum Floty. AgentProfile
apiServerAccessProfile Profil dostępu dla serwera interfejsu API centrum floty. APIServerAccessProfile
dnsPrefiks Prefiks DNS używany do tworzenia nazwy FQDN dla centrum Floty. struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 54
Wzorzec = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

Właściwości floty

Nazwa Opis Wartość
Profil huba Element FleetHubProfile konfiguruje centrum Floty. Profil FleetHub

ManagedServiceIdentity

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

Śledzone tagi zasobów

Nazwa Opis Wartość

UserAssignedIdentities

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Template Opis
Menedżer floty Azure Kubernetes

Wdrażanie na platformie Azure
Wdrażanie prywatnej floty Hubful za pomocą usługi Azure Kubernetes Fleet Manager
Menedżer floty Azure Kubernetes

Wdrażanie na platformie Azure
Wdrażanie kompleksowej floty za pomocą usługi Azure Kubernetes Fleet Manager
Menedżer floty Azure Kubernetes

Wdrażanie na platformie Azure
Wdrażanie floty bez koncentratora za pomocą usługi Azure Kubernetes Fleet Manager

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu floty można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ContainerService/fleets, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

Microsoft.ContainerService/floty

Nazwa Opis Wartość
tożsamość Tożsamość zarządzana. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 63
Wzorzec = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ (wymagane)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
właściwości Właściwości specyficzne dla zasobu dla tego zasobu. Właściwości floty
Etykiety Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.ContainerService/fleets@2025-08-01-preview"

Profil agenta

Nazwa Opis Wartość
subnetId (identyfikator podsieci) Identyfikator podsieci, do której dołączy węzeł centrum Floty podczas uruchamiania. Jeśli ta wartość nie zostanie określona, zostanie wygenerowana i użyta sieć wirtualna i podsieć. ciąg
Rozmiar maszyny wirtualnej Rozmiar maszyny wirtualnej koncentratora Floty. ciąg

APIServerAccessProfile

Nazwa Opis Wartość
enablePrivateCluster (Klaster prywatny) Czy chcesz utworzyć centrum Floty jako klaster prywatny, czy nie. Bool
enableVnetIntegration (Integracja sieci enableVnetIntegration) Czy włączyć integrację z siecią wirtualną apiserver dla centrum Floty, czy nie. Bool
subnetId (identyfikator podsieci) Podsieć, która ma być używana, gdy jest włączona integracja z siecią wirtualną apiserver. Jest to wymagane podczas tworzenia nowej floty przy użyciu sieci wirtualnej BYO. ciąg

Profil FleetHub

Nazwa Opis Wartość
Profil agenta Profil agenta dla centrum Floty. AgentProfile
apiServerAccessProfile Profil dostępu dla serwera interfejsu API centrum floty. APIServerAccessProfile
dnsPrefiks Prefiks DNS używany do tworzenia nazwy FQDN dla centrum Floty. struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 54
Wzorzec = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

Właściwości floty

Nazwa Opis Wartość
Profil huba Element FleetHubProfile konfiguruje centrum Floty. Profil FleetHub

ManagedServiceIdentity

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

Śledzone tagi zasobów

Nazwa Opis Wartość

UserAssignedIdentities

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrożenia 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 = {}
  }
}