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

Bicep リソース定義

managedClusters/nodeTypes リソースの種類は、次を対象とする操作でデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.ServiceFabric/managedClusters/nodeTypes リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.ServiceFabric/managedClusters/nodeTypes@2021-07-01-preview' = {
  name: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  parent: resourceSymbolicName
  properties: {
    applicationPorts: {
      endPort: int
      startPort: int
    }
    capacities: {
      {customized property}: 'string'
    }
    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: {
      {customized property}: 'string'
    }
    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'
  }
}

プロパティ値

managedClusters/nodeTypes

名前 説明
name リソース名

Bicep で子リソースの名前と型を設定する方法を参照してください。
string (必須)
tags Azure リソース タグ。 タグ名と値のディクショナリ。 「テンプレートのタグ」を参照してください
sku ノードの種類 sku。 NodeTypeSku
parent Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。

詳細については、「 親リソースの外部にある子リソース」を参照してください。
種類のリソースのシンボリック名: managedClusters
properties ノードの種類のプロパティ NodeTypeProperties

NodeTypeProperties

名前 説明
applicationPorts クラスターが Service Fabric アプリケーションにポートを割り当てたポートの範囲。 EndpointRangeDescription
capacities ノードの種類のノードに適用される容量タグ。クラスター リソース マネージャーはこれらのタグを使用して、ノードに含まれるリソースの量を把握します。 NodeTypePropertiesCapacities
dataDiskSizeGB GB のノードの種類の各 VM のディスク サイズ。 int (必須)
dataDiskType マネージド データ ディスクの種類。 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
ephemeralPorts このノード タイプのノードを構成する必要があるエフェメラル ポートの範囲。 EndpointRangeDescription
frontendConfigurations ノードの種類が、クラスターの既定の構成ではなく、独自のフロントエンド構成を使用することを示します。 この設定は、非プライマリ ノード タイプに対してのみ指定でき、ノード タイプの作成後に追加または削除することはできません。 FrontendConfiguration[]
isPrimary クラスターの Service Fabric システム サービスがこのノードの種類で実行されることを示します。 この設定は、ノード タイプが作成された後は変更できません。 bool (必須)
isStateless ノードの種類がステートレス ワークロードのみをホストできるかどうかを示します。 [bool]
multiplePlacementGroups ノード タイプに関連付けられているスケール セットを複数の配置グループで構成できるかどうかを示します。 [bool]
networkSecurityRules このノード タイプのネットワーク セキュリティ規則。 この設定は、フロントエンド構成で構成されているノードの種類に対してのみ指定できます。 NetworkSecurityRule[]
placementProperties ノード の種類のノードに適用される配置タグ。これは、特定のサービス (ワークロード) を実行する場所を示すために使用できます。 NodeTypePropertiesPlacementProperties
vmExtensions 仮想マシンにインストールする必要がある拡張機能のセット。 VmssExtension[]
vmImageOffer Azure Virtual Machines Marketplace イメージのオファーの種類。 たとえば、UbuntuServer や WindowsServer などです。 string
vmImagePublisher Azure Virtual Machines Marketplace イメージの発行元。 たとえば、Canonical や MicrosoftWindowsServer などです。 string
vmImageSku Azure Virtual Machines Marketplace イメージの SKU。 たとえば、14.04.0-LTS や 2012-R2-Datacenter などです。 string
vmImageVersion Azure Virtual Machines Marketplace イメージのバージョン。 'latest' の値を指定して、イメージの最新バージョンを選択できます。 省略した場合、既定値は 'latest' です。 string
vmInstanceCount ノード タイプ内のノードの数。

値:
-1 - 自動スケール ルールが構成されている場合、または sku.capacity が定義されている場合に使用する
0 - サポートされていません
}0 - 手動スケールに使用します。
int (必須)

制約:
最大値 = 2147483647
vmManagedIdentity ノードの種類で仮想マシン スケール セットに割り当てる ID。 VmManagedIdentity
vmSecrets 仮想マシンにインストールするシークレット。 VaultSecretGroup[]
vmSize プール内の仮想マシンのサイズ。 プール内の仮想マシンのサイズはすべて同じです。 たとえば、Standard_D3。 string

EndpointRangeDescription

名前 説明
endPort ポートの範囲の終了ポート int (必須)
startPort ポート範囲の開始ポート int (必須)

