Bicep 資源定義
機隊資源類型可以使用目標作業來部署：
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.ContainerService/fleets 資源，請將下列 Bicep 新增至範本。
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'
}
}
屬性值
Microsoft.ContainerService/fleets
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 身分識別 | 受控識別。 | ManagedServiceIdentity |
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名稱 | 資源名稱 | 字串 約束： 最小長度 = 1 最大長度 = 63 模式 = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ （必要） |
| 屬性 | 此資源的資源特定屬性。 | FleetProperties |
| 範圍 | 在與部署範圍不同的範圍內建立資源時，請使用 。 | 將此屬性設定為資源的符號名稱，以套用 擴充資源。 |
| 標記 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
代理簡介
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 子網ID | 艦隊中樞節點將在啟動時加入的子網標識符。 如果未指定此專案，則會產生及使用 vnet 和子網。 | 字串 |
| vmSize | 艦隊中樞的虛擬機大小。 | 字串 |
APIServerAccessProfile
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| enablePrivateCluster | 是否要將 Fleet 中樞建立為私人叢集。 | 布爾 (bool) |
| enableVnetIntegration | 是否要啟用 Fleet 中樞的 apiserver vnet 整合。 | 布爾 (bool) |
| 子網ID | 啟用apiserver vnet整合時要使用的子網。 使用 BYO vnet 建立新的艦隊時，這是必要的。 | 字串 |
FleetHub配置檔
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| agent簡介 | Fleet 中樞的代理程式配置檔。 | 代理簡介 |
| apiServerAccessProfile | Fleet 中樞 API 伺服器的存取設定檔。 | APIServerAccessProfile |
| dns前綴 | 用來建立艦隊中樞 FQDN 的 DNS 前置詞。 | 字串 約束： 最小長度 = 1 最大長度 = 54 圖案 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$ |
FleetProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| hub簡介 | FleetHubProfile 會設定 Fleet 的中樞。 | FleetHub配置檔 |
ManagedServiceIdentity
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 型別 | 受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。 | “無” “系統分配” 'SystemAssigned， UserAssigned' 'UserAssigned' （必要） |
| 使用者指派的身份 | 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件 （{}）。 | UserAssignedIdentities |
TrackedResourceTags
| 名稱 | 說明 | 價值觀 |
|---|
UserAssignedIdentities
| 名稱 | 說明 | 價值觀 |
|---|
UserAssignedIdentity
| 名稱 | 說明 | 價值觀 |
|---|
使用範例
Azure 快速入門範例
下列 Azure 快速入門範本 包含用於部署此資源類型的 Bicep 範例。
| Bicep 檔案 | 說明 |
|---|---|
| Azure Kubernetes 機群管理員 | 使用 Azure Kubernetes 叢集管理員部署私人 Hubful 叢集 |
| Azure Kubernetes 機群管理員 | 使用 Azure Kubernetes Fleet Manager 部署 Hubful 叢集 |
| Azure Kubernetes 機群管理員 | 使用 Azure Kubernetes Fleet Manager 部署無中樞叢集 |
ARM 樣本資源定義
機隊資源類型可以使用目標作業來部署：
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.ContainerService/fleets 資源，請將下列 JSON 新增至範本。
{
"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"
}
}
屬性值
Microsoft.ContainerService/fleets
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| apiVersion | API 版本 | “2025-08-01-預覽” |
| 身分識別 | 受控識別。 | ManagedServiceIdentity |
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名稱 | 資源名稱 | 字串 約束： 最小長度 = 1 最大長度 = 63 模式 = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ （必要） |
| 屬性 | 此資源的資源特定屬性。 | FleetProperties |
| 標記 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
| 型別 | 資源類型 | “Microsoft.ContainerService/fleets” |
代理簡介
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 子網ID | 艦隊中樞節點將在啟動時加入的子網標識符。 如果未指定此專案，則會產生及使用 vnet 和子網。 | 字串 |
| vmSize | 艦隊中樞的虛擬機大小。 | 字串 |
APIServerAccessProfile
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| enablePrivateCluster | 是否要將 Fleet 中樞建立為私人叢集。 | 布爾 (bool) |
| enableVnetIntegration | 是否要啟用 Fleet 中樞的 apiserver vnet 整合。 | 布爾 (bool) |
| 子網ID | 啟用apiserver vnet整合時要使用的子網。 使用 BYO vnet 建立新的艦隊時，這是必要的。 | 字串 |
FleetHub配置檔
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| agent簡介 | Fleet 中樞的代理程式配置檔。 | 代理簡介 |
| apiServerAccessProfile | Fleet 中樞 API 伺服器的存取設定檔。 | APIServerAccessProfile |
| dns前綴 | 用來建立艦隊中樞 FQDN 的 DNS 前置詞。 | 字串 約束： 最小長度 = 1 最大長度 = 54 圖案 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$ |
FleetProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| hub簡介 | FleetHubProfile 會設定 Fleet 的中樞。 | FleetHub配置檔 |
ManagedServiceIdentity
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 型別 | 受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。 | “無” “系統分配” 'SystemAssigned， UserAssigned' 'UserAssigned' （必要） |
| 使用者指派的身份 | 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件 （{}）。 | UserAssignedIdentities |
TrackedResourceTags
| 名稱 | 說明 | 價值觀 |
|---|
UserAssignedIdentities
| 名稱 | 說明 | 價值觀 |
|---|
UserAssignedIdentity
| 名稱 | 說明 | 價值觀 |
|---|
使用範例
Azure 快速入門範本
下列 Azure 快速入門範本 部署此資源類型。
| Template | 說明 |
|---|---|
Azure Kubernetes 機群管理員
|
使用 Azure Kubernetes 叢集管理員部署私人 Hubful 叢集 |
|
Azure Kubernetes 機群管理員
|
使用 Azure Kubernetes Fleet Manager 部署 Hubful 叢集 |
|
Azure Kubernetes 機群管理員
|
使用 Azure Kubernetes Fleet Manager 部署無中樞叢集 |
Terraform （AzAPI 提供者） 資源定義
機隊資源類型可以使用目標作業來部署：
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.ContainerService/fleets 資源，請將下列 Terraform 新增至範本。
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"
}
}
}
}
屬性值
Microsoft.ContainerService/fleets
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 身分識別 | 受控識別。 | ManagedServiceIdentity |
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名稱 | 資源名稱 | 字串 約束： 最小長度 = 1 最大長度 = 63 模式 = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ （必要） |
| parent_id | 要套用此延伸模組資源之資源的標識碼。 | 字串 （必要） |
| 屬性 | 此資源的資源特定屬性。 | FleetProperties |
| 標記 | 資源標籤 | 標記名稱和值的字典。 |
| 型別 | 資源類型 | “Microsoft.ContainerService/fleets@2025-08-01-preview” |
代理簡介
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 子網ID | 艦隊中樞節點將在啟動時加入的子網標識符。 如果未指定此專案，則會產生及使用 vnet 和子網。 | 字串 |
| vmSize | 艦隊中樞的虛擬機大小。 | 字串 |
APIServerAccessProfile
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| enablePrivateCluster | 是否要將 Fleet 中樞建立為私人叢集。 | 布爾 (bool) |
| enableVnetIntegration | 是否要啟用 Fleet 中樞的 apiserver vnet 整合。 | 布爾 (bool) |
| 子網ID | 啟用apiserver vnet整合時要使用的子網。 使用 BYO vnet 建立新的艦隊時，這是必要的。 | 字串 |
FleetHub配置檔
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| agent簡介 | Fleet 中樞的代理程式配置檔。 | 代理簡介 |
| apiServerAccessProfile | Fleet 中樞 API 伺服器的存取設定檔。 | APIServerAccessProfile |
| dns前綴 | 用來建立艦隊中樞 FQDN 的 DNS 前置詞。 | 字串 約束： 最小長度 = 1 最大長度 = 54 圖案 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$ |
FleetProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| hub簡介 | FleetHubProfile 會設定 Fleet 的中樞。 | FleetHub配置檔 |
ManagedServiceIdentity
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 型別 | 受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。 | “無” “系統分配” 'SystemAssigned， UserAssigned' 'UserAssigned' （必要） |
| 使用者指派的身份 | 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件 （{}）。 | UserAssignedIdentities |
TrackedResourceTags
| 名稱 | 說明 | 價值觀 |
|---|
UserAssignedIdentities
| 名稱 | 說明 | 價值觀 |
|---|
UserAssignedIdentity
| 名稱 | 說明 | 價值觀 |
|---|
使用範例
Terraform 範例
部署 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 = {}
}
}