共用方式為


Microsoft.ServiceFabric managedClusters/nodeTypes 2024-06-01-preview

Bicep 資源定義

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

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

資源格式

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

resource symbolicname 'Microsoft.ServiceFabric/managedClusters/nodeTypes@2024-06-01-preview' = {
  name: 'string'
  properties: {
    additionalDataDisks: [
      {
        diskLetter: 'string'
        diskSizeGB: int
        diskType: 'string'
        lun: int
      }
    ]
    additionalNetworkInterfaceConfigurations: [
      {
        dscpConfiguration: {
          id: 'string'
        }
        enableAcceleratedNetworking: bool
        ipConfigurations: [
          {
            applicationGatewayBackendAddressPools: [
              {
                id: 'string'
              }
            ]
            loadBalancerBackendAddressPools: [
              {
                id: 'string'
              }
            ]
            loadBalancerInboundNatPools: [
              {
                id: 'string'
              }
            ]
            name: 'string'
            privateIPAddressVersion: 'string'
            publicIPAddressConfiguration: {
              ipTags: [
                {
                  ipTagType: 'string'
                  tag: 'string'
                }
              ]
              name: 'string'
              publicIPAddressVersion: 'string'
            }
            subnet: {
              id: 'string'
            }
          }
        ]
        name: 'string'
      }
    ]
    applicationPorts: {
      endPort: int
      startPort: int
    }
    capacities: {
      {customized property}: 'string'
    }
    computerNamePrefix: 'string'
    dataDiskLetter: 'string'
    dataDiskSizeGB: int
    dataDiskType: 'string'
    dscpConfigurationId: 'string'
    enableAcceleratedNetworking: bool
    enableEncryptionAtHost: bool
    enableNodePublicIP: bool
    enableNodePublicIPv6: bool
    enableOverProvisioning: bool
    ephemeralPorts: {
      endPort: int
      startPort: int
    }
    evictionPolicy: 'string'
    frontendConfigurations: [
      {
        applicationGatewayBackendAddressPoolId: 'string'
        ipAddressType: 'string'
        loadBalancerBackendAddressPoolId: 'string'
        loadBalancerInboundNatPoolId: 'string'
      }
    ]
    hostGroupId: 'string'
    isPrimary: bool
    isSpotVM: bool
    isStateless: bool
    multiplePlacementGroups: bool
    natConfigurations: [
      {
        backendPort: int
        frontendPortRangeEnd: int
        frontendPortRangeStart: int
      }
    ]
    natGatewayId: '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'
        ]
      }
    ]
    placementProperties: {
      {customized property}: 'string'
    }
    secureBootEnabled: bool
    securityType: 'string'
    serviceArtifactReferenceId: 'string'
    spotRestoreTimeout: 'string'
    subnetId: 'string'
    useDefaultPublicLoadBalancer: bool
    useEphemeralOSDisk: bool
    useTempDataDisk: bool
    vmApplications: [
      {
        configurationReference: 'string'
        enableAutomaticUpgrade: bool
        order: int
        packageReferenceId: 'string'
        treatFailureAsDeploymentFailure: bool
        vmGalleryTags: 'string'
      }
    ]
    vmExtensions: [
      {
        name: 'string'
        properties: {
          autoUpgradeMinorVersion: bool
          enableAutomaticUpgrade: bool
          forceUpdateTag: 'string'
          protectedSettings: any(Azure.Bicep.Types.Concrete.AnyType)
          provisionAfterExtensions: [
            'string'
          ]
          publisher: 'string'
          settings: any(Azure.Bicep.Types.Concrete.AnyType)
          setupOrder: [
            'string'
          ]
          type: 'string'
          typeHandlerVersion: 'string'
        }
      }
    ]
    vmImageOffer: 'string'
    vmImagePlan: {
      name: 'string'
      product: 'string'
      promotionCode: 'string'
      publisher: 'string'
    }
    vmImagePublisher: 'string'
    vmImageResourceId: 'string'
    vmImageSku: 'string'
    vmImageVersion: 'string'
    vmInstanceCount: int
    vmManagedIdentity: {
      userAssignedIdentities: [
        'string'
      ]
    }
    vmSecrets: [
      {
        sourceVault: {
          id: 'string'
        }
        vaultCertificates: [
          {
            certificateStore: 'string'
            certificateUrl: 'string'
          }
        ]
      }
    ]
    vmSetupActions: [
      'string'
    ]
    vmSharedGalleryImageId: 'string'
    vmSize: 'string'
    zones: [
      'string'
    ]
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

屬性值

AdditionalNetworkInterfaceConfiguration

名字 描述 價值
dscpConfiguration 指定要套用至網路介面的 DSCP 組態。 SubResource
enableAcceleratedNetworking 指定網路介面是否已啟用加速網路功能。 bool
ipConfigurations 指定網路介面的IP組態。 IpConfiguration[] (必要)
名字 網路介面的名稱。 字串 (必要)

EndpointRangeDescription

名字 描述 價值
endPort 一系列埠的結束埠 int (必要)
startPort 起始埠範圍 int (必要)

FrontendConfiguration

名字 描述 價值
applicationGatewayBackendAddressPoolId 應用程式閘道後端位址池的資源標識碼。 資源標識符的格式為 '/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/applicationGateways/<applicationGatewayName>/backendAddressPools/<backendAddressPoolName>'。 字串
ipAddressType 此前端組態的IP位址類型。 如果省略預設值為 IPv4。 'IPv4'
'IPv6'
loadBalancerBackendAddressPoolId 與節點類型之 VM 實例相關聯的 Load Balancer 後端位址池資源識別碼。 資源標識符的格式為 '/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/loadBalancers/<loadBalancerName>/backendAddressPools/<backendAddressPoolName>'。 字串
loadBalancerInboundNatPoolId 與節點類型之 VM 實例相關聯的 Load Balancer 輸入 NAT 集區資源識別碼。 資源標識符的格式為 '/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/loadBalancers/<loadBalancerName>/inboundNatPools/<inboundNatPoolName>'。 字串

IpConfiguration

名字 描述 價值
applicationGatewayBackendAddressPools 指定應用程式閘道後端位址池的參考數位。 節點類型可以參考多個應用程式閘道的後端位址池。 多個節點類型無法使用相同的應用程式閘道。 SubResource[]
loadBalancerBackendAddressPools 指定負載平衡器後端位址池的參考陣列。 節點類型可以參考一個公用和一個內部負載平衡器的後端位址池。 多個節點類型無法使用相同的基本 SKU 負載平衡器。 SubResource[]
loadBalancerInboundNatPools 指定負載平衡器輸入 Nat 集區的參考陣列。 節點類型可以參考一個公用和一個內部負載平衡器的輸入 nat 集區。 多個節點類型無法使用相同的基本 SKU 負載平衡器。 SubResource[]
名字 網路介面的名稱。 字串 (必要)
privateIPAddressVersion 指定IP組態的私人IP是IPv4或IPv6。 預設值為 IPv4。 'IPv4'
'IPv6'
publicIPAddressConfiguration 網路介面的公用IP位址組態。 IpConfigurationPublicIPAddressConfiguration
指定網路介面的子網。 SubResource

IpConfigurationPublicIPAddressConfiguration

名字 描述 價值
ipTags 指定與公用IP位址相關聯的IP標籤清單。 IpTag[]
名字 網路介面的名稱。 字串 (必要)
publicIPAddressVersion 指定IP組態的公用IP是IPv4還是IPv6。 預設值為 IPv4。 'IPv4'
'IPv6'

IpTag

名字 描述 價值
ipTagType IP 標籤類型。 範例:FirstPartyUsage。 字串 (必要)
標記 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 字串 (必要)

ManagedProxyResourceTags

名字 描述 價值

Microsoft.ServiceFabric/managedClusters/nodeTypes

名字 描述 價值
名字 資源名稱 字串 (必要)
父母 在 Bicep 中,您可以指定子資源的父資源。 只有在父資源外部宣告子資源時,才需要新增這個屬性。

如需詳細資訊,請參閱 父資源外部的子資源
類型資源的符號名稱:managedClusters
性能 節點類型屬性 NodeTypeProperties
sku 節點類型 sku。 NodeTypeSku
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤

NetworkSecurityRule

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

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

NodeTypeNatConfig

名字 描述 價值
backendPort NAT 組態的內部埠。 int

約束:
最小值 = 1
最大值 = 65535
frontendPortRangeEnd 外部端點的埠範圍結束。 int

約束:
最小值 = 1
最大值 = 65534
frontendPortRangeStart 外部端點的埠範圍開始。 int

約束:
最小值 = 1
最大值 = 65534

NodeTypeProperties

名字 描述 價值
additionalDataDisks 其他受控數據磁碟。 VmssDataDisk[]
additionalNetworkInterfaceConfigurations 指定附加至節點類型之任何其他次要網路介面的設定。 AdditionalNetworkInterfaceConfiguration[]
applicationPorts 叢集指派埠至 Service Fabric 應用程式的埠範圍。 EndpointRangeDescription
能力 叢集資源管理員會使用這些標籤來了解節點擁有多少資源,套用至節點類型的節點容量卷標。 NodeTypePropertiesCapacities
computerNamePrefix 指定計算機名稱前置詞。 限制為9個字元。 如果指定,允許為節點類型名稱指定較長的名稱。 字串
dataDiskLetter 受控數據磁碟字母。 它無法使用保留的字母 C 或 D,而且無法在建立之後變更。 字串

約束:
Pattern = ^[a-zA-Z]{1}$
dataDiskSizeGB 連結至節點類型上 VM 之受控磁碟的磁碟大小,以 GB 為單位。 int
dataDiskType 受控數據磁碟類型。 指定受控磁碟的記憶體帳戶類型 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
dscpConfigurationId 指定要套用至節點類型網路介面之 DSCP 組態的資源識別碼。 字串
enableAcceleratedNetworking 指定網路介面是否已啟用加速網路功能。 bool
enableEncryptionAtHost 為節點類型上的虛擬機啟用或停用主機加密。 這會啟用所有磁碟的加密,包括主機本身的資源/暫存磁碟。 默認值:除非資源將此屬性設定為 true,否則將會停用主機的加密。 bool
enableNodePublicIP 指定每個節點是否配置自己的公用 IPv4 位址。 只有使用自定義Load Balancer 的次要節點類型才支援此功能。 bool
enableNodePublicIPv6 指定每個節點是否配置自己的公用 IPv6 位址。 只有使用自定義Load Balancer 的次要節點類型才支援此功能。 bool
enableOverProvisioning 指定是否應該過度布建節點類型。 它只允許無狀態節點類型。 bool
ephemeralPorts 此節點類型中節點應設定的暫時埠範圍。 EndpointRangeDescription
evictionPolicy 指定SPOT節點類型中虛擬機的收回原則。 預設值為 Delete。 'Deallocate'
'Delete'
frontendConfigurations 指出節點類型會使用自己的前端組態,而不是叢集的預設組態。 此設定只能針對非主要節點類型指定,而且無法在建立節點類型之後新增或移除。 FrontendConfiguration[]
hostGroupId 指定完整的主機群組資源標識碼。此屬性用於在 Azure 專用主機上部署。 字串
isPrimary 指出叢集的 Service Fabric 系統服務將會在此節點類型上執行。 建立節點類型之後,就無法變更此設定。 布林 (必要)
isSpotVM 指出節點類型是否為現成虛擬機。 如果有可用的容量,Azure 將會配置 VM,而且 VM 可以隨時收回。 bool
isStateless 指出節點類型是否只能裝載無狀態工作負載。 bool
multiplePlacementGroups 指出與節點類型相關聯的擴展集是否可以由多個放置群組組成。 bool
natConfigurations 指定節點類型預設公用Load Balancer上的NAT組態。 只有節點類型才支援使用預設公用Load Balancer。 NodeTypeNatConfig[]
natGatewayId 指定 NAT 閘道的資源識別碼,以附加至此節點類型的子網。 節點類型必須使用自定義負載平衡器。 字串
networkSecurityRules 此節點類型的網路安全性規則。 此設定只能針對使用前端組態設定的節點類型指定。 NetworkSecurityRule[]
placementProperties 套用至節點類型中節點的放置標記,可用來指出特定服務(工作負載)應該執行的位置。 NodeTypePropertiesPlacementProperties
secureBootEnabled 指定是否應在 nodeType 上啟用安全開機。 只能與 TrustedLaunch SecurityType 搭配使用 bool
securityType 指定 nodeType 的安全性類型。 目前僅支援 Standard 和 TrustedLaunch 'Standard'
'TrustedLaunch'
serviceArtifactReferenceId 指定使用 'latest' 映射版本時,用來為擴展集中所有虛擬機設定相同映像版本的服務成品參考標識符。 字串
spotRestoreTimeout 指出平臺不會嘗試還原指定為 ISO 8601 的 VMSS SPOT 實例的持續時間。 字串
subnetId 指出節點類型的子網資源標識碼。 字串
useDefaultPublicLoadBalancer 指定是否使用公用負載平衡器。 如果未指定,且節點類型沒有自己的前端組態,則會附加至預設負載平衡器。 如果節點類型使用自己的Load Balancer且 useDefaultPublicLoadBalancer 為 true,則前端必須是內部Load Balancer。 如果節點類型使用自己的Load Balancer且 useDefaultPublicLoadBalancer 為 false 或未設定,則自定義負載平衡器必須包含公用負載平衡器以提供輸出連線能力。 bool
useEphemeralOSDisk 指出是否要使用暫時os磁碟。 在 vmSize 屬性上選取的 SKU 必須支援這項功能。 bool
useTempDataDisk 指定是否要使用 Service Fabric 數據根目錄的暫存磁碟,在此情況下不會鏈接受控數據磁碟,而且將使用暫存磁碟。 它只允許無狀態節點類型。 bool
vmApplications 指定應該提供給基礎 VMSS 的資源庫應用程式。 VmApplication[]
vmExtensions 應該安裝在虛擬機上的擴充功能集。 VmssExtension[]
vmImageOffer Azure 虛擬機 Marketplace 映像的供應項目類型。 例如,UbuntuServer 或 WindowsServer。 字串
vmImagePlan 指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站中,尋找您想要使用的市集映射,然後按兩下 [想要以程式設計方式部署]、[開始使用] ->。 輸入任何必要資訊,然後按兩下 [儲存]。 VmImagePlan
vmImagePublisher Azure 虛擬機 Marketplace 映像的發行者。 例如,Canonical 或 MicrosoftWindowsServer。 字串
vmImageResourceId 指出 vm 映像的資源標識碼。 此參數用於自定義 VM 映像。 字串
vmImageSku Azure 虛擬機 Marketplace 映像的 SKU。 例如,14.04.0-LTS 或 2012-R2-Datacenter。 字串
vmImageVersion Azure 虛擬機 Marketplace 映像的版本。 您可以指定 'latest' 的值來選取映像的最新版本。 如果省略,預設值為 'latest'。 字串
vmInstanceCount 節點類型中的節點數目。

值:
-1 - 設定自動調整規則或定義 sku.capacity 時使用
0 - 不支援
>0 - 用於手動調整。
int

約束:
最小值 = -1
最大值 = 2147483647 (必要)
vmManagedIdentity 要指派給節點類型下虛擬機擴展集的身分識別。 VmManagedIdentity
vmSecrets 要安裝在虛擬機中的秘密。 VaultSecretGroup[]
vmSetupActions 指定要在 VM 上執行的動作,再啟動載入 Service Fabric 運行時間。 包含任何的字串數組:
'EnableContainers'
'EnableHyperV'
vmSharedGalleryImageId 指出 vm 共用資源庫映像的資源標識碼。 此參數用於自定義 VM 映像。 字串
vmSize 集區中的虛擬機大小。 集區中的所有虛擬機大小都相同。 例如,Standard_D3。 字串
指定節點類型跨越的可用性區域。 如果叢集未跨越可用性區域,請起始叢集的 az migration。 string[]

NodeTypePropertiesCapacities

名字 描述 價值

NodeTypePropertiesPlacementProperties

名字 描述 價值

NodeTypeSku

名字 描述 價值
能力 節點類型中的節點數目。

如果存在於要求中,則會覆寫 properties.vmInstanceCount。
int

約束:
最小值 = 1
最大值 = 2147483647 (必要)
名字 SKU 名稱。

名稱會在內部產生,並用於自動調整案例中。
屬性不允許變更為產生的其他值。
若要避免部署錯誤,請省略 屬性。
字串
指定節點類型的階層。

可能的值:
Standard
字串

SubResource

名字 描述 價值
id Azure 資源標識碼。 字串

VaultCertificate

名字 描述 價值
certificateStore 針對 Windows VM,指定應新增憑證之虛擬機上的證書存儲。 指定的證書存儲隱含在 LocalMachine 帳戶中。

針對 Linux VM,憑證檔案會放在 /var/lib/waagent 目錄底下,檔名 <X509 憑證檔案的大寫Thumbprint>.crt,並針對私鑰 <大寫Thumbprint>.prv。 這兩個檔案都是 .pem 格式。
字串 (必要)
certificateUrl 這是已上傳至 Key Vault 做為秘密之憑證的 URL。 如需將秘密新增至 Key Vault,請參閱 將金鑰或秘密新增至金鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8:

{
“data”:“<Base64 編碼憑證>”,
“dataType”:“pfx”,
“password”:“<pfx-file-password>”
}
字串 (必要)

VaultSecretGroup

名字 描述 價值
sourceVault Key Vault 的相對 URL,其中包含 VaultCertificates 中的所有憑證。 SubResource (必要)
vaultCertificates SourceVault 中包含憑證的金鑰保存庫參考清單。 VaultCertificate[] (必要)

VmApplication

名字 描述 價值
configurationReference 選擇性指定 Azure Blob 的 URI,如果提供的話,將會取代套件的預設組態。 字串
enableAutomaticUpgrade 如果設定為 true,當 PIR/SIG 中提供新的資源庫應用程式版本時,將會自動更新基礎 VMSS。 bool
次序 選擇性,指定套件必須安裝的順序。 int
packageReferenceId 指定 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/applications/{application}/versions/{version}形式的 GalleryApplicationVersion 資源標識符。 字串 (必要)
treatFailureAsDeploymentFailure 選擇性的 [如果為 true],VmApplication 中任何作業的任何失敗都會使部署失敗。 bool
vmGalleryTags 選擇性,指定更多泛型內容的傳遞值。 接受 JSON 格式的字串,例如 '{“Tag1”:“Value1”,“Tag2”:“Value2”}'。 字串

VmImagePlan

名字 描述 價值
名字 方案標識碼。 字串
產品 指定來自市集的映像產品。 這個值與 imageReference 元素下的 Offer 值相同。 字串
promotionCode 促銷碼。 字串
發行人 發行者標識碼。 字串

VmManagedIdentity

名字 描述 價值
userAssignedIdentities 與節點類型下虛擬機擴展集相關聯的使用者身分識別清單。 每個項目都會是一個 ARM 資源標識符,格式如下:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 string[]

VmssDataDisk

名字 描述 價值
diskLetter 受控數據磁碟字母。 它無法使用保留的字母 C 或 D,而且無法在建立之後變更。 字串

約束:
模式 = ^[a-zA-Z]{1}$ (必要)
diskSizeGB 節點類型中每個 VM 的磁碟大小,以 GB 為單位。 int (必要)
diskType 受控數據磁碟類型。 指定受控磁碟的記憶體帳戶類型 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS' (必要)
指定數據磁碟的邏輯單元編號。 這個值是用來識別 VM 內的數據磁碟,因此對於連結至 VM 的每個數據磁碟而言都必須是唯一的。 Lun 0 會保留給 Service Fabric 數據磁碟。 int

約束:
最小值 = 1 (必要)

VmssExtension

名字 描述 價值
名字 延伸模組的名稱。 字串 (必要)
性能 描述虛擬機擴展集擴充功能的屬性。 VmssExtensionProperties (必要)

VmssExtensionProperties

名字 描述 價值
autoUpgradeMinorVersion 指出如果部署期間有新的次要版本,擴充功能是否應該使用較新的次要版本。 不過,部署之後,除非重新部署,否則擴充功能不會升級次要版本,即使此屬性設定為 true 也一定會升級。 bool
enableAutomaticUpgrade 指出如果有較新版本的延伸模組可用,平臺是否應該自動升級延伸模組。 bool
forceUpdateTag 如果提供值,且與先前的值不同,即使延伸模組組態尚未變更,擴充處理程式仍會強制更新。 字串
protectedSettings 延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault 或完全沒有受保護的設定。 任意
provisionAfterExtensions 必須布建此延伸模組之後的延伸模組名稱集合。 string[]
發行人 擴充處理程序發行者的名稱。 字串 (必要)
設置 擴充功能的 Json 格式化公用設定。 任意
setupOrder 表示延伸模組的設定順序。 包含任何的字串數組:
'BeforeSFRuntime'
類型 指定延伸模組的類型;例如“CustomScriptExtension”。 字串 (必要)
typeHandlerVersion 指定文稿處理程式的版本。 字串 (必要)

ARM 樣本資源定義

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

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

資源格式

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

{
  "type": "Microsoft.ServiceFabric/managedClusters/nodeTypes",
  "apiVersion": "2024-06-01-preview",
  "name": "string",
  "properties": {
    "additionalDataDisks": [
      {
        "diskLetter": "string",
        "diskSizeGB": "int",
        "diskType": "string",
        "lun": "int"
      }
    ],
    "additionalNetworkInterfaceConfigurations": [
      {
        "dscpConfiguration": {
          "id": "string"
        },
        "enableAcceleratedNetworking": "bool",
        "ipConfigurations": [
          {
            "applicationGatewayBackendAddressPools": [
              {
                "id": "string"
              }
            ],
            "loadBalancerBackendAddressPools": [
              {
                "id": "string"
              }
            ],
            "loadBalancerInboundNatPools": [
              {
                "id": "string"
              }
            ],
            "name": "string",
            "privateIPAddressVersion": "string",
            "publicIPAddressConfiguration": {
              "ipTags": [
                {
                  "ipTagType": "string",
                  "tag": "string"
                }
              ],
              "name": "string",
              "publicIPAddressVersion": "string"
            },
            "subnet": {
              "id": "string"
            }
          }
        ],
        "name": "string"
      }
    ],
    "applicationPorts": {
      "endPort": "int",
      "startPort": "int"
    },
    "capacities": {
      "{customized property}": "string"
    },
    "computerNamePrefix": "string",
    "dataDiskLetter": "string",
    "dataDiskSizeGB": "int",
    "dataDiskType": "string",
    "dscpConfigurationId": "string",
    "enableAcceleratedNetworking": "bool",
    "enableEncryptionAtHost": "bool",
    "enableNodePublicIP": "bool",
    "enableNodePublicIPv6": "bool",
    "enableOverProvisioning": "bool",
    "ephemeralPorts": {
      "endPort": "int",
      "startPort": "int"
    },
    "evictionPolicy": "string",
    "frontendConfigurations": [
      {
        "applicationGatewayBackendAddressPoolId": "string",
        "ipAddressType": "string",
        "loadBalancerBackendAddressPoolId": "string",
        "loadBalancerInboundNatPoolId": "string"
      }
    ],
    "hostGroupId": "string",
    "isPrimary": "bool",
    "isSpotVM": "bool",
    "isStateless": "bool",
    "multiplePlacementGroups": "bool",
    "natConfigurations": [
      {
        "backendPort": "int",
        "frontendPortRangeEnd": "int",
        "frontendPortRangeStart": "int"
      }
    ],
    "natGatewayId": "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" ]
      }
    ],
    "placementProperties": {
      "{customized property}": "string"
    },
    "secureBootEnabled": "bool",
    "securityType": "string",
    "serviceArtifactReferenceId": "string",
    "spotRestoreTimeout": "string",
    "subnetId": "string",
    "useDefaultPublicLoadBalancer": "bool",
    "useEphemeralOSDisk": "bool",
    "useTempDataDisk": "bool",
    "vmApplications": [
      {
        "configurationReference": "string",
        "enableAutomaticUpgrade": "bool",
        "order": "int",
        "packageReferenceId": "string",
        "treatFailureAsDeploymentFailure": "bool",
        "vmGalleryTags": "string"
      }
    ],
    "vmExtensions": [
      {
        "name": "string",
        "properties": {
          "autoUpgradeMinorVersion": "bool",
          "enableAutomaticUpgrade": "bool",
          "forceUpdateTag": "string",
          "protectedSettings": {},
          "provisionAfterExtensions": [ "string" ],
          "publisher": "string",
          "settings": {},
          "setupOrder": [ "string" ],
          "type": "string",
          "typeHandlerVersion": "string"
        }
      }
    ],
    "vmImageOffer": "string",
    "vmImagePlan": {
      "name": "string",
      "product": "string",
      "promotionCode": "string",
      "publisher": "string"
    },
    "vmImagePublisher": "string",
    "vmImageResourceId": "string",
    "vmImageSku": "string",
    "vmImageVersion": "string",
    "vmInstanceCount": "int",
    "vmManagedIdentity": {
      "userAssignedIdentities": [ "string" ]
    },
    "vmSecrets": [
      {
        "sourceVault": {
          "id": "string"
        },
        "vaultCertificates": [
          {
            "certificateStore": "string",
            "certificateUrl": "string"
          }
        ]
      }
    ],
    "vmSetupActions": [ "string" ],
    "vmSharedGalleryImageId": "string",
    "vmSize": "string",
    "zones": [ "string" ]
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

