Microsoft.ServiceFabric マネージドクラスター 2023-03-01-preview

• 最新
• 2025-06-01-preview
• 2025-03-01-プレビュー
• 2024-11-01-プレビュー
• 2024-09-01-プレビュー
• 2024-06-01-プレビュー
• 2024-04-01
• 2024-02-01-プレビュー
• 2023-12-01-プレビュー
• 2023-11-01-プレビュー
• 2023-09-01-プレビュー
• 2023-07-01-プレビュー
• 2023-03-01-プレビュー
• 2023-02-01-プレビュー
• 2022-10-01-プレビュー
• 2022-08-01-プレビュー
• 2022-06-01-プレビュー
• 2022-02-01-プレビュー
• 2022-01-01
• 2021-11-01-プレビュー
• 2021-07-01-プレビュー
• 2021-05-01
• 2021-01-01-プレビュー
• 2020-01-01-プレビュー

Bicep リソース定義

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

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

リソースの形式

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

resource symbolicname 'Microsoft.ServiceFabric/managedClusters@2023-03-01-preview' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    addonFeatures: [
      'string'
    ]
    adminPassword: 'string'
    adminUserName: 'string'
    allowRdpAccess: bool
    applicationTypeVersionsCleanupPolicy: {
      maxUnusedVersionsToKeep: int
    }
    auxiliarySubnets: [
      {
        enableIpv6: bool
        name: 'string'
        networkSecurityGroupId: 'string'
        privateEndpointNetworkPolicies: 'string'
        privateLinkServiceNetworkPolicies: 'string'
      }
    ]
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
    }
    clientConnectionPort: int
    clients: [
      {
        commonName: 'string'
        isAdmin: bool
        issuerThumbprint: 'string'
        thumbprint: 'string'
      }
    ]
    clusterCodeVersion: 'string'
    clusterUpgradeCadence: 'string'
    clusterUpgradeMode: 'string'
    dnsName: 'string'
    enableAutoOSUpgrade: bool
    enableIpv6: bool
    enableServicePublicIP: bool
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    httpGatewayConnectionPort: int
    ipTags: [
      {
        ipTagType: 'string'
        tag: 'string'
      }
    ]
    loadBalancingRules: [
      {
        backendPort: int
        frontendPort: int
        loadDistribution: 'string'
        probePort: int
        probeProtocol: 'string'
        probeRequestPath: 'string'
        protocol: 'string'
      }
    ]
    networkSecurityRules: [
      {
        access: 'string'
        description: 'string'
        destinationAddressPrefix: 'string'
        destinationAddressPrefixes: [
          'string'
        ]
        destinationPortRange: 'string'
        destinationPortRanges: [
          'string'
        ]
        direction: 'string'
        name: 'string'
        priority: int
        protocol: 'string'
        sourceAddressPrefix: 'string'
        sourceAddressPrefixes: [
          'string'
        ]
        sourcePortRange: 'string'
        sourcePortRanges: [
          'string'
        ]
      }
    ]
    publicIPPrefixId: 'string'
    serviceEndpoints: [
      {
        locations: [
          'string'
        ]
        service: 'string'
      }
    ]
    subnetId: 'string'
    useCustomVnet: bool
    zonalResiliency: bool
    zonalUpdateMode: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.ServiceFabric/managedClusters

名前	説明	価値
位置	Azure リソースの場所。	string (必須)
名前	リソース名	string (必須)
プロパティ	マネージド クラスター リソースのプロパティ	ManagedClusterProperties の
スコープ	デプロイ スコープとは異なるスコープでリソースを作成するときに使用します。	このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。
エスケーユー	マネージド クラスターの SKU	SKU (必須)
タグ	リソース タグ	タグ名と値のディクショナリ。 テンプレート の タグを参照してください

ApplicationTypeVersionsCleanupPolicy (英語)

名前	説明	価値
maxUnusedVersionsToKeep (マックス未使用バージョン保持)	保持するアプリケーションの種類ごとの未使用バージョンの数。	int 制約： 最小値 = 0 (必須)

AzureのActiveDirectory

名前	説明	価値
クライアントアプリケーション	Azure Active Directory クライアント アプリケーション ID。	文字列
クラスタアプリケーション	Azure Active Directory クラスター アプリケーション ID。	文字列
テナントID	Azure Active Directory テナント ID。	文字列

クライアント証明書

名前	説明	価値
コモンネーム	証明書の共通名。	文字列
isAdminの	クライアント証明書にクラスターへの管理者アクセス権があるかどうかを示します。 管理者以外のクライアントは、クラスターに対して読み取り専用操作のみを実行できます。	bool (必須)
発行者拇印	証明書の発行者の拇印。 CommonName と共にのみ使用されます。	文字列
サムプリント	証明書の拇印。	文字列

IPTagの

名前	説明	価値
ipTagType (英語)	IP タグの種類。	string (必須)
タグ	IP タグの値。	string (必須)

ロードバランスルール

