Microsoft.ServiceFabric managedClusters/nodeTypes 2021-07-01-preview

The managedClusters/nodeTypes resource type can be deployed to: Resource groups.

To learn about resource group deployments, see Bicep or ARM template.

Template format

To create a Microsoft.ServiceFabric/managedClusters/nodeTypes resource, add the following Bicep or JSON to your template.

resource symbolicname 'Microsoft.ServiceFabric/managedClusters/nodeTypes@2021-07-01-preview' = {
  name: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  properties: {
    applicationPorts: {
      endPort: int
      startPort: int
    capacities: {}
    dataDiskSizeGB: int
    dataDiskType: 'string'
    ephemeralPorts: {
      endPort: int
      startPort: int
    frontendConfigurations: [
        ipAddressType: 'string'
        loadBalancerBackendAddressPoolId: 'string'
        loadBalancerInboundNatPoolId: 'string'
    isPrimary: bool
    isStateless: bool
    multiplePlacementGroups: bool
    networkSecurityRules: [
        access: 'string'
        description: 'string'
        destinationAddressPrefixes: [ 'string' ]
        destinationPortRanges: [ 'string' ]
        direction: 'string'
        name: 'string'
        priority: int
        protocol: 'string'
        sourceAddressPrefixes: [ 'string' ]
        sourcePortRanges: [ 'string' ]
    placementProperties: {}
    vmExtensions: [
        name: 'string'
        properties: {
          autoUpgradeMinorVersion: bool
          forceUpdateTag: 'string'
          protectedSettings: any()
          provisionAfterExtensions: [ 'string' ]
          publisher: 'string'
          settings: any()
          type: 'string'
          typeHandlerVersion: 'string'
    vmImageOffer: 'string'
    vmImagePublisher: 'string'
    vmImageSku: 'string'
    vmImageVersion: 'string'
    vmInstanceCount: int
    vmManagedIdentity: {
      userAssignedIdentities: [ 'string' ]
    vmSecrets: [
        sourceVault: {
          id: 'string'
        vaultCertificates: [
            certificateStore: 'string'
            certificateUrl: 'string'
    vmSize: 'string'

Property values


Name Description Value
type The resource type

For Bicep, set this value in the resource declaration.
apiVersion The resource api version

For Bicep, set this value in the resource declaration.
name The resource name

See how to set names and types for child resources in Bicep or JSON ARM templates.
string (required)
tags Azure resource tags. Dictionary of tag names and values. See Tags in templates
sku Describes a node type sku. NodeTypeSku
properties Describes a node type in the cluster, each node type represents sub set of nodes in the cluster. NodeTypeProperties


Name Description Value
applicationPorts Port range details EndpointRangeDescription
capacities The capacity tags applied to the nodes in the node type, the cluster resource manager uses these tags to understand how much resource a node has. object
dataDiskSizeGB Disk size for each vm in the node type in GBs. int (required)
dataDiskType Managed data disk type. IOPS and throughput are given by the disk size, to see more information go to /azure/virtual-machines/disks-types. 'Premium_LRS'
ephemeralPorts Port range details EndpointRangeDescription
frontendConfigurations Indicates the node type uses its own frontend configurations instead of the default one for the cluster. This setting can only be specified for non-primary node types and can not be added or removed after the node type is created. FrontendConfiguration[]
isPrimary Indicates the Service Fabric system services for the cluster will run on this node type. This setting cannot be changed once the node type is created. bool (required)
isStateless Indicates if the node type can only host Stateless workloads. bool
multiplePlacementGroups Indicates if scale set associated with the node type can be composed of multiple placement groups. bool
networkSecurityRules The Network Security Rules for this node type. This setting can only be specified for node types that are configured with frontend configurations. NetworkSecurityRule[]
placementProperties The placement tags applied to nodes in the node type, which can be used to indicate where certain services (workload) should run. object
vmExtensions Set of extensions that should be installed onto the virtual machines. VmssExtension[]
vmImageOffer The offer type of the Azure Virtual Machines Marketplace image. For example, UbuntuServer or WindowsServer. string
vmImagePublisher The publisher of the Azure Virtual Machines Marketplace image. For example, Canonical or MicrosoftWindowsServer. string
vmImageSku The SKU of the Azure Virtual Machines Marketplace image. For example, 14.04.0-LTS or 2012-R2-Datacenter. string
vmImageVersion The version of the Azure Virtual Machines Marketplace image. A value of 'latest' can be specified to select the latest version of an image. If omitted, the default is 'latest'. string
vmInstanceCount The number of nodes in the node type.

-1 - Use when auto scale rules are configured or sku.capacity is defined
0 - Not supported
}0 - Use for manual scale.
int (required)
vmManagedIdentity Identities for the virtual machine scale set under the node type. VmManagedIdentity
vmSecrets The secrets to install in the virtual machines. VaultSecretGroup[]
vmSize The size of virtual machines in the pool. All virtual machines in a pool are the same size. For example, Standard_D3. string


Name Description Value
endPort End port of a range of ports int (required)
startPort Starting port of a range of ports int (required)


Name Description Value
ipAddressType The IP address type. 'IPv4'
loadBalancerBackendAddressPoolId The resource Id of the Load Balancer backend address pool that the VM instances of the node type are associated with. The format of the resource Id is '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/backendAddressPools/{backendAddressPoolName}'. string
loadBalancerInboundNatPoolId The resource Id of the Load Balancer inbound NAT pool that the VM instances of the node type are associated with. The format of the resource Id is '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/inboundNatPools/{inboundNatPoolName}'. string


Name Description Value
access The network traffic is allowed or denied. 'allow'
description Network security rule description. string
destinationAddressPrefixes The destination address prefixes. CIDR or destination IP ranges. string[]
destinationPortRanges The destination port ranges. string[]
direction Network security rule direction. 'inbound'
name Network security rule name. string (required)
priority The priority of the rule. The value can be in the range 1000 to 3000. Values outside this range are reserved for Service Fabric ManagerCluster Resource Provider. The priority number must be unique for each rule in the collection. The lower the priority number, the higher the priority of the rule. int (required)
protocol Network protocol this rule applies to. 'ah'
sourceAddressPrefixes The CIDR or source IP ranges. string[]
sourcePortRanges The source port ranges. string[]


Name Description Value
name The name of the extension. string (required)
properties Describes the properties of a Virtual Machine Scale Set Extension. VmssExtensionProperties (required)


Name Description Value
autoUpgradeMinorVersion Indicates whether the extension should use a newer minor version if one is available at deployment time. Once deployed, however, the extension will not upgrade minor versions unless redeployed, even with this property set to true. bool
forceUpdateTag If a value is provided and is different from the previous value, the extension handler will be forced to update even if the extension configuration has not changed. string
protectedSettings Any object For Bicep, you can use the any() function.
provisionAfterExtensions Collection of extension names after which this extension needs to be provisioned. string[]
publisher The name of the extension handler publisher. string (required)
settings Any object For Bicep, you can use the any() function.
type Specifies the type of the extension; an example is "CustomScriptExtension". string (required)
typeHandlerVersion Specifies the version of the script handler. string (required)


Name Description Value
userAssignedIdentities The list of user identities associated with the virtual machine scale set under the node type. Each entry will be an ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. string[]


Name Description Value
sourceVault Azure resource identifier. SubResource (required)
vaultCertificates The list of key vault references in SourceVault which contain certificates. VaultCertificate[] (required)


Name Description Value
id Azure resource identifier. string


Name Description Value
certificateStore For Windows VMs, specifies the certificate store on the Virtual Machine to which the certificate should be added. The specified certificate store is implicitly in the LocalMachine account.

For Linux VMs, the certificate file is placed under the /var/lib/waagent directory, with the file name {UppercaseThumbprint}.crt for the X509 certificate file and {UppercaseThumbprint}.prv for private key. Both of these files are .pem formatted.
string (required)
certificateUrl This is the URL of a certificate that has been uploaded to Key Vault as a secret. For adding a secret to the Key Vault, see Add a key or secret to the key vault. In this case, your certificate needs to be It is the Base64 encoding of the following JSON Object which is encoded in UTF-8:

string (required)


Name Description Value
capacity The number of nodes in the node type.

If present in request it will override properties.vmInstanceCount.
int (required)
name The sku name.

Name is internally generated and is used in auto-scale scenarios.
Property does not allow to be changed to other values than generated.
To avoid deployment errors please omit the property.
tier Specifies the tier of the node type.

Possible Values: