共用方式為


Microsoft.ServiceFabric managedClusters 2021-01-01-preview

Bicep 資源定義

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

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

資源格式

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

resource symbolicname 'Microsoft.ServiceFabric/managedClusters@2021-01-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
    }
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
    }
    clientConnectionPort: int
    clients: [
      {
        commonName: 'string'
        isAdmin: bool
        issuerThumbprint: 'string'
        thumbprint: 'string'
      }
    ]
    clusterCodeVersion: 'string'
    clusterUpgradeCadence: 'string'
    dnsName: 'string'
    enableAutoOSUpgrade: bool
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    httpGatewayConnectionPort: int
    loadBalancingRules: [
      {
        backendPort: int
        frontendPort: int
        probeProtocol: 'string'
        probeRequestPath: 'string'
        protocol: 'string'
      }
    ]
    networkSecurityRules: [
      {
        access: 'string'
        description: 'string'
        destinationAddressPrefixes: [
          'string'
        ]
        destinationPortRanges: [
          'string'
        ]
        direction: 'string'
        name: 'string'
        priority: int
        protocol: 'string'
        sourceAddressPrefixes: [
          'string'
        ]
        sourcePortRanges: [
          '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
azureActiveDirectory 叢集的 AAD 驗證設定。 AzureActiveDirectory
clientConnectionPort 用於客戶端連線至叢集的埠。 int
用戶端 允許管理叢集的客戶端憑證。 ClientCertificate[]
clusterCodeVersion 叢集的 Service Fabric 運行時間版本。 只有在 upgradeMode 設定為 'Manual' 時,才能將此屬性設定為使用者。 若要取得新叢集的可用 Service Fabric 版本清單,請使用 ClusterVersion API。 若要取得現有叢集的可用版本清單,請使用 availableClusterVersions 字串
clusterUpgradeCadence 指出發行新的叢集運行時間版本升級之後,何時會套用它們。 預設為 Wave0。 'Wave0'
'Wave1'
'Wave2'
dnsName 叢集 dns 名稱。 字串 (必要)
enableAutoOSUpgrade 將此設定為 true 可針對使用任何平臺 OS 映射搭配版本 『latest』 建立的節點類型自動升級。 此設定的預設值為 false。 bool
fabricSettings 要設定叢集的自定義網狀架構設定清單。 SettingsSectionDescription[]
httpGatewayConnectionPort 用於叢集 HTTP 連線的埠。 int
loadBalancingRules 套用至叢集公用負載平衡器的負載平衡規則。 LoadBalancingRule[]
networkSecurityRules 套用至叢集虛擬網路的自定義網路安全性規則。 NetworkSecurityRule[]

ApplicationTypeVersionsCleanupPolicy

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

約束:
最小值 = 0

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 網狀架構設定的參數名稱。 字串 (必要)
網狀架構設定的參數值。 字串 (必要)

LoadBalancingRule

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

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

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

NetworkSecurityRule

名稱 描述
access 允許或拒絕網路流量。 'allow'
'deny' (必要)
description 網路安全性規則描述。 字串
destinationAddressPrefixes 目的地位址前置詞。 CIDR 或目的地IP範圍。 string[]
destinationPortRanges 目的地埠範圍。 string[]
direction 網路安全性規則方向。 'inbound'
需要「輸出」 ()
NAME 網路安全性規則名稱。 字串 (必要)
priority 規則的優先順序。 值的範圍可以是 1000 到 3000。 超出此範圍的值會保留給 Service Fabric ManagerCluster 資源提供者。 集合中每個規則的優先順序數字必須是唯一的。 優先順序號碼愈小,規則優先順序就愈高。 int (必要)

約束:
最小值 = 1000
最大值 = 3000
protocol 此規則適用的網路通訊協定。 'ah'
'esp'
'http'
'https'
'icmp'
'tcp'
'udp' (必要)
sourceAddressPrefixes CIDR 或來源IP範圍。 string[]
sourcePortRanges 來源埠範圍。 string[]

SKU

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

ARM 範本資源定義

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

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

資源格式

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

{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "apiVersion": "2021-01-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"
    },
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string"
    },
    "clientConnectionPort": "int",
    "clients": [
      {
        "commonName": "string",
        "isAdmin": "bool",
        "issuerThumbprint": "string",
        "thumbprint": "string"
      }
    ],
    "clusterCodeVersion": "string",
    "clusterUpgradeCadence": "string",
    "dnsName": "string",
    "enableAutoOSUpgrade": "bool",
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "httpGatewayConnectionPort": "int",
    "loadBalancingRules": [
      {
        "backendPort": "int",
        "frontendPort": "int",
        "probeProtocol": "string",
        "probeRequestPath": "string",
        "protocol": "string"
      }
    ],
    "networkSecurityRules": [
      {
        "access": "string",
        "description": "string",
        "destinationAddressPrefixes": [ "string" ],
        "destinationPortRanges": [ "string" ],
        "direction": "string",
        "name": "string",
        "priority": "int",
        "protocol": "string",
        "sourceAddressPrefixes": [ "string" ],
        "sourcePortRanges": [ "string" ]
      }
    ]
  }
}