NodeTypePropertiesCapacities

名前 説明
{カスタマイズされたプロパティ} string

FrontendConfiguration

名前 説明
ipAddressType このフロントエンド構成の IP アドレスの種類。 省略すると、既定値は IPv4 になります。 'IPv4'
'IPv6'
loadBalancerBackendAddressPoolId ノードタイプの VM インスタンスが関連付けられているLoad Balancerバックエンド アドレス プールのリソース ID。 リソース ID の形式は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/backendAddressPools/{backendAddressPoolName}' です。 string
loadBalancerInboundNatPoolId ノード タイプの VM インスタンスが関連付けられているLoad Balancer受信 NAT プールのリソース ID。 リソース ID の形式は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/inboundNatPools/{inboundNatPoolName}' です。 string

NetworkSecurityRule

名前 説明
access ネットワーク トラフィックは許可または拒否されます。 'allow'
'deny' (必須)
description ネットワーク セキュリティ規則の説明。 string
destinationAddressPrefixes 宛先アドレス プレフィックス。 CIDR または宛先 IP 範囲。 string[]
destinationPortRanges 宛先ポート範囲。 string[]
方向 ネットワーク セキュリティ規則の方向。 'inbound'
'outbound' (必須)
name ネットワーク セキュリティ規則の名前。 string (必須)
priority ルールの優先度。 値は、1000 ~ 3000 の範囲にすることができます。 この範囲外の値は、Service Fabric ManagerCluster リソース プロバイダー用に予約されています。 優先度番号は、コレクション内のルールごとに一意である必要があります。 優先度番号が低いほど、規則の優先度が高くなります。 int (必須)

制約:
最小値 = 1000
最大値 = 3000
protocol この規則が適用されるネットワーク プロトコル。 'ah'
'esp'
'http'
'https'
'icmp'
'tcp'
'udp' (必須)
sourceAddressPrefixes CIDR またはソース IP 範囲。 string[]
sourcePortRanges ソース ポートの範囲。 string[]

NodeTypePropertiesPlacementProperties

名前 説明
{カスタマイズされたプロパティ} string

VmssExtension

名前 説明
name 拡張機能の名前です。 string (必須)
properties 仮想マシン スケール セット拡張機能のプロパティについて説明します。 VmssExtensionProperties (必須)

VmssExtensionProperties

名前 説明
autoUpgradeMinorVersion 展開時に使用可能な場合に、拡張機能で新しいマイナー バージョンを使用するかどうかを示します。 ただし、デプロイされると、このプロパティが true に設定されていても、再デプロイされない限り、拡張機能でマイナー バージョンのアップグレードは行われません。 [bool]
forceUpdateTag 値が指定され、前の値と異なる場合、拡張機能の構成が変更されていない場合でも、拡張機能ハンドラーは強制的に更新されます。 string
protectedSettings 拡張機能には、protectedSettings または protectedSettingsFromKeyVault を含めることも、保護された設定をまったく含めることもできます。 Bicep の場合は、 any() 関数を使用できます。
provisionAfterExtensions この拡張機能をプロビジョニングする必要がある拡張機能名のコレクション。 string[]
publisher 拡張ハンドラーパブリッシャーの名前。 string (必須)
settings 拡張機能の Json 形式のパブリック設定。 Bicep の場合は、 any() 関数を使用できます。
拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。 string (必須)
typeHandlerVersion スクリプト ハンドラーのバージョンを指定します。 string (必須)

VmManagedIdentity

名前 説明
userAssignedIdentities ノードの種類の下にある仮想マシン スケール セットに関連付けられているユーザー ID の一覧。 各エントリは、"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}" という形式の ARM リソース ID になります。 string[]

VaultSecretGroup

名前 説明
sourceVault VaultCertificates のすべての証明書を含むKey Vaultの相対 URL。 SubResource (必須)
vaultCertificates 証明書を含む SourceVault 内のキー コンテナー参照の一覧。 VaultCertificate[] (必須)

サブリソース

名前 説明
id Azure リソース識別子。 string

VaultCertificate

名前 説明
certificateStore Windows VM の場合は、証明書を追加する仮想マシン上の証明書ストアを指定します。 指定された証明書ストアは、LocalMachine アカウントに暗黙的に含まれます。