名前	説明	価値
バックエンドポート	エンドポイントの内部接続に使用されるポート。 使用できる値は 1 ~ 65535 です。	int 制約： 最小値 = 1 最大値 = 65534 (必須)
フロントエンドポート	外部エンドポイントのポートです。 各規則のポート番号は、ロード バランサー内で一意である必要があります。 使用できる値は 1 ~ 65534 です。	int 制約： 最小値 = 1 最大値 = 65534 (必須)
負荷分布	この規則の負荷分散ポリシー。	文字列
プローブポート	負荷分散規則で使用されるプローブ ポート。 使用できる値は 1 ~ 65535 です。	int 制約： 最小値 = 1 最大値 = 65534
プローブプロトコル	負荷分散規則で使用されるロード バランサー プローブへの参照。	「http」 「https」 'tcp' (必須)
プローブリクエストパス	プローブ要求パス。 HTTP/HTTPS プローブでのみサポートされます。	文字列
プロトコル	負荷分散規則で使用されるトランスポート プロトコルへの参照。	'tcp' 'udp' (必須)

ManagedClusterProperties (管理クラスタプロパティ)

名前	説明	価値
addon機能	クラスターで有効にするアドオン機能の一覧。	次のいずれかを含む文字列配列: 'BackupRestoreService' 「Dnsサービス」 'リソースモニターサービス'
管理者パスワード	VM 管理者のユーザー パスワード。	糸 制約： 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
adminUserName(管理者ユーザー名)	VM 管理者ユーザー名。	string (必須)
allowRdpAccess (許可Rdpアクセス)	これを true に設定すると、VM への RDP アクセスが有効になります。 既定の NSG 規則は、インターネットへの RDP ポートを開きます。このポートは、カスタム ネットワーク セキュリティ規則でオーバーライドできます。 この設定の既定値は false です。	ブール (bool)
applicationTypeVersionsCleanupPolicy	未使用のバージョンをクリーンアップするために使用されるポリシー。	ApplicationTypeVersionsCleanupPolicy の
補助サブネット	クラスターの補助サブネット。	サブネット[]
azureActiveDirectory の	クラスターの AAD 認証設定。	AzureのActiveDirectory
クライアント接続ポート	クラスターへのクライアント接続に使用されるポート。	整数 (int)
クライアント	クラスターの管理が許可されているクライアント証明書。	クライアント証明書[]
clusterCodeVersion (クラスタコードバージョン)	クラスターの Service Fabric ランタイム バージョン。 このプロパティは、clusterUpgradeMode が 'Manual' に設定されている場合に必要です。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、ClusterVersion API使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、availableClusterVersions使用します。	文字列
clusterUpgradeCadence	新しいクラスター ランタイム バージョンのアップグレードがリリース後に適用されるタイミングを示します。 既定では Wave0 です。 clusterUpgradeMode が 'Automatic' に設定されている場合にのみ適用されます。	「ウェーブ0」 「ウェーブ1」 「ウェーブ2」
clusterUpgradeMode	新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。	「自動」 「マニュアル」
dnsName (英語)	クラスターの DNS 名。	string (必須)
enableAutoOSUpgrade	これを true に設定すると、バージョン 'latest' のプラットフォーム OS イメージを使用して作成されたノードの種類に対する OS の自動アップグレードが有効になります。 この設定の既定値は false です。	ブール (bool)
enableipv6	これを true に設定すると、クラスターで使用される既定の VNet の IPv6 アドレス空間が作成されます。 この設定は、クラスターが作成された後は変更できません。 この設定の既定値は false です。	ブール (bool)
enableServicePublicIPの	これを true に設定すると、IPv4 アドレスが IPv6 アドレスの ServicePublicIP としてリンクされます。 これは、クラスターで IPv6 が有効になっている場合にのみ True に設定できます。	ブール (bool)
ファブリック設定	クラスターを構成するためのカスタム ファブリック設定の一覧。	SettingsSectionDescription[]
httpGatewayConnectionPort (英語)	クラスターへの HTTP 接続に使用されるポート。	整数 (int)
ipタグ	クラスターの既定のパブリック IP アドレスに関連付けられている IP タグの一覧。	IPタグ[]
loadBalancingルール	クラスターのパブリック ロード バランサーに適用される負荷分散規則。	ロードバランシングルール[]
ネットワークセキュリティルール	クラスターの仮想ネットワークに適用されるカスタム ネットワーク セキュリティ規則。	ネットワークセキュリティルール[]
publicIPPrefixId(英語)	ロード バランサーがパブリック IP アドレスを割り当てるパブリック IP プレフィックスのリソース ID を指定します。 IPv4 のみがサポートされます。	文字列
サービスエンドポイント	クラスター内のサブネットのサービス エンドポイント。	サービスエンドポイント[]
サブネットID	指定した場合、クラスターのノードの種類は、既定の VNet ではなく、このサブネットに作成されます。 クラスターに指定された networkSecurityRules も、このサブネットに適用されます。 この設定は、クラスターが作成された後は変更できません。	文字列
useCustomVnetの	新しいクラスターの場合、このパラメーターは Bring Your Own VNet を使用することを示しますが、サブネットはノード タイプ レベルで指定されます。このようなクラスターでは、ノードの種類に subnetId プロパティが必要です。	ブール (bool)
zonalResiliency (ゾナルレジリエンシー)	クラスターにゾーンの回復性があるかどうかを示します。	ブール (bool)
zonalUpdateMode	クロス Az クラスターの更新モードを示します。	「速い」 「スタンダード」

ネットワークセキュリティルール