屬性值

AdditionalNetworkInterfaceConfiguration

名字 描述 價值
dscpConfiguration 指定要套用至網路介面的 DSCP 組態。 SubResource
enableAcceleratedNetworking 指定網路介面是否已啟用加速網路功能。 bool
ipConfigurations 指定網路介面的IP組態。 IpConfiguration[] (必要)
名字 網路介面的名稱。 字串 (必要)

EndpointRangeDescription

名字 描述 價值
endPort 一系列埠的結束埠 int (必要)
startPort 起始埠範圍 int (必要)

FrontendConfiguration

名字 描述 價值
applicationGatewayBackendAddressPoolId 應用程式閘道後端位址池的資源標識碼。 資源標識符的格式為 '/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/applicationGateways/<applicationGatewayName>/backendAddressPools/<backendAddressPoolName>'。 字串
ipAddressType 此前端組態的IP位址類型。 如果省略預設值為 IPv4。 'IPv4'
'IPv6'
loadBalancerBackendAddressPoolId 與節點類型之 VM 實例相關聯的 Load Balancer 後端位址池資源識別碼。 資源標識符的格式為 '/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/loadBalancers/<loadBalancerName>/backendAddressPools/<backendAddressPoolName>'。 字串
loadBalancerInboundNatPoolId 與節點類型之 VM 實例相關聯的 Load Balancer 輸入 NAT 集區資源識別碼。 資源標識符的格式為 '/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/loadBalancers/<loadBalancerName>/inboundNatPools/<inboundNatPoolName>'。 字串

IpConfiguration

名字 描述 價值
applicationGatewayBackendAddressPools 指定應用程式閘道後端位址池的參考數位。 節點類型可以參考多個應用程式閘道的後端位址池。 多個節點類型無法使用相同的應用程式閘道。 SubResource[]
loadBalancerBackendAddressPools 指定負載平衡器後端位址池的參考陣列。 節點類型可以參考一個公用和一個內部負載平衡器的後端位址池。 多個節點類型無法使用相同的基本 SKU 負載平衡器。 SubResource[]
loadBalancerInboundNatPools 指定負載平衡器輸入 Nat 集區的參考陣列。 節點類型可以參考一個公用和一個內部負載平衡器的輸入 nat 集區。 多個節點類型無法使用相同的基本 SKU 負載平衡器。 SubResource[]
名字 網路介面的名稱。 字串 (必要)
privateIPAddressVersion 指定IP組態的私人IP是IPv4或IPv6。 預設值為 IPv4。 'IPv4'
'IPv6'
publicIPAddressConfiguration 網路介面的公用IP位址組態。 IpConfigurationPublicIPAddressConfiguration
指定網路介面的子網。 SubResource

IpConfigurationPublicIPAddressConfiguration

名字 描述 價值
ipTags 指定與公用IP位址相關聯的IP標籤清單。 IpTag[]
名字 網路介面的名稱。 字串 (必要)
publicIPAddressVersion 指定IP組態的公用IP是IPv4還是IPv6。 預設值為 IPv4。 'IPv4'
'IPv6'

IpTag

名字 描述 價值
ipTagType IP 標籤類型。 範例:FirstPartyUsage。 字串 (必要)
標記 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 字串 (必要)

ManagedProxyResourceTags

名字 描述 價值

Microsoft.ServiceFabric/managedClusters/nodeTypes

名字 描述 價值
apiVersion API 版本 '2024-06-01-preview'
名字 資源名稱 字串 (必要)
性能 節點類型屬性 NodeTypeProperties
sku 節點類型 sku。 NodeTypeSku
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤
類型 資源類型 'Microsoft.ServiceFabric/managedClusters/nodeTypes'

NetworkSecurityRule

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

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

NodeTypeNatConfig

名字 描述 價值
backendPort NAT 組態的內部埠。 int

約束:
最小值 = 1
最大值 = 65535
frontendPortRangeEnd 外部端點的埠範圍結束。 int

約束:
最小值 = 1
最大值 = 65534
frontendPortRangeStart 外部端點的埠範圍開始。 int

約束:
最小值 = 1
最大值 = 65534

NodeTypeProperties

名字 描述 價值
additionalDataDisks 其他受控數據磁碟。 VmssDataDisk[]
additionalNetworkInterfaceConfigurations 指定附加至節點類型之任何其他次要網路介面的設定。 AdditionalNetworkInterfaceConfiguration[]
applicationPorts 叢集指派埠至 Service Fabric 應用程式的埠範圍。 EndpointRangeDescription
能力 叢集資源管理員會使用這些標籤來了解節點擁有多少資源,套用至節點類型的節點容量卷標。 NodeTypePropertiesCapacities
computerNamePrefix 指定計算機名稱前置詞。 限制為9個字元。 如果指定,允許為節點類型名稱指定較長的名稱。 字串
dataDiskLetter 受控數據磁碟字母。 它無法使用保留的字母 C 或 D,而且無法在建立之後變更。 字串