Linux VM の場合、証明書ファイルは /var/lib/waagent ディレクトリの下に配置され、X509 証明書ファイルにはファイル名 {UppercaseThumbprint}.crt、秘密キーには {UppercaseThumbprint}.prv が付けられます。 これらのファイルはどちらも .pem 形式です。
string (必須)
certificateUrl これは、シークレットとしてKey Vaultにアップロードされた証明書の URL です。 Key Vaultにシークレットを追加する方法については、「キー コンテナーにキーまたはシークレットを追加する」を参照してください。 この場合、証明書は UTF-8 でエンコードされた次の JSON オブジェクトの Base64 エンコードである必要があります。

{
"data":"{Base64-encoded-certificate}",
"dataType":"pfx",
"password":"{pfx-file-password}"
}
string (必須)

NodeTypeSku

名前 説明
capacity ノード タイプ内のノードの数。

要求に存在する場合は、properties.vmInstanceCount をオーバーライドします。
int (必須)

制約:
最小値 = 1
最大値 = 2147483647
name SKU 名。

名前は内部的に生成され、自動スケール シナリオで使用されます。
プロパティでは、生成された以外の値に変更することはできません。
展開エラーを回避するには、 プロパティを省略してください。
string
レベル ノード の種類の層を指定します。

有効値は次のとおりです。
Standard
string

ARM テンプレート リソース定義

managedClusters/nodeTypes リソースの種類は、次をターゲットとする操作でデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.ServiceFabric/managedClusters/nodeTypes リソースを作成するには、テンプレートに次の JSON を追加します。