名前	説明	価値
アクセス	ネットワーク トラフィックは許可または拒否されます。	「許可」 'deny' (必須)
説明	ネットワーク セキュリティ規則の説明。	文字列
destinationAddressプレフィックス	宛先アドレス プレフィックス。 CIDR または宛先 IP 範囲。 アスタリスク '*' を使用して、すべてのソース IP を照合することもできます。 "VirtualNetwork"、"AzureLoadBalancer"、"Internet" などの既定のタグも使用できます。	文字列
destinationAddressプレフィックス	宛先アドレス プレフィックス。 CIDR または宛先 IP 範囲。	文字列[]
destinationPortRange (宛先ポートレンジ)	宛先ポートまたは範囲。 整数または 0 ~ 65535 の範囲。 アスタリスク '*' は、すべてのポートとの照合にも使用できます。	文字列
destinationPortRanges(宛先ポート範囲)	宛先ポートの範囲。	文字列[]
方向	ネットワーク セキュリティ規則の方向。	「インバウンド」 'outbound' (必須)
名前	ネットワーク セキュリティ規則の名前。	string (必須)
優先権	ルールの優先順位。 値の範囲は 1000 ~ 3000 です。 この範囲外の値は、Service Fabric ManagerCluster リソース プロバイダー用に予約されています。 優先順位番号は、コレクション内の各ルールで一意である必要があります。 優先度の数値が小さいと、ルールの優先度が高くなります。	int 制約： 最小値 = 1000 最大値 = 3000 (必須)
プロトコル	この規則が適用されるネットワーク プロトコル。	「あぁ」 「ESP」 「http」 「https」 「icmp」 'tcp' 'udp' (必須)
sourceAddressプレフィックス	CIDR またはソース IP 範囲。 アスタリスク '*' を使用して、すべてのソース IP を照合することもできます。 "VirtualNetwork"、"AzureLoadBalancer"、"Internet" などの既定のタグも使用できます。 これがイングレス ルールの場合は、ネットワーク トラフィックの発信元を指定します。	文字列
sourceAddressプレフィックス	CIDR またはソース IP 範囲。	文字列[]
ソースポートレンジ	ソース ポートまたは範囲。 整数または 0 ~ 65535 の範囲。 アスタリスク '*' は、すべてのポートとの照合にも使用できます。	文字列
ソースポート範囲	ソース ポートの範囲。	文字列[]

リソースタグ

名前	説明	価値

サービスエンドポイント

名前	説明	価値
ロケーション	場所の一覧。	文字列[]
サービス	エンドポイント サービスの種類。	string (必須)

SettingsParameterDescription

名前	説明	価値
名前	ファブリック設定のパラメーター名。	string (必須)
価値	ファブリック設定のパラメーター値。	string (必須)

SettingsSectionDescription (設定セクションの説明)

名前	説明	価値
名前	ファブリック設定のセクション名。	string (必須)
パラメーター	セクション内のパラメーターのコレクション。	SettingsParameterDescription[] (必須)

SKUの

名前	説明	価値
名前	SKU 名。	「ベーシック」 'Standard' (必須)

サブネット

名前	説明	価値
enableipv6	Ipv6 を有効にしないかどうかを示します。 指定しない場合は、クラスターと同じ構成になります。	ブール (bool)
名前	サブネット名。	string (必須)
ネットワークセキュリティグループID	ネットワーク セキュリティ グループの完全なリソース ID。	文字列
privateEndpointNetworkPolicies (プライベートエンドポイントネットワークポリシー)	サブネット内のプライベート エンドポイントでネットワーク ポリシーの適用を有効または無効にします。	'無効' '有効'
privateLinkServiceNetworkPolicies (プライベートリンクサービスネットワークポリシー)	サブネット内のプライベート リンク サービスに対するネットワーク ポリシーの適用を有効または無効にします。	'無効' '有効'

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

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

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

リソースの形式

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

{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "apiVersion": "2023-03-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "addonFeatures": [ "string" ],
    "adminPassword": "string",
    "adminUserName": "string",
    "allowRdpAccess": "bool",
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": "int"
    },
    "auxiliarySubnets": [
      {
        "enableIpv6": "bool",
        "name": "string",
        "networkSecurityGroupId": "string",
        "privateEndpointNetworkPolicies": "string",
        "privateLinkServiceNetworkPolicies": "string"
      }
    ],
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string"
    },
    "clientConnectionPort": "int",
    "clients": [
      {
        "commonName": "string",
        "isAdmin": "bool",
        "issuerThumbprint": "string",
        "thumbprint": "string"
      }
    ],
    "clusterCodeVersion": "string",
    "clusterUpgradeCadence": "string",
    "clusterUpgradeMode": "string",
    "dnsName": "string",
    "enableAutoOSUpgrade": "bool",
    "enableIpv6": "bool",
    "enableServicePublicIP": "bool",
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "httpGatewayConnectionPort": "int",
    "ipTags": [
      {
        "ipTagType": "string",
        "tag": "string"
      }
    ],
    "loadBalancingRules": [
      {
        "backendPort": "int",
        "frontendPort": "int",
        "loadDistribution": "string",
        "probePort": "int",
        "probeProtocol": "string",
        "probeRequestPath": "string",
        "protocol": "string"
      }
    ],
    "networkSecurityRules": [
      {
        "access": "string",
        "description": "string",
        "destinationAddressPrefix": "string",
        "destinationAddressPrefixes": [ "string" ],
        "destinationPortRange": "string",
        "destinationPortRanges": [ "string" ],
        "direction": "string",
        "name": "string",
        "priority": "int",
        "protocol": "string",
        "sourceAddressPrefix": "string",
        "sourceAddressPrefixes": [ "string" ],
        "sourcePortRange": "string",
        "sourcePortRanges": [ "string" ]
      }
    ],
    "publicIPPrefixId": "string",
    "serviceEndpoints": [
      {
        "locations": [ "string" ],
        "service": "string"
      }
    ],
    "subnetId": "string",
    "useCustomVnet": "bool",
    "zonalResiliency": "bool",
    "zonalUpdateMode": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.ServiceFabric/managedClusters