約束:
Pattern = ^[a-zA-Z]{1}$
dataDiskSizeGB 連結至節點類型上 VM 之受控磁碟的磁碟大小,以 GB 為單位。 int
dataDiskType 受控數據磁碟類型。 指定受控磁碟的記憶體帳戶類型 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
dscpConfigurationId 指定要套用至節點類型網路介面之 DSCP 組態的資源識別碼。 字串
enableAcceleratedNetworking 指定網路介面是否已啟用加速網路功能。 bool
enableEncryptionAtHost 為節點類型上的虛擬機啟用或停用主機加密。 這會啟用所有磁碟的加密,包括主機本身的資源/暫存磁碟。 默認值:除非資源將此屬性設定為 true,否則將會停用主機的加密。 bool
enableNodePublicIP 指定每個節點是否配置自己的公用 IPv4 位址。 只有使用自定義Load Balancer 的次要節點類型才支援此功能。 bool
enableNodePublicIPv6 指定每個節點是否配置自己的公用 IPv6 位址。 只有使用自定義Load Balancer 的次要節點類型才支援此功能。 bool
enableOverProvisioning 指定是否應該過度布建節點類型。 它只允許無狀態節點類型。 bool
ephemeralPorts 此節點類型中節點應設定的暫時埠範圍。 EndpointRangeDescription
evictionPolicy 指定SPOT節點類型中虛擬機的收回原則。 預設值為 Delete。 'Deallocate'
'Delete'
frontendConfigurations 指出節點類型會使用自己的前端組態,而不是叢集的預設組態。 此設定只能針對非主要節點類型指定,而且無法在建立節點類型之後新增或移除。 FrontendConfiguration[]
hostGroupId 指定完整的主機群組資源標識碼。此屬性用於在 Azure 專用主機上部署。 字串
isPrimary 指出叢集的 Service Fabric 系統服務將會在此節點類型上執行。 建立節點類型之後,就無法變更此設定。 布林 (必要)
isSpotVM 指出節點類型是否為現成虛擬機。 如果有可用的容量,Azure 將會配置 VM,而且 VM 可以隨時收回。 bool
isStateless 指出節點類型是否只能裝載無狀態工作負載。 bool
multiplePlacementGroups 指出與節點類型相關聯的擴展集是否可以由多個放置群組組成。 bool
natConfigurations 指定節點類型預設公用Load Balancer上的NAT組態。 只有節點類型才支援使用預設公用Load Balancer。 NodeTypeNatConfig[]
natGatewayId 指定 NAT 閘道的資源識別碼,以附加至此節點類型的子網。 節點類型必須使用自定義負載平衡器。 字串
networkSecurityRules 此節點類型的網路安全性規則。 此設定只能針對使用前端組態設定的節點類型指定。 NetworkSecurityRule[]
placementProperties 套用至節點類型中節點的放置標記,可用來指出特定服務(工作負載)應該執行的位置。 NodeTypePropertiesPlacementProperties
secureBootEnabled 指定是否應在 nodeType 上啟用安全開機。 只能與 TrustedLaunch SecurityType 搭配使用 bool
securityType 指定 nodeType 的安全性類型。 目前僅支援 Standard 和 TrustedLaunch 'Standard'
'TrustedLaunch'
serviceArtifactReferenceId 指定使用 'latest' 映射版本時,用來為擴展集中所有虛擬機設定相同映像版本的服務成品參考標識符。 字串
spotRestoreTimeout 指出平臺不會嘗試還原指定為 ISO 8601 的 VMSS SPOT 實例的持續時間。 字串
subnetId 指出節點類型的子網資源標識碼。 字串
useDefaultPublicLoadBalancer 指定是否使用公用負載平衡器。 如果未指定,且節點類型沒有自己的前端組態,則會附加至預設負載平衡器。 如果節點類型使用自己的Load Balancer且 useDefaultPublicLoadBalancer 為 true,則前端必須是內部Load Balancer。 如果節點類型使用自己的Load Balancer且 useDefaultPublicLoadBalancer 為 false 或未設定,則自定義負載平衡器必須包含公用負載平衡器以提供輸出連線能力。 bool
useEphemeralOSDisk 指出是否要使用暫時os磁碟。 在 vmSize 屬性上選取的 SKU 必須支援這項功能。 bool
useTempDataDisk 指定是否要使用 Service Fabric 數據根目錄的暫存磁碟,在此情況下不會鏈接受控數據磁碟,而且將使用暫存磁碟。 它只允許無狀態節點類型。 bool
vmApplications 指定應該提供給基礎 VMSS 的資源庫應用程式。 VmApplication[]
vmExtensions 應該安裝在虛擬機上的擴充功能集。 VmssExtension[]
vmImageOffer Azure 虛擬機 Marketplace 映像的供應項目類型。 例如,UbuntuServer 或 WindowsServer。 字串
vmImagePlan 指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站中,尋找您想要使用的市集映射,然後按兩下 [想要以程式設計方式部署]、[開始使用] ->。 輸入任何必要資訊,然後按兩下 [儲存]。 VmImagePlan
vmImagePublisher Azure 虛擬機 Marketplace 映像的發行者。 例如,Canonical 或 MicrosoftWindowsServer。 字串
vmImageResourceId 指出 vm 映像的資源標識碼。 此參數用於自定義 VM 映像。 字串
vmImageSku Azure 虛擬機 Marketplace 映像的 SKU。 例如,14.04.0-LTS 或 2012-R2-Datacenter。 字串
vmImageVersion Azure 虛擬機 Marketplace 映像的版本。 您可以指定 'latest' 的值來選取映像的最新版本。 如果省略,預設值為 'latest'。 字串
vmInstanceCount 節點類型中的節點數目。

值:
-1 - 設定自動調整規則或定義 sku.capacity 時使用
0 - 不支援
>0 - 用於手動調整。
int

約束:
最小值 = -1
最大值 = 2147483647 (必要)
vmManagedIdentity 要指派給節點類型下虛擬機擴展集的身分識別。 VmManagedIdentity
vmSecrets 要安裝在虛擬機中的秘密。 VaultSecretGroup[]
vmSetupActions 指定要在 VM 上執行的動作,再啟動載入 Service Fabric 運行時間。 包含任何的字串數組:
'EnableContainers'
'EnableHyperV'
vmSharedGalleryImageId 指出 vm 共用資源庫映像的資源標識碼。 此參數用於自定義 VM 映像。 字串
vmSize 集區中的虛擬機大小。 集區中的所有虛擬機大小都相同。 例如,Standard_D3。 字串
指定節點類型跨越的可用性區域。 如果叢集未跨越可用性區域,請起始叢集的 az migration。 string[]

NodeTypePropertiesCapacities

名字 描述 價值

NodeTypePropertiesPlacementProperties

名字 描述 價值

NodeTypeSku

名字 描述 價值
能力 節點類型中的節點數目。

如果存在於要求中,則會覆寫 properties.vmInstanceCount。
int

約束:
最小值 = 1
最大值 = 2147483647 (必要)
名字 SKU 名稱。

名稱會在內部產生,並用於自動調整案例中。
屬性不允許變更為產生的其他值。
若要避免部署錯誤,請省略 屬性。
字串
指定節點類型的階層。

可能的值:
Standard
字串

SubResource

名字 描述 價值
id Azure 資源標識碼。 字串

VaultCertificate

名字 描述 價值
certificateStore 針對 Windows VM,指定應新增憑證之虛擬機上的證書存儲。 指定的證書存儲隱含在 LocalMachine 帳戶中。

針對 Linux VM,憑證檔案會放在 /var/lib/waagent 目錄底下,檔名 <X509 憑證檔案的大寫Thumbprint>.crt,並針對私鑰 <大寫Thumbprint>.prv。 這兩個檔案都是 .pem 格式。
字串 (必要)
certificateUrl 這是已上傳至 Key Vault 做為秘密之憑證的 URL。 如需將秘密新增至 Key Vault,請參閱 將金鑰或秘密新增至金鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8:

{
“data”:“<Base64 編碼憑證>”,
“dataType”:“pfx”,
“password”:“<pfx-file-password>”
}
字串 (必要)

VaultSecretGroup

名字 描述 價值
sourceVault Key Vault 的相對 URL,其中包含 VaultCertificates 中的所有憑證。 SubResource (必要)
vaultCertificates SourceVault 中包含憑證的金鑰保存庫參考清單。 VaultCertificate[] (必要)

VmApplication

名字 描述 價值
configurationReference 選擇性指定 Azure Blob 的 URI,如果提供的話,將會取代套件的預設組態。 字串
enableAutomaticUpgrade 如果設定為 true,當 PIR/SIG 中提供新的資源庫應用程式版本時,將會自動更新基礎 VMSS。 bool
次序 選擇性,指定套件必須安裝的順序。 int
packageReferenceId 指定 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/applications/{application}/versions/{version}形式的 GalleryApplicationVersion 資源標識符。 字串 (必要)
treatFailureAsDeploymentFailure 選擇性的 [如果為 true],VmApplication 中任何作業的任何失敗都會使部署失敗。 bool
vmGalleryTags 選擇性,指定更多泛型內容的傳遞值。 接受 JSON 格式的字串,例如 '{“Tag1”:“Value1”,“Tag2”:“Value2”}'。 字串