{
  "type": "Microsoft.ServiceFabric/managedClusters/nodeTypes",
  "apiVersion": "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": {
      "{customized property}": "string"
    },
    "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": {
      "{customized property}": "string"
    },
    "vmExtensions": [
      {
        "name": "string",
        "properties": {
          "autoUpgradeMinorVersion": "bool",
          "forceUpdateTag": "string",
          "protectedSettings": {},
          "provisionAfterExtensions": [ "string" ],
          "publisher": "string",
          "settings": {},
          "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"
  }
}

プロパティ値

managedClusters/nodeTypes

名前 説明
type リソースの種類 'Microsoft.ServiceFabric/managedClusters/nodeTypes'
apiVersion リソース API のバージョン '2021-07-01-preview'
name リソース名

JSON ARM テンプレートで子リソースの名前と型を設定する方法を参照してください。
string (必須)
tags Azure リソース タグ。 タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
sku ノードの種類 sku。 NodeTypeSku
properties ノードの種類のプロパティ NodeTypeProperties

NodeTypeProperties

名前 説明
applicationPorts クラスターが Service Fabric アプリケーションにポートを割り当てたポートの範囲。 EndpointRangeDescription
capacities ノードの種類のノードに適用される容量タグでは、クラスター リソース マネージャーはこれらのタグを使用して、ノードのリソースの量を把握します。 NodeTypePropertiesCapacities
dataDiskSizeGB GB のノード タイプ内の各 VM のディスク サイズ。 int (必須)
dataDiskType マネージド データ ディスクの種類。 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
ephemeralPorts このノード タイプのノードを構成する必要があるエフェメラル ポートの範囲。 EndpointRangeDescription
frontendConfigurations ノード の種類が、クラスターの既定の構成ではなく、独自のフロントエンド構成を使用することを示します。 この設定は、非プライマリ ノード タイプに対してのみ指定でき、ノード タイプの作成後に追加または削除することはできません。 FrontendConfiguration[]
isPrimary クラスターの Service Fabric システム サービスがこのノード タイプで実行されることを示します。 この設定は、ノード タイプを作成した後は変更できません。 bool (必須)
isStateless ノードの種類がステートレス ワークロードのみをホストできるかどうかを示します。 [bool]
multiplePlacementGroups ノード タイプに関連付けられているスケール セットを複数の配置グループで構成できるかどうかを示します。 [bool]
networkSecurityRules このノード タイプのネットワーク セキュリティ規則。 この設定は、フロントエンド構成で構成されているノードの種類に対してのみ指定できます。 NetworkSecurityRule[]
placementProperties ノード の種類のノードに適用される配置タグ。これは、特定のサービス (ワークロード) を実行する場所を示すために使用できます。 NodeTypePropertiesPlacementProperties
vmExtensions 仮想マシンにインストールする必要がある拡張機能のセット。 VmssExtension[]
vmImageOffer Azure Virtual Machines Marketplace イメージのオファーの種類。 たとえば、UbuntuServer や WindowsServer などです。 string
vmImagePublisher Azure Virtual Machines Marketplace イメージの発行元。 たとえば、Canonical や MicrosoftWindowsServer などです。 string
vmImageSku Azure Virtual Machines Marketplace イメージの SKU。 たとえば、14.04.0-LTS や 2012-R2-Datacenter などです。 string
vmImageVersion Azure Virtual Machines Marketplace イメージのバージョン。 'latest' の値を指定して、イメージの最新バージョンを選択できます。 省略した場合、既定値は 'latest' です。 string
vmInstanceCount ノード タイプ内のノードの数。

値:
-1 - 自動スケール ルールが構成されている場合、または sku.capacity が定義されている場合に使用する
0 - サポートされていません
}0 - 手動スケールに使用します。
int (必須)

制約:
最大値 = 2147483647
vmManagedIdentity ノードの種類で仮想マシン スケール セットに割り当てる ID。 VmManagedIdentity
vmSecrets 仮想マシンにインストールするシークレット。 VaultSecretGroup[]
vmSize プール内の仮想マシンのサイズ。 プール内の仮想マシンのサイズはすべて同じです。 たとえば、Standard_D3。 string

EndpointRangeDescription

名前 説明
endPort ポートの範囲の終了ポート int (必須)
startPort ポート範囲の開始ポート int (必須)

NodeTypePropertiesCapacities

名前 説明
{カスタマイズされたプロパティ} string

FrontendConfiguration

名前 説明
ipAddressType このフロントエンド構成の IP アドレスの種類。 省略すると、既定値は IPv4 になります。 'IPv4'
'IPv6'
loadBalancerBackendAddressPoolId ノードタイプの VM インスタンスが関連付けられているLoad Balancerバックエンド アドレス プールのリソース ID。 リソース ID の形式は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/backendAddressPools/{backendAddressPoolName}' です。 string
loadBalancerInboundNatPoolId ノード タイプの VM インスタンスが関連付けられているLoad Balancer受信 NAT プールのリソース ID。 リソース ID の形式は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/inboundNatPools/{inboundNatPoolName}' です。 string

NetworkSecurityRule

名前 説明
access ネットワーク トラフィックは許可または拒否されます。 'allow'
'deny' (必須)
description ネットワーク セキュリティ規則の説明。 string
destinationAddressPrefixes 宛先アドレス プレフィックス。 CIDR または宛先 IP 範囲。 string[]
destinationPortRanges 宛先ポート範囲。 string[]
方向 ネットワーク セキュリティ規則の方向。 'inbound'
'outbound' (必須)
name ネットワーク セキュリティ規則の名前。 string (必須)
priority ルールの優先度。 値は、1000 ~ 3000 の範囲にすることができます。 この範囲外の値は、Service Fabric ManagerCluster リソース プロバイダー用に予約されています。 優先度番号は、コレクション内のルールごとに一意である必要があります。 優先度番号が低いほど、規則の優先度が高くなります。 int (必須)

制約:
最小値 = 1000
最大値 = 3000
protocol この規則が適用されるネットワーク プロトコル。 'ah'
'esp'
'http'
'https'
'icmp'
'tcp'
'udp' (必須)
sourceAddressPrefixes CIDR またはソース IP 範囲。 string[]
sourcePortRanges ソース ポートの範囲。 string[]

NodeTypePropertiesPlacementProperties

名前 説明
{カスタマイズされたプロパティ} string

VmssExtension

名前 説明
name 拡張機能の名前です。 string (必須)
properties 仮想マシン スケール セット拡張機能のプロパティについて説明します。 VmssExtensionProperties (必須)

VmssExtensionProperties

名前 説明
autoUpgradeMinorVersion 展開時に使用可能な場合に、拡張機能で新しいマイナー バージョンを使用するかどうかを示します。 ただし、デプロイされると、このプロパティが true に設定されていても、再デプロイされない限り、拡張機能でマイナー バージョンのアップグレードは行われません。 [bool]
forceUpdateTag 値が指定され、前の値と異なる場合、拡張機能の構成が変更されていない場合でも、拡張機能ハンドラーは強制的に更新されます。 string
protectedSettings 拡張機能には、protectedSettings または protectedSettingsFromKeyVault を含めることも、保護された設定をまったく含めることもできます。
provisionAfterExtensions この拡張機能をプロビジョニングする必要がある拡張機能名のコレクション。 string[]
publisher 拡張ハンドラーパブリッシャーの名前。 string (必須)
settings 拡張機能の Json 形式のパブリック設定。
拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。 string (必須)
typeHandlerVersion スクリプト ハンドラーのバージョンを指定します。 string (必須)

VmManagedIdentity

名前 説明
userAssignedIdentities ノードの種類の下にある仮想マシン スケール セットに関連付けられているユーザー ID の一覧。 各エントリは、"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}" という形式の ARM リソース ID になります。 string[]

VaultSecretGroup

名前 説明
sourceVault VaultCertificates のすべての証明書を含むKey Vaultの相対 URL。 SubResource (必須)
vaultCertificates 証明書を含む SourceVault 内のキー コンテナー参照の一覧。 VaultCertificate[] (必須)

サブリソース

名前 説明
id Azure リソース識別子。 string

VaultCertificate

名前 説明
certificateStore Windows VM の場合は、証明書を追加する仮想マシン上の証明書ストアを指定します。 指定された証明書ストアは、LocalMachine アカウントに暗黙的に含まれます。

Linux VM の場合、証明書ファイルは /var/lib/waagent ディレクトリの下に配置され、X509 証明書ファイルにはファイル名 {UppercaseThumbprint}.crt、秘密キーには {UppercaseThumbprint}.prv が付けられます。 これらのファイルはどちらも .pem 形式です。
string (必須)
certificateUrl これは、シークレットとしてKey Vaultにアップロードされた証明書の URL です。 Key Vaultにシークレットを追加する方法については、「キー コンテナーにキーまたはシークレットを追加する」を参照してください。 この場合、証明書は UTF-8 でエンコードされた次の JSON オブジェクトの Base64 エンコードである必要があります。

{
"data":"{Base64-encoded-certificate}",
"dataType":"pfx",
"password":"{pfx-file-password}"
}
string (必須)

NodeTypeSku

名前 説明
capacity ノード タイプ内のノードの数。

要求に存在する場合は、properties.vmInstanceCount をオーバーライドします。
int (必須)

制約:
最小値 = 1
最大値 = 2147483647
name SKU 名。

名前は内部的に生成され、自動スケール シナリオで使用されます。
プロパティでは、生成された以外の値に変更することはできません。
展開エラーを回避するには、 プロパティを省略してください。
string
レベル ノード の種類の層を指定します。

有効値は次のとおりです。
Standard
string

Terraform (AzAPI プロバイダー) リソース定義

managedClusters/nodeTypes リソースの種類は、次をターゲットとする操作でデプロイできます。

  • リソース グループ

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.ServiceFabric/managedClusters/nodeTypes リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedClusters/nodeTypes@2021-07-01-preview"
  name = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      applicationPorts = {
        endPort = int
        startPort = int
      }
      capacities = {
        {customized property} = "string"
      }
      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 = {
        {customized property} = "string"
      }
      vmExtensions = [
        {
          name = "string"
          properties = {
            autoUpgradeMinorVersion = bool
            forceUpdateTag = "string"
            provisionAfterExtensions = [
              "string"
            ]
            publisher = "string"
            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"
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  })
}

プロパティ値

managedClusters/nodeTypes

名前 説明
type リソースの種類 "Microsoft.ServiceFabric/managedClusters/nodeTypes@2021-07-01-preview"
name リソース名 string (必須)
parent_id このリソースの親であるリソースの ID。 種類のリソースの ID: managedClusters
tags Azure リソース タグ。 タグの名前と値のディクショナリ。
sku ノードの種類 sku。 NodeTypeSku
properties ノードの種類のプロパティ NodeTypeProperties

NodeTypeProperties

名前 説明
applicationPorts クラスターが Service Fabric アプリケーションにポートを割り当てたポートの範囲。 EndpointRangeDescription
capacities ノードの種類のノードに適用される容量タグでは、クラスター リソース マネージャーはこれらのタグを使用して、ノードのリソースの量を把握します。 NodeTypePropertiesCapacities
dataDiskSizeGB GB のノード タイプ内の各 VM のディスク サイズ。 int (必須)
dataDiskType マネージド データ ディスクの種類。 "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
ephemeralPorts このノード タイプのノードを構成する必要があるエフェメラル ポートの範囲。 EndpointRangeDescription
frontendConfigurations ノード の種類が、クラスターの既定の構成ではなく、独自のフロントエンド構成を使用することを示します。 この設定は、非プライマリ ノード タイプに対してのみ指定でき、ノード タイプの作成後に追加または削除することはできません。 FrontendConfiguration[]
isPrimary クラスターの Service Fabric システム サービスがこのノード タイプで実行されることを示します。 この設定は、ノード タイプを作成した後は変更できません。 bool (必須)
isStateless ノードの種類がステートレス ワークロードのみをホストできるかどうかを示します。 [bool]
multiplePlacementGroups ノード タイプに関連付けられているスケール セットを複数の配置グループで構成できるかどうかを示します。 [bool]
networkSecurityRules このノード タイプのネットワーク セキュリティ規則。 この設定は、フロントエンド構成で構成されているノードの種類に対してのみ指定できます。 NetworkSecurityRule[]
placementProperties ノード の種類のノードに適用される配置タグ。これは、特定のサービス (ワークロード) を実行する場所を示すために使用できます。 NodeTypePropertiesPlacementProperties
vmExtensions 仮想マシンにインストールする必要がある拡張機能のセット。 VmssExtension[]
vmImageOffer Azure Virtual Machines Marketplace イメージのオファーの種類。 たとえば、UbuntuServer や WindowsServer などです。 string
vmImagePublisher Azure Virtual Machines Marketplace イメージの発行元。 たとえば、Canonical や MicrosoftWindowsServer などです。 string
vmImageSku Azure Virtual Machines Marketplace イメージの SKU。 たとえば、14.04.0-LTS や 2012-R2-Datacenter などです。 string
vmImageVersion Azure Virtual Machines Marketplace イメージのバージョン。 'latest' の値を指定して、イメージの最新バージョンを選択できます。 省略した場合、既定値は 'latest' です。 string
vmInstanceCount ノード タイプ内のノードの数。

値:
-1 - 自動スケール ルールが構成されている場合、または sku.capacity が定義されている場合に使用する
0 - サポートされていません
}0 - 手動スケールに使用します。
int (必須)

