- 最近的
- 2026-05-01-預覽
- 2026-02-01
- 2025-10-01-預覽
- 2025-06-01-preview
- 2025-03-01-預覽版
- 2024-11-01-預覽版
- 2024-09-01-預覽版
- 2024-06-01-預覽版
- 2024-04-01
- 2024-02-01-預覽版
- 2023-12-01-預覽版
- 2023-11-01-預覽版
- 2023-09-01-預覽版
- 2023-07-01-預覽版
- 2023-03-01-預覽版
- 2023-02-01-預覽版
- 2022-10-01-預覽版
- 2022-08-01-預覽版
- 2022-06-01-預覽版
- 2022-02-01-預覽版
- 2022-01-01
- 2021-11-01-預覽版
- 2021-07-01-預覽版
- 2021-05-01
- 2021-01-01-預覽版
- 2020-01-01-預覽版
Bicep 資源定義
managedClusters 資源類型可以使用目標作業來部署:
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。
使用範例
Bicep 範例
部署資源群組的基本範例。
param location string = 'westeurope'
@description('The administrator username for the Service Fabric managed cluster')
param adminUsername string
@secure()
@description('The administrator password for the Service Fabric managed cluster')
param adminPassword string
param resourceName string = 'acctest0001'
resource managedCluster 'Microsoft.ServiceFabric/managedClusters@2021-05-01' = {
name: resourceName
location: location
sku: {
name: 'Standard'
}
properties: {
addonFeatures: [
'DnsService'
]
adminPassword: adminPassword
adminUserName: adminUsername
clientConnectionPort: 12345
clusterUpgradeCadence: 'Wave0'
dnsName: resourceName
httpGatewayConnectionPort: 23456
loadBalancingRules: [
{
backendPort: 8000
frontendPort: 443
probeProtocol: 'http'
probeRequestPath: '/'
protocol: 'tcp'
}
]
networkSecurityRules: [
{
access: 'allow'
destinationAddressPrefixes: [
'0.0.0.0/0'
]
destinationPortRanges: [
'443'
]
direction: 'inbound'
name: 'rule443-allow-fe'
priority: 1000
protocol: 'tcp'
sourceAddressPrefixes: [
'0.0.0.0/0'
]
sourcePortRanges: [
'1-65535'
]
}
]
}
tags: {
Test: 'value'
}
}
資源格式
要建立 Microsoft.ServiceFabric/managedClusters 資源,請將以下 Bicep 加入範本。
resource symbolicname 'Microsoft.ServiceFabric/managedClusters@2026-05-01-preview' = {
location: 'string'
name: 'string'
properties: {
addonFeatures: [
'string'
]
adminPassword: 'string'
adminUserName: 'string'
allocatedOutboundPorts: int
allowRdpAccess: bool
applicationTypeVersionsCleanupPolicy: {
maxUnusedVersionsToKeep: int
}
autoGeneratedDomainNameLabelScope: 'string'
auxiliarySubnets: [
{
enableIpv6: bool
name: 'string'
networkSecurityGroupId: 'string'
privateEndpointNetworkPolicies: 'string'
privateLinkServiceNetworkPolicies: 'string'
}
]
azureActiveDirectory: {
clientApplication: 'string'
clusterApplication: 'string'
tenantId: 'string'
}
clientConnectionPort: int
clients: [
{
commonName: 'string'
isAdmin: bool
issuerThumbprint: 'string'
thumbprint: 'string'
}
]
clusterCodeVersion: 'string'
clusterUpgradeCadence: 'string'
clusterUpgradeMode: 'string'
ddosProtectionPlanId: 'string'
dnsName: 'string'
enableAutoOSUpgrade: bool
enableHttpGatewayExclusiveAuthMode: bool
enableIpv6: bool
enableOutboundOnlyNodeTypes: bool
enableServicePublicIP: bool
fabricSettings: [
{
name: 'string'
parameters: [
{
name: 'string'
value: 'string'
}
]
}
]
httpGatewayConnectionPort: int
httpGatewayTokenAuthConnectionPort: int
ipTags: [
{
ipTagType: 'string'
tag: 'string'
}
]
loadBalancingRules: [
{
backendPort: int
frontendPort: int
loadDistribution: 'string'
probePort: int
probeProtocol: 'string'
probeRequestPath: 'string'
protocol: 'string'
}
]
networkSecurityRules: [
{
access: 'string'
description: 'string'
destinationAddressPrefix: 'string'
destinationAddressPrefixes: [
'string'
]
destinationPortRange: 'string'
destinationPortRanges: [
'string'
]
direction: 'string'
name: 'string'
priority: int
protocol: 'string'
sourceAddressPrefix: 'string'
sourceAddressPrefixes: [
'string'
]
sourcePortRange: 'string'
sourcePortRanges: [
'string'
]
}
]
publicIPPrefixId: 'string'
publicIPv6PrefixId: 'string'
serviceEndpoints: [
{
locations: [
'string'
]
networkIdentifier: 'string'
service: 'string'
}
]
skipManagedNsgAssignment: bool
subnetId: 'string'
upgradeDescription: {
deltaHealthPolicy: {
maxPercentDeltaUnhealthyApplications: int
maxPercentDeltaUnhealthyNodes: int
maxPercentUpgradeDomainDeltaUnhealthyNodes: int
}
forceRestart: bool
healthPolicy: {
maxPercentUnhealthyApplications: int
maxPercentUnhealthyNodes: int
}
monitoringPolicy: {
healthCheckRetryTimeout: 'string'
healthCheckStableDuration: 'string'
healthCheckWaitDuration: 'string'
upgradeDomainTimeout: 'string'
upgradeTimeout: 'string'
}
upgradeReplicaSetCheckTimeout: 'string'
}
useCustomVnet: bool
VMImage: 'string'
zonalResiliency: bool
zonalUpdateMode: 'string'
}
sku: {
name: 'string'
}
tags: {
{customized property}: 'string'
}
}
屬性值
Microsoft.ServiceFabric/managedClusters
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 位置 | 資源所在的地理位置 | 字串 (必要) |
| 名稱 | 資源名稱 | 字串 (必要) |
| 屬性 | 受控叢集資源屬性 | ManagedClusterProperties |
| SKU | 受控叢集的SKU | Sku (必要) |
| 標記 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
ApplicationTypeVersionsCleanupPolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| maxUnusedVersionsToKeep | 要保留的每個應用程式類型未使用的版本數目。 | int 約束: 最小值 = 0 (必要) |
AzureActiveDirectory
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 用戶端應用程式 | Azure Active Directory client application id. | 字串 |
| cluster應用程式 | Azure Active Directory cluster application id. | 字串 |
| 租戶ID | Azure Active Directory tenant id. | 字串 |
用戶端憑證
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 通用名稱 | 憑證一般名稱。 | 字串 |
| isAdmin | 指出客戶端憑證是否具有叢集的系統管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | 布林 (必要) |
| issuerThumbprint | 憑證的簽發者指紋。 只能與 CommonName 搭配使用。 | 字串 |
| 指紋 | 憑證指紋。 | 字串 |
ClusterHealthPolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| maxPercentUnhealthy應用程式 | 報告錯誤之前,允許的應用程式狀況不良百分比上限。 例如,若要允許10個應用程式% 狀況不良,這個值會是10。 百分比代表在叢集視為錯誤之前,可能狀況不良的應用程式最大容許百分比。 如果遵守百分比,但至少有一個狀況不良的應用程式,則健康情況會評估為Warning。 這是藉由將狀況不良的應用程式數目除以叢集中應用程式實例總數,不包括 ApplicationTypeHealthPolicyMap 中包含的應用程式類型應用程式。 計算會四捨五入,以容許少量應用程序發生一個失敗。 默認百分比為零。 |
int 約束: 最小值 = 0 最大值 = 100 (必要) |
| maxPercentUnhealthyNodes | 報告錯誤之前,允許狀況不良節點的百分比上限。 例如,若要允許10個節點% 狀況不良,這個值會是10。 百分比代表在叢集視為錯誤之前,可狀況不良之節點的最大容許百分比。 如果遵守百分比,但至少有一個狀況不良的節點,則健康情況會評估為Warning。 百分比的計算方式是將狀況不良的節點數目除以叢集中的節點總數。 計算會四捨五入,以容忍少數節點上可能發生的一次失敗。 默認百分比為零。 在大型叢集中,某些節點一律會關閉或關閉以進行修復,因此應該將此百分比設定為容許該百分比。 |
int 約束: 最小值 = 0 最大值 = 100 (必要) |
ClusterMonitoringPolicy 的
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| healthCheckRetryTimeout | 在升級復原之前,當應用程式或叢集情況不良時,重試健康情況評估的時間量。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| healthCheckStableDuration | 在升級繼續進行下一個升級網域之前,應用程式或叢集必須保持狀況良好的時間量。 持續時間可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| healthCheckWaitDuration | 在執行健康狀態檢查之前,完成升級網域之後要等待的時間長度。 持續時間可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| upgradeDomainTimeout | 每個升級網域在升級回復之前必須完成的時間量。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| upgradeTimeout | 升級復原之前,整體升級必須完成的時間量。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
ClusterUpgradeDeltaHealthPolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | 叢集升級期間允許的應用程式健康情況降低百分比上限。 差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。 檢查會在每個升級網域升級完成之後執行,以確保叢集的全域狀態在容許的限制內。 系統服務不包含在此專案中。 注意:此值會覆寫屬性中指定的值。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications |
int 約束: 最小值 = 0 最大值 = 100 |
| maxPercentDeltaUnhealthyNodes | 叢集升級期間允許的最大節點健康情況降低百分比。 差異會在升級開始時的節點狀態和健康情況評估時節點的狀態之間測量。 檢查會在每個升級網域升級完成之後執行,以確保叢集的全域狀態在容許的限制內。 |
int 約束: 最小值 = 0 最大值 = 100 (必要) |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | 叢集升級期間允許升級網域節點健康情況降低的最大允許百分比。 差異會測量升級網域節點在升級開始時的狀態,以及健康情況評估時升級網域節點的狀態。 檢查會在所有已完成升級網域的每個升級網域完成之後執行,以確保升級網域的狀態在容許的限制內。 |
int 約束: 最小值 = 0 最大值 = 100 |
ClusterUpgradePolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| deltaHealthPolicy (簡體中文) | 叢集差異健康情況原則會定義用來評估叢集升級期間叢集健康情況的健康情況原則。 | ClusterUpgradeDeltaHealthPolicy |
| forceRestart 強制重啟 | 如果為 true,則即使程式代碼版本未變更,也會強制在升級期間重新啟動進程(升級只會變更組態或數據)。 | 布爾 (bool) |
| 健康政策 | 叢集健康狀態原則會定義用來評估叢集升級期間叢集健康情況的健康情況原則。 | ClusterHealthPolicy |
| monitoringPolicy (監控策略) | 叢集監視原則描述在受監視模式中監視升級的參數。 | ClusterMonitoringPolicy 的 |
| upgradeReplicaSetCheckTimeout | 封鎖升級網域處理的時間上限,並避免在發生非預期的問題時遺失可用性。 當此逾時到期時,不論可用性遺失問題為何,升級網域的處理都會繼續。 逾時會在每個升級網域開始時重設。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 此值必須介於 00:00:00 和 49710.06:28:15 之間(秒的無符號 32 位整數) |
字串 |
IpTag
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| ipTag類型 | IP 標籤類型。 範例:FirstPartyUsage。 | 字串 (必要) |
| 加標籤 | 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 | 字串 (必要) |
LoadBalancing規則
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| backendPort | 用於端點上內部連線的埠。 可接受的值介於 1 到 65535 之間。 | int 約束: 最小值 = 1 最大值 = 65534 (必要) |
| frontendPort | 外部端點的連接埠。 每個規則的埠號必須在 Load Balancer 內唯一。 可接受的值為 1 到 65534。 | int 約束: 最小值 = 1 最大值 = 65534 (必要) |
| 負載分佈 | 此規則的負載分配原則。 | 字串 |
| 探針埠 | 負載平衡規則所使用的探查埠。 可接受的值介於 1 到 65535 之間。 | int 約束: 最小值 = 1 最大值 = 65534 |
| 探針協定 | 負載平衡規則所使用的負載平衡器探查參考。 | “http” 'https' 'tcp' (必要) |
| 探針請求路徑 | 探查要求路徑。 僅支援 HTTP/HTTPS 探查。 | 字串 |
| 通訊協定 | 負載平衡規則所使用的傳輸通訊協議參考。 | 'tcp' 'udp' (必要) |
ManagedClusterProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| addon功能 | 在叢集上啟用的附加元件功能清單。 | 包含任何的字串數組: “BackupRestoreService” “DnsService” “ResourceMonitorService” |
| 管理員密碼 | VM 系統管理員用戶密碼。 | 字串 約束: 敏感性值。 以安全參數的形式傳入。 |
| 管理者用戶名 | VM 系統管理員用戶名稱。 | 字串 (必要) |
| allocatedOutboundPorts | 針對預設負載平衡器後端集區中每個節點配置給SNAT的輸出埠數目。 默認值為 0,會根據集區大小提供動態埠配置。 | 整數 (int) |
| allowRdpAccess | 將此設定為 true 可讓 RDP 存取 VM。 默認 NSG 規則會開啟 RDP 連接埠至因特網,以自定義網路安全性規則加以覆寫。 此設定的預設值為 false。 | 布爾 (bool) |
| applicationTypeVersionsCleanupPolicy | 用來清除未使用版本的原則。 | ApplicationTypeVersionsCleanupPolicy |
| autoGeneratedDomainNameLabelScope | 此屬性是針對叢集憑證使用公用 CA 憑證的進入點。它會指定針對所建立之自定義 FQDN 所允許的重複使用層級,以符合公用 CA 憑證的主體。 | '禁止重複使用' “ResourceGroupReuse” “訂閱重用” “TenantReuse” |
| 輔助子網 | 叢集的輔助子網。 | 子網[] |
| azureActiveDirectory | 叢集的 AAD 驗證設定。 | AzureActiveDirectory |
| clientConnectionPort | 用於與叢集之用戶端連線的埠。 | 整數 (int) |
| 客戶 | 允許管理叢集的客戶端憑證。 | 用戶端證書 |
| clusterCodeVersion | 叢集的 Service Fabric 運行時間版本。 當 clusterUpgradeMode 設定為 'Manual' 時,需要此屬性。 若要取得新叢集可用的 Service Fabric 版本列表,請使用 ClusterVersion API。 若要取得現有叢集可用的版本清單,請使用 availableClusterVersions。 | 字串 |
| clusterUpgradeCadence | 指出發行新的叢集運行時間版本升級何時會套用。 根據預設為 Wave0。 只有在 clusterUpgradeMode 設定為 'Automatic' 時,才會套用叢集UpgradeMode。 | 'Wave0' 'Wave1' '第 2 波' |
| clusterUpgradeMode | 有新的 Service Fabric 執行時間版本可用時,叢集的升級模式。 | “自動” “手動” |
| ddosProtectionPlanId | 指定與叢集虛擬網路相關聯的 DDoS 網路保護計劃資源識別碼。 | 字串 |
| dns名稱 | 叢集 dns 名稱。 | 字串 (必要) |
| enableAutoOSUpgrade | 針對使用作系統映像與版本「最新」建立的節點類型啟用自動OS升級。 此設定的預設值為 false。 | 布爾 (bool) |
| enableHttpGatewayExclusiveAuthMode | 如果為 true,則 HttpGatewayEndpoint 上不允許令牌型驗證。 這需要支援 TLS 1.3 版和更新版本。 如果使用令牌型驗證,則必須定義 HttpGatewayTokenAuthConnectionPort。 | 布爾 (bool) |
| 啟用 Ipv6 | 將此設定為 true 會為叢集所使用的預設 VNet 建立 IPv6 位址空間。 建立叢集之後,就無法變更此設定。 此設定的預設值為 false。 | 布爾 (bool) |
| enableOutboundOnlyNodeTypes | 啟用僅啟用輸出流量的節點類型建立。 如果設定,則會為已啟用輸入流量的節點類型建立個別的負載平衡器後端集區。 只能在建立叢集時設定。 | 布爾 (bool) |
| enableServicePublicIP | 將此設定為 true 會將 IPv4 位址連結為 IPv6 位址的 ServicePublicIP。 只有在叢集上啟用 IPv6 時,才能將它設定為 True。 | 布爾 (bool) |
| fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
| httpGatewayConnectionPort | 用於叢集 HTTP 連線的埠。 | 整數 (int) |
| httpGatewayTokenAuthConnectionPort | 用於對叢集進行令牌驗證型 HTTPS 連線的埠。 無法設定為與 HttpGatewayEndpoint 相同的埠。 | 整數 (int) |
| ip標籤 | 與叢集預設公用IP位址相關聯的IP標籤清單。 | IpTag [] |
| loadBalancing規則 | 套用至叢集公用負載平衡器的負載平衡規則。 | LoadBalancingRule[] |
| networkSecurityRules | 自訂網路安全規則,套用於叢集的 虛擬網路。 | NetworkSecurityRule[] |
| 公共IPPrefixId | 指定負載平衡器將從中配置公用 IPv4 位址之公用 IPv4 前置的資源識別碼。 建立叢集之後,就無法變更此設定。 | 字串 |
| publicIPv6PrefixId | 指定負載平衡器將從中配置公用 IPv6 位址的公用 IPv6 前置碼資源識別碼。 建立叢集之後,就無法變更此設定。 | 字串 |
| serviceEndpoints | 叢集中子網的服務端點。 | ServiceEndpoint[] |
| skipManagedNsgAssignment | 判斷在使用自帶虛擬網路(BYOVNET)配置時,是否跳過將受管理網路安全群組(SF-NSG)指派至叢集子網路。 預設值為 false。 | 布爾 (bool) |
| 子網ID | 如果指定,則會在此子網中建立叢集的節點類型,而不是預設的 VNet。 為叢集指定的 networkSecurityRules 也會套用至此子網。 建立叢集之後,就無法變更此設定。 | 字串 |
| upgrade描述 | 升級叢集時要使用的原則。 | ClusterUpgradePolicy |
| useCustomVnet | 對於新的叢集,此參數表示其使用自備 VNet,但子網是在節點類型層級指定;對於這類叢集,節點類型需要subnetId屬性。 | 布爾 (bool) |
| VMImage | 節點類型設定的 VM 映像。 此屬性會控制要用於叢集的 Service Fabric 元件套件。 允許的值為:「Windows」。 預設值是「Windows」。 | 字串 |
| zonalResiliency (區域彈性) | 指出叢集是否有區域復原能力。 | 布爾 (bool) |
| zonalUpdateMode | 指出跨 Az 叢集的更新模式。 | “快” “標準” |
網路安全規則
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 訪問 | 允許或拒絕網路流量。 | '允許' 'deny' (必要) |
| 說明 | 網路安全性規則描述。 | 字串 |
| destinationAddressPrefix 的 | 目的地位址前置詞。 CIDR 或目的地IP範圍。 星號 『*』 也可以用來比對所有來源 IP。 您也可以使用默認標籤,例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 | 字串 |
| destinationAddress前綴 | 目的地位址前置詞。 CIDR 或目的地IP範圍。 | 字串[] |
| destinationPortRange | 他目的地埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 | 字串 |
| destinationPortRanges | 目的地埠範圍。 | 字串[] |
| 方向 | 網路安全性規則方向。 | “入站” 'outbound' (必要) |
| 名稱 | 網路安全性規則名稱。 | 字串 (必要) |
| 優先權 | 規則的優先順序。 此值的範圍可以是 1000 到 3000。 超出此範圍的值會保留給 Service Fabric ManagerCluster 資源提供者。 集合中每個規則的優先順序號碼必須是唯一的。 優先順序數位越低,規則的優先順序就越高。 | int 約束: 最小值 = 1000 最大值 = 3000 (必要) |
| 通訊協定 | 此規則適用的網路協定。 | '啊' 'ESP' “http” 'https' 'ICMP (國際貨幣委員會) 'tcp' 'udp' (必要) |
| sourceAddressPrefix 的 | CIDR 或來源IP範圍。 星號 『*』 也可以用來比對所有來源 IP。 您也可以使用默認標籤,例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 如果這是輸入規則,請指定網路流量的來源。 | 字串 |
| sourceAddress前綴 | CIDR 或來源IP範圍。 | 字串[] |
| sourcePortRange | 來源埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 | 字串 |
| sourcePort範圍 | 來源埠範圍。 | 字串[] |
ServiceEndpoint 服務
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 地點 | 位置清單。 | 字串[] |
| 網路標識碼 | 指定要在叢集中使用的服務端點的資源識別碼。 | 字串 |
| 服務 | 端點服務的型別。 | 字串 (必要) |
SettingsParameterDescription
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 名稱 | 網狀架構設定的參數名稱。 | 字串 (必要) |
| 價值 | 網狀架構設定的參數值。 | 字串 (必要) |
SettingsSection描述
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 名稱 | 網狀架構設定的區段名稱。 | 字串 (必要) |
| 參數 | 區段中的參數集合。 | SettingsParameterDescription[] (必要) |
SKU
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 名稱 | Sku 名稱。 | “基本” 'Standard' (必要) |
子網路
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 啟用 Ipv6 | 表示啟用 Ipv6 或否。 如果未提供,則會採用與叢集相同的組態。 | 布爾 (bool) |
| 名稱 | 子網名稱。 | 字串 (必要) |
| networkSecurityGroupId | 網路安全組的完整資源標識碼。 | 字串 |
| privateEndpointNetwork策略 | 在子網的私人端點上啟用或停用套用網路原則。 | '已禁用' '已啟用' |
| privateLinkServiceNetwork策略 | 在子網中的私人連結服務上啟用或停用套用網路原則。 | '已禁用' '已啟用' |
TrackedResourceTags
| 名稱 | 說明 | 價值觀 |
|---|
ARM 樣本資源定義
managedClusters 資源類型可以使用目標作業來部署:
使用範例
資源格式
若要建立 Microsoft.ServiceFabric/managedClusters 資源,請將下列 JSON 新增至範本。
{
"type": "Microsoft.ServiceFabric/managedClusters",
"apiVersion": "2026-05-01-preview",
"name": "string",
"location": "string",
"properties": {
"addonFeatures": [ "string" ],
"adminPassword": "string",
"adminUserName": "string",
"allocatedOutboundPorts": "int",
"allowRdpAccess": "bool",
"applicationTypeVersionsCleanupPolicy": {
"maxUnusedVersionsToKeep": "int"
},
"autoGeneratedDomainNameLabelScope": "string",
"auxiliarySubnets": [
{
"enableIpv6": "bool",
"name": "string",
"networkSecurityGroupId": "string",
"privateEndpointNetworkPolicies": "string",
"privateLinkServiceNetworkPolicies": "string"
}
],
"azureActiveDirectory": {
"clientApplication": "string",
"clusterApplication": "string",
"tenantId": "string"
},
"clientConnectionPort": "int",
"clients": [
{
"commonName": "string",
"isAdmin": "bool",
"issuerThumbprint": "string",
"thumbprint": "string"
}
],
"clusterCodeVersion": "string",
"clusterUpgradeCadence": "string",
"clusterUpgradeMode": "string",
"ddosProtectionPlanId": "string",
"dnsName": "string",
"enableAutoOSUpgrade": "bool",
"enableHttpGatewayExclusiveAuthMode": "bool",
"enableIpv6": "bool",
"enableOutboundOnlyNodeTypes": "bool",
"enableServicePublicIP": "bool",
"fabricSettings": [
{
"name": "string",
"parameters": [
{
"name": "string",
"value": "string"
}
]
}
],
"httpGatewayConnectionPort": "int",
"httpGatewayTokenAuthConnectionPort": "int",
"ipTags": [
{
"ipTagType": "string",
"tag": "string"
}
],
"loadBalancingRules": [
{
"backendPort": "int",
"frontendPort": "int",
"loadDistribution": "string",
"probePort": "int",
"probeProtocol": "string",
"probeRequestPath": "string",
"protocol": "string"
}
],
"networkSecurityRules": [
{
"access": "string",
"description": "string",
"destinationAddressPrefix": "string",
"destinationAddressPrefixes": [ "string" ],
"destinationPortRange": "string",
"destinationPortRanges": [ "string" ],
"direction": "string",
"name": "string",
"priority": "int",
"protocol": "string",
"sourceAddressPrefix": "string",
"sourceAddressPrefixes": [ "string" ],
"sourcePortRange": "string",
"sourcePortRanges": [ "string" ]
}
],
"publicIPPrefixId": "string",
"publicIPv6PrefixId": "string",
"serviceEndpoints": [
{
"locations": [ "string" ],
"networkIdentifier": "string",
"service": "string"
}
],
"skipManagedNsgAssignment": "bool",
"subnetId": "string",
"upgradeDescription": {
"deltaHealthPolicy": {
"maxPercentDeltaUnhealthyApplications": "int",
"maxPercentDeltaUnhealthyNodes": "int",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
},
"forceRestart": "bool",
"healthPolicy": {
"maxPercentUnhealthyApplications": "int",
"maxPercentUnhealthyNodes": "int"
},
"monitoringPolicy": {
"healthCheckRetryTimeout": "string",
"healthCheckStableDuration": "string",
"healthCheckWaitDuration": "string",
"upgradeDomainTimeout": "string",
"upgradeTimeout": "string"
},
"upgradeReplicaSetCheckTimeout": "string"
},
"useCustomVnet": "bool",
"VMImage": "string",
"zonalResiliency": "bool",
"zonalUpdateMode": "string"
},
"sku": {
"name": "string"
},
"tags": {
"{customized property}": "string"
}
}
屬性值
Microsoft.ServiceFabric/managedClusters
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| apiVersion | API 版本 | 『2026-05-01-預覽』 |
| 位置 | 資源所在的地理位置 | 字串 (必要) |
| 名稱 | 資源名稱 | 字串 (必要) |
| 屬性 | 受控叢集資源屬性 | ManagedClusterProperties |
| SKU | 受控叢集的SKU | Sku (必要) |
| 標記 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
| 型別 | 資源類型 | “Microsoft.ServiceFabric/managedClusters” |
ApplicationTypeVersionsCleanupPolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| maxUnusedVersionsToKeep | 要保留的每個應用程式類型未使用的版本數目。 | int 約束: 最小值 = 0 (必要) |
AzureActiveDirectory
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 用戶端應用程式 | Azure Active Directory client application id. | 字串 |
| cluster應用程式 | Azure Active Directory cluster application id. | 字串 |
| 租戶ID | Azure Active Directory tenant id. | 字串 |
用戶端憑證
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 通用名稱 | 憑證一般名稱。 | 字串 |
| isAdmin | 指出客戶端憑證是否具有叢集的系統管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | 布林 (必要) |
| issuerThumbprint | 憑證的簽發者指紋。 只能與 CommonName 搭配使用。 | 字串 |
| 指紋 | 憑證指紋。 | 字串 |
ClusterHealthPolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| maxPercentUnhealthy應用程式 | 報告錯誤之前,允許的應用程式狀況不良百分比上限。 例如,若要允許10個應用程式% 狀況不良,這個值會是10。 百分比代表在叢集視為錯誤之前,可能狀況不良的應用程式最大容許百分比。 如果遵守百分比,但至少有一個狀況不良的應用程式,則健康情況會評估為Warning。 這是藉由將狀況不良的應用程式數目除以叢集中應用程式實例總數,不包括 ApplicationTypeHealthPolicyMap 中包含的應用程式類型應用程式。 計算會四捨五入,以容許少量應用程序發生一個失敗。 默認百分比為零。 |
int 約束: 最小值 = 0 最大值 = 100 (必要) |
| maxPercentUnhealthyNodes | 報告錯誤之前,允許狀況不良節點的百分比上限。 例如,若要允許10個節點% 狀況不良,這個值會是10。 百分比代表在叢集視為錯誤之前,可狀況不良之節點的最大容許百分比。 如果遵守百分比,但至少有一個狀況不良的節點,則健康情況會評估為Warning。 百分比的計算方式是將狀況不良的節點數目除以叢集中的節點總數。 計算會四捨五入,以容忍少數節點上可能發生的一次失敗。 默認百分比為零。 在大型叢集中,某些節點一律會關閉或關閉以進行修復,因此應該將此百分比設定為容許該百分比。 |
int 約束: 最小值 = 0 最大值 = 100 (必要) |
ClusterMonitoringPolicy 的
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| healthCheckRetryTimeout | 在升級復原之前,當應用程式或叢集情況不良時,重試健康情況評估的時間量。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| healthCheckStableDuration | 在升級繼續進行下一個升級網域之前,應用程式或叢集必須保持狀況良好的時間量。 持續時間可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| healthCheckWaitDuration | 在執行健康狀態檢查之前,完成升級網域之後要等待的時間長度。 持續時間可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| upgradeDomainTimeout | 每個升級網域在升級回復之前必須完成的時間量。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| upgradeTimeout | 升級復原之前,整體升級必須完成的時間量。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
ClusterUpgradeDeltaHealthPolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | 叢集升級期間允許的應用程式健康情況降低百分比上限。 差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。 檢查會在每個升級網域升級完成之後執行,以確保叢集的全域狀態在容許的限制內。 系統服務不包含在此專案中。 注意:此值會覆寫屬性中指定的值。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications |
int 約束: 最小值 = 0 最大值 = 100 |
| maxPercentDeltaUnhealthyNodes | 叢集升級期間允許的最大節點健康情況降低百分比。 差異會在升級開始時的節點狀態和健康情況評估時節點的狀態之間測量。 檢查會在每個升級網域升級完成之後執行,以確保叢集的全域狀態在容許的限制內。 |
int 約束: 最小值 = 0 最大值 = 100 (必要) |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | 叢集升級期間允許升級網域節點健康情況降低的最大允許百分比。 差異會測量升級網域節點在升級開始時的狀態,以及健康情況評估時升級網域節點的狀態。 檢查會在所有已完成升級網域的每個升級網域完成之後執行,以確保升級網域的狀態在容許的限制內。 |
int 約束: 最小值 = 0 最大值 = 100 |
ClusterUpgradePolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| deltaHealthPolicy (簡體中文) | 叢集差異健康情況原則會定義用來評估叢集升級期間叢集健康情況的健康情況原則。 | ClusterUpgradeDeltaHealthPolicy |
| forceRestart 強制重啟 | 如果為 true,則即使程式代碼版本未變更,也會強制在升級期間重新啟動進程(升級只會變更組態或數據)。 | 布爾 (bool) |
| 健康政策 | 叢集健康狀態原則會定義用來評估叢集升級期間叢集健康情況的健康情況原則。 | ClusterHealthPolicy |
| monitoringPolicy (監控策略) | 叢集監視原則描述在受監視模式中監視升級的參數。 | ClusterMonitoringPolicy 的 |
| upgradeReplicaSetCheckTimeout | 封鎖升級網域處理的時間上限,並避免在發生非預期的問題時遺失可用性。 當此逾時到期時,不論可用性遺失問題為何,升級網域的處理都會繼續。 逾時會在每個升級網域開始時重設。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 此值必須介於 00:00:00 和 49710.06:28:15 之間(秒的無符號 32 位整數) |
字串 |
IpTag
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| ipTag類型 | IP 標籤類型。 範例:FirstPartyUsage。 | 字串 (必要) |
| 加標籤 | 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 | 字串 (必要) |
LoadBalancing規則
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| backendPort | 用於端點上內部連線的埠。 可接受的值介於 1 到 65535 之間。 | int 約束: 最小值 = 1 最大值 = 65534 (必要) |
| frontendPort | 外部端點的連接埠。 每個規則的埠號必須在 Load Balancer 內唯一。 可接受的值為 1 到 65534。 | int 約束: 最小值 = 1 最大值 = 65534 (必要) |
| 負載分佈 | 此規則的負載分配原則。 | 字串 |
| 探針埠 | 負載平衡規則所使用的探查埠。 可接受的值介於 1 到 65535 之間。 | int 約束: 最小值 = 1 最大值 = 65534 |
| 探針協定 | 負載平衡規則所使用的負載平衡器探查參考。 | “http” 'https' 'tcp' (必要) |
| 探針請求路徑 | 探查要求路徑。 僅支援 HTTP/HTTPS 探查。 | 字串 |
| 通訊協定 | 負載平衡規則所使用的傳輸通訊協議參考。 | 'tcp' 'udp' (必要) |
ManagedClusterProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| addon功能 | 在叢集上啟用的附加元件功能清單。 | 包含任何的字串數組: “BackupRestoreService” “DnsService” “ResourceMonitorService” |
| 管理員密碼 | VM 系統管理員用戶密碼。 | 字串 約束: 敏感性值。 以安全參數的形式傳入。 |
| 管理者用戶名 | VM 系統管理員用戶名稱。 | 字串 (必要) |
| allocatedOutboundPorts | 針對預設負載平衡器後端集區中每個節點配置給SNAT的輸出埠數目。 默認值為 0,會根據集區大小提供動態埠配置。 | 整數 (int) |
| allowRdpAccess | 將此設定為 true 可讓 RDP 存取 VM。 默認 NSG 規則會開啟 RDP 連接埠至因特網,以自定義網路安全性規則加以覆寫。 此設定的預設值為 false。 | 布爾 (bool) |
| applicationTypeVersionsCleanupPolicy | 用來清除未使用版本的原則。 | ApplicationTypeVersionsCleanupPolicy |
| autoGeneratedDomainNameLabelScope | 此屬性是針對叢集憑證使用公用 CA 憑證的進入點。它會指定針對所建立之自定義 FQDN 所允許的重複使用層級,以符合公用 CA 憑證的主體。 | '禁止重複使用' “ResourceGroupReuse” “訂閱重用” “TenantReuse” |
| 輔助子網 | 叢集的輔助子網。 | 子網[] |
| azureActiveDirectory | 叢集的 AAD 驗證設定。 | AzureActiveDirectory |
| clientConnectionPort | 用於與叢集之用戶端連線的埠。 | 整數 (int) |
| 客戶 | 允許管理叢集的客戶端憑證。 | 用戶端證書 |
| clusterCodeVersion | 叢集的 Service Fabric 運行時間版本。 當 clusterUpgradeMode 設定為 'Manual' 時,需要此屬性。 若要取得新叢集可用的 Service Fabric 版本列表,請使用 ClusterVersion API。 若要取得現有叢集可用的版本清單,請使用 availableClusterVersions。 | 字串 |
| clusterUpgradeCadence | 指出發行新的叢集運行時間版本升級何時會套用。 根據預設為 Wave0。 只有在 clusterUpgradeMode 設定為 'Automatic' 時,才會套用叢集UpgradeMode。 | 'Wave0' 'Wave1' '第 2 波' |
| clusterUpgradeMode | 有新的 Service Fabric 執行時間版本可用時,叢集的升級模式。 | “自動” “手動” |
| ddosProtectionPlanId | 指定與叢集虛擬網路相關聯的 DDoS 網路保護計劃資源識別碼。 | 字串 |
| dns名稱 | 叢集 dns 名稱。 | 字串 (必要) |
| enableAutoOSUpgrade | 針對使用作系統映像與版本「最新」建立的節點類型啟用自動OS升級。 此設定的預設值為 false。 | 布爾 (bool) |
| enableHttpGatewayExclusiveAuthMode | 如果為 true,則 HttpGatewayEndpoint 上不允許令牌型驗證。 這需要支援 TLS 1.3 版和更新版本。 如果使用令牌型驗證,則必須定義 HttpGatewayTokenAuthConnectionPort。 | 布爾 (bool) |
| 啟用 Ipv6 | 將此設定為 true 會為叢集所使用的預設 VNet 建立 IPv6 位址空間。 建立叢集之後,就無法變更此設定。 此設定的預設值為 false。 | 布爾 (bool) |
| enableOutboundOnlyNodeTypes | 啟用僅啟用輸出流量的節點類型建立。 如果設定,則會為已啟用輸入流量的節點類型建立個別的負載平衡器後端集區。 只能在建立叢集時設定。 | 布爾 (bool) |
| enableServicePublicIP | 將此設定為 true 會將 IPv4 位址連結為 IPv6 位址的 ServicePublicIP。 只有在叢集上啟用 IPv6 時,才能將它設定為 True。 | 布爾 (bool) |
| fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
| httpGatewayConnectionPort | 用於叢集 HTTP 連線的埠。 | 整數 (int) |
| httpGatewayTokenAuthConnectionPort | 用於對叢集進行令牌驗證型 HTTPS 連線的埠。 無法設定為與 HttpGatewayEndpoint 相同的埠。 | 整數 (int) |
| ip標籤 | 與叢集預設公用IP位址相關聯的IP標籤清單。 | IpTag [] |
| loadBalancing規則 | 套用至叢集公用負載平衡器的負載平衡規則。 | LoadBalancingRule[] |
| networkSecurityRules | 自訂網路安全規則,套用於叢集的 虛擬網路。 | NetworkSecurityRule[] |
| 公共IPPrefixId | 指定負載平衡器將從中配置公用 IPv4 位址之公用 IPv4 前置的資源識別碼。 建立叢集之後,就無法變更此設定。 | 字串 |
| publicIPv6PrefixId | 指定負載平衡器將從中配置公用 IPv6 位址的公用 IPv6 前置碼資源識別碼。 建立叢集之後,就無法變更此設定。 | 字串 |
| serviceEndpoints | 叢集中子網的服務端點。 | ServiceEndpoint[] |
| skipManagedNsgAssignment | 判斷在使用自帶虛擬網路(BYOVNET)配置時,是否跳過將受管理網路安全群組(SF-NSG)指派至叢集子網路。 預設值為 false。 | 布爾 (bool) |
| 子網ID | 如果指定,則會在此子網中建立叢集的節點類型,而不是預設的 VNet。 為叢集指定的 networkSecurityRules 也會套用至此子網。 建立叢集之後,就無法變更此設定。 | 字串 |
| upgrade描述 | 升級叢集時要使用的原則。 | ClusterUpgradePolicy |
| useCustomVnet | 對於新的叢集,此參數表示其使用自備 VNet,但子網是在節點類型層級指定;對於這類叢集,節點類型需要subnetId屬性。 | 布爾 (bool) |
| VMImage | 節點類型設定的 VM 映像。 此屬性會控制要用於叢集的 Service Fabric 元件套件。 允許的值為:「Windows」。 預設值是「Windows」。 | 字串 |
| zonalResiliency (區域彈性) | 指出叢集是否有區域復原能力。 | 布爾 (bool) |
| zonalUpdateMode | 指出跨 Az 叢集的更新模式。 | “快” “標準” |
網路安全規則
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 訪問 | 允許或拒絕網路流量。 | '允許' 'deny' (必要) |
| 說明 | 網路安全性規則描述。 | 字串 |
| destinationAddressPrefix 的 | 目的地位址前置詞。 CIDR 或目的地IP範圍。 星號 『*』 也可以用來比對所有來源 IP。 您也可以使用默認標籤,例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 | 字串 |
| destinationAddress前綴 | 目的地位址前置詞。 CIDR 或目的地IP範圍。 | 字串[] |
| destinationPortRange | 他目的地埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 | 字串 |
| destinationPortRanges | 目的地埠範圍。 | 字串[] |
| 方向 | 網路安全性規則方向。 | “入站” 'outbound' (必要) |
| 名稱 | 網路安全性規則名稱。 | 字串 (必要) |
| 優先權 | 規則的優先順序。 此值的範圍可以是 1000 到 3000。 超出此範圍的值會保留給 Service Fabric ManagerCluster 資源提供者。 集合中每個規則的優先順序號碼必須是唯一的。 優先順序數位越低,規則的優先順序就越高。 | int 約束: 最小值 = 1000 最大值 = 3000 (必要) |
| 通訊協定 | 此規則適用的網路協定。 | '啊' 'ESP' “http” 'https' 'ICMP (國際貨幣委員會) 'tcp' 'udp' (必要) |
| sourceAddressPrefix 的 | CIDR 或來源IP範圍。 星號 『*』 也可以用來比對所有來源 IP。 您也可以使用默認標籤,例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 如果這是輸入規則,請指定網路流量的來源。 | 字串 |
| sourceAddress前綴 | CIDR 或來源IP範圍。 | 字串[] |
| sourcePortRange | 來源埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 | 字串 |
| sourcePort範圍 | 來源埠範圍。 | 字串[] |
ServiceEndpoint 服務
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 地點 | 位置清單。 | 字串[] |
| 網路標識碼 | 指定要在叢集中使用的服務端點的資源識別碼。 | 字串 |
| 服務 | 端點服務的型別。 | 字串 (必要) |
SettingsParameterDescription
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 名稱 | 網狀架構設定的參數名稱。 | 字串 (必要) |
| 價值 | 網狀架構設定的參數值。 | 字串 (必要) |
SettingsSection描述
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 名稱 | 網狀架構設定的區段名稱。 | 字串 (必要) |
| 參數 | 區段中的參數集合。 | SettingsParameterDescription[] (必要) |
SKU
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 名稱 | Sku 名稱。 | “基本” 'Standard' (必要) |
子網路
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 啟用 Ipv6 | 表示啟用 Ipv6 或否。 如果未提供,則會採用與叢集相同的組態。 | 布爾 (bool) |
| 名稱 | 子網名稱。 | 字串 (必要) |
| networkSecurityGroupId | 網路安全組的完整資源標識碼。 | 字串 |
| privateEndpointNetwork策略 | 在子網的私人端點上啟用或停用套用網路原則。 | '已禁用' '已啟用' |
| privateLinkServiceNetwork策略 | 在子網中的私人連結服務上啟用或停用套用網路原則。 | '已禁用' '已啟用' |
TrackedResourceTags
| 名稱 | 說明 | 價值觀 |
|---|
Terraform (AzAPI 提供者) 資源定義
managedClusters 資源類型可以使用目標作業來部署:
- 資源團體 關於每個 API 版本變更屬性的清單,請參見 變更日誌。
使用範例
Terraform 範例
部署資源群組的基本範例。
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 = "westeurope"
}
variable "admin_username" {
type = string
description = "The administrator username for the Service Fabric managed cluster"
}
variable "admin_password" {
type = string
description = "The administrator password for the Service Fabric managed cluster"
sensitive = true
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "managedCluster" {
type = "Microsoft.ServiceFabric/managedClusters@2021-05-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
addonFeatures = [
"DnsService",
]
adminPassword = var.admin_password
adminUserName = var.admin_username
clientConnectionPort = 12345
clusterUpgradeCadence = "Wave0"
dnsName = var.resource_name
httpGatewayConnectionPort = 23456
loadBalancingRules = [
{
backendPort = 8000
frontendPort = 443
probeProtocol = "http"
probeRequestPath = "/"
protocol = "tcp"
},
]
networkSecurityRules = [
{
access = "allow"
destinationAddressPrefixes = [
"0.0.0.0/0",
]
destinationPortRanges = [
"443",
]
direction = "inbound"
name = "rule443-allow-fe"
priority = 1000
protocol = "tcp"
sourceAddressPrefixes = [
"0.0.0.0/0",
]
sourcePortRanges = [
"1-65535",
]
},
]
}
sku = {
name = "Standard"
}
tags = {
Test = "value"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
資源格式
若要建立 Microsoft.ServiceFabric/managedClusters 資源,請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceFabric/managedClusters@2026-05-01-preview"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
addonFeatures = [
"string"
]
adminPassword = "string"
adminUserName = "string"
allocatedOutboundPorts = int
allowRdpAccess = bool
applicationTypeVersionsCleanupPolicy = {
maxUnusedVersionsToKeep = int
}
autoGeneratedDomainNameLabelScope = "string"
auxiliarySubnets = [
{
enableIpv6 = bool
name = "string"
networkSecurityGroupId = "string"
privateEndpointNetworkPolicies = "string"
privateLinkServiceNetworkPolicies = "string"
}
]
azureActiveDirectory = {
clientApplication = "string"
clusterApplication = "string"
tenantId = "string"
}
clientConnectionPort = int
clients = [
{
commonName = "string"
isAdmin = bool
issuerThumbprint = "string"
thumbprint = "string"
}
]
clusterCodeVersion = "string"
clusterUpgradeCadence = "string"
clusterUpgradeMode = "string"
ddosProtectionPlanId = "string"
dnsName = "string"
enableAutoOSUpgrade = bool
enableHttpGatewayExclusiveAuthMode = bool
enableIpv6 = bool
enableOutboundOnlyNodeTypes = bool
enableServicePublicIP = bool
fabricSettings = [
{
name = "string"
parameters = [
{
name = "string"
value = "string"
}
]
}
]
httpGatewayConnectionPort = int
httpGatewayTokenAuthConnectionPort = int
ipTags = [
{
ipTagType = "string"
tag = "string"
}
]
loadBalancingRules = [
{
backendPort = int
frontendPort = int
loadDistribution = "string"
probePort = int
probeProtocol = "string"
probeRequestPath = "string"
protocol = "string"
}
]
networkSecurityRules = [
{
access = "string"
description = "string"
destinationAddressPrefix = "string"
destinationAddressPrefixes = [
"string"
]
destinationPortRange = "string"
destinationPortRanges = [
"string"
]
direction = "string"
name = "string"
priority = int
protocol = "string"
sourceAddressPrefix = "string"
sourceAddressPrefixes = [
"string"
]
sourcePortRange = "string"
sourcePortRanges = [
"string"
]
}
]
publicIPPrefixId = "string"
publicIPv6PrefixId = "string"
serviceEndpoints = [
{
locations = [
"string"
]
networkIdentifier = "string"
service = "string"
}
]
skipManagedNsgAssignment = bool
subnetId = "string"
upgradeDescription = {
deltaHealthPolicy = {
maxPercentDeltaUnhealthyApplications = int
maxPercentDeltaUnhealthyNodes = int
maxPercentUpgradeDomainDeltaUnhealthyNodes = int
}
forceRestart = bool
healthPolicy = {
maxPercentUnhealthyApplications = int
maxPercentUnhealthyNodes = int
}
monitoringPolicy = {
healthCheckRetryTimeout = "string"
healthCheckStableDuration = "string"
healthCheckWaitDuration = "string"
upgradeDomainTimeout = "string"
upgradeTimeout = "string"
}
upgradeReplicaSetCheckTimeout = "string"
}
useCustomVnet = bool
VMImage = "string"
zonalResiliency = bool
zonalUpdateMode = "string"
}
sku = {
name = "string"
}
}
}
屬性值
Microsoft.ServiceFabric/managedClusters
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 位置 | 資源所在的地理位置 | 字串 (必要) |
| 名稱 | 資源名稱 | 字串 (必要) |
| 屬性 | 受控叢集資源屬性 | ManagedClusterProperties |
| SKU | 受控叢集的SKU | Sku (必要) |
| 標記 | 資源標籤 | 標記名稱和值的字典。 |
| 型別 | 資源類型 | 「Microsoft。ServiceFabric/managedClusters@2026-05-01-preview” |
ApplicationTypeVersionsCleanupPolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| maxUnusedVersionsToKeep | 要保留的每個應用程式類型未使用的版本數目。 | int 約束: 最小值 = 0 (必要) |
AzureActiveDirectory
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 用戶端應用程式 | Azure Active Directory client application id. | 字串 |
| cluster應用程式 | Azure Active Directory cluster application id. | 字串 |
| 租戶ID | Azure Active Directory tenant id. | 字串 |
用戶端憑證
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 通用名稱 | 憑證一般名稱。 | 字串 |
| isAdmin | 指出客戶端憑證是否具有叢集的系統管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | 布林 (必要) |
| issuerThumbprint | 憑證的簽發者指紋。 只能與 CommonName 搭配使用。 | 字串 |
| 指紋 | 憑證指紋。 | 字串 |
ClusterHealthPolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| maxPercentUnhealthy應用程式 | 報告錯誤之前,允許的應用程式狀況不良百分比上限。 例如,若要允許10個應用程式% 狀況不良,這個值會是10。 百分比代表在叢集視為錯誤之前,可能狀況不良的應用程式最大容許百分比。 如果遵守百分比,但至少有一個狀況不良的應用程式,則健康情況會評估為Warning。 這是藉由將狀況不良的應用程式數目除以叢集中應用程式實例總數,不包括 ApplicationTypeHealthPolicyMap 中包含的應用程式類型應用程式。 計算會四捨五入,以容許少量應用程序發生一個失敗。 默認百分比為零。 |
int 約束: 最小值 = 0 最大值 = 100 (必要) |
| maxPercentUnhealthyNodes | 報告錯誤之前,允許狀況不良節點的百分比上限。 例如,若要允許10個節點% 狀況不良,這個值會是10。 百分比代表在叢集視為錯誤之前,可狀況不良之節點的最大容許百分比。 如果遵守百分比,但至少有一個狀況不良的節點,則健康情況會評估為Warning。 百分比的計算方式是將狀況不良的節點數目除以叢集中的節點總數。 計算會四捨五入,以容忍少數節點上可能發生的一次失敗。 默認百分比為零。 在大型叢集中,某些節點一律會關閉或關閉以進行修復,因此應該將此百分比設定為容許該百分比。 |
int 約束: 最小值 = 0 最大值 = 100 (必要) |
ClusterMonitoringPolicy 的
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| healthCheckRetryTimeout | 在升級復原之前,當應用程式或叢集情況不良時,重試健康情況評估的時間量。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| healthCheckStableDuration | 在升級繼續進行下一個升級網域之前,應用程式或叢集必須保持狀況良好的時間量。 持續時間可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| healthCheckWaitDuration | 在執行健康狀態檢查之前,完成升級網域之後要等待的時間長度。 持續時間可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| upgradeDomainTimeout | 每個升級網域在升級回復之前必須完成的時間量。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
| upgradeTimeout | 升級復原之前,整體升級必須完成的時間量。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 | 字串 (必要) |
ClusterUpgradeDeltaHealthPolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | 叢集升級期間允許的應用程式健康情況降低百分比上限。 差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。 檢查會在每個升級網域升級完成之後執行,以確保叢集的全域狀態在容許的限制內。 系統服務不包含在此專案中。 注意:此值會覆寫屬性中指定的值。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications |
int 約束: 最小值 = 0 最大值 = 100 |
| maxPercentDeltaUnhealthyNodes | 叢集升級期間允許的最大節點健康情況降低百分比。 差異會在升級開始時的節點狀態和健康情況評估時節點的狀態之間測量。 檢查會在每個升級網域升級完成之後執行,以確保叢集的全域狀態在容許的限制內。 |
int 約束: 最小值 = 0 最大值 = 100 (必要) |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | 叢集升級期間允許升級網域節點健康情況降低的最大允許百分比。 差異會測量升級網域節點在升級開始時的狀態,以及健康情況評估時升級網域節點的狀態。 檢查會在所有已完成升級網域的每個升級網域完成之後執行,以確保升級網域的狀態在容許的限制內。 |
int 約束: 最小值 = 0 最大值 = 100 |
ClusterUpgradePolicy
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| deltaHealthPolicy (簡體中文) | 叢集差異健康情況原則會定義用來評估叢集升級期間叢集健康情況的健康情況原則。 | ClusterUpgradeDeltaHealthPolicy |
| forceRestart 強制重啟 | 如果為 true,則即使程式代碼版本未變更,也會強制在升級期間重新啟動進程(升級只會變更組態或數據)。 | 布爾 (bool) |
| 健康政策 | 叢集健康狀態原則會定義用來評估叢集升級期間叢集健康情況的健康情況原則。 | ClusterHealthPolicy |
| monitoringPolicy (監控策略) | 叢集監視原則描述在受監視模式中監視升級的參數。 | ClusterMonitoringPolicy 的 |
| upgradeReplicaSetCheckTimeout | 封鎖升級網域處理的時間上限,並避免在發生非預期的問題時遺失可用性。 當此逾時到期時,不論可用性遺失問題為何,升級網域的處理都會繼續。 逾時會在每個升級網域開始時重設。 逾時可以是 hh:mm:ss 或 d.hh:mm:ss.ms 格式。 此值必須介於 00:00:00 和 49710.06:28:15 之間(秒的無符號 32 位整數) |
字串 |
IpTag
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| ipTag類型 | IP 標籤類型。 範例:FirstPartyUsage。 | 字串 (必要) |
| 加標籤 | 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 | 字串 (必要) |
LoadBalancing規則
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| backendPort | 用於端點上內部連線的埠。 可接受的值介於 1 到 65535 之間。 | int 約束: 最小值 = 1 最大值 = 65534 (必要) |
| frontendPort | 外部端點的連接埠。 每個規則的埠號必須在 Load Balancer 內唯一。 可接受的值為 1 到 65534。 | int 約束: 最小值 = 1 最大值 = 65534 (必要) |
| 負載分佈 | 此規則的負載分配原則。 | 字串 |
| 探針埠 | 負載平衡規則所使用的探查埠。 可接受的值介於 1 到 65535 之間。 | int 約束: 最小值 = 1 最大值 = 65534 |
| 探針協定 | 負載平衡規則所使用的負載平衡器探查參考。 | “http” 'https' 'tcp' (必要) |
| 探針請求路徑 | 探查要求路徑。 僅支援 HTTP/HTTPS 探查。 | 字串 |
| 通訊協定 | 負載平衡規則所使用的傳輸通訊協議參考。 | 'tcp' 'udp' (必要) |
ManagedClusterProperties
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| addon功能 | 在叢集上啟用的附加元件功能清單。 | 包含任何的字串數組: “BackupRestoreService” “DnsService” “ResourceMonitorService” |
| 管理員密碼 | VM 系統管理員用戶密碼。 | 字串 約束: 敏感性值。 以安全參數的形式傳入。 |
| 管理者用戶名 | VM 系統管理員用戶名稱。 | 字串 (必要) |
| allocatedOutboundPorts | 針對預設負載平衡器後端集區中每個節點配置給SNAT的輸出埠數目。 默認值為 0,會根據集區大小提供動態埠配置。 | 整數 (int) |
| allowRdpAccess | 將此設定為 true 可讓 RDP 存取 VM。 默認 NSG 規則會開啟 RDP 連接埠至因特網,以自定義網路安全性規則加以覆寫。 此設定的預設值為 false。 | 布爾 (bool) |
| applicationTypeVersionsCleanupPolicy | 用來清除未使用版本的原則。 | ApplicationTypeVersionsCleanupPolicy |
| autoGeneratedDomainNameLabelScope | 此屬性是針對叢集憑證使用公用 CA 憑證的進入點。它會指定針對所建立之自定義 FQDN 所允許的重複使用層級,以符合公用 CA 憑證的主體。 | '禁止重複使用' “ResourceGroupReuse” “訂閱重用” “TenantReuse” |
| 輔助子網 | 叢集的輔助子網。 | 子網[] |
| azureActiveDirectory | 叢集的 AAD 驗證設定。 | AzureActiveDirectory |
| clientConnectionPort | 用於與叢集之用戶端連線的埠。 | 整數 (int) |
| 客戶 | 允許管理叢集的客戶端憑證。 | 用戶端證書 |
| clusterCodeVersion | 叢集的 Service Fabric 運行時間版本。 當 clusterUpgradeMode 設定為 'Manual' 時,需要此屬性。 若要取得新叢集可用的 Service Fabric 版本列表,請使用 ClusterVersion API。 若要取得現有叢集可用的版本清單,請使用 availableClusterVersions。 | 字串 |
| clusterUpgradeCadence | 指出發行新的叢集運行時間版本升級何時會套用。 根據預設為 Wave0。 只有在 clusterUpgradeMode 設定為 'Automatic' 時,才會套用叢集UpgradeMode。 | 'Wave0' 'Wave1' '第 2 波' |
| clusterUpgradeMode | 有新的 Service Fabric 執行時間版本可用時,叢集的升級模式。 | “自動” “手動” |
| ddosProtectionPlanId | 指定與叢集虛擬網路相關聯的 DDoS 網路保護計劃資源識別碼。 | 字串 |
| dns名稱 | 叢集 dns 名稱。 | 字串 (必要) |
| enableAutoOSUpgrade | 針對使用作系統映像與版本「最新」建立的節點類型啟用自動OS升級。 此設定的預設值為 false。 | 布爾 (bool) |
| enableHttpGatewayExclusiveAuthMode | 如果為 true,則 HttpGatewayEndpoint 上不允許令牌型驗證。 這需要支援 TLS 1.3 版和更新版本。 如果使用令牌型驗證,則必須定義 HttpGatewayTokenAuthConnectionPort。 | 布爾 (bool) |
| 啟用 Ipv6 | 將此設定為 true 會為叢集所使用的預設 VNet 建立 IPv6 位址空間。 建立叢集之後,就無法變更此設定。 此設定的預設值為 false。 | 布爾 (bool) |
| enableOutboundOnlyNodeTypes | 啟用僅啟用輸出流量的節點類型建立。 如果設定,則會為已啟用輸入流量的節點類型建立個別的負載平衡器後端集區。 只能在建立叢集時設定。 | 布爾 (bool) |
| enableServicePublicIP | 將此設定為 true 會將 IPv4 位址連結為 IPv6 位址的 ServicePublicIP。 只有在叢集上啟用 IPv6 時,才能將它設定為 True。 | 布爾 (bool) |
| fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
| httpGatewayConnectionPort | 用於叢集 HTTP 連線的埠。 | 整數 (int) |
| httpGatewayTokenAuthConnectionPort | 用於對叢集進行令牌驗證型 HTTPS 連線的埠。 無法設定為與 HttpGatewayEndpoint 相同的埠。 | 整數 (int) |
| ip標籤 | 與叢集預設公用IP位址相關聯的IP標籤清單。 | IpTag [] |
| loadBalancing規則 | 套用至叢集公用負載平衡器的負載平衡規則。 | LoadBalancingRule[] |
| networkSecurityRules | 自訂網路安全規則,套用於叢集的 虛擬網路。 | NetworkSecurityRule[] |
| 公共IPPrefixId | 指定負載平衡器將從中配置公用 IPv4 位址之公用 IPv4 前置的資源識別碼。 建立叢集之後,就無法變更此設定。 | 字串 |
| publicIPv6PrefixId | 指定負載平衡器將從中配置公用 IPv6 位址的公用 IPv6 前置碼資源識別碼。 建立叢集之後,就無法變更此設定。 | 字串 |
| serviceEndpoints | 叢集中子網的服務端點。 | ServiceEndpoint[] |
| skipManagedNsgAssignment | 判斷在使用自帶虛擬網路(BYOVNET)配置時,是否跳過將受管理網路安全群組(SF-NSG)指派至叢集子網路。 預設值為 false。 | 布爾 (bool) |
| 子網ID | 如果指定,則會在此子網中建立叢集的節點類型,而不是預設的 VNet。 為叢集指定的 networkSecurityRules 也會套用至此子網。 建立叢集之後,就無法變更此設定。 | 字串 |
| upgrade描述 | 升級叢集時要使用的原則。 | ClusterUpgradePolicy |
| useCustomVnet | 對於新的叢集,此參數表示其使用自備 VNet,但子網是在節點類型層級指定;對於這類叢集,節點類型需要subnetId屬性。 | 布爾 (bool) |
| VMImage | 節點類型設定的 VM 映像。 此屬性會控制要用於叢集的 Service Fabric 元件套件。 允許的值為:「Windows」。 預設值是「Windows」。 | 字串 |
| zonalResiliency (區域彈性) | 指出叢集是否有區域復原能力。 | 布爾 (bool) |
| zonalUpdateMode | 指出跨 Az 叢集的更新模式。 | “快” “標準” |
網路安全規則
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 訪問 | 允許或拒絕網路流量。 | '允許' 'deny' (必要) |
| 說明 | 網路安全性規則描述。 | 字串 |
| destinationAddressPrefix 的 | 目的地位址前置詞。 CIDR 或目的地IP範圍。 星號 『*』 也可以用來比對所有來源 IP。 您也可以使用默認標籤,例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 | 字串 |
| destinationAddress前綴 | 目的地位址前置詞。 CIDR 或目的地IP範圍。 | 字串[] |
| destinationPortRange | 他目的地埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 | 字串 |
| destinationPortRanges | 目的地埠範圍。 | 字串[] |
| 方向 | 網路安全性規則方向。 | “入站” 'outbound' (必要) |
| 名稱 | 網路安全性規則名稱。 | 字串 (必要) |
| 優先權 | 規則的優先順序。 此值的範圍可以是 1000 到 3000。 超出此範圍的值會保留給 Service Fabric ManagerCluster 資源提供者。 集合中每個規則的優先順序號碼必須是唯一的。 優先順序數位越低,規則的優先順序就越高。 | int 約束: 最小值 = 1000 最大值 = 3000 (必要) |
| 通訊協定 | 此規則適用的網路協定。 | '啊' 'ESP' “http” 'https' 'ICMP (國際貨幣委員會) 'tcp' 'udp' (必要) |
| sourceAddressPrefix 的 | CIDR 或來源IP範圍。 星號 『*』 也可以用來比對所有來源 IP。 您也可以使用默認標籤,例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 如果這是輸入規則,請指定網路流量的來源。 | 字串 |
| sourceAddress前綴 | CIDR 或來源IP範圍。 | 字串[] |
| sourcePortRange | 來源埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 | 字串 |
| sourcePort範圍 | 來源埠範圍。 | 字串[] |
ServiceEndpoint 服務
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 地點 | 位置清單。 | 字串[] |
| 網路標識碼 | 指定要在叢集中使用的服務端點的資源識別碼。 | 字串 |
| 服務 | 端點服務的型別。 | 字串 (必要) |
SettingsParameterDescription
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 名稱 | 網狀架構設定的參數名稱。 | 字串 (必要) |
| 價值 | 網狀架構設定的參數值。 | 字串 (必要) |
SettingsSection描述
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 名稱 | 網狀架構設定的區段名稱。 | 字串 (必要) |
| 參數 | 區段中的參數集合。 | SettingsParameterDescription[] (必要) |
SKU
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 名稱 | Sku 名稱。 | “基本” 'Standard' (必要) |
子網路
| 名稱 | 說明 | 價值觀 |
|---|---|---|
| 啟用 Ipv6 | 表示啟用 Ipv6 或否。 如果未提供,則會採用與叢集相同的組態。 | 布爾 (bool) |
| 名稱 | 子網名稱。 | 字串 (必要) |
| networkSecurityGroupId | 網路安全組的完整資源標識碼。 | 字串 |
| privateEndpointNetwork策略 | 在子網的私人端點上啟用或停用套用網路原則。 | '已禁用' '已啟用' |
| privateLinkServiceNetwork策略 | 在子網中的私人連結服務上啟用或停用套用網路原則。 | '已禁用' '已啟用' |
TrackedResourceTags
| 名稱 | 說明 | 價值觀 |
|---|