共用方式為

Microsoft.ServiceFabric managedClusters 2023-11-01-preview

  • 發行項

Bicep 資源定義

managedClusters 資源類型可以使用以下列目標作業部署：

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.ServiceFabric/managedClusters 資源，請將下列 Bicep 新增至範本。

resource symbolicname 'Microsoft.ServiceFabric/managedClusters@2023-11-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  properties: {
    addonFeatures: [
      'string'
    ]
    adminPassword: 'string'
    adminUserName: 'string'
    allowRdpAccess: bool
    applicationTypeVersionsCleanupPolicy: {
      maxUnusedVersionsToKeep: int
      maxUnusedVersionsToKeep: int
    }
    auxiliarySubnets: [
      {
        enableIpv6: bool
        name: 'string'
        networkSecurityGroupId: 'string'
        privateEndpointNetworkPolicies: 'string'
        privateLinkServiceNetworkPolicies: 'string'
      }
    ]
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
      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
    enableIpv6: bool
    enableServicePublicIP: bool
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
            name: 'string'
            value: 'string'
          }
        ]
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    httpGatewayConnectionPort: 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'
        ]
        service: 'string'
      }
    ]
    subnetId: 'string'
    upgradeDescription: {
      deltaHealthPolicy: {
        applicationDeltaHealthPolicies: {
          {customized property}: {
            defaultServiceTypeDeltaHealthPolicy: {
              maxPercentDeltaUnhealthyServices: int
            }
            serviceTypeDeltaHealthPolicies: {
              {customized property}: {
                maxPercentDeltaUnhealthyServices: int
              }
            }
          }
        }
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
      }
      forceRestart: bool
      healthCheckRetryTimeout: 'string'
      healthCheckStableDuration: 'string'
      healthCheckWaitDuration: 'string'
      healthPolicy: {
        applicationHealthPolicies: {
          {customized property}: {
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
              maxPercentUnhealthyPartitionsPerService: int
              maxPercentUnhealthyReplicasPerPartition: int
              maxPercentUnhealthyServices: int
            }
            serviceTypeHealthPolicies: {
              {customized property}: {
                maxPercentUnhealthyServices: int
                maxPercentUnhealthyPartitionsPerService: int
                maxPercentUnhealthyReplicasPerPartition: int
                maxPercentUnhealthyServices: int
              }
            }
            considerWarningAsError: bool
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
              maxPercentUnhealthyPartitionsPerService: int
              maxPercentUnhealthyReplicasPerPartition: int
              maxPercentUnhealthyServices: int
            }
            maxPercentUnhealthyDeployedApplications: int
            serviceTypeHealthPolicyMap: {
              {customized property}: {
                maxPercentUnhealthyServices: int
                maxPercentUnhealthyPartitionsPerService: int
                maxPercentUnhealthyReplicasPerPartition: int
                maxPercentUnhealthyServices: int
              }
            }
          }
        }
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
      }
      upgradeDomainTimeout: 'string'
      upgradeReplicaSetCheckTimeout: 'string'
      upgradeTimeout: 'string'
      deltaHealthPolicy: {
        applicationDeltaHealthPolicies: {
          {customized property}: {
            defaultServiceTypeDeltaHealthPolicy: {
              maxPercentDeltaUnhealthyServices: int
            }
            serviceTypeDeltaHealthPolicies: {
              {customized property}: {
                maxPercentDeltaUnhealthyServices: int
              }
            }
          }
        }
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
      }
      forceRestart: bool
      healthPolicy: {
        applicationHealthPolicies: {
          {customized property}: {
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
              maxPercentUnhealthyPartitionsPerService: int
              maxPercentUnhealthyReplicasPerPartition: int
              maxPercentUnhealthyServices: int
            }
            serviceTypeHealthPolicies: {
              {customized property}: {
                maxPercentUnhealthyServices: int
                maxPercentUnhealthyPartitionsPerService: int
                maxPercentUnhealthyReplicasPerPartition: int
                maxPercentUnhealthyServices: int
              }
            }
            considerWarningAsError: bool
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
              maxPercentUnhealthyPartitionsPerService: int
              maxPercentUnhealthyReplicasPerPartition: int
              maxPercentUnhealthyServices: int
            }
            maxPercentUnhealthyDeployedApplications: int
            serviceTypeHealthPolicyMap: {
              {customized property}: {
                maxPercentUnhealthyServices: int
                maxPercentUnhealthyPartitionsPerService: int
                maxPercentUnhealthyReplicasPerPartition: int
                maxPercentUnhealthyServices: int
              }
            }
          }
        }
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
      }
      monitoringPolicy: {
        healthCheckRetryTimeout: 'string'
        healthCheckStableDuration: 'string'
        healthCheckWaitDuration: 'string'
        upgradeDomainTimeout: 'string'
        upgradeTimeout: 'string'
      }
      upgradeReplicaSetCheckTimeout: 'string'
    }
    useCustomVnet: bool
    zonalResiliency: bool
    zonalUpdateMode: 'string'
  }
}

屬性值

managedClusters

名稱 描述 值
NAME 資源名稱 需要字串 ()
location Azure 資源位置。 需要字串 ()
tags Azure 資源標籤。 標記名稱和值的字典。 請參閱 範本中的標籤
sku 受控叢集的SKU 需要sku ()
properties 受控叢集資源屬性 ManagedClusterProperties

ManagedClusterProperties

名稱 描述 值
addonFeatures 在叢集上啟用的附加元件功能清單。 包含任何項目的字串數組：
'BackupRestoreService'
'DnsService'
'ResourceMonitorService'
adminPassword VM 系統管理員用戶密碼。 字串

約束：
敏感性值。 以安全參數的形式傳入。
adminUserName VM 系統管理員用戶名稱。 需要字串 ()
allowRdpAccess 將此設定為 true 可讓 RDP 存取 VM。 默認 NSG 規則會開啟 RDP 連接埠到因特網，可使用自訂的網路安全性規則加以覆寫。 此設定的預設值為 false。 bool
applicationTypeVersionsCleanupPolicy 用來清除未使用版本的原則。 ApplicationTypeVersionsCleanupPolicy
auxiliarySubnets 叢集的輔助子網。 Subnet[]
azureActiveDirectory 叢集的 AAD 驗證設定。 AzureActiveDirectory
clientConnectionPort 用於客戶端連線至叢集的埠。 int
用戶端 允許管理叢集的客戶端憑證。 ClientCertificate[]
clusterCodeVersion 叢集的 Service Fabric 運行時間版本。 當 clusterUpgradeMode 設定為 'Manual' 時，需要這個屬性。 若要取得新叢集的可用 Service Fabric 版本清單，請使用 ClusterVersion API。 若要取得現有叢集的可用版本清單，請使用 availableClusterVersions。 字串
clusterUpgradeCadence 指出發行新的叢集運行時間版本升級之後，何時會套用它們。 預設為 Wave0。 只有在 clusterUpgradeMode 設定為 'Automatic' 時才適用。 'Wave0'
'Wave1'
'Wave2'
clusterUpgradeMode 當有新的 Service Fabric 執行時間版本可用時，叢集的升級模式。 'Automatic'
'Manual'
ddosProtectionPlanId 指定與叢集虛擬網路相關聯的 DDoS 網路保護計劃資源識別碼。 字串
dnsName 叢集 dns 名稱。 字串 (必要)
enableAutoOSUpgrade 將此設定為 true 可針對使用任何平臺 OS 映射搭配版本 『latest』 建立的節點類型自動升級。 此設定的預設值為 false。 bool
enableIpv6 將此設定為 true 會為叢集所使用的預設 VNet 建立 IPv6 位址空間。 建立叢集之後，就無法變更此設定。 此設定的預設值為 false。 bool
enableServicePublicIP 將此設定為 true 會將 IPv4 位址連結為 IPv6 位址的 ServicePublicIP。 只有在叢集上啟用 IPv6 時，才能將它設定為 True。 bool
fabricSettings 要設定叢集的自定義網狀架構設定清單。 SettingsSectionDescription[]
httpGatewayConnectionPort 用於叢集 HTTP 連線的埠。 int
ipTags 與叢集預設公用IP位址相關聯的IP標籤清單。 IPTag[]
loadBalancingRules 套用至叢集公用負載平衡器的負載平衡規則。 LoadBalancingRule[]
networkSecurityRules 套用至叢集 虛擬網路 的自定義網路安全性規則。 NetworkSecurityRule[]
publicIPPrefixId 指定負載平衡器將配置公用 IPv4 位址的來源公用 IPv4 前置詞的資源識別碼。 建立叢集之後，就無法變更此設定。 字串
publicIPv6PrefixId 指定負載平衡器將配置公用 IPv6 位址的來源公用 IPv6 前置詞的資源識別碼。 建立叢集之後，就無法變更此設定。 字串
serviceEndpoints 叢集中子網的服務端點。 ServiceEndpoint[]
subnetId 如果指定，則會在此子網中建立叢集的節點類型，而不是預設的 VNet。 針對叢集指定的 networkSecurityRules 也會套用至此子網。 建立叢集之後，就無法變更此設定。 字串
upgradeDescription 升級叢集時要使用的原則。 ClusterUpgradePolicy
useCustomVnet 對於新的叢集，此參數表示它使用自備 VNet，但子網是在節點類型層級指定;針對這類叢集，節點類型需要subnetId屬性。 bool
zonalResiliency 指出叢集是否有區域復原功能。 bool
zonalUpdateMode 指出跨 Az 叢集的更新模式。 'Fast'
'Standard'