名前	説明	価値
apiVersion (英語)	API のバージョン	「2023-03-01-プレビュー」
位置	Azure リソースの場所。	string (必須)
名前	リソース名	string (必須)
プロパティ	マネージド クラスター リソースのプロパティ	ManagedClusterProperties の
エスケーユー	マネージド クラスターの SKU	SKU (必須)
タグ	リソース タグ	タグ名と値のディクショナリ。 テンプレート の タグを参照してください
型	リソースの種類	'Microsoft.ServiceFabric/managedClusters'

ApplicationTypeVersionsCleanupPolicy (英語)

名前	説明	価値
maxUnusedVersionsToKeep (マックス未使用バージョン保持)	保持するアプリケーションの種類ごとの未使用バージョンの数。	int 制約： 最小値 = 0 (必須)

AzureのActiveDirectory

名前	説明	価値
クライアントアプリケーション	Azure Active Directory クライアント アプリケーション ID。	文字列
クラスタアプリケーション	Azure Active Directory クラスター アプリケーション ID。	文字列
テナントID	Azure Active Directory テナント ID。	文字列

クライアント証明書

名前	説明	価値
コモンネーム	証明書の共通名。	文字列
isAdminの	クライアント証明書にクラスターへの管理者アクセス権があるかどうかを示します。 管理者以外のクライアントは、クラスターに対して読み取り専用操作のみを実行できます。	bool (必須)
発行者拇印	証明書の発行者の拇印。 CommonName と共にのみ使用されます。	文字列
サムプリント	証明書の拇印。	文字列

IPTagの

名前	説明	価値
ipTagType (英語)	IP タグの種類。	string (必須)
タグ	IP タグの値。	string (必須)

ロードバランスルール

名前	説明	価値
バックエンドポート	エンドポイントの内部接続に使用されるポート。 使用できる値は 1 ~ 65535 です。	int 制約： 最小値 = 1 最大値 = 65534 (必須)
フロントエンドポート	外部エンドポイントのポートです。 各規則のポート番号は、ロード バランサー内で一意である必要があります。 使用できる値は 1 ~ 65534 です。	int 制約： 最小値 = 1 最大値 = 65534 (必須)
負荷分布	この規則の負荷分散ポリシー。	文字列
プローブポート	負荷分散規則で使用されるプローブ ポート。 使用できる値は 1 ~ 65535 です。	int 制約： 最小値 = 1 最大値 = 65534
プローブプロトコル	負荷分散規則で使用されるロード バランサー プローブへの参照。	「http」 「https」 'tcp' (必須)
プローブリクエストパス	プローブ要求パス。 HTTP/HTTPS プローブでのみサポートされます。	文字列
プロトコル	負荷分散規則で使用されるトランスポート プロトコルへの参照。	'tcp' 'udp' (必須)

ManagedClusterProperties (管理クラスタプロパティ)