VmImagePlan

名字 描述 價值
名字 方案標識碼。 字串
產品 指定來自市集的映像產品。 這個值與 imageReference 元素下的 Offer 值相同。 字串
promotionCode 促銷碼。 字串
發行人 發行者標識碼。 字串

VmManagedIdentity

名字 描述 價值
userAssignedIdentities 與節點類型下虛擬機擴展集相關聯的使用者身分識別清單。 每個項目都會是一個 ARM 資源標識符,格式如下:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 string[]

VmssDataDisk

名字 描述 價值
diskLetter 受控數據磁碟字母。 它無法使用保留的字母 C 或 D,而且無法在建立之後變更。 字串

約束:
模式 = ^[a-zA-Z]{1}$ (必要)
diskSizeGB 節點類型中每個 VM 的磁碟大小,以 GB 為單位。 int (必要)
diskType 受控數據磁碟類型。 指定受控磁碟的記憶體帳戶類型 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS' (必要)
指定數據磁碟的邏輯單元編號。 這個值是用來識別 VM 內的數據磁碟,因此對於連結至 VM 的每個數據磁碟而言都必須是唯一的。 Lun 0 會保留給 Service Fabric 數據磁碟。 int

約束:
最小值 = 1 (必要)

VmssExtension

名字 描述 價值
名字 延伸模組的名稱。 字串 (必要)
性能 描述虛擬機擴展集擴充功能的屬性。 VmssExtensionProperties (必要)

VmssExtensionProperties

名字 描述 價值
autoUpgradeMinorVersion 指出如果部署期間有新的次要版本,擴充功能是否應該使用較新的次要版本。 不過,部署之後,除非重新部署,否則擴充功能不會升級次要版本,即使此屬性設定為 true 也一定會升級。 bool
enableAutomaticUpgrade 指出如果有較新版本的延伸模組可用,平臺是否應該自動升級延伸模組。 bool
forceUpdateTag 如果提供值,且與先前的值不同,即使延伸模組組態尚未變更,擴充處理程式仍會強制更新。 字串
protectedSettings 延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault 或完全沒有受保護的設定。 任意
provisionAfterExtensions 必須布建此延伸模組之後的延伸模組名稱集合。 string[]
發行人 擴充處理程序發行者的名稱。 字串 (必要)
設置 擴充功能的 Json 格式化公用設定。 任意
setupOrder 表示延伸模組的設定順序。 包含任何的字串數組:
'BeforeSFRuntime'
類型 指定延伸模組的類型;例如“CustomScriptExtension”。 字串 (必要)
typeHandlerVersion 指定文稿處理程式的版本。 字串 (必要)

Terraform (AzAPI 提供者) 資源定義

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

  • 資源群組

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

資源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedClusters/nodeTypes@2024-06-01-preview"
  name = "string"
  body = jsonencode({
    properties = {
      additionalDataDisks = [
        {
          diskLetter = "string"
          diskSizeGB = int
          diskType = "string"
          lun = int
        }
      ]
      additionalNetworkInterfaceConfigurations = [
        {
          dscpConfiguration = {
            id = "string"
          }
          enableAcceleratedNetworking = bool
          ipConfigurations = [
            {
              applicationGatewayBackendAddressPools = [
                {
                  id = "string"
                }
              ]
              loadBalancerBackendAddressPools = [
                {
                  id = "string"
                }
              ]
              loadBalancerInboundNatPools = [
                {
                  id = "string"
                }
              ]
              name = "string"
              privateIPAddressVersion = "string"
              publicIPAddressConfiguration = {
                ipTags = [
                  {
                    ipTagType = "string"
                    tag = "string"
                  }
                ]
                name = "string"
                publicIPAddressVersion = "string"
              }
              subnet = {
                id = "string"
              }
            }
          ]
          name = "string"
        }
      ]
      applicationPorts = {
        endPort = int
        startPort = int
      }
      capacities = {
        {customized property} = "string"
      }
      computerNamePrefix = "string"
      dataDiskLetter = "string"
      dataDiskSizeGB = int
      dataDiskType = "string"
      dscpConfigurationId = "string"
      enableAcceleratedNetworking = bool
      enableEncryptionAtHost = bool
      enableNodePublicIP = bool
      enableNodePublicIPv6 = bool
      enableOverProvisioning = bool
      ephemeralPorts = {
        endPort = int
        startPort = int
      }
      evictionPolicy = "string"
      frontendConfigurations = [
        {
          applicationGatewayBackendAddressPoolId = "string"
          ipAddressType = "string"
          loadBalancerBackendAddressPoolId = "string"
          loadBalancerInboundNatPoolId = "string"
        }
      ]
      hostGroupId = "string"
      isPrimary = bool
      isSpotVM = bool
      isStateless = bool
      multiplePlacementGroups = bool
      natConfigurations = [
        {
          backendPort = int
          frontendPortRangeEnd = int
          frontendPortRangeStart = int
        }
      ]
      natGatewayId = "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"
          ]
        }
      ]
      placementProperties = {
        {customized property} = "string"
      }
      secureBootEnabled = bool
      securityType = "string"
      serviceArtifactReferenceId = "string"
      spotRestoreTimeout = "string"
      subnetId = "string"
      useDefaultPublicLoadBalancer = bool
      useEphemeralOSDisk = bool
      useTempDataDisk = bool
      vmApplications = [
        {
          configurationReference = "string"
          enableAutomaticUpgrade = bool
          order = int
          packageReferenceId = "string"
          treatFailureAsDeploymentFailure = bool
          vmGalleryTags = "string"
        }
      ]
      vmExtensions = [
        {
          name = "string"
          properties = {
            autoUpgradeMinorVersion = bool
            enableAutomaticUpgrade = bool
            forceUpdateTag = "string"
            protectedSettings = ?
            provisionAfterExtensions = [
              "string"
            ]
            publisher = "string"
            settings = ?
            setupOrder = [
              "string"
            ]
            type = "string"
            typeHandlerVersion = "string"
          }
        }
      ]
      vmImageOffer = "string"
      vmImagePlan = {
        name = "string"
        product = "string"
        promotionCode = "string"
        publisher = "string"
      }
      vmImagePublisher = "string"
      vmImageResourceId = "string"
      vmImageSku = "string"
      vmImageVersion = "string"
      vmInstanceCount = int
      vmManagedIdentity = {
        userAssignedIdentities = [
          "string"
        ]
      }
      vmSecrets = [
        {
          sourceVault = {
            id = "string"
          }
          vaultCertificates = [
            {
              certificateStore = "string"
              certificateUrl = "string"
            }
          ]
        }
      ]
      vmSetupActions = [
        "string"
      ]
      vmSharedGalleryImageId = "string"
      vmSize = "string"
      zones = [
        "string"
      ]
    }
  })
  sku = {
    capacity = int
    name = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
}

屬性值

AdditionalNetworkInterfaceConfiguration

名字 描述 價值
dscpConfiguration 指定要套用至網路介面的 DSCP 組態。 SubResource
enableAcceleratedNetworking 指定網路介面是否已啟用加速網路功能。 bool
ipConfigurations 指定網路介面的IP組態。 IpConfiguration[] (必要)
名字 網路介面的名稱。 字串 (必要)

EndpointRangeDescription

名字 描述 價值
endPort 一系列埠的結束埠 int (必要)
startPort 起始埠範圍 int (必要)

FrontendConfiguration