ApplicationTypeVersionsCleanupPolicy

名稱 描述 值
maxUnusedVersionsToKeep 每個應用程式類型要保留的未使用版本數目。 int (必要)

約束：
最小值 = 0
maxUnusedVersionsToKeep 每個應用程式類型要保留的未使用版本數目。 int (必要)

約束：
最小值 = 0

子網路

名稱 描述 值
enableIpv6 表示啟用 Ipv6 或未啟用。 如果未提供，則會採用與叢集相同的設定。 bool
NAME 子網名稱。 字串 (必要)
networkSecurityGroupId 網路安全組的完整資源標識碼。 字串
privateEndpointNetworkPolicies 在子網的私人端點上啟用或停用套用網路原則。 'disabled'
'enabled'
privateLinkServiceNetworkPolicies 在子網中的私人連結服務上啟用或停用套用網路原則。 'disabled'
'enabled'

AzureActiveDirectory

名稱 描述 值
clientApplication Azure Active Directory 用戶端應用程式識別碼。 字串
clusterApplication Azure Active Directory 叢集應用程式標識符。 字串
tenantId Azure Active Directory 租用戶標識符。 字串
clientApplication Azure Active Directory 用戶端應用程式識別碼。 字串
clusterApplication Azure Active Directory 叢集應用程式標識符。 字串
tenantId Azure Active Directory 租用戶標識符。 字串

ClientCertificate

名稱 描述 值
commonName 憑證一般名稱。 字串
isAdmin 指出客戶端憑證是否具有叢集的系統管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 bool (必要)
issuerThumbprint 憑證的簽發者指紋。 僅與 CommonName 搭配使用。 字串
thumbprint 憑證指紋。 字串

SettingsSectionDescription

名稱 描述 值
NAME 網狀架構設定的區段名稱。 字串 (必要)
參數 區段中的參數集合。 SettingsParameterDescription[] (必要)
NAME 網狀架構設定的區段名稱。 字串 (必要)
參數 區段中的參數集合。 SettingsParameterDescription[] (必要)

SettingsParameterDescription

名稱 描述 值
NAME 網狀架構設定的參數名稱。 字串 (必要)
值 網狀架構設定的參數值。 字串 (必要)
NAME 網狀架構設定的參數名稱。 字串 (必要)
值 網狀架構設定的參數值。 字串 (必要)

IPTag

名稱 描述 值
ipTagType IP 標籤類型。 字串 (必要)
標籤 IP 標籤的值。 字串 (必要)

LoadBalancingRule

名稱 描述 值
backendPort 在端點上用於內部連接的連接埠。 可接受的值介於 1 到 65535 之間。 int (必要)

約束：
最小值 = 1
最大值 = 65534
frontendPort 外部端點的連接埠。 每個規則的埠號碼在 Load Balancer 內必須是唯一的。 可接受的值介於 1 到 65534 之間。 需要 int ()

約束：
最小值 = 1
最大值 = 65534
loadDistribution 此規則的負載分配原則。 字串
probePort 負載平衡規則所使用的探查埠。 可接受的值介於 1 到 65535 之間。 int

約束：
最小值 = 1
最大值 = 65534
probeProtocol 負載平衡規則所使用的負載平衡器探查參考。 'http'
'https'
需要 『tcp』 ()
probeRequestPath 探查要求路徑。 僅支援 HTTP/HTTPS 探查。 字串
protocol 負載平衡規則所使用的傳輸通訊協議參考。 'tcp'
需要 『udp』 ()

NetworkSecurityRule

名稱 描述 值
access 允許或拒絕網路流量。 'allow'
需要 『deny』 ()
description 網路安全性規則描述。 字串
destinationAddressPrefix 目的地地址前綴。 CIDR 或目的地IP範圍。 也可用星號 (*) 來比對所有的來源 IP。 您也可以使用默認標籤，例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 字串
destinationAddressPrefixes 目的地位址前置詞。 CIDR 或目的地IP範圍。 string[]
destinationPortRange 他目的地埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 字串
destinationPortRanges 目的地埠範圍。 string[]
direction 網路安全性規則方向。 'inbound'
需要 『outbound』 ()
NAME 網路安全性規則名稱。 需要字串 ()
priority 規則的優先順序。 此值的範圍可以是 1000 到 3000。 此範圍以外的值會保留給 Service Fabric ManagerCluster 資源提供者。 集合中每個規則的優先順序數字必須是唯一的。 優先順序號碼愈小，規則優先順序就愈高。 需要 int ()

約束：
最小值 = 1000
最大值 = 3000
protocol 此規則適用的網路通訊協定。 'ah'
'esp'
'http'
'https'
'icmp'
'tcp'
需要 『udp』 ()
sourceAddressPrefix CIDR 或來源IP範圍。 也可用星號 (*) 來比對所有的來源 IP。 您也可以使用默認標籤，例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 如果這是輸入規則，請指定網路流量的來源。 字串
sourceAddressPrefixes CIDR 或來源IP範圍。 string[]
sourcePortRange 來源埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 字串
sourcePortRanges 來源埠範圍。 string[]

ServiceEndpoint

名稱 描述 值
位置 位置清單。 string[]
service 端點服務的型別。 字串 (必要)

ClusterUpgradePolicy

名稱 描述 值
deltaHealthPolicy 升級叢集時所使用的叢集差異健康情況原則。 ClusterUpgradeDeltaHealthPolicy
forceRestart 如果為 true，則即使程式代碼版本未變更，升級期間仍會強制重新啟動進程 (只會變更組態或數據) 。 bool
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 格式。 字串 (必要)
healthPolicy 升級叢集時使用的叢集健康情況原則。 ClusterHealthPolicy (必要)
upgradeDomainTimeout 每個升級網域在升級復原之前必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 字串 (必要)
upgradeReplicaSetCheckTimeout 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。 此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。 逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 字串 (必要)
upgradeTimeout 在升級復原之前，整體升級必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 字串 (必要)
deltaHealthPolicy 叢集差異健康情況原則會定義用來評估叢集升級期間叢集健康情況的健康情況原則。 ClusterUpgradeDeltaHealthPolicy
forceRestart 如果為 true，則即使程式代碼版本未變更，升級期間仍會強制重新啟動進程 (只會變更組態或數據) 。 bool
healthPolicy 叢集健康狀態原則會定義用來在叢集升級期間評估叢集健康情況的健康情況原則。 ClusterHealthPolicy
monitoringPolicy 叢集監視原則描述監視受監視模式升級的參數。 ClusterMonitoringPolicy
upgradeReplicaSetCheckTimeout 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。
此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。
逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。
此值必須介於 00：00：00 和 49710.06：28：15 之間， (不帶正負號的 32 位整數，以秒為單位)
字串

ClusterUpgradeDeltaHealthPolicy

名稱 描述 值
applicationDeltaHealthPolicies 定義在升級叢集時，用來評估應用程式或其其中一個子實體健康情況的應用程式差異健康情況原則對應。 ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications 叢集升級期間允許的應用程式健康情況降低百分比上限。
差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 系統服務不包含在此專案中。		 int (必要)

約束：
最小值 = 0
最大值 = 100
maxPercentDeltaUnhealthyNodes 在叢集升級期間允許的節點健康情況衰退百分比上限。
差異是測量升級開始時節點的狀態和健康情況評估時節點的狀態之間的差異。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。		 int (必要)

約束：
最小值 = 0
最大值 = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes 在叢集升級期間允許的升級網域節點健康情況衰退百分比上限。
差異是測量升級開始時升級網域節點的狀態和健康情況評估時升級網域節點的狀態之間的差異。
每次所有已完成升級網域的升級網域升級完成後都會執行檢查，以確保升級網域的狀態處於容許的限制範圍內。
 int (必要)

約束：
最小值 = 0
最大值 = 100
maxPercentDeltaUnhealthyApplications 叢集升級期間允許的應用程式健康情況降低百分比上限。
差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 系統服務不包含在此服務中。
注意：此值會覆寫屬性中指定的值。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications		 int

約束：
最小值 = 0
最大值 = 100
maxPercentDeltaUnhealthyNodes 在叢集升級期間允許的節點健康情況衰退百分比上限。
差異是測量升級開始時節點的狀態和健康情況評估時節點的狀態之間的差異。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。		 需要 int ()

約束：
最小值 = 0
最大值 = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes 在叢集升級期間允許的升級網域節點健康情況衰退百分比上限。
差異是測量升級開始時升級網域節點的狀態和健康情況評估時升級網域節點的狀態之間的差異。
每次所有已完成升級網域的升級網域升級完成後都會執行檢查，以確保升級網域的狀態處於容許的限制範圍內。
 int

約束：
最小值 = 0
最大值 = 100

ApplicationDeltaHealthPolicyMap

名稱 描述 值
{自定義屬性} ApplicationDeltaHealthPolicy

ApplicationDeltaHealthPolicy

名稱 描述 值
defaultServiceTypeDeltaHealthPolicy 升級叢集時，預設用來評估服務類型健康情況的差異健全狀況原則。 ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies 每個服務類型名稱的服務類型差異健全狀況原則對應。 對應預設是空的。 ServiceTypeDeltaHealthPolicyMap