制約:
最大値 = 2147483647
vmManagedIdentity ノードの種類で仮想マシン スケール セットに割り当てる ID。 VmManagedIdentity
vmSecrets 仮想マシンにインストールするシークレット。 VaultSecretGroup[]
vmSize プール内の仮想マシンのサイズ。 プール内の仮想マシンのサイズはすべて同じです。 たとえば、Standard_D3。 string

EndpointRangeDescription

名前 説明
endPort ポートの範囲の終了ポート int (必須)
startPort ポート範囲の開始ポート int (必須)

NodeTypePropertiesCapacities

名前 説明
{カスタマイズされたプロパティ} string

FrontendConfiguration

名前 説明
ipAddressType このフロントエンド構成の IP アドレスの種類。 省略すると、既定値は IPv4 になります。 "IPv4"
"IPv6"
loadBalancerBackendAddressPoolId ノードタイプの VM インスタンスが関連付けられているLoad Balancerバックエンド アドレス プールのリソース ID。 リソース ID の形式は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/backendAddressPools/{backendAddressPoolName}' です。 string
loadBalancerInboundNatPoolId ノード タイプの VM インスタンスが関連付けられているLoad Balancer受信 NAT プールのリソース ID。 リソース ID の形式は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/inboundNatPools/{inboundNatPoolName}' です。 string

