Microsoft.ServiceFabric managedClusters 2024-02-01-preview
- 最新
- 2024-04-01
- 2024-02-01-preview
- 2023-12-01-preview
- 2023-11-01-preview
- 2023-09-01-preview
- 2023-07-01-preview
- 2023-03-01-preview
- 2023-02-01-preview
- 2022-10-01-preview
- 2022-08-01-preview
- 2022-06-01-preview
- 2022-02-01-preview
- 2022 年 1 月 1 日
- 2021-11-01-preview
- 2021-07-01-preview
- 2021-05-01
- 2021-01-01-preview
- 2020-01-01-preview
Bicep 資源定義
managedClusters 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄。
資源格式
若要建立 Microsoft.ServiceFabric/managedClusters 資源，請將下列 Bicep 新增至您的範本。
resource symbolicname 'Microsoft.ServiceFabric/managedClusters@2024-02-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
}
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
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'
]
service: 'string'
}
]
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
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 |
| enableHttpGatewayExclusiveAuthMode | 如果為 true，HttpGatewayEndpoint 上不允許令牌型驗證。 這是支援 TLS 1.3 版和更新版本的必要專案。 如果使用令牌型驗證，則必須定義 HttpGatewayTokenAuthConnectionPort。 | bool |
| enableIpv6 | 將此設定為 true 會為叢集所使用的預設 VNet 建立 IPv6 位址空間。 建立叢集之後，就無法變更此設定。 此設定的預設值為 false。 | bool |
| enableServicePublicIP | 將此設定為 true 會將 IPv4 位址連結為 IPv6 位址的 ServicePublicIP。 只有在叢集上啟用 IPv6 時，才能將它設定為 True。 | bool |
| fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
| httpGatewayConnectionPort | 用於叢集 HTTP 連線的埠。 | int |
| httpGatewayTokenAuthConnectionPort | 用於對叢集進行令牌驗證型 HTTPS 連線的埠。 無法設定為與 HttpGatewayEndpoint 相同的埠。 | 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 |
子網路
| 名稱 | 描述 | 值 |
|---|---|---|
| enableIpv6 | 表示啟用 Ipv6 或未啟用。 如果未提供，則會採用與叢集相同的設定。 | bool |
| NAME | 子網名稱。 | 字串 (必要) |
| networkSecurityGroupId | 網路安全組的完整資源標識碼。 | 字串 |
| privateEndpointNetworkPolicies | 在子網的私人端點上啟用或停用套用網路原則。 | 'disabled' 'enabled' |
| privateLinkServiceNetworkPolicies | 在子網中的私人連結服務上啟用或停用套用網路原則。 | 'disabled' 'enabled' |
AzureActiveDirectory
| 名稱 | 描述 | 值 |
|---|---|---|
| clientApplication | Azure Active Directory 用戶端應用程式識別碼。 | 字串 |
| clusterApplication | Azure Active Directory 叢集應用程式標識符。 | 字串 |
| tenantId | Azure Active Directory 租用戶標識符。 | 字串 |
ClientCertificate
| 名稱 | 描述 | 值 |
|---|---|---|
| commonName | 憑證一般名稱。 | 字串 |
| isAdmin | 指出客戶端憑證是否具有叢集的系統管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | bool (必要) |
| issuerThumbprint | 憑證的簽發者指紋。 僅與 CommonName 搭配使用。 | 字串 |
| thumbprint | 憑證指紋。 | 字串 |
SettingsSectionDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | 網狀架構設定的區段名稱。 | 字串 (必要) |
| 參數 | 區段中的參數集合。 | SettingsParameterDescription[] (必要) |
SettingsParameterDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| 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 |
| healthPolicy | 叢集健康狀態原則會定義用來在叢集升級期間評估叢集健康情況的健康情況原則。 | ClusterHealthPolicy |
| monitoringPolicy | 叢集監視原則描述監視受監視模式升級的參數。 | ClusterMonitoringPolicy |
| upgradeReplicaSetCheckTimeout | 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。 此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。 逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 此值必須介於 00：00：00 和 49710.06：28：15 之間， (不帶正負號的 32 位整數，以秒為單位) |
字串 |
ClusterUpgradeDeltaHealthPolicy
| 名稱 | 描述 | 值 |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | 叢集升級期間允許的應用程式健康情況降低百分比上限。 差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。 每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 系統服務不包含在此專案中。 注意：此值會覆寫屬性中指定的值。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications |
int 約束： 最小值 = 0 最大值 = 100 |
| maxPercentDeltaUnhealthyNodes | 在叢集升級期間允許的節點健康情況衰退百分比上限。 差異是測量升級開始時節點的狀態和健康情況評估時節點的狀態之間的差異。 每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 |
int (必要) 約束： 最小值 = 0 最大值 = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | 在叢集升級期間允許的升級網域節點健康情況衰退百分比上限。 差異是測量升級開始時升級網域節點的狀態和健康情況評估時升級網域節點的狀態之間的差異。 每次所有已完成升級網域的升級網域升級完成後都會執行檢查，以確保升級網域的狀態處於容許的限制範圍內。 |
int 約束： 最小值 = 0 最大值 = 100 |
ClusterHealthPolicy
| 名稱 | 描述 | 值 |
|---|---|---|
| maxPercentUnhealthyApplications | 在報告錯誤之前，允許健康情況不良應用程式的最大百分比。 例如，若要允許 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 格式。 | 字串 (必要) |
SKU
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | Sku 名稱。 | 'Basic' 必要) 的「標準」 ( |
ARM 範本資源定義
managedClusters 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄。
資源格式
若要建立 Microsoft.ServiceFabric/managedClusters 資源，請將下列 JSON 新增至您的範本。
{
"type": "Microsoft.ServiceFabric/managedClusters",
"apiVersion": "2024-02-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"
},
"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",
"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" ],
"service": "string"
}
],
"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",
"zonalResiliency": "bool",
"zonalUpdateMode": "string"
}
}
屬性值
managedClusters
| 名稱 | 描述 | 值 |
|---|---|---|
| 類型 | 資源類型 | 'Microsoft.ServiceFabric/managedClusters' |
| apiVersion | 資源 API 版本 | '2024-02-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 |
| enableHttpGatewayExclusiveAuthMode | 如果為 true，則 HttpGatewayEndpoint 上不允許令牌型驗證。 這是支援 TLS 1.3 版和更新版本的必要專案。 如果使用令牌型驗證，則必須定義 HttpGatewayTokenAuthConnectionPort。 | bool |
| enableIpv6 | 將此設定為 true 會為叢集使用的預設 VNet 建立 IPv6 位址空間。 建立叢集之後，就無法變更此設定。 此設定的預設值為 false。 | bool |
| enableServicePublicIP | 將此設定為 true 會將 IPv4 位址連結為 IPv6 位址的 ServicePublicIP。 只有在叢集上啟用 IPv6 時，才能將它設定為 True。 | bool |
| fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
| httpGatewayConnectionPort | 用於叢集 HTTP 連線的埠。 | int |
| httpGatewayTokenAuthConnectionPort | 用於令牌驗證型 HTTPS 連線至叢集的埠。 無法設定為與 HttpGatewayEndpoint 相同的埠。 | 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 |
子網路
| 名稱 | 描述 | 值 |
|---|---|---|
| enableIpv6 | 表示我們是否要啟用 Ipv6。 如果未提供，則會採用與叢集相同的設定。 | bool |
| NAME | 子網名稱。 | 需要字串 () |
| networkSecurityGroupId | 網路安全組的完整資源標識碼。 | 字串 |
| privateEndpointNetworkPolicies | 在子網的私人端點上啟用或停用套用網路原則。 | 'disabled' 'enabled' |
| privateLinkServiceNetworkPolicies | 在子網中的私人連結服務上啟用或停用套用網路原則。 | 'disabled' 'enabled' |
AzureActiveDirectory
| 名稱 | 描述 | 值 |
|---|---|---|
| clientApplication | Azure Active Directory 用戶端應用程式識別碼。 | 字串 |
| clusterApplication | Azure Active Directory 叢集應用程式標識符。 | 字串 |
| tenantId | Azure Active Directory 租用戶標識符。 | 字串 |
ClientCertificate
| 名稱 | 描述 | 值 |
|---|---|---|
| commonName | 憑證一般名稱。 | 字串 |
| isAdmin | 指出客戶端憑證是否具有叢集的管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | bool (必要) |
| issuerThumbprint | 憑證的簽發者指紋。 只與 CommonName 搭配使用。 | 字串 |
| thumbprint | 憑證指紋。 | 字串 |
SettingsSectionDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | 網狀架構設定的區段名稱。 | 需要字串 () |
| 參數 | 區段中的參數集合。 | SettingsParameterDescription[] (必要) |
SettingsParameterDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| 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 |
| healthPolicy | 叢集健康狀態原則會定義用來在叢集升級期間評估叢集健康情況的健康情況原則。 | ClusterHealthPolicy |
| monitoringPolicy | 叢集監視原則描述監視受監視模式升級的參數。 | ClusterMonitoringPolicy |
| upgradeReplicaSetCheckTimeout | 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。 此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。 逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 此值必須介於 00：00：00 和 49710.06：28：15 之間， (不帶正負號的 32 位整數，以秒為單位) |
字串 |
ClusterUpgradeDeltaHealthPolicy
| 名稱 | 描述 | 值 |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | 叢集升級期間允許的應用程式健康情況降低百分比上限。 差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。 每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 系統服務不包含在此專案中。 注意：此值會覆寫屬性中指定的值。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications |
int 約束： 最小值 = 0 最大值 = 100 |
| maxPercentDeltaUnhealthyNodes | 在叢集升級期間允許的節點健康情況衰退百分比上限。 差異是測量升級開始時節點的狀態和健康情況評估時節點的狀態之間的差異。 每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 |
int (必要) 約束： 最小值 = 0 最大值 = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | 在叢集升級期間允許的升級網域節點健康情況衰退百分比上限。 差異是測量升級開始時升級網域節點的狀態和健康情況評估時升級網域節點的狀態之間的差異。 每次所有已完成升級網域的升級網域升級完成後都會執行檢查，以確保升級網域的狀態處於容許的限制範圍內。 |
int 約束： 最小值 = 0 最大值 = 100 |
ClusterHealthPolicy
| 名稱 | 描述 | 值 |
|---|---|---|
| maxPercentUnhealthyApplications | 在報告錯誤之前，允許健康情況不良應用程式的最大百分比。 例如，若要允許 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 格式。 | 字串 (必要) |
SKU
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | Sku 名稱。 | 'Basic' 必要) 的「標準」 ( |
Terraform (AzAPI 提供者) 資源定義
managedClusters 資源類型可以使用目標作業來部署：
- 資源群組
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄。
資源格式
若要建立 Microsoft.ServiceFabric/managedClusters 資源，請將下列 Terraform 新增至您的範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceFabric/managedClusters@2024-02-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
}
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
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"
]
service = "string"
}
]
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
zonalResiliency = bool
zonalUpdateMode = "string"
}
sku = {
name = "string"
}
})
}
屬性值
managedClusters
| 名稱 | 描述 | 值 |
|---|---|---|
| 類型 | 資源類型 | “Microsoft.ServiceFabric/managedClusters@2024-02-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 |
| enableHttpGatewayExclusiveAuthMode | 如果為 true，則 HttpGatewayEndpoint 上不允許令牌型驗證。 這是支援 TLS 1.3 版和更新版本的必要專案。 如果使用令牌型驗證，則必須定義 HttpGatewayTokenAuthConnectionPort。 | bool |
| enableIpv6 | 將此設定為 true 會為叢集使用的預設 VNet 建立 IPv6 位址空間。 建立叢集之後，就無法變更此設定。 此設定的預設值為 false。 | bool |
| enableServicePublicIP | 將此設定為 true 會將 IPv4 位址連結為 IPv6 位址的 ServicePublicIP。 只有在叢集上啟用 IPv6 時，才能將它設定為 True。 | bool |
| fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
| httpGatewayConnectionPort | 用於叢集 HTTP 連線的埠。 | int |
| httpGatewayTokenAuthConnectionPort | 用於對叢集進行令牌驗證型 HTTPS 連線的埠。 無法設定為與 HttpGatewayEndpoint 相同的埠。 | 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 |
子網路
| 名稱 | 描述 | 值 |
|---|---|---|
| enableIpv6 | 表示啟用 Ipv6 或未啟用。 如果未提供，則會採用與叢集相同的設定。 | bool |
| NAME | 子網名稱。 | 字串 (必要) |
| networkSecurityGroupId | 網路安全組的完整資源標識碼。 | 字串 |
| privateEndpointNetworkPolicies | 在子網的私人端點上啟用或停用套用網路原則。 | 「已停用」 「已啟用」 |
| privateLinkServiceNetworkPolicies | 在子網中的私人連結服務上啟用或停用套用網路原則。 | 「已停用」 「已啟用」 |
AzureActiveDirectory
| 名稱 | 描述 | 值 |
|---|---|---|
| clientApplication | Azure Active Directory 用戶端應用程式識別碼。 | 字串 |
| clusterApplication | Azure Active Directory 叢集應用程式標識符。 | 字串 |
| tenantId | Azure Active Directory 租用戶標識符。 | 字串 |
ClientCertificate
| 名稱 | 描述 | 值 |
|---|---|---|
| commonName | 憑證一般名稱。 | 字串 |
| isAdmin | 指出客戶端憑證是否具有叢集的管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | bool (必要) |
| issuerThumbprint | 憑證的簽發者指紋。 只與 CommonName 搭配使用。 | 字串 |
| thumbprint | 憑證指紋。 | 字串 |
SettingsSectionDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | 網狀架構設定的區段名稱。 | 需要字串 () |
| 參數 | 區段中的參數集合。 | SettingsParameterDescription[] (必要) |
SettingsParameterDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| 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 |
| healthPolicy | 叢集健康狀態原則會定義健康情況原則，用來在叢集升級期間評估叢集的健康情況。 | ClusterHealthPolicy |
| monitoringPolicy | 叢集監視原則描述在受監視模式中監視升級的參數。 | ClusterMonitoringPolicy |
| upgradeReplicaSetCheckTimeout | 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。 此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。 逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 此值必須介於 00：00：00 和 49710.06：28：15 之間， (不帶正負號的 32 位整數，以秒為單位) |
字串 |
ClusterUpgradeDeltaHealthPolicy
| 名稱 | 描述 | 值 |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | 叢集升級期間允許的應用程式健康情況降低百分比上限。 差異會在升級開始時的應用程式狀態和健康情況評估時的應用程式狀態之間測量。 每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 系統服務不包含在此服務中。 注意：此值會覆寫屬性中指定的值。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications |
int 約束： 最小值 = 0 最大值 = 100 |
| maxPercentDeltaUnhealthyNodes | 在叢集升級期間允許的節點健康情況衰退百分比上限。 差異是測量升級開始時節點的狀態和健康情況評估時節點的狀態之間的差異。 每次升級網域升級完成後都會執行檢查，以確保叢集的全域狀態處於容許的限制範圍內。 |
int (必要) 約束： 最小值 = 0 最大值 = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | 在叢集升級期間允許的升級網域節點健康情況衰退百分比上限。 差異是測量升級開始時升級網域節點的狀態和健康情況評估時升級網域節點的狀態之間的差異。 每次所有已完成升級網域的升級網域升級完成後都會執行檢查，以確保升級網域的狀態處於容許的限制範圍內。 |
int 約束： 最小值 = 0 最大值 = 100 |
ClusterHealthPolicy
| 名稱 | 描述 | 值 |
|---|---|---|
| maxPercentUnhealthyApplications | 在報告錯誤之前，允許健康情況不良應用程式的最大百分比。 例如，若要允許 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 格式。 | 字串 (必要) |
SKU
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | Sku 名稱。 | "Basic" 「標準」 (必要) |
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應