ServiceTypeDeltaHealthPolicy

名稱 描述 值
maxPercentDeltaUnhealthyServices 叢集升級期間允許的服務健康情況降低百分比上限。
在升級開始時的服務狀態與健康情況評估時的服務狀態之間，會測量差異。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。
 int

約束：
最小值 = 0
最大值 = 100

ServiceTypeDeltaHealthPolicyMap

名稱 描述 值
{自定義屬性} ServiceTypeDeltaHealthPolicy

ClusterHealthPolicy

名稱 描述 值
applicationHealthPolicies 定義用來評估應用程式或其其中一個子實體健康情況的應用程式健全狀況原則對應。 ApplicationHealthPolicyMap
maxPercentUnhealthyApplications 在報告錯誤之前，允許健康情況不良應用程式的最大百分比。 例如，若要允許 10% 的應用程式健康情況不良，這個值會是 10。

百分比表示在系統將叢集視為錯誤之前，容許應用程式健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的應用程式，則健康情況會評估為 Warning。
此計算是將健康情況不良的應用程式數目除以叢集中應用程式執行個體的總數而得，但不包括 ApplicationTypeHealthPolicyMap 所包含之應用程式類型的應用程式。
針對少量的應用程式數目，計算會四捨五入以容許一個失敗。 預設百分比是零。		 int

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyNodes 在報告錯誤之前，允許健康情況不良節點的最大百分比。 例如，若要允許 10% 的節點健康情況不良，這個值會是 10。

百分比表示在叢集被視為處於錯誤狀態之前，容許節點健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的節點，則健康情況會評估為 Warning。
百分比是將健康情況不良節點數目除以叢集中的節點總數計算而得。
針對較少的節點數目，計算會四捨五入以容許一個失敗。 預設百分比是零。

在大型叢集中，永遠都有一些節點會關閉或需要修復，因此應設定此百分比來容許這種情形。
 int

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyApplications 在報告錯誤之前，允許健康情況不良應用程式的最大百分比。 例如，若要允許 10% 的應用程式健康情況不良，這個值會是 10。

百分比表示在系統將叢集視為錯誤之前，容許應用程式健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的應用程式，則健康情況會評估為 Warning。
此計算是將健康情況不良的應用程式數目除以叢集中應用程式執行個體的總數而得，但不包括 ApplicationTypeHealthPolicyMap 所包含之應用程式類型的應用程式。
針對少量的應用程式數目，計算會四捨五入以容許一個失敗。 預設百分比是零。		 需要 int ()

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyNodes 在報告錯誤之前，允許健康情況不良節點的最大百分比。 例如，若要允許 10% 的節點健康情況不良，這個值會是 10。

百分比表示在叢集被視為處於錯誤狀態之前，容許節點健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的節點，則健康情況會評估為 Warning。
百分比是將健康情況不良節點數目除以叢集中的節點總數計算而得。
針對較少的節點數目，計算會四捨五入以容許一個失敗。 預設百分比是零。

在大型叢集中，永遠都有一些節點會關閉或需要修復，因此應設定此百分比來容許這種情形。
 int (必要)

約束：
最小值 = 0
最大值 = 100

ApplicationHealthPolicyMap

名稱 描述 值
{自定義屬性} ApplicationHealthPolicy

ApplicationHealthPolicy

名稱 描述 值
defaultServiceTypeHealthPolicy 默認用來評估服務類型健康情況的健康情況原則。 ServiceTypeHealthPolicy
serviceTypeHealthPolicies 每個服務類型名稱的服務類型健康情況原則對應。 對應預設是空的。 ServiceTypeHealthPolicyMap
considerWarningAsError 可指示是否將具有相同嚴重性的警告視為錯誤。 bool (必要)
defaultServiceTypeHealthPolicy 默認用來評估服務類型健康情況的健康情況原則。 ServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications 允許的狀況不良已部署應用程式百分比上限。 允許的值是從零到 100 的位元元組值。
百分比代表在應用程式被視為錯誤之前，可能狀況不良的已部署應用程式最大容許百分比。
這會藉由將應用程式目前部署在叢集中的節點數目除以狀況不良部署的應用程式數目來計算。
針對較少的節點數目，計算會四捨五入以容許一個失敗。 預設百分比是零。		 int (必要)
serviceTypeHealthPolicyMap 每個服務類型名稱的服務類型健康情況原則對應。 對應預設是空的。 ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

名稱 描述 值
maxPercentUnhealthyServices 在應用程式被視為錯誤之前，允許處於狀況不良的服務百分比上限。 int

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyPartitionsPerService 每個服務所允許狀況不良分割區的最大百分比。

百分比代表在服務被視為錯誤之前，可處於狀況不良的分割區最大容許百分比。
如果遵守百分比，但至少有一個狀況不良的數據分割，則健康情況會評估為警告。
百分比的計算方式是將狀況不良的數據分割數目除以服務中的數據分割總數。
計算會四捨五入，以容許少數分割區上的一個失敗。		 int (必要)

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyReplicasPerPartition 每個分割區所允許的狀況不良復本百分比上限。

百分比代表在發生錯誤數據分割之前，可處於狀況不良之復本的最大容許百分比。
如果遵守百分比，但至少有一個狀況不良的複本，則健康情況會評估為警告。
百分比的計算方式是將狀況不良的複本數目除以分割區中的複本總數。
計算會四捨五入，以容許少數複本上的一個失敗。		 int (必要)

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyServices 狀況不良服務允許的最大百分比。

百分比代表在應用程式被視為發生錯誤之前，可能會狀況不良之服務的最大容許百分比。
如果遵守百分比，但至少有一個狀況不良的服務，則健康情況會評估為警告。
這會藉由將特定服務類型的狀況不良服務數目除以特定服務類型的服務總數來計算。
計算會四捨五入，以容許少數服務發生一個失敗。
 int (必要)

約束：
最小值 = 0
最大值 = 100

ServiceTypeHealthPolicyMap

名稱 描述 值
{自定義屬性} ServiceTypeHealthPolicy

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 格式。 需要字串 ()

SKU

名稱 描述 值
NAME Sku 名稱。 'Basic'
「標準」 (必要)

ARM 範本資源定義

managedClusters 資源類型可以使用以下列目標作業部署：

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.ServiceFabric/managedClusters 資源，請將下列 JSON 新增至您的範本。

{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "apiVersion": "2023-11-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "properties": {
    "addonFeatures": [ "string" ],
    "adminPassword": "string",
    "adminUserName": "string",
    "allowRdpAccess": "bool",
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": "int",
      "maxUnusedVersionsToKeep": "int"
    },
    "auxiliarySubnets": [
      {
        "enableIpv6": "bool",
        "name": "string",
        "networkSecurityGroupId": "string",
        "privateEndpointNetworkPolicies": "string",
        "privateLinkServiceNetworkPolicies": "string"
      }
    ],
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string",
      "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",
    "enableIpv6": "bool",
    "enableServicePublicIP": "bool",
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string",
            "name": "string",
            "value": "string"
          }
        ],
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string",
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "httpGatewayConnectionPort": "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" ],
        "service": "string"
      }
    ],
    "subnetId": "string",
    "upgradeDescription": {
      "deltaHealthPolicy": {
        "applicationDeltaHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeDeltaHealthPolicy": {
              "maxPercentDeltaUnhealthyServices": "int"
            },
            "serviceTypeDeltaHealthPolicies": {
              "{customized property}": {
                "maxPercentDeltaUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int",
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
      },
      "forceRestart": "bool",
      "healthCheckRetryTimeout": "string",
      "healthCheckStableDuration": "string",
      "healthCheckWaitDuration": "string",
      "healthPolicy": {
        "applicationHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int",
              "maxPercentUnhealthyPartitionsPerService": "int",
              "maxPercentUnhealthyReplicasPerPartition": "int",
              "maxPercentUnhealthyServices": "int"
            },
            "serviceTypeHealthPolicies": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int",
                "maxPercentUnhealthyPartitionsPerService": "int",
                "maxPercentUnhealthyReplicasPerPartition": "int",
                "maxPercentUnhealthyServices": "int"
              }
            },
            "considerWarningAsError": "bool",
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int",
              "maxPercentUnhealthyPartitionsPerService": "int",
              "maxPercentUnhealthyReplicasPerPartition": "int",
              "maxPercentUnhealthyServices": "int"
            },
            "maxPercentUnhealthyDeployedApplications": "int",
            "serviceTypeHealthPolicyMap": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int",
                "maxPercentUnhealthyPartitionsPerService": "int",
                "maxPercentUnhealthyReplicasPerPartition": "int",
                "maxPercentUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int",
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int"
      },
      "upgradeDomainTimeout": "string",
      "upgradeReplicaSetCheckTimeout": "string",
      "upgradeTimeout": "string",
      "deltaHealthPolicy": {
        "applicationDeltaHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeDeltaHealthPolicy": {
              "maxPercentDeltaUnhealthyServices": "int"
            },
            "serviceTypeDeltaHealthPolicies": {
              "{customized property}": {
                "maxPercentDeltaUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int",
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
      },
      "forceRestart": "bool",
      "healthPolicy": {
        "applicationHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int",
              "maxPercentUnhealthyPartitionsPerService": "int",
              "maxPercentUnhealthyReplicasPerPartition": "int",
              "maxPercentUnhealthyServices": "int"
            },
            "serviceTypeHealthPolicies": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int",
                "maxPercentUnhealthyPartitionsPerService": "int",
                "maxPercentUnhealthyReplicasPerPartition": "int",
                "maxPercentUnhealthyServices": "int"
              }
            },
            "considerWarningAsError": "bool",
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int",
              "maxPercentUnhealthyPartitionsPerService": "int",
              "maxPercentUnhealthyReplicasPerPartition": "int",
              "maxPercentUnhealthyServices": "int"
            },
            "maxPercentUnhealthyDeployedApplications": "int",
            "serviceTypeHealthPolicyMap": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int",
                "maxPercentUnhealthyPartitionsPerService": "int",
                "maxPercentUnhealthyReplicasPerPartition": "int",
                "maxPercentUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int",
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int"
      },
      "monitoringPolicy": {
        "healthCheckRetryTimeout": "string",
        "healthCheckStableDuration": "string",
        "healthCheckWaitDuration": "string",
        "upgradeDomainTimeout": "string",
        "upgradeTimeout": "string"
      },
      "upgradeReplicaSetCheckTimeout": "string"
    },
    "useCustomVnet": "bool",
    "zonalResiliency": "bool",
    "zonalUpdateMode": "string"
  }
}