NetworkSecurityRule

名前 説明
access ネットワーク トラフィックは許可または拒否されます。 "許可"
"deny" (必須)
description ネットワーク セキュリティ規則の説明。 string
destinationAddressPrefixes 宛先アドレス プレフィックス。 CIDR または宛先 IP 範囲。 string[]
destinationPortRanges 宛先ポート範囲。 string[]
方向 ネットワーク セキュリティ規則の方向。 "inbound"
"アウトバウンド" (必須)
name ネットワーク セキュリティ規則の名前。 string (必須)
priority ルールの優先度。 値は、1000 ~ 3000 の範囲にすることができます。 この範囲外の値は、Service Fabric ManagerCluster リソース プロバイダー用に予約されています。 優先度番号は、コレクション内のルールごとに一意である必要があります。 優先度番号が低いほど、規則の優先度が高くなります。 int (必須)

制約:
最小値 = 1000
最大値 = 3000
protocol この規則が適用されるネットワーク プロトコル。 "ah"
"esp"
"http"
"https"
"icmp"
"tcp"
"udp" (必須)
sourceAddressPrefixes CIDR またはソース IP 範囲。 string[]
sourcePortRanges ソース ポートの範囲。 string[]

NodeTypePropertiesPlacementProperties

名前 説明
{カスタマイズされたプロパティ} string