名字 描述 價值
applicationGatewayBackendAddressPoolId 應用程式閘道後端位址池的資源標識碼。 資源標識符的格式為 '/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/applicationGateways/<applicationGatewayName>/backendAddressPools/<backendAddressPoolName>'。 字串
ipAddressType 此前端組態的IP位址類型。 如果省略預設值為 IPv4。 'IPv4'
'IPv6'
loadBalancerBackendAddressPoolId 與節點類型之 VM 實例相關聯的 Load Balancer 後端位址池資源識別碼。 資源標識符的格式為 '/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/loadBalancers/<loadBalancerName>/backendAddressPools/<backendAddressPoolName>'。 字串
loadBalancerInboundNatPoolId 與節點類型之 VM 實例相關聯的 Load Balancer 輸入 NAT 集區資源識別碼。 資源標識符的格式為 '/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/loadBalancers/<loadBalancerName>/inboundNatPools/<inboundNatPoolName>'。 字串

IpConfiguration

名字 描述 價值
applicationGatewayBackendAddressPools 指定應用程式閘道後端位址池的參考數位。 節點類型可以參考多個應用程式閘道的後端位址池。 多個節點類型無法使用相同的應用程式閘道。 SubResource[]
loadBalancerBackendAddressPools 指定負載平衡器後端位址池的參考陣列。 節點類型可以參考一個公用和一個內部負載平衡器的後端位址池。 多個節點類型無法使用相同的基本 SKU 負載平衡器。 SubResource[]
loadBalancerInboundNatPools 指定負載平衡器輸入 Nat 集區的參考陣列。 節點類型可以參考一個公用和一個內部負載平衡器的輸入 nat 集區。 多個節點類型無法使用相同的基本 SKU 負載平衡器。 SubResource[]
名字 網路介面的名稱。 字串 (必要)
privateIPAddressVersion 指定IP組態的私人IP是IPv4或IPv6。 預設值為 IPv4。 'IPv4'
'IPv6'
publicIPAddressConfiguration 網路介面的公用IP位址組態。 IpConfigurationPublicIPAddressConfiguration
指定網路介面的子網。 SubResource

IpConfigurationPublicIPAddressConfiguration

名字 描述 價值
ipTags 指定與公用IP位址相關聯的IP標籤清單。 IpTag[]
名字 網路介面的名稱。 字串 (必要)
publicIPAddressVersion 指定IP組態的公用IP是IPv4還是IPv6。 預設值為 IPv4。 'IPv4'
'IPv6'

IpTag

名字 描述 價值
ipTagType IP 標籤類型。 範例:FirstPartyUsage。 字串 (必要)
標記 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 字串 (必要)

ManagedProxyResourceTags

名字 描述 價值

Microsoft.ServiceFabric/managedClusters/nodeTypes

名字 描述 價值
名字 資源名稱 字串 (必要)
parent_id 此資源為父系之資源的標識碼。 類型的資源標識碼:managedClusters
性能 節點類型屬性 NodeTypeProperties
sku 節點類型 sku。 NodeTypeSku
標籤 資源標籤 標記名稱和值的字典。
類型 資源類型 “Microsoft.ServiceFabric/managedClusters/nodeTypes@2024-06-01-preview”

NetworkSecurityRule

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

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

NodeTypeNatConfig

名字 描述 價值
backendPort NAT 組態的內部埠。 int

約束:
最小值 = 1
最大值 = 65535
frontendPortRangeEnd 外部端點的埠範圍結束。 int

約束:
最小值 = 1
最大值 = 65534
frontendPortRangeStart 外部端點的埠範圍開始。 int

約束:
最小值 = 1
最大值 = 65534

NodeTypeProperties

名字 描述 價值
additionalDataDisks 其他受控數據磁碟。 VmssDataDisk[]
additionalNetworkInterfaceConfigurations 指定附加至節點類型之任何其他次要網路介面的設定。 AdditionalNetworkInterfaceConfiguration[]
applicationPorts 叢集指派埠至 Service Fabric 應用程式的埠範圍。 EndpointRangeDescription
能力 叢集資源管理員會使用這些標籤來了解節點擁有多少資源,套用至節點類型的節點容量卷標。 NodeTypePropertiesCapacities
computerNamePrefix 指定計算機名稱前置詞。 限制為9個字元。 如果指定,允許為節點類型名稱指定較長的名稱。 字串
dataDiskLetter 受控數據磁碟字母。 它無法使用保留的字母 C 或 D,而且無法在建立之後變更。 字串

約束:
Pattern = ^[a-zA-Z]{1}$
dataDiskSizeGB 連結至節點類型上 VM 之受控磁碟的磁碟大小,以 GB 為單位。 int
dataDiskType 受控數據磁碟類型。 指定受控磁碟的記憶體帳戶類型 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
dscpConfigurationId 指定要套用至節點類型網路介面之 DSCP 組態的資源識別碼。 字串
enableAcceleratedNetworking 指定網路介面是否已啟用加速網路功能。 bool
enableEncryptionAtHost 為節點類型上的虛擬機啟用或停用主機加密。 這會啟用所有磁碟的加密,包括主機本身的資源/暫存磁碟。 默認值:除非資源將此屬性設定為 true,否則將會停用主機的加密。 bool
enableNodePublicIP 指定每個節點是否配置自己的公用 IPv4 位址。 只有使用自定義Load Balancer 的次要節點類型才支援此功能。 bool
enableNodePublicIPv6 指定每個節點是否配置自己的公用 IPv6 位址。 只有使用自定義Load Balancer 的次要節點類型才支援此功能。 bool
enableOverProvisioning 指定是否應該過度布建節點類型。 它只允許無狀態節點類型。 bool
ephemeralPorts 此節點類型中節點應設定的暫時埠範圍。 EndpointRangeDescription
evictionPolicy 指定SPOT節點類型中虛擬機的收回原則。 預設值為 Delete。 'Deallocate'
'Delete'
frontendConfigurations 指出節點類型會使用自己的前端組態,而不是叢集的預設組態。 此設定只能針對非主要節點類型指定,而且無法在建立節點類型之後新增或移除。 FrontendConfiguration[]
hostGroupId 指定完整的主機群組資源標識碼。此屬性用於在 Azure 專用主機上部署。 字串
isPrimary 指出叢集的 Service Fabric 系統服務將會在此節點類型上執行。 建立節點類型之後,就無法變更此設定。 布林 (必要)
isSpotVM 指出節點類型是否為現成虛擬機。 如果有可用的容量,Azure 將會配置 VM,而且 VM 可以隨時收回。 bool
isStateless 指出節點類型是否只能裝載無狀態工作負載。 bool
multiplePlacementGroups 指出與節點類型相關聯的擴展集是否可以由多個放置群組組成。 bool
natConfigurations 指定節點類型預設公用Load Balancer上的NAT組態。 只有節點類型才支援使用預設公用Load Balancer。 NodeTypeNatConfig[]
natGatewayId 指定 NAT 閘道的資源識別碼,以附加至此節點類型的子網。 節點類型必須使用自定義負載平衡器。 字串
networkSecurityRules 此節點類型的網路安全性規則。 此設定只能針對使用前端組態設定的節點類型指定。 NetworkSecurityRule[]
placementProperties 套用至節點類型中節點的放置標記,可用來指出特定服務(工作負載)應該執行的位置。 NodeTypePropertiesPlacementProperties
secureBootEnabled 指定是否應在 nodeType 上啟用安全開機。 只能與 TrustedLaunch SecurityType 搭配使用 bool
securityType 指定 nodeType 的安全性類型。 目前僅支援 Standard 和 TrustedLaunch 'Standard'
'TrustedLaunch'
serviceArtifactReferenceId 指定使用 'latest' 映射版本時,用來為擴展集中所有虛擬機設定相同映像版本的服務成品參考標識符。 字串
spotRestoreTimeout 指出平臺不會嘗試還原指定為 ISO 8601 的 VMSS SPOT 實例的持續時間。 字串
subnetId 指出節點類型的子網資源標識碼。 字串
useDefaultPublicLoadBalancer 指定是否使用公用負載平衡器。 如果未指定,且節點類型沒有自己的前端組態,則會附加至預設負載平衡器。 如果節點類型使用自己的Load Balancer且 useDefaultPublicLoadBalancer 為 true,則前端必須是內部Load Balancer。 如果節點類型使用自己的Load Balancer且 useDefaultPublicLoadBalancer 為 false 或未設定,則自定義負載平衡器必須包含公用負載平衡器以提供輸出連線能力。 bool
useEphemeralOSDisk 指出是否要使用暫時os磁碟。 在 vmSize 屬性上選取的 SKU 必須支援這項功能。 bool
useTempDataDisk 指定是否要使用 Service Fabric 數據根目錄的暫存磁碟,在此情況下不會鏈接受控數據磁碟,而且將使用暫存磁碟。 它只允許無狀態節點類型。 bool
vmApplications 指定應該提供給基礎 VMSS 的資源庫應用程式。 VmApplication[]
vmExtensions 應該安裝在虛擬機上的擴充功能集。 VmssExtension[]
vmImageOffer Azure 虛擬機 Marketplace 映像的供應項目類型。 例如,UbuntuServer 或 WindowsServer。 字串
vmImagePlan 指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站中,尋找您想要使用的市集映射,然後按兩下 [想要以程式設計方式部署]、[開始使用] ->。 輸入任何必要資訊,然後按兩下 [儲存]。 VmImagePlan
vmImagePublisher Azure 虛擬機 Marketplace 映像的發行者。 例如,Canonical 或 MicrosoftWindowsServer。 字串
vmImageResourceId 指出 vm 映像的資源標識碼。 此參數用於自定義 VM 映像。 字串
vmImageSku Azure 虛擬機 Marketplace 映像的 SKU。 例如,14.04.0-LTS 或 2012-R2-Datacenter。 字串
vmImageVersion Azure 虛擬機 Marketplace 映像的版本。 您可以指定 'latest' 的值來選取映像的最新版本。 如果省略,預設值為 'latest'。 字串
vmInstanceCount 節點類型中的節點數目。