屬性值

managedClusters

名稱 描述 值
類型 資源類型 'Microsoft.ServiceFabric/managedClusters'
apiVersion 資源 API 版本 '2023-11-01-preview'
NAME 資源名稱 需要字串 ()
location Azure 資源位置。 需要字串 ()
tags Azure 資源標籤。 標記名稱和值的字典。 請參閱 範本中的標籤
sku 受控叢集的SKU 需要sku ()
properties 受控叢集資源屬性 ManagedClusterProperties

ManagedClusterProperties

名稱 描述 值
addonFeatures 在叢集上啟用的附加元件功能清單。 包含任何項目的字串數組：
'BackupRestoreService'
'DnsService'
'ResourceMonitorService'
adminPassword VM 系統管理員用戶密碼。 字串

約束：
敏感性值。 以安全參數的形式傳入。
adminUserName VM 系統管理員用戶名稱。 需要字串 ()
allowRdpAccess 將此設定為 true 可讓 RDP 存取 VM。 默認 NSG 規則會開啟 RDP 連接埠到因特網，可使用自訂的網路安全性規則加以覆寫。 此設定的預設值為 false。 bool
applicationTypeVersionsCleanupPolicy 用來清除未使用版本的原則。 ApplicationTypeVersionsCleanupPolicy
auxiliarySubnets 叢集的輔助子網。 Subnet[]
azureActiveDirectory 叢集的 AAD 驗證設定。 AzureActiveDirectory
clientConnectionPort 用於客戶端連線至叢集的埠。 int
用戶端 允許管理叢集的客戶端憑證。 ClientCertificate[]
clusterCodeVersion 叢集的 Service Fabric 運行時間版本。 當 clusterUpgradeMode 設定為 'Manual' 時，需要這個屬性。 若要取得新叢集的可用 Service Fabric 版本清單，請使用 ClusterVersion API。 若要取得現有叢集的可用版本清單，請使用 availableClusterVersions。 字串
clusterUpgradeCadence 指出發行新的叢集運行時間版本升級之後，何時會套用它們。 預設為 Wave0。 只有在 clusterUpgradeMode 設定為 'Automatic' 時才適用。 'Wave0'
'Wave1'
'Wave2'
clusterUpgradeMode 有新的 Service Fabric 執行時間版本可用時，叢集的升級模式。 'Automatic'
'Manual'
ddosProtectionPlanId 指定將與叢集虛擬網路相關聯的 DDoS 網路保護計劃資源識別碼。 字串
dnsName 叢集 dns 名稱。 需要字串 ()
enableAutoOSUpgrade 將此設定為 true 可針對使用任何平臺 OS 映射建立且版本為 'latest' 的節點類型啟用自動 OS 升級。 此設定的預設值為 false。 bool
enableIpv6 將此設定為 true 會為叢集使用的預設 VNet 建立 IPv6 位址空間。 建立叢集之後，就無法變更此設定。 此設定的預設值為 false。 bool
enableServicePublicIP 將此設定為 true 會將 IPv4 位址連結為 IPv6 位址的 ServicePublicIP。 只有在叢集上啟用 IPv6 時，才能將它設定為 True。 bool
fabricSettings 要設定叢集的自定義網狀架構設定清單。 SettingsSectionDescription[]
httpGatewayConnectionPort 用於叢集 HTTP 連線的埠。 int
ipTags 與叢集預設公用IP位址相關聯的IP標籤清單。 IPTag[]
loadBalancingRules 套用至叢集公用負載平衡器的負載平衡規則。 LoadBalancingRule[]
networkSecurityRules 套用至叢集 虛擬網路 的自定義網路安全性規則。 NetworkSecurityRule[]
publicIPPrefixId 指定負載平衡器將配置公用 IPv4 位址的來源公用 IPv4 前置詞的資源識別碼。 建立叢集之後，就無法變更此設定。 字串
publicIPv6PrefixId 指定負載平衡器將配置公用 IPv6 位址的來源公用 IPv6 前置詞的資源識別碼。 建立叢集之後，就無法變更此設定。 字串
serviceEndpoints 叢集中子網的服務端點。 ServiceEndpoint[]
subnetId 如果指定，則會在此子網中建立叢集的節點類型，而不是預設的 VNet。 針對叢集指定的 networkSecurityRules 也會套用至此子網。 建立叢集之後，就無法變更此設定。 字串
upgradeDescription 升級叢集時要使用的原則。 ClusterUpgradePolicy
useCustomVnet 針對新的叢集，此參數表示其使用「攜帶您自己的 VNet」，但子網是在節點類型層級指定;對於這類叢集，節點類型需要subnetId屬性。 bool
zonalResiliency 指出叢集是否有區域復原能力。 bool
zonalUpdateMode 指出跨 Az 叢集的更新模式。 'Fast'
'Standard'

ApplicationTypeVersionsCleanupPolicy

名稱 描述 值
maxUnusedVersionsToKeep 要保留的每個應用程式類型未使用的版本數目。 需要 int ()

約束：
最小值 = 0
maxUnusedVersionsToKeep 要保留的每個應用程式類型未使用的版本數目。 需要 int ()

約束：
最小值 = 0

子網路

名稱 描述 值
enableIpv6 表示我們是否要啟用 Ipv6。 如果未提供，則會採用與叢集相同的設定。 bool
NAME 子網名稱。 需要字串 ()
networkSecurityGroupId 網路安全組的完整資源標識碼。 字串
privateEndpointNetworkPolicies 在子網的私人端點上啟用或停用套用網路原則。 'disabled'
'enabled'
privateLinkServiceNetworkPolicies 在子網中的私人連結服務上啟用或停用套用網路原則。 'disabled'
'enabled'

AzureActiveDirectory

名稱 描述 值
clientApplication Azure Active Directory 用戶端應用程式識別碼。 字串
clusterApplication Azure Active Directory 叢集應用程式標識符。 字串
tenantId Azure Active Directory 租用戶標識符。 字串
clientApplication Azure Active Directory 用戶端應用程式識別碼。 字串
clusterApplication Azure Active Directory 叢集應用程式標識符。 字串
tenantId Azure Active Directory 租用戶標識符。 字串

ClientCertificate

名稱 描述 值
commonName 憑證一般名稱。 字串
isAdmin 指出客戶端憑證是否具有叢集的管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 bool (必要)
issuerThumbprint 憑證的簽發者指紋。 只與 CommonName 搭配使用。 字串
thumbprint 憑證指紋。 字串

SettingsSectionDescription

名稱 描述 值
NAME 網狀架構設定的區段名稱。 需要字串 ()
參數 區段中的參數集合。 SettingsParameterDescription[] (必要)
NAME 網狀架構設定的區段名稱。 需要字串 ()
參數 區段中的參數集合。 SettingsParameterDescription[] (必要)

SettingsParameterDescription

名稱 描述 值
NAME 網狀架構設定的參數名稱。 需要字串 ()
值 網狀架構設定的參數值。 需要字串 ()
NAME 網狀架構設定的參數名稱。 需要字串 ()
值 網狀架構設定的參數值。 需要字串 ()

IPTag

名稱 描述 值
ipTagType IP 標籤類型。 需要字串 ()
標籤 IP 標籤的值。 需要字串 ()

LoadBalancingRule

名稱 描述 值
backendPort 在端點上用於內部連接的連接埠。 可接受的值介於 1 到 65535 之間。 int (必要)

約束：
最小值 = 1
最大值 = 65534
frontendPort 外部端點的連接埠。 每個規則的埠號碼在 Load Balancer 內必須是唯一的。 可接受的值介於 1 到 65534 之間。 int (必要)

約束：
最小值 = 1
最大值 = 65534
loadDistribution 此規則的負載分配原則。 字串
probePort 負載平衡規則所使用的探查埠。 可接受的值介於 1 到 65535 之間。 int