名前	説明	価値
addon機能	クラスターで有効にするアドオン機能の一覧。	次のいずれかを含む文字列配列: 'BackupRestoreService' 「Dnsサービス」 'リソースモニターサービス'
管理者パスワード	VM 管理者のユーザー パスワード。	糸 制約： 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
adminUserName(管理者ユーザー名)	VM 管理者ユーザー名。	string (必須)
allowRdpAccess (許可Rdpアクセス)	これを true に設定すると、VM への RDP アクセスが有効になります。 既定の NSG 規則は、インターネットへの RDP ポートを開きます。このポートは、カスタム ネットワーク セキュリティ規則でオーバーライドできます。 この設定の既定値は false です。	ブール (bool)
applicationTypeVersionsCleanupPolicy	未使用のバージョンをクリーンアップするために使用されるポリシー。	ApplicationTypeVersionsCleanupPolicy の
補助サブネット	クラスターの補助サブネット。	サブネット[]
azureActiveDirectory の	クラスターの AAD 認証設定。	AzureのActiveDirectory
クライアント接続ポート	クラスターへのクライアント接続に使用されるポート。	整数 (int)
クライアント	クラスターの管理が許可されているクライアント証明書。	クライアント証明書[]
clusterCodeVersion (クラスタコードバージョン)	クラスターの Service Fabric ランタイム バージョン。 このプロパティは、clusterUpgradeMode が 'Manual' に設定されている場合に必要です。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、ClusterVersion API使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、availableClusterVersions使用します。	文字列
clusterUpgradeCadence	新しいクラスター ランタイム バージョンのアップグレードがリリース後に適用されるタイミングを示します。 既定では Wave0 です。 clusterUpgradeMode が 'Automatic' に設定されている場合にのみ適用されます。	「ウェーブ0」 「ウェーブ1」 「ウェーブ2」
clusterUpgradeMode	新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。	「自動」 「マニュアル」
dnsName (英語)	クラスターの DNS 名。	string (必須)
enableAutoOSUpgrade	これを true に設定すると、バージョン 'latest' のプラットフォーム OS イメージを使用して作成されたノードの種類に対する OS の自動アップグレードが有効になります。 この設定の既定値は false です。	ブール (bool)
enableipv6	これを true に設定すると、クラスターで使用される既定の VNet の IPv6 アドレス空間が作成されます。 この設定は、クラスターが作成された後は変更できません。 この設定の既定値は false です。	ブール (bool)
enableServicePublicIPの	これを true に設定すると、IPv4 アドレスが IPv6 アドレスの ServicePublicIP としてリンクされます。 これは、クラスターで IPv6 が有効になっている場合にのみ True に設定できます。	ブール (bool)
ファブリック設定	クラスターを構成するためのカスタム ファブリック設定の一覧。	SettingsSectionDescription[]
httpGatewayConnectionPort (英語)	クラスターへの HTTP 接続に使用されるポート。	整数 (int)
ipタグ	クラスターの既定のパブリック IP アドレスに関連付けられている IP タグの一覧。	IPタグ[]
loadBalancingルール	クラスターのパブリック ロード バランサーに適用される負荷分散規則。	ロードバランシングルール[]
ネットワークセキュリティルール	クラスターの仮想ネットワークに適用されるカスタム ネットワーク セキュリティ規則。	ネットワークセキュリティルール[]
publicIPPrefixId(英語)	ロード バランサーがパブリック IP アドレスを割り当てるパブリック IP プレフィックスのリソース ID を指定します。 IPv4 のみがサポートされます。	文字列
サービスエンドポイント	クラスター内のサブネットのサービス エンドポイント。	サービスエンドポイント[]
サブネットID	指定した場合、クラスターのノードの種類は、既定の VNet ではなく、このサブネットに作成されます。 クラスターに指定された networkSecurityRules も、このサブネットに適用されます。 この設定は、クラスターが作成された後は変更できません。	文字列
useCustomVnetの	新しいクラスターの場合、このパラメーターは Bring Your Own VNet を使用することを示しますが、サブネットはノード タイプ レベルで指定されます。このようなクラスターでは、ノードの種類に subnetId プロパティが必要です。	ブール (bool)
zonalResiliency (ゾナルレジリエンシー)	クラスターにゾーンの回復性があるかどうかを示します。	ブール (bool)
zonalUpdateMode	クロス Az クラスターの更新モードを示します。	「速い」 「スタンダード」

ネットワークセキュリティルール

名前	説明	価値
アクセス	ネットワーク トラフィックは許可または拒否されます。	「許可」 'deny' (必須)
説明	ネットワーク セキュリティ規則の説明。	文字列
destinationAddressプレフィックス	宛先アドレス プレフィックス。 CIDR または宛先 IP 範囲。 アスタリスク '*' を使用して、すべてのソース IP を照合することもできます。 "VirtualNetwork"、"AzureLoadBalancer"、"Internet" などの既定のタグも使用できます。	文字列
destinationAddressプレフィックス	宛先アドレス プレフィックス。 CIDR または宛先 IP 範囲。	文字列[]
destinationPortRange (宛先ポートレンジ)	宛先ポートまたは範囲。 整数または 0 ~ 65535 の範囲。 アスタリスク '*' は、すべてのポートとの照合にも使用できます。	文字列
destinationPortRanges(宛先ポート範囲)	宛先ポートの範囲。	文字列[]
方向	ネットワーク セキュリティ規則の方向。	「インバウンド」 'outbound' (必須)
名前	ネットワーク セキュリティ規則の名前。	string (必須)
優先権	ルールの優先順位。 値の範囲は 1000 ~ 3000 です。 この範囲外の値は、Service Fabric ManagerCluster リソース プロバイダー用に予約されています。 優先順位番号は、コレクション内の各ルールで一意である必要があります。 優先度の数値が小さいと、ルールの優先度が高くなります。	int 制約： 最小値 = 1000 最大値 = 3000 (必須)
プロトコル	この規則が適用されるネットワーク プロトコル。	「あぁ」 「ESP」 「http」 「https」 「icmp」 'tcp' 'udp' (必須)
sourceAddressプレフィックス	CIDR またはソース IP 範囲。 アスタリスク '*' を使用して、すべてのソース IP を照合することもできます。 "VirtualNetwork"、"AzureLoadBalancer"、"Internet" などの既定のタグも使用できます。 これがイングレス ルールの場合は、ネットワーク トラフィックの発信元を指定します。	文字列
sourceAddressプレフィックス	CIDR またはソース IP 範囲。	文字列[]
ソースポートレンジ	ソース ポートまたは範囲。 整数または 0 ~ 65535 の範囲。 アスタリスク '*' は、すべてのポートとの照合にも使用できます。	文字列
ソースポート範囲	ソース ポートの範囲。	文字列[]

リソースタグ

名前	説明	価値

サービスエンドポイント

名前	説明	価値
ロケーション	場所の一覧。	文字列[]
サービス	エンドポイント サービスの種類。	string (必須)

SettingsParameterDescription

名前	説明	価値
名前	ファブリック設定のパラメーター名。	string (必須)
価値	ファブリック設定のパラメーター値。	string (必須)

SettingsSectionDescription (設定セクションの説明)

名前	説明	価値
名前	ファブリック設定のセクション名。	string (必須)
パラメーター	セクション内のパラメーターのコレクション。	SettingsParameterDescription[] (必須)

SKUの

名前	説明	価値
名前	SKU 名。	「ベーシック」 'Standard' (必須)

サブネット

名前	説明	価値
enableipv6	Ipv6 を有効にしないかどうかを示します。 指定しない場合は、クラスターと同じ構成になります。	ブール (bool)
名前	サブネット名。	string (必須)
ネットワークセキュリティグループID	ネットワーク セキュリティ グループの完全なリソース ID。	文字列
privateEndpointNetworkPolicies (プライベートエンドポイントネットワークポリシー)	サブネット内のプライベート エンドポイントでネットワーク ポリシーの適用を有効または無効にします。	'無効' '有効'
privateLinkServiceNetworkPolicies (プライベートリンクサービスネットワークポリシー)	サブネット内のプライベート リンク サービスに対するネットワーク ポリシーの適用を有効または無効にします。	'無効' '有効'

使用例

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

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

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

リソースの形式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedClusters@2023-03-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      addonFeatures = [
        "string"
      ]
      adminPassword = "string"
      adminUserName = "string"
      allowRdpAccess = bool
      applicationTypeVersionsCleanupPolicy = {
        maxUnusedVersionsToKeep = int
      }
      auxiliarySubnets = [
        {
          enableIpv6 = bool
          name = "string"
          networkSecurityGroupId = "string"
          privateEndpointNetworkPolicies = "string"
          privateLinkServiceNetworkPolicies = "string"
        }
      ]
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
      }
      clientConnectionPort = int
      clients = [
        {
          commonName = "string"
          isAdmin = bool
          issuerThumbprint = "string"
          thumbprint = "string"
        }
      ]
      clusterCodeVersion = "string"
      clusterUpgradeCadence = "string"
      clusterUpgradeMode = "string"
      dnsName = "string"
      enableAutoOSUpgrade = bool
      enableIpv6 = bool
      enableServicePublicIP = bool
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      httpGatewayConnectionPort = int
      ipTags = [
        {
          ipTagType = "string"
          tag = "string"
        }
      ]
      loadBalancingRules = [
        {
          backendPort = int
          frontendPort = int
          loadDistribution = "string"
          probePort = int
          probeProtocol = "string"
          probeRequestPath = "string"
          protocol = "string"
        }
      ]
      networkSecurityRules = [
        {
          access = "string"
          description = "string"
          destinationAddressPrefix = "string"
          destinationAddressPrefixes = [
            "string"
          ]
          destinationPortRange = "string"
          destinationPortRanges = [
            "string"
          ]
          direction = "string"
          name = "string"
          priority = int
          protocol = "string"
          sourceAddressPrefix = "string"
          sourceAddressPrefixes = [
            "string"
          ]
          sourcePortRange = "string"
          sourcePortRanges = [
            "string"
          ]
        }
      ]
      publicIPPrefixId = "string"
      serviceEndpoints = [
        {
          locations = [
            "string"
          ]
          service = "string"
        }
      ]
      subnetId = "string"
      useCustomVnet = bool
      zonalResiliency = bool
      zonalUpdateMode = "string"
    }
    sku = {
      name = "string"
    }
  }
}

プロパティ値

Microsoft.ServiceFabric/managedClusters

名前	説明	価値
位置	Azure リソースの場所。	string (必須)
名前	リソース名	string (必須)
parent_id	この拡張リソースを適用するリソースの ID。	string (必須)
プロパティ	マネージド クラスター リソースのプロパティ	ManagedClusterProperties の
エスケーユー	マネージド クラスターの SKU	SKU (必須)
タグ	リソース タグ	タグ名と値のディクショナリ。
型	リソースの種類	「Microsoft.ServiceFabric/managedClusters@2023-03-01-preview」

ApplicationTypeVersionsCleanupPolicy (英語)

名前	説明	価値
maxUnusedVersionsToKeep (マックス未使用バージョン保持)	保持するアプリケーションの種類ごとの未使用バージョンの数。	int 制約： 最小値 = 0 (必須)

AzureのActiveDirectory

名前	説明	価値
クライアントアプリケーション	Azure Active Directory クライアント アプリケーション ID。	文字列
クラスタアプリケーション	Azure Active Directory クラスター アプリケーション ID。	文字列
テナントID	Azure Active Directory テナント ID。	文字列

クライアント証明書

名前	説明	価値
コモンネーム	証明書の共通名。	文字列
isAdminの	クライアント証明書にクラスターへの管理者アクセス権があるかどうかを示します。 管理者以外のクライアントは、クラスターに対して読み取り専用操作のみを実行できます。	bool (必須)
発行者拇印	証明書の発行者の拇印。 CommonName と共にのみ使用されます。	文字列
サムプリント	証明書の拇印。	文字列

IPTagの

名前	説明	価値
ipTagType (英語)	IP タグの種類。	string (必須)
タグ	IP タグの値。	string (必須)

ロードバランスルール