值:
-1 - 設定自動調整規則或定義 sku.capacity 時使用
0 - 不支援
>0 - 用於手動調整。
int

約束:
最小值 = -1
最大值 = 2147483647 (必要)
vmManagedIdentity 要指派給節點類型下虛擬機擴展集的身分識別。 VmManagedIdentity
vmSecrets 要安裝在虛擬機中的秘密。 VaultSecretGroup[]
vmSetupActions 指定要在 VM 上執行的動作,再啟動載入 Service Fabric 運行時間。 包含任何的字串數組:
'EnableContainers'
'EnableHyperV'
vmSharedGalleryImageId 指出 vm 共用資源庫映像的資源標識碼。 此參數用於自定義 VM 映像。 字串
vmSize 集區中的虛擬機大小。 集區中的所有虛擬機大小都相同。 例如,Standard_D3。 字串
指定節點類型跨越的可用性區域。 如果叢集未跨越可用性區域,請起始叢集的 az migration。 string[]

NodeTypePropertiesCapacities

名字 描述 價值

NodeTypePropertiesPlacementProperties

名字 描述 價值

NodeTypeSku

名字 描述 價值
能力 節點類型中的節點數目。

如果存在於要求中,則會覆寫 properties.vmInstanceCount。
int

約束:
最小值 = 1
最大值 = 2147483647 (必要)
名字 SKU 名稱。

名稱會在內部產生,並用於自動調整案例中。
屬性不允許變更為產生的其他值。
若要避免部署錯誤,請省略 屬性。
字串
指定節點類型的階層。

可能的值:
Standard
字串

SubResource

名字 描述 價值
id Azure 資源標識碼。 字串

VaultCertificate

名字 描述 價值
certificateStore 針對 Windows VM,指定應新增憑證之虛擬機上的證書存儲。 指定的證書存儲隱含在 LocalMachine 帳戶中。

針對 Linux VM,憑證檔案會放在 /var/lib/waagent 目錄底下,檔名 <X509 憑證檔案的大寫Thumbprint>.crt,並針對私鑰 <大寫Thumbprint>.prv。 這兩個檔案都是 .pem 格式。
字串 (必要)
certificateUrl 這是已上傳至 Key Vault 做為秘密之憑證的 URL。 如需將秘密新增至 Key Vault,請參閱 將金鑰或秘密新增至金鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8:

{
“data”:“<Base64 編碼憑證>”,
“dataType”:“pfx”,
“password”:“<pfx-file-password>”
}
字串 (必要)

VaultSecretGroup

名字 描述 價值
sourceVault Key Vault 的相對 URL,其中包含 VaultCertificates 中的所有憑證。 SubResource (必要)
vaultCertificates SourceVault 中包含憑證的金鑰保存庫參考清單。 VaultCertificate[] (必要)

VmApplication

名字 描述 價值
configurationReference 選擇性指定 Azure Blob 的 URI,如果提供的話,將會取代套件的預設組態。 字串
enableAutomaticUpgrade 如果設定為 true,當 PIR/SIG 中提供新的資源庫應用程式版本時,將會自動更新基礎 VMSS。 bool
次序 選擇性,指定套件必須安裝的順序。 int
packageReferenceId 指定 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/applications/{application}/versions/{version}形式的 GalleryApplicationVersion 資源標識符。 字串 (必要)
treatFailureAsDeploymentFailure 選擇性的 [如果為 true],VmApplication 中任何作業的任何失敗都會使部署失敗。 bool
vmGalleryTags 選擇性,指定更多泛型內容的傳遞值。 接受 JSON 格式的字串,例如 '{“Tag1”:“Value1”,“Tag2”:“Value2”}'。 字串

VmImagePlan

名字 描述 價值
名字 方案標識碼。 字串
產品 指定來自市集的映像產品。 這個值與 imageReference 元素下的 Offer 值相同。 字串
promotionCode 促銷碼。 字串
發行人 發行者標識碼。 字串

VmManagedIdentity

名字 描述 價值
userAssignedIdentities 與節點類型下虛擬機擴展集相關聯的使用者身分識別清單。 每個項目都會是一個 ARM 資源標識符,格式如下:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 string[]

VmssDataDisk

名字 描述 價值
diskLetter 受控數據磁碟字母。 它無法使用保留的字母 C 或 D,而且無法在建立之後變更。 字串

約束:
模式 = ^[a-zA-Z]{1}$ (必要)
diskSizeGB 節點類型中每個 VM 的磁碟大小,以 GB 為單位。 int (必要)
diskType 受控數據磁碟類型。 指定受控磁碟的記憶體帳戶類型 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS' (必要)
指定數據磁碟的邏輯單元編號。 這個值是用來識別 VM 內的數據磁碟,因此對於連結至 VM 的每個數據磁碟而言都必須是唯一的。 Lun 0 會保留給 Service Fabric 數據磁碟。 int

約束:
最小值 = 1 (必要)

VmssExtension

名字 描述 價值
名字 延伸模組的名稱。 字串 (必要)
性能 描述虛擬機擴展集擴充功能的屬性。 VmssExtensionProperties (必要)

VmssExtensionProperties

名字 描述 價值
autoUpgradeMinorVersion 指出如果部署期間有新的次要版本,擴充功能是否應該使用較新的次要版本。 不過,部署之後,除非重新部署,否則擴充功能不會升級次要版本,即使此屬性設定為 true 也一定會升級。 bool
enableAutomaticUpgrade 指出如果有較新版本的延伸模組可用,平臺是否應該自動升級延伸模組。 bool
forceUpdateTag 如果提供值,且與先前的值不同,即使延伸模組組態尚未變更,擴充處理程式仍會強制更新。 字串
protectedSettings 延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault 或完全沒有受保護的設定。 任意
provisionAfterExtensions 必須布建此延伸模組之後的延伸模組名稱集合。 string[]
發行人 擴充處理程序發行者的名稱。 字串 (必要)
設置 擴充功能的 Json 格式化公用設定。 任意
setupOrder 表示延伸模組的設定順序。 包含任何的字串數組:
'BeforeSFRuntime'
類型 指定延伸模組的類型;例如“CustomScriptExtension”。 字串 (必要)
typeHandlerVersion 指定文稿處理程式的版本。 字串 (必要)