屬性值

managedClusters

名稱 描述
類型 資源類型 'Microsoft.ServiceFabric/managedClusters'
apiVersion 資源 API 版本 '2021-01-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
azureActiveDirectory 叢集的 AAD 驗證設定。 AzureActiveDirectory
clientConnectionPort 用於與叢集之用戶端連線的埠。 int
用戶端 允許管理叢集的客戶端憑證。 ClientCertificate[]
clusterCodeVersion 叢集的 Service Fabric 運行時間版本。 只有在 upgradeMode 設定為 'Manual' 時,才能將此屬性設定為使用者。 若要取得新叢集可用的 Service Fabric 版本清單,請使用 ClusterVersion API。 若要取得現有叢集可用的版本清單,請使用 availableClusterVersions 字串
clusterUpgradeCadence 指出發行新的叢集運行時間版本升級何時會套用。 預設為 Wave0。 'Wave0'
'Wave1'
'Wave2'
dnsName 叢集 dns 名稱。 字串 (必要)
enableAutoOSUpgrade 將此設定為 true 可針對使用任何平臺 OS 映射搭配版本 『latest』 建立的節點類型自動升級。 此設定的預設值為 false。 bool
fabricSettings 要設定叢集的自定義網狀架構設定清單。 SettingsSectionDescription[]
httpGatewayConnectionPort 用於叢集 HTTP 連線的埠。 int
loadBalancingRules 套用至叢集公用負載平衡器的負載平衡規則。 LoadBalancingRule[]
networkSecurityRules 套用至叢集虛擬網路的自定義網路安全性規則。 NetworkSecurityRule[]

ApplicationTypeVersionsCleanupPolicy

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

約束:
最小值 = 0

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 網狀架構設定的參數名稱。 需要字串 ()
網狀架構設定的參數值。 需要字串 ()

LoadBalancingRule

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

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

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

NetworkSecurityRule

名稱 描述
access 允許或拒絕網路流量。 'allow'
需要 『deny』 ()
description 網路安全性規則描述。 字串
destinationAddressPrefixes 目的地位址前置詞。 CIDR 或目的地IP範圍。 string[]
destinationPortRanges 目的地埠範圍。 string[]
direction 網路安全性規則方向。 'inbound'
需要 『outbound』 ()
NAME 網路安全性規則名稱。 需要字串 ()
priority 規則的優先順序。 此值的範圍可以是 1000 到 3000。 此範圍以外的值會保留給 Service Fabric ManagerCluster 資源提供者。 集合中每個規則的優先順序數字必須是唯一的。 優先順序號碼愈小,規則優先順序就愈高。 需要 int ()

約束:
最小值 = 1000
最大值 = 3000
protocol 此規則適用的網路通訊協定。 'ah'
'esp'
'http'
'https'
'icmp'
'tcp'
需要 『udp』 ()
sourceAddressPrefixes CIDR 或來源IP範圍。 string[]
sourcePortRanges 來源埠範圍。 string[]

SKU

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