約束：
最小值 = 1
最大值 = 65534
probeProtocol 負載平衡規則所使用的負載平衡器探查參考。 'http'
'https'
'tcp' (必要)
probeRequestPath 探查要求路徑。 僅支援 HTTP/HTTPS 探查。 字串
protocol 負載平衡規則所使用的傳輸通訊協議參考。 'tcp'
'udp' (必要)

NetworkSecurityRule

名稱 描述 值
access 允許或拒絕網路流量。 'allow'
'deny' (必要)
description 網路安全性規則描述。 字串
destinationAddressPrefix 目的地位址前置詞。 CIDR 或目的地IP範圍。 也可用星號 (*) 來比對所有的來源 IP。 您也可以使用默認標籤，例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 字串
destinationAddressPrefixes 目的地位址前置詞。 CIDR 或目的地IP範圍。 string[]
destinationPortRange 他目的地埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 字串
destinationPortRanges 目的地埠範圍。 string[]
direction 網路安全性規則方向。 'inbound'
需要「輸出」 ()
NAME 網路安全性規則名稱。 字串 (必要)
priority 規則的優先順序。 值的範圍可以是 1000 到 3000。 超出此範圍的值會保留給 Service Fabric ManagerCluster 資源提供者。 集合中每個規則的優先順序數字必須是唯一的。 優先順序號碼愈小，規則優先順序就愈高。 int (必要)

約束：
最小值 = 1000
最大值 = 3000
protocol 此規則適用的網路通訊協定。 'ah'
'esp'
'http'
'https'
'icmp'
'tcp'
'udp' (必要)
sourceAddressPrefix CIDR 或來源IP範圍。 也可用星號 (*) 來比對所有的來源 IP。 您也可以使用默認標籤，例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 如果這是輸入規則，請指定網路流量的來源。 字串
sourceAddressPrefixes CIDR 或來源IP範圍。 string[]
sourcePortRange 來源埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 字串
sourcePortRanges 來源埠範圍。 string[]

ServiceEndpoint

名稱 描述 值
位置 位置清單。 string[]
service 端點服務的型別。 需要字串 ()

ClusterUpgradePolicy

名稱 描述 值
deltaHealthPolicy 升級叢集時所使用的叢集差異健全狀況原則。 ClusterUpgradeDeltaHealthPolicy
forceRestart 如果為 true，則即使程式代碼版本未變更，仍會在升級期間強制重新啟動， (升級只會變更組態或數據) 。 bool
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 格式。 需要字串 ()
healthPolicy 升級叢集時所使用的叢集健全狀況原則。 ClusterHealthPolicy (必要)
upgradeDomainTimeout 每個升級網域在升級復原之前必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 需要字串 ()
upgradeReplicaSetCheckTimeout 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。 此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。 逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 需要字串 ()
upgradeTimeout 在升級復原之前，整體升級必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 需要字串 ()
deltaHealthPolicy 叢集差異健全狀況原則會定義健康情況原則，以在叢集升級期間用來評估叢集的健康情況。 ClusterUpgradeDeltaHealthPolicy
forceRestart 如果為 true，則即使程式代碼版本未變更，仍會在升級期間強制重新啟動， (升級只會變更組態或數據) 。 bool
healthPolicy 叢集健康狀態原則會定義健康情況原則，用來在叢集升級期間評估叢集的健康情況。 ClusterHealthPolicy
monitoringPolicy 叢集監視原則描述在受監視模式中監視升級的參數。 ClusterMonitoringPolicy
upgradeReplicaSetCheckTimeout 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。
此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。
逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。
此值必須介於 00：00：00 和 49710.06：28：15 之間， (不帶正負號的 32 位整數，以秒為單位)
字串

ClusterUpgradeDeltaHealthPolicy

名稱 描述 值
applicationDeltaHealthPolicies 定義應用程式差異健全狀況原則對應，用來在升級叢集時評估應用程式或其子實體的健康情況。 ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications 叢集升級期間允許的應用程式健康情況降低百分比上限。
差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 系統服務不包含在此服務中。		 需要 int ()

約束：
最小值 = 0
最大值 = 100
maxPercentDeltaUnhealthyNodes 在叢集升級期間允許的節點健康情況衰退百分比上限。
差異是測量升級開始時節點的狀態和健康情況評估時節點的狀態之間的差異。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。		 需要 int ()

約束：
最小值 = 0
最大值 = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes 在叢集升級期間允許的升級網域節點健康情況衰退百分比上限。
差異是測量升級開始時升級網域節點的狀態和健康情況評估時升級網域節點的狀態之間的差異。
每次所有已完成升級網域的升級網域升級完成後都會執行檢查，以確保升級網域的狀態處於容許的限制範圍內。
 int (必要)

約束：
最小值 = 0
最大值 = 100
maxPercentDeltaUnhealthyApplications 叢集升級期間允許的應用程式健康情況降低百分比上限。
差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 系統服務不包含在此專案中。
注意：此值會覆寫屬性中指定的值。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications		 int

約束：
最小值 = 0
最大值 = 100
maxPercentDeltaUnhealthyNodes 在叢集升級期間允許的節點健康情況衰退百分比上限。
差異是測量升級開始時節點的狀態和健康情況評估時節點的狀態之間的差異。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。		 int (必要)

約束：
最小值 = 0
最大值 = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes 在叢集升級期間允許的升級網域節點健康情況衰退百分比上限。
差異是測量升級開始時升級網域節點的狀態和健康情況評估時升級網域節點的狀態之間的差異。
每次所有已完成升級網域的升級網域升級完成後都會執行檢查，以確保升級網域的狀態處於容許的限制範圍內。
 int

約束：
最小值 = 0
最大值 = 100

ApplicationDeltaHealthPolicyMap

名稱 描述 值
{自定義屬性} ApplicationDeltaHealthPolicy

ApplicationDeltaHealthPolicy

名稱 描述 值
defaultServiceTypeDeltaHealthPolicy 升級叢集時，預設用來評估服務類型健康情況的差異健康情況原則。 ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies 每個服務類型名稱具有服務類型差異健康情況原則的對應。 對應預設是空的。 ServiceTypeDeltaHealthPolicyMap

ServiceTypeDeltaHealthPolicy

名稱 描述 值
maxPercentDeltaUnhealthyServices 叢集升級期間允許的服務健康情況降低百分比上限。
差異會在升級開始時的服務狀態與健康情況評估時的服務狀態之間測量。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。
 int

約束：
最小值 = 0
最大值 = 100

ServiceTypeDeltaHealthPolicyMap

名稱 描述 值
{自定義屬性} ServiceTypeDeltaHealthPolicy

ClusterHealthPolicy

名稱 描述 值
applicationHealthPolicies 定義用來評估應用程式或其中一個子實體健康情況的應用程式健康情況原則對應。 ApplicationHealthPolicyMap
maxPercentUnhealthyApplications 在報告錯誤之前，允許健康情況不良應用程式的最大百分比。 例如，若要允許 10% 的應用程式健康情況不良，這個值會是 10。

百分比表示在系統將叢集視為錯誤之前，容許應用程式健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的應用程式，則健康情況會評估為 Warning。
此計算是將健康情況不良的應用程式數目除以叢集中應用程式執行個體的總數而得，但不包括 ApplicationTypeHealthPolicyMap 所包含之應用程式類型的應用程式。
針對少量的應用程式數目，計算會四捨五入以容許一個失敗。 預設百分比是零。		 int

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyNodes 在報告錯誤之前，允許健康情況不良節點的最大百分比。 例如，若要允許 10% 的節點健康情況不良，這個值會是 10。

百分比表示在叢集被視為處於錯誤狀態之前，容許節點健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的節點，則健康情況會評估為 Warning。
百分比是將健康情況不良節點數目除以叢集中的節點總數計算而得。
針對較少的節點數目，計算會四捨五入以容許一個失敗。 預設百分比是零。

在大型叢集中，永遠都有一些節點會關閉或需要修復，因此應設定此百分比來容許這種情形。
 int

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyApplications 在報告錯誤之前，允許健康情況不良應用程式的最大百分比。 例如，若要允許 10% 的應用程式健康情況不良，這個值會是 10。

百分比表示在系統將叢集視為錯誤之前，容許應用程式健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的應用程式，則健康情況會評估為 Warning。
此計算是將健康情況不良的應用程式數目除以叢集中應用程式執行個體的總數而得，但不包括 ApplicationTypeHealthPolicyMap 所包含之應用程式類型的應用程式。
針對少量的應用程式數目，計算會四捨五入以容許一個失敗。 預設百分比是零。		 需要 int ()

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyNodes 在報告錯誤之前，允許健康情況不良節點的最大百分比。 例如，若要允許 10% 的節點健康情況不良，這個值會是 10。

百分比表示在叢集被視為處於錯誤狀態之前，容許節點健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的節點，則健康情況會評估為 Warning。
百分比是將健康情況不良節點數目除以叢集中的節點總數計算而得。
針對較少的節點數目，計算會四捨五入以容許一個失敗。 預設百分比是零。

在大型叢集中，永遠都有一些節點會關閉或需要修復，因此應設定此百分比來容許這種情形。
 需要 int ()

約束：
最小值 = 0
最大值 = 100

ApplicationHealthPolicyMap

名稱 描述 值
{自定義屬性} ApplicationHealthPolicy

ApplicationHealthPolicy