名前	説明	価値
バックエンドポート	エンドポイントの内部接続に使用されるポート。 使用できる値は 1 ~ 65535 です。	int 制約： 最小値 = 1 最大値 = 65534 (必須)
フロントエンドポート	外部エンドポイントのポートです。 各規則のポート番号は、ロード バランサー内で一意である必要があります。 使用できる値は 1 ~ 65534 です。	int 制約： 最小値 = 1 最大値 = 65534 (必須)
負荷分布	この規則の負荷分散ポリシー。	文字列
プローブポート	負荷分散規則で使用されるプローブ ポート。 使用できる値は 1 ~ 65535 です。	int 制約： 最小値 = 1 最大値 = 65534
プローブプロトコル	負荷分散規則で使用されるロード バランサー プローブへの参照。	「http」 「https」 'tcp' (必須)
プローブリクエストパス	プローブ要求パス。 HTTP/HTTPS プローブでのみサポートされます。	文字列
プロトコル	負荷分散規則で使用されるトランスポート プロトコルへの参照。	'tcp' 'udp' (必須)

ManagedClusterProperties (管理クラスタプロパティ)

名前	説明	価値
addon機能	クラスターで有効にするアドオン機能の一覧。	次のいずれかを含む文字列配列: 'BackupRestoreService' 「Dnsサービス」 'リソースモニターサービス'
管理者パスワード	VM 管理者のユーザー パスワード。	糸 制約： 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
adminUserName(管理者ユーザー名)	VM 管理者ユーザー名。	string (必須)
allowRdpAccess (許可Rdpアクセス)	これを true に設定すると、VM への RDP アクセスが有効になります。 既定の NSG 規則は、インターネットへの RDP ポートを開きます。このポートは、カスタム ネットワーク セキュリティ規則でオーバーライドできます。 この設定の既定値は false です。	ブール (bool)
applicationTypeVersionsCleanupPolicy	未使用のバージョンをクリーンアップするために使用されるポリシー。	ApplicationTypeVersionsCleanupPolicy の
補助サブネット	クラスターの補助サブネット。	サブネット[]
azureActiveDirectory の	クラスターの AAD 認証設定。	AzureのActiveDirectory
クライアント接続ポート	クラスターへのクライアント接続に使用されるポート。	整数 (int)
クライアント	クラスターの管理が許可されているクライアント証明書。	クライアント証明書[]
clusterCodeVersion (クラスタコードバージョン)	クラスターの Service Fabric ランタイム バージョン。 このプロパティは、clusterUpgradeMode が 'Manual' に設定されている場合に必要です。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、ClusterVersion API使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、availableClusterVersions使用します。	文字列
clusterUpgradeCadence	新しいクラスター ランタイム バージョンのアップグレードがリリース後に適用されるタイミングを示します。 既定では Wave0 です。 clusterUpgradeMode が 'Automatic' に設定されている場合にのみ適用されます。	「ウェーブ0」 「ウェーブ1」 「ウェーブ2」
clusterUpgradeMode	新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。	「自動」 「マニュアル」
dnsName (英語)	クラスターの DNS 名。	string (必須)
enableAutoOSUpgrade	これを true に設定すると、バージョン 'latest' のプラットフォーム OS イメージを使用して作成されたノードの種類に対する OS の自動アップグレードが有効になります。 この設定の既定値は false です。	ブール (bool)
enableipv6	これを true に設定すると、クラスターで使用される既定の VNet の IPv6 アドレス空間が作成されます。 この設定は、クラスターが作成された後は変更できません。 この設定の既定値は false です。	ブール (bool)
enableServicePublicIPの	これを true に設定すると、IPv4 アドレスが IPv6 アドレスの ServicePublicIP としてリンクされます。 これは、クラスターで IPv6 が有効になっている場合にのみ True に設定できます。	ブール (bool)
ファブリック設定	クラスターを構成するためのカスタム ファブリック設定の一覧。	SettingsSectionDescription[]
httpGatewayConnectionPort (英語)	クラスターへの HTTP 接続に使用されるポート。	整数 (int)
ipタグ	クラスターの既定のパブリック IP アドレスに関連付けられている IP タグの一覧。	IPタグ[]
loadBalancingルール	クラスターのパブリック ロード バランサーに適用される負荷分散規則。	ロードバランシングルール[]
ネットワークセキュリティルール	クラスターの仮想ネットワークに適用されるカスタム ネットワーク セキュリティ規則。	ネットワークセキュリティルール[]
publicIPPrefixId(英語)	ロード バランサーがパブリック IP アドレスを割り当てるパブリック IP プレフィックスのリソース ID を指定します。 IPv4 のみがサポートされます。	文字列
サービスエンドポイント	クラスター内のサブネットのサービス エンドポイント。	サービスエンドポイント[]
サブネットID	指定した場合、クラスターのノードの種類は、既定の VNet ではなく、このサブネットに作成されます。 クラスターに指定された networkSecurityRules も、このサブネットに適用されます。 この設定は、クラスターが作成された後は変更できません。	文字列
useCustomVnetの	新しいクラスターの場合、このパラメーターは Bring Your Own VNet を使用することを示しますが、サブネットはノード タイプ レベルで指定されます。このようなクラスターでは、ノードの種類に subnetId プロパティが必要です。	ブール (bool)
zonalResiliency (ゾナルレジリエンシー)	クラスターにゾーンの回復性があるかどうかを示します。	ブール (bool)
zonalUpdateMode	クロス Az クラスターの更新モードを示します。	「速い」 「スタンダード」