Terraform (AzAPI 提供者) 資源定義

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

  • 資源群組

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

資源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedClusters@2021-01-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
      }
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
      }
      clientConnectionPort = int
      clients = [
        {
          commonName = "string"
          isAdmin = bool
          issuerThumbprint = "string"
          thumbprint = "string"
        }
      ]
      clusterCodeVersion = "string"
      clusterUpgradeCadence = "string"
      dnsName = "string"
      enableAutoOSUpgrade = bool
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      httpGatewayConnectionPort = int
      loadBalancingRules = [
        {
          backendPort = int
          frontendPort = int
          probeProtocol = "string"
          probeRequestPath = "string"
          protocol = "string"
        }
      ]
      networkSecurityRules = [
        {
          access = "string"
          description = "string"
          destinationAddressPrefixes = [
            "string"
          ]
          destinationPortRanges = [
            "string"
          ]
          direction = "string"
          name = "string"
          priority = int
          protocol = "string"
          sourceAddressPrefixes = [
            "string"
          ]
          sourcePortRanges = [
            "string"
          ]
        }
      ]
    }
    sku = {
      name = "string"
    }
  })
}

屬性值

managedClusters

名稱 描述
類型 資源類型 “Microsoft.ServiceFabric/managedClusters@2021-01-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
azureActiveDirectory 叢集的 AAD 驗證設定。 AzureActiveDirectory
clientConnectionPort 用於與叢集之用戶端連線的埠。 int
用戶端 允許管理叢集的客戶端憑證。 ClientCertificate[]
clusterCodeVersion 叢集的 Service Fabric 運行時間版本。 只有在 upgradeMode 設定為 'Manual' 時,才能將此屬性設定為使用者。 若要取得新叢集可用的 Service Fabric 版本清單,請使用 ClusterVersion API。 若要取得現有叢集可用的版本清單,請使用 availableClusterVersions 字串
clusterUpgradeCadence 指出發行新的叢集運行時間版本升級何時會套用。 預設為 Wave0。 “Wave0”
“Wave1”
“Wave2”
dnsName 叢集 dns 名稱。 字串 (必要)
enableAutoOSUpgrade 將此設定為 true 可針對使用任何平臺 OS 映射搭配版本 『latest』 建立的節點類型自動升級。 此設定的預設值為 false。 bool
fabricSettings 要設定叢集的自定義網狀架構設定清單。 SettingsSectionDescription[]
httpGatewayConnectionPort 用於叢集 HTTP 連線的埠。 int
loadBalancingRules 套用至叢集公用負載平衡器的負載平衡規則。 LoadBalancingRule[]
networkSecurityRules 套用至叢集虛擬網路的自定義網路安全性規則。 NetworkSecurityRule[]

ApplicationTypeVersionsCleanupPolicy

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

約束:
最小值 = 0

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 網狀架構設定的參數名稱。 字串 (必要)
網狀架構設定的參數值。 字串 (必要)

LoadBalancingRule

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

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

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

NetworkSecurityRule

名稱 描述
access 允許或拒絕網路流量。 “allow”
「拒絕」 (必要)
description 網路安全性規則描述。 字串
destinationAddressPrefixes 目的地位址前置詞。 CIDR 或目的地IP範圍。 string[]
destinationPortRanges 目的地埠範圍。 string[]
direction 網路安全性規則方向。 “inbound”
必要的「輸出」 ()
NAME 網路安全性規則名稱。 字串 (必要)
priority 規則的優先順序。 值的範圍可以是 1000 到 3000。 超出此範圍的值會保留給 Service Fabric ManagerCluster 資源提供者。 集合中每個規則的優先順序數字必須是唯一的。 優先順序號碼愈小,規則優先順序就愈高。 int (必要)

約束:
最小值 = 1000
最大值 = 3000
protocol 此規則適用的網路通訊協定。 “ah”
“esp”
"http"
"https"
“icmp”
“tcp”
“udp” (必要)
sourceAddressPrefixes CIDR 或來源IP範圍。 string[]
sourcePortRanges 來源埠範圍。 string[]

SKU

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