VmssExtension

名前 説明
name 拡張機能の名前です。 string (必須)
properties 仮想マシン スケール セット拡張機能のプロパティについて説明します。 VmssExtensionProperties (必須)

VmssExtensionProperties

名前 説明
autoUpgradeMinorVersion 展開時に使用可能な場合に、拡張機能で新しいマイナー バージョンを使用するかどうかを示します。 ただし、デプロイされると、このプロパティが true に設定されていても、再デプロイされない限り、拡張機能でマイナー バージョンのアップグレードは行われません。 [bool]
forceUpdateTag 値が指定され、前の値と異なる場合、拡張機能の構成が変更されていない場合でも、拡張機能ハンドラーは強制的に更新されます。 string
protectedSettings 拡張機能には、protectedSettings または protectedSettingsFromKeyVault を含めることも、保護された設定をまったく含めることもできます。
provisionAfterExtensions この拡張機能をプロビジョニングする必要がある拡張機能名のコレクション。 string[]
publisher 拡張ハンドラーパブリッシャーの名前。 string (必須)
settings 拡張機能の Json 形式のパブリック設定。
拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。 string (必須)
typeHandlerVersion スクリプト ハンドラーのバージョンを指定します。 string (必須)

VmManagedIdentity

名前 説明
userAssignedIdentities ノードの種類の下にある仮想マシン スケール セットに関連付けられているユーザー ID の一覧。 各エントリは、"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}" という形式の ARM リソース ID になります。 string[]

VaultSecretGroup

名前 説明
sourceVault VaultCertificates のすべての証明書を含むKey Vaultの相対 URL。 SubResource (必須)
vaultCertificates 証明書を含む SourceVault 内のキー コンテナー参照の一覧。 VaultCertificate[] (必須)

サブリソース

名前 説明
id Azure リソース識別子。 string

VaultCertificate

名前 説明
certificateStore Windows VM の場合は、証明書を追加する仮想マシン上の証明書ストアを指定します。 指定された証明書ストアは、LocalMachine アカウントに暗黙的に含まれます。

Linux VM の場合、証明書ファイルは /var/lib/waagent ディレクトリの下に配置され、X509 証明書ファイルにはファイル名 {UppercaseThumbprint}.crt、秘密キーには {UppercaseThumbprint}.prv が付けられます。 これらのファイルはどちらも .pem 形式です。
string (必須)
certificateUrl これは、シークレットとしてKey Vaultにアップロードされた証明書の URL です。 Key Vaultにシークレットを追加する方法については、「キー コンテナーにキーまたはシークレットを追加する」を参照してください。 この場合、証明書は UTF-8 でエンコードされた次の JSON オブジェクトの Base64 エンコードである必要があります。

{
"data":"{Base64-encoded-certificate}",
"dataType":"pfx",
"password":"{pfx-file-password}"
}
string (必須)

NodeTypeSku

名前 説明
capacity ノード タイプ内のノードの数。

要求に存在する場合は、properties.vmInstanceCount をオーバーライドします。
int (必須)

制約:
最小値 = 1
最大値 = 2147483647
name SKU 名。

名前は内部的に生成され、自動スケール シナリオで使用されます。
プロパティでは、生成された以外の値に変更することはできません。
展開エラーを回避するには、 プロパティを省略してください。
string
レベル ノード の種類の層を指定します。

有効値は次のとおりです。
Standard
string