名稱 描述 值
defaultServiceTypeHealthPolicy 默認用來評估服務類型健康情況的健康狀態原則。 ServiceTypeHealthPolicy
serviceTypeHealthPolicies 每個服務類型名稱的服務類型健全狀況原則對應。 對應預設是空的。 ServiceTypeHealthPolicyMap
considerWarningAsError 可指示是否將具有相同嚴重性的警告視為錯誤。 bool (必要)
defaultServiceTypeHealthPolicy 默認用來評估服務類型健康情況的健康狀態原則。 ServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications 允許的狀況不良已部署應用程式百分比上限。 允許的值是從零到 100 的位元元組值。
百分比代表在應用程式被視為錯誤之前，可能狀況不良之已部署應用程式的最大容許百分比。
這是藉由將狀況不良的已部署應用程式數目除以叢集中目前部署應用程式的節點數目來計算。
針對較少的節點數目，計算會四捨五入以容許一個失敗。 預設百分比是零。		 需要 int ()
serviceTypeHealthPolicyMap 每個服務類型名稱的服務類型健全狀況原則對應。 對應預設是空的。 ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

名稱 描述 值
maxPercentUnhealthyServices 在應用程式被視為錯誤之前，允許狀況不良的服務百分比上限。 int

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyPartitionsPerService 每個服務允許的狀況不良分割區百分比上限。

百分比代表在服務被視為錯誤之前，可能狀況不良的分割區最大容許百分比。
如果遵守百分比，但至少有一個狀況不良的數據分割，則會將健康情況評估為警告。
百分比的計算方式是將狀況不良的數據分割數目除以服務中的數據分割總數。
計算會四捨五入，以容許少數分割區發生一個失敗。		 需要 int ()

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyReplicasPerPartition 每個分割區允許的狀況不良復本百分比上限。

百分比代表在分割區被視為錯誤之前，可能狀況不良之復本的最大容許百分比。
如果遵守百分比，但至少有一個狀況不良的複本，則會將健康情況評估為警告。
百分比的計算方式是將狀況不良的複本數目除以分割區中的複本總數。
計算會四捨五入，以容許少數複本發生一個失敗。		 需要 int ()

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyServices 狀況不良服務允許的最大百分比。

百分比代表在應用程式被視為錯誤之前，可能狀況不良的服務最大容許百分比。
如果遵守百分比，但至少有一個狀況不良的服務，則會將健康情況評估為警告。
計算方式是將特定服務類型的狀況不良服務數目除以特定服務類型的服務總數。
計算會四捨五入，以容許少數服務發生一個失敗。
 需要 int ()

約束：
最小值 = 0
最大值 = 100

ServiceTypeHealthPolicyMap

名稱 描述 值
{自定義屬性} ServiceTypeHealthPolicy

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 格式。 字串 (必要)

SKU

名稱 描述 值
NAME Sku 名稱。 'Basic'
必要) 的「標準」 (

Terraform (AzAPI 提供者) 資源定義

managedClusters 資源類型可以使用目標作業來部署：

  • 資源群組

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄。

資源格式

若要建立 Microsoft.ServiceFabric/managedClusters 資源，請將下列 Terraform 新增至您的範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedClusters@2023-11-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      addonFeatures = [
        "string"
      ]
      adminPassword = "string"
      adminUserName = "string"
      allowRdpAccess = bool
      applicationTypeVersionsCleanupPolicy = {
        maxUnusedVersionsToKeep = int
        maxUnusedVersionsToKeep = int
      }
      auxiliarySubnets = [
        {
          enableIpv6 = bool
          name = "string"
          networkSecurityGroupId = "string"
          privateEndpointNetworkPolicies = "string"
          privateLinkServiceNetworkPolicies = "string"
        }
      ]
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
        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
      enableIpv6 = bool
      enableServicePublicIP = bool
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
              name = "string"
              value = "string"
            }
          ]
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      httpGatewayConnectionPort = 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"
          ]
          service = "string"
        }
      ]
      subnetId = "string"
      upgradeDescription = {
        deltaHealthPolicy = {
          applicationDeltaHealthPolicies = {
            {customized property} = {
              defaultServiceTypeDeltaHealthPolicy = {
                maxPercentDeltaUnhealthyServices = int
              }
              serviceTypeDeltaHealthPolicies = {
                {customized property} = {
                  maxPercentDeltaUnhealthyServices = int
                }
              }
            }
          }
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
        }
        forceRestart = bool
        healthCheckRetryTimeout = "string"
        healthCheckStableDuration = "string"
        healthCheckWaitDuration = "string"
        healthPolicy = {
          applicationHealthPolicies = {
            {customized property} = {
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
                maxPercentUnhealthyPartitionsPerService = int
                maxPercentUnhealthyReplicasPerPartition = int
                maxPercentUnhealthyServices = int
              }
              serviceTypeHealthPolicies = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                  maxPercentUnhealthyPartitionsPerService = int
                  maxPercentUnhealthyReplicasPerPartition = int
                  maxPercentUnhealthyServices = int
                }
              }
              considerWarningAsError = bool
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
                maxPercentUnhealthyPartitionsPerService = int
                maxPercentUnhealthyReplicasPerPartition = int
                maxPercentUnhealthyServices = int
              }
              maxPercentUnhealthyDeployedApplications = int
              serviceTypeHealthPolicyMap = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                  maxPercentUnhealthyPartitionsPerService = int
                  maxPercentUnhealthyReplicasPerPartition = int
                  maxPercentUnhealthyServices = int
                }
              }
            }
          }
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
        }
        upgradeDomainTimeout = "string"
        upgradeReplicaSetCheckTimeout = "string"
        upgradeTimeout = "string"
        deltaHealthPolicy = {
          applicationDeltaHealthPolicies = {
            {customized property} = {
              defaultServiceTypeDeltaHealthPolicy = {
                maxPercentDeltaUnhealthyServices = int
              }
              serviceTypeDeltaHealthPolicies = {
                {customized property} = {
                  maxPercentDeltaUnhealthyServices = int
                }
              }
            }
          }
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
        }
        forceRestart = bool
        healthPolicy = {
          applicationHealthPolicies = {
            {customized property} = {
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
                maxPercentUnhealthyPartitionsPerService = int
                maxPercentUnhealthyReplicasPerPartition = int
                maxPercentUnhealthyServices = int
              }
              serviceTypeHealthPolicies = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                  maxPercentUnhealthyPartitionsPerService = int
                  maxPercentUnhealthyReplicasPerPartition = int
                  maxPercentUnhealthyServices = int
                }
              }
              considerWarningAsError = bool
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
                maxPercentUnhealthyPartitionsPerService = int
                maxPercentUnhealthyReplicasPerPartition = int
                maxPercentUnhealthyServices = int
              }
              maxPercentUnhealthyDeployedApplications = int
              serviceTypeHealthPolicyMap = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                  maxPercentUnhealthyPartitionsPerService = int
                  maxPercentUnhealthyReplicasPerPartition = int
                  maxPercentUnhealthyServices = int
                }
              }
            }
          }
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
        }
        monitoringPolicy = {
          healthCheckRetryTimeout = "string"
          healthCheckStableDuration = "string"
          healthCheckWaitDuration = "string"
          upgradeDomainTimeout = "string"
          upgradeTimeout = "string"
        }
        upgradeReplicaSetCheckTimeout = "string"
      }
      useCustomVnet = bool
      zonalResiliency = bool
      zonalUpdateMode = "string"
    }
    sku = {
      name = "string"
    }
  })
}

屬性值

managedClusters

名稱 描述 值
類型 資源類型 “Microsoft.ServiceFabric/managedClusters@2023-11-01-preview”
NAME 資源名稱 字串 (必要)
location Azure 資源位置。 字串 (必要)
parent_id 若要部署至資源群組，請使用該資源群組的標識碼。 字串 (必要)
tags Azure 資源標籤。 標記名稱和值的字典。
sku 受控叢集的SKU 需要sku ()
properties 受控叢集資源屬性 ManagedClusterProperties

ManagedClusterProperties

名稱 描述 值
addonFeatures 在叢集上啟用的附加元件功能清單。 包含任何項目的字串數組：
“BackupRestoreService”
“DnsService”
“ResourceMonitorService”
adminPassword VM 系統管理員用戶密碼。 字串

約束：
敏感性值。 以安全參數的形式傳入。
adminUserName VM 系統管理員用戶名稱。 字串 (必要)
allowRdpAccess 將此設定為 true 可讓 RDP 存取 VM。 默認 NSG 規則會開啟 RDP 連接埠到因特網，可使用自訂的網路安全性規則加以覆寫。 此設定的預設值為 false。 bool
applicationTypeVersionsCleanupPolicy 用來清除未使用版本的原則。 ApplicationTypeVersionsCleanupPolicy
auxiliarySubnets 叢集的輔助子網。 Subnet[]
azureActiveDirectory 叢集的 AAD 驗證設定。 AzureActiveDirectory
clientConnectionPort 用於客戶端連線至叢集的埠。 int
用戶端 允許管理叢集的客戶端憑證。 ClientCertificate[]
clusterCodeVersion 叢集的 Service Fabric 運行時間版本。 當 clusterUpgradeMode 設定為 'Manual' 時，需要這個屬性。 若要取得新叢集的可用 Service Fabric 版本清單，請使用 ClusterVersion API。 若要取得現有叢集的可用版本清單，請使用 availableClusterVersions。 字串
clusterUpgradeCadence 指出發行新的叢集運行時間版本升級之後，何時會套用它們。 預設為 Wave0。 只有在 clusterUpgradeMode 設定為 'Automatic' 時才適用。 “Wave0”
“Wave1”
“Wave2”
clusterUpgradeMode 有新的 Service Fabric 執行時間版本可用時，叢集的升級模式。 “Automatic”
“手動”
ddosProtectionPlanId 指定將與叢集虛擬網路相關聯的 DDoS 網路保護計劃資源識別碼。 字串
dnsName 叢集 dns 名稱。 需要字串 ()
enableAutoOSUpgrade 將此設定為 true 可針對使用任何平臺 OS 映射建立且版本為 'latest' 的節點類型啟用自動 OS 升級。 此設定的預設值為 false。 bool
enableIpv6 將此設定為 true 會為叢集使用的預設 VNet 建立 IPv6 位址空間。 建立叢集之後，就無法變更此設定。 此設定的預設值為 false。 bool
enableServicePublicIP 將此設定為 true 會將 IPv4 位址連結為 IPv6 位址的 ServicePublicIP。 只有在叢集上啟用 IPv6 時，才能將它設定為 True。 bool
fabricSettings 要設定叢集的自定義網狀架構設定清單。 SettingsSectionDescription[]
httpGatewayConnectionPort 用於叢集 HTTP 連線的埠。 int
ipTags 與叢集預設公用IP位址相關聯的IP標籤清單。 IPTag[]
loadBalancingRules 套用至叢集公用負載平衡器的負載平衡規則。 LoadBalancingRule[]
networkSecurityRules 套用至叢集 虛擬網路 的自定義網路安全性規則。 NetworkSecurityRule[]
publicIPPrefixId 指定負載平衡器將配置公用 IPv4 位址的來源公用 IPv4 前置詞的資源識別碼。 建立叢集之後，就無法變更此設定。 字串
publicIPv6PrefixId 指定負載平衡器將配置公用 IPv6 位址的來源公用 IPv6 前置詞的資源識別碼。 建立叢集之後，就無法變更此設定。 字串
serviceEndpoints 叢集中子網的服務端點。 ServiceEndpoint[]
subnetId 如果指定，則會在此子網中建立叢集的節點類型，而不是預設的 VNet。 針對叢集指定的 networkSecurityRules 也會套用至此子網。 建立叢集之後，就無法變更此設定。 字串
upgradeDescription 升級叢集時要使用的原則。 ClusterUpgradePolicy
useCustomVnet 針對新的叢集，此參數表示其使用「攜帶您自己的 VNet」，但子網是在節點類型層級指定;對於這類叢集，節點類型需要subnetId屬性。 bool
zonalResiliency 指出叢集是否有區域復原能力。 bool
zonalUpdateMode 指出跨 Az 叢集的更新模式。 “Fast”
“標準”

ApplicationTypeVersionsCleanupPolicy

名稱 描述 值
maxUnusedVersionsToKeep 要保留的每個應用程式類型未使用的版本數目。 需要 int ()

約束：
最小值 = 0
maxUnusedVersionsToKeep 每個應用程式類型要保留的未使用版本數目。 int (必要)

約束：
最小值 = 0

子網路

名稱 描述 值
enableIpv6 表示啟用 Ipv6 或未啟用。 如果未提供，則會採用與叢集相同的設定。 bool
NAME 子網名稱。 字串 (必要)
networkSecurityGroupId 網路安全組的完整資源標識碼。 字串
privateEndpointNetworkPolicies 在子網的私人端點上啟用或停用套用網路原則。 「已停用」
「已啟用」
privateLinkServiceNetworkPolicies 在子網中的私人連結服務上啟用或停用套用網路原則。 「已停用」
「已啟用」

AzureActiveDirectory

名稱 描述 值
clientApplication Azure Active Directory 用戶端應用程式識別碼。 字串
clusterApplication Azure Active Directory 叢集應用程式標識符。 字串
tenantId Azure Active Directory 租用戶標識符。 字串
clientApplication Azure Active Directory 用戶端應用程式識別碼。 字串
clusterApplication Azure Active Directory 叢集應用程式標識符。 字串
tenantId Azure Active Directory 租用戶標識符。 字串

ClientCertificate

名稱 描述 值
commonName 憑證一般名稱。 字串
isAdmin 指出客戶端憑證是否具有叢集的系統管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 bool (必要)
issuerThumbprint 憑證的簽發者指紋。 僅與 CommonName 搭配使用。 字串
thumbprint 憑證指紋。 字串

SettingsSectionDescription

名稱 描述 值
NAME 網狀架構設定的區段名稱。 字串 (必要)
參數 區段中的參數集合。 SettingsParameterDescription[] (必要)
NAME 網狀架構設定的區段名稱。 字串 (必要)
參數 區段中的參數集合。 SettingsParameterDescription[] (必要)

SettingsParameterDescription

名稱 描述 值
NAME 網狀架構設定的參數名稱。 字串 (必要)
值 網狀架構設定的參數值。 字串 (必要)
NAME 網狀架構設定的參數名稱。 字串 (必要)
值 網狀架構設定的參數值。 字串 (必要)

IPTag

名稱 描述 值
ipTagType IP 標籤類型。 字串 (必要)
標籤 IP 標籤的值。 字串 (必要)

LoadBalancingRule

名稱 描述 值
backendPort 在端點上用於內部連接的連接埠。 可接受的值介於 1 到 65535 之間。 int (必要)

約束：
最小值 = 1
最大值 = 65534
frontendPort 外部端點的連接埠。 每個規則的埠號碼在 Load Balancer 內必須是唯一的。 可接受的值介於 1 到 65534 之間。 int (必要)

約束：
最小值 = 1
最大值 = 65534
loadDistribution 此規則的負載分配原則。 字串
probePort 負載平衡規則所使用的探查埠。 可接受的值介於 1 到 65535 之間。 int

約束：
最小值 = 1
最大值 = 65534
probeProtocol 負載平衡規則所使用的負載平衡器探查參考。 "http"
"https"
“tcp” (必要)
probeRequestPath 探查要求路徑。 僅支援 HTTP/HTTPS 探查。 字串
protocol 負載平衡規則所使用的傳輸通訊協議參考。 “tcp”
“udp” (必要)

NetworkSecurityRule

名稱 描述 值
access 允許或拒絕網路流量。 “allow”
「拒絕」 (必要)
description 網路安全性規則描述。 字串
destinationAddressPrefix 目的地位址前置詞。 CIDR 或目的地IP範圍。 也可用星號 (*) 來比對所有的來源 IP。 您也可以使用默認標籤，例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 字串
destinationAddressPrefixes 目的地位址前置詞。 CIDR 或目的地IP範圍。 string[]
destinationPortRange 他目的地埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 字串
destinationPortRanges 目的地埠範圍。 string[]
direction 網路安全性規則方向。 “inbound”
必要的「輸出」 ()
NAME 網路安全性規則名稱。 字串 (必要)
priority 規則的優先順序。 值的範圍可以是 1000 到 3000。 超出此範圍的值會保留給 Service Fabric ManagerCluster 資源提供者。 集合中每個規則的優先順序數字必須是唯一的。 優先順序號碼愈小，規則優先順序就愈高。 int (必要)

約束：
最小值 = 1000
最大值 = 3000
protocol 此規則適用的網路通訊協定。 “ah”
“esp”
"http"
"https"
“icmp”
“tcp”
“udp” (必要)
sourceAddressPrefix CIDR 或來源IP範圍。 也可用星號 (*) 來比對所有的來源 IP。 您也可以使用默認標籤，例如 'VirtualNetwork'、'AzureLoadBalancer' 和 'Internet'。 如果這是輸入規則，請指定網路流量的來源。 字串
sourceAddressPrefixes CIDR 或來源IP範圍。 string[]
sourcePortRange 來源埠或範圍。 介於 0 到 65535 之間的整數或範圍。 星號 『*』 也可以用來比對所有埠。 字串
sourcePortRanges 來源埠範圍。 string[]

ServiceEndpoint

名稱 描述 值
位置 位置清單。 string[]
service 端點服務的型別。 需要字串 ()

ClusterUpgradePolicy

名稱 描述 值
deltaHealthPolicy 升級叢集時所使用的叢集差異健全狀況原則。 ClusterUpgradeDeltaHealthPolicy
forceRestart 如果為 true，則即使程式代碼版本未變更，仍會在升級期間強制重新啟動， (升級只會變更組態或數據) 。 bool
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 格式。 需要字串 ()
healthPolicy 升級叢集時所使用的叢集健全狀況原則。 ClusterHealthPolicy (必要)
upgradeDomainTimeout 每個升級網域在升級復原之前必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 需要字串 ()
upgradeReplicaSetCheckTimeout 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。 此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。 逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 需要字串 ()
upgradeTimeout 在升級復原之前，整體升級必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 需要字串 ()
deltaHealthPolicy 叢集差異健全狀況原則會定義健康情況原則，以在叢集升級期間用來評估叢集的健康情況。 ClusterUpgradeDeltaHealthPolicy
forceRestart 如果為 true，則即使程式代碼版本未變更，仍會在升級期間強制重新啟動， (升級只會變更組態或數據) 。 bool
healthPolicy 叢集健康狀態原則會定義健康情況原則，用來在叢集升級期間評估叢集的健康情況。 ClusterHealthPolicy
monitoringPolicy 叢集監視原則描述在受監視模式中監視升級的參數。 ClusterMonitoringPolicy
upgradeReplicaSetCheckTimeout 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。
此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。
逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。
此值必須介於 00：00：00 和 49710.06：28：15 之間， (不帶正負號的 32 位整數，以秒為單位)
字串