ネットワークセキュリティルール

名前	説明	価値
アクセス	ネットワーク トラフィックは許可または拒否されます。	「許可」 'deny' (必須)
説明	ネットワーク セキュリティ規則の説明。	文字列
destinationAddressプレフィックス	宛先アドレス プレフィックス。 CIDR または宛先 IP 範囲。 アスタリスク '*' を使用して、すべてのソース IP を照合することもできます。 "VirtualNetwork"、"AzureLoadBalancer"、"Internet" などの既定のタグも使用できます。	文字列
destinationAddressプレフィックス	宛先アドレス プレフィックス。 CIDR または宛先 IP 範囲。	文字列[]
destinationPortRange (宛先ポートレンジ)	宛先ポートまたは範囲。 整数または 0 ~ 65535 の範囲。 アスタリスク '*' は、すべてのポートとの照合にも使用できます。	文字列
destinationPortRanges(宛先ポート範囲)	宛先ポートの範囲。	文字列[]
方向	ネットワーク セキュリティ規則の方向。	「インバウンド」 'outbound' (必須)
名前	ネットワーク セキュリティ規則の名前。	string (必須)
優先権	ルールの優先順位。 値の範囲は 1000 ~ 3000 です。 この範囲外の値は、Service Fabric ManagerCluster リソース プロバイダー用に予約されています。 優先順位番号は、コレクション内の各ルールで一意である必要があります。 優先度の数値が小さいと、ルールの優先度が高くなります。	int 制約： 最小値 = 1000 最大値 = 3000 (必須)
プロトコル	この規則が適用されるネットワーク プロトコル。	「あぁ」 「ESP」 「http」 「https」 「icmp」 'tcp' 'udp' (必須)
sourceAddressプレフィックス	CIDR またはソース IP 範囲。 アスタリスク '*' を使用して、すべてのソース IP を照合することもできます。 "VirtualNetwork"、"AzureLoadBalancer"、"Internet" などの既定のタグも使用できます。 これがイングレス ルールの場合は、ネットワーク トラフィックの発信元を指定します。	文字列
sourceAddressプレフィックス	CIDR またはソース IP 範囲。	文字列[]
ソースポートレンジ	ソース ポートまたは範囲。 整数または 0 ~ 65535 の範囲。 アスタリスク '*' は、すべてのポートとの照合にも使用できます。	文字列
ソースポート範囲	ソース ポートの範囲。	文字列[]

リソースタグ

名前	説明	価値

サービスエンドポイント

名前	説明	価値
ロケーション	場所の一覧。	文字列[]
サービス	エンドポイント サービスの種類。	string (必須)

SettingsParameterDescription

名前	説明	価値
名前	ファブリック設定のパラメーター名。	string (必須)
価値	ファブリック設定のパラメーター値。	string (必須)

SettingsSectionDescription (設定セクションの説明)

名前	説明	価値
名前	ファブリック設定のセクション名。	string (必須)
パラメーター	セクション内のパラメーターのコレクション。	SettingsParameterDescription[] (必須)

SKUの

名前	説明	価値
名前	SKU 名。	「ベーシック」 'Standard' (必須)

サブネット

名前	説明	価値
enableipv6	Ipv6 を有効にしないかどうかを示します。 指定しない場合は、クラスターと同じ構成になります。	ブール (bool)
名前	サブネット名。	string (必須)
ネットワークセキュリティグループID	ネットワーク セキュリティ グループの完全なリソース ID。	文字列
privateEndpointNetworkPolicies (プライベートエンドポイントネットワークポリシー)	サブネット内のプライベート エンドポイントでネットワーク ポリシーの適用を有効または無効にします。	'無効' '有効'
privateLinkServiceNetworkPolicies (プライベートリンクサービスネットワークポリシー)	サブネット内のプライベート リンク サービスに対するネットワーク ポリシーの適用を有効または無効にします。	'無効' '有効'

使用例

Terraformサンプル

リソース グループのデプロイの基本的な例。

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "admin_username" {
  type        = string
  description = "The administrator username for the Service Fabric managed cluster"
}

variable "admin_password" {
  type        = string
  description = "The administrator password for the Service Fabric managed cluster"
  sensitive   = true
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "managedCluster" {
  type      = "Microsoft.ServiceFabric/managedClusters@2021-05-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      addonFeatures = [
        "DnsService",
      ]
      adminPassword             = var.admin_password
      adminUserName             = var.admin_username
      clientConnectionPort      = 12345
      clusterUpgradeCadence     = "Wave0"
      dnsName                   = var.resource_name
      httpGatewayConnectionPort = 23456
      loadBalancingRules = [
        {
          backendPort      = 8000
          frontendPort     = 443
          probeProtocol    = "http"
          probeRequestPath = "/"
          protocol         = "tcp"
        },
      ]
      networkSecurityRules = [
        {
          access = "allow"
          destinationAddressPrefixes = [
            "0.0.0.0/0",
          ]
          destinationPortRanges = [
            "443",
          ]
          direction = "inbound"
          name      = "rule443-allow-fe"
          priority  = 1000
          protocol  = "tcp"
          sourceAddressPrefixes = [
            "0.0.0.0/0",
          ]
          sourcePortRanges = [
            "1-65535",
          ]
        },
      ]
    }
    sku = {
      name = "Standard"
    }
    tags = {
      Test = "value"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}