ClusterUpgradeDeltaHealthPolicy

名稱 描述 值
applicationDeltaHealthPolicies 定義應用程式差異健全狀況原則對應，用來在升級叢集時評估應用程式或其子實體的健康情況。 ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications 叢集升級期間允許的應用程式健康情況降低百分比上限。
差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 系統服務不包含在此服務中。		 需要 int ()

約束：
最小值 = 0
最大值 = 100
maxPercentDeltaUnhealthyNodes 在叢集升級期間允許的節點健康情況衰退百分比上限。
差異是測量升級開始時節點的狀態和健康情況評估時節點的狀態之間的差異。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。		 需要 int ()

約束：
最小值 = 0
最大值 = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes 在叢集升級期間允許的升級網域節點健康情況衰退百分比上限。
差異是測量升級開始時升級網域節點的狀態和健康情況評估時升級網域節點的狀態之間的差異。
每次所有已完成升級網域的升級網域升級完成後都會執行檢查，以確保升級網域的狀態處於容許的限制範圍內。
 需要 int ()

約束：
最小值 = 0
最大值 = 100
maxPercentDeltaUnhealthyApplications 叢集升級期間允許的應用程式健康情況降低百分比上限。
差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 系統服務不包含在此服務中。
注意：此值會覆寫屬性中指定的值。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications		 int

約束：
最小值 = 0
最大值 = 100
maxPercentDeltaUnhealthyNodes 在叢集升級期間允許的節點健康情況衰退百分比上限。
差異是測量升級開始時節點的狀態和健康情況評估時節點的狀態之間的差異。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。		 需要 int ()

約束：
最小值 = 0
最大值 = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes 在叢集升級期間允許的升級網域節點健康情況衰退百分比上限。
差異是測量升級開始時升級網域節點的狀態和健康情況評估時升級網域節點的狀態之間的差異。
每次所有已完成升級網域的升級網域升級完成後都會執行檢查，以確保升級網域的狀態處於容許的限制範圍內。
 int

約束：
最小值 = 0
最大值 = 100

ApplicationDeltaHealthPolicyMap

名稱 描述 值
{自定義屬性} ApplicationDeltaHealthPolicy

ApplicationDeltaHealthPolicy

名稱 描述 值
defaultServiceTypeDeltaHealthPolicy 升級叢集時，預設用來評估服務類型健康情況的差異健全狀況原則。 ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies 每個服務類型名稱的服務類型差異健全狀況原則對應。 對應預設是空的。 ServiceTypeDeltaHealthPolicyMap

ServiceTypeDeltaHealthPolicy

名稱 描述 值
maxPercentDeltaUnhealthyServices 叢集升級期間允許的服務健康情況降低百分比上限。
在升級開始時的服務狀態與健康情況評估時的服務狀態之間，會測量差異。
每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。
 int

約束：
最小值 = 0
最大值 = 100

ServiceTypeDeltaHealthPolicyMap

名稱 描述 值
{自定義屬性} ServiceTypeDeltaHealthPolicy

ClusterHealthPolicy

名稱 描述 值
applicationHealthPolicies 定義用來評估應用程式或其其中一個子實體健康情況的應用程式健全狀況原則對應。 ApplicationHealthPolicyMap
maxPercentUnhealthyApplications 在報告錯誤之前，允許健康情況不良應用程式的最大百分比。 例如，若要允許 10% 的應用程式健康情況不良，這個值會是 10。

百分比表示在系統將叢集視為錯誤之前，容許應用程式健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的應用程式，則健康情況會評估為 Warning。
此計算是將健康情況不良的應用程式數目除以叢集中應用程式執行個體的總數而得，但不包括 ApplicationTypeHealthPolicyMap 所包含之應用程式類型的應用程式。
針對少量的應用程式數目，計算會四捨五入以容許一個失敗。 預設百分比是零。		 int

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyNodes 在報告錯誤之前，允許健康情況不良節點的最大百分比。 例如，若要允許 10% 的節點健康情況不良，這個值會是 10。

百分比表示在叢集被視為處於錯誤狀態之前，容許節點健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的節點，則健康情況會評估為 Warning。
百分比是將健康情況不良節點數目除以叢集中的節點總數計算而得。
針對較少的節點數目，計算會四捨五入以容許一個失敗。 預設百分比是零。

在大型叢集中，永遠都有一些節點會關閉或需要修復，因此應設定此百分比來容許這種情形。
 int

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyApplications 在報告錯誤之前，允許健康情況不良應用程式的最大百分比。 例如，若要允許 10% 的應用程式健康情況不良，這個值會是 10。

百分比表示在系統將叢集視為錯誤之前，容許應用程式健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的應用程式，則健康情況會評估為 Warning。
此計算是將健康情況不良的應用程式數目除以叢集中應用程式執行個體的總數而得，但不包括 ApplicationTypeHealthPolicyMap 所包含之應用程式類型的應用程式。
針對少量的應用程式數目，計算會四捨五入以容許一個失敗。 預設百分比是零。		 int (必要)

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyNodes 在報告錯誤之前，允許健康情況不良節點的最大百分比。 例如，若要允許 10% 的節點健康情況不良，這個值會是 10。

百分比表示在叢集被視為處於錯誤狀態之前，容許節點健康情況不良的最大百分比。
如果未到達此百分比，但至少有一個健康情況不良的節點，則健康情況會評估為 Warning。
百分比是將健康情況不良節點數目除以叢集中的節點總數計算而得。
針對較少的節點數目，計算會四捨五入以容許一個失敗。 預設百分比是零。

在大型叢集中，永遠都有一些節點會關閉或需要修復，因此應設定此百分比來容許這種情形。
 int (必要)

約束：
最小值 = 0
最大值 = 100

ApplicationHealthPolicyMap

名稱 描述 值
{自定義屬性} ApplicationHealthPolicy

ApplicationHealthPolicy

名稱 描述 值
defaultServiceTypeHealthPolicy 默認用來評估服務類型健康情況的健康情況原則。 ServiceTypeHealthPolicy
serviceTypeHealthPolicies 每個服務類型名稱的服務類型健康情況原則對應。 對應預設是空的。 ServiceTypeHealthPolicyMap
considerWarningAsError 可指示是否將具有相同嚴重性的警告視為錯誤。 bool (必要)
defaultServiceTypeHealthPolicy 默認用來評估服務類型健康情況的健康情況原則。 ServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications 允許的狀況不良已部署應用程式百分比上限。 允許的值是從零到 100 的位元元組值。
百分比代表在應用程式被視為錯誤之前，可能狀況不良的已部署應用程式最大容許百分比。
這會藉由將應用程式目前部署在叢集中的節點數目除以狀況不良部署的應用程式數目來計算。
針對較少的節點數目，計算會四捨五入以容許一個失敗。 預設百分比是零。		 int (必要)
serviceTypeHealthPolicyMap 每個服務類型名稱的服務類型健康情況原則對應。 對應預設是空的。 ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

名稱 描述 值
maxPercentUnhealthyServices 在應用程式被視為錯誤之前，允許處於狀況不良的服務百分比上限。 int

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyPartitionsPerService 每個服務所允許狀況不良分割區的最大百分比。

百分比代表在服務被視為錯誤之前，可處於狀況不良的分割區最大容許百分比。
如果遵守百分比，但至少有一個狀況不良的數據分割，則健康情況會評估為警告。
百分比的計算方式是將狀況不良的數據分割數目除以服務中的數據分割總數。
計算會四捨五入，以容許少數分割區上的一個失敗。		 int (必要)

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyReplicasPerPartition 每個分割區所允許的狀況不良復本百分比上限。

百分比代表在發生錯誤數據分割之前，可處於狀況不良之復本的最大容許百分比。
如果遵守百分比，但至少有一個狀況不良的複本，則健康情況會評估為警告。
百分比的計算方式是將狀況不良的複本數目除以分割區中的複本總數。
計算會四捨五入，以容許少數複本上的一個失敗。		 int (必要)

約束：
最小值 = 0
最大值 = 100
maxPercentUnhealthyServices 狀況不良服務允許的最大百分比。

百分比代表在應用程式被視為錯誤之前，可能狀況不良的服務最大容許百分比。
如果遵守百分比，但至少有一個狀況不良的服務，則會將健康情況評估為警告。
計算方式是將特定服務類型的狀況不良服務數目除以特定服務類型的服務總數。
計算會四捨五入，以容許少數服務發生一個失敗。
 需要 int ()

約束：
最小值 = 0
最大值 = 100

ServiceTypeHealthPolicyMap

名稱 描述 值
{自定義屬性} ServiceTypeHealthPolicy

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 格式。 需要字串 ()

SKU

名稱 描述 值
NAME Sku 名稱。 "Basic"
「標準」 (必要)