Microsoft.ServiceFabric managedClusters 2022-01-01

Bicep リソース定義

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

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

リソース形式

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

resource symbolicname 'Microsoft.ServiceFabric/managedClusters@2022-01-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    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'
        ]
      }
    ]
    serviceEndpoints: [
      {
        locations: [
          'string'
        ]
        service: 'string'
      }
    ]
    subnetId: 'string'
    zonalResiliency: bool
  }
}

プロパティ値

managedClusters

名前 説明
name リソース名 string (必須)
location Azure リソースの場所。 string (必須)
tags Azure リソース タグ。 タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
sku マネージド クラスターの SKU SKU
properties マネージド クラスター リソースのプロパティ ManagedClusterProperties

ManagedClusterProperties

名前 説明
addonFeatures クラスターで有効にするアドオン機能の一覧。 次のいずれかを含む文字列配列:
'BackupRestoreService'
'DnsService'
'ResourceMonitorService'
adminPassword VM 管理者ユーザー のパスワード。 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとしてを渡します。
adminUserName VM 管理者ユーザー名。 string (必須)
allowRdpAccess これを true に設定すると、VM への RDP アクセスが有効になります。 既定の NSG 規則は、カスタム ネットワーク セキュリティ規則でオーバーライドできるインターネットへの RDP ポートを開きます。 この設定の既定値は false です。 [bool]
applicationTypeVersionsCleanupPolicy 未使用のバージョンをクリーンするために使用されるポリシー。 ApplicationTypeVersionsCleanupPolicy
auxiliarySubnets クラスターの補助サブネット。 Subnet[]
azureActiveDirectory クラスターの AAD 認証設定。 AzureActiveDirectory
clientConnectionPort クラスターへのクライアント接続に使用されるポート。 INT
クライアント クラスターの管理が許可されているクライアント証明書。 ClientCertificate[]
clusterCodeVersion クラスターの Service Fabric ランタイム バージョン。 このプロパティは、 clusterUpgradeMode が 'Manual' に設定されている場合に必要です。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、ClusterVersion API を使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、 availableClusterVersions を使用します string
clusterUpgradeCadence 新しいクラスター ランタイム バージョンのアップグレードがリリース後に適用されるタイミングを示します。 既定では Wave0 です。 clusterUpgradeMode が 'Automatic' に設定されている場合にのみ適用されます。 'Wave0'
'Wave1'
'Wave2'
clusterUpgradeMode 新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。 'Automatic'
'Manual'
dnsName クラスターの DNS 名。 string (必須)
enableAutoOSUpgrade これを true に設定すると、バージョン 'latest' のプラットフォーム OS イメージを使用して作成されたノードの種類に対する OS の自動アップグレードが有効になります。 この設定の既定値は false です。 [bool]
enableIpv6 これを true に設定すると、クラスターで使用される既定の VNet の IPv6 アドレス空間が作成されます。 この設定は、クラスターが作成された後は変更できません。 この設定の既定値は false です。 [bool]
enableServicePublicIP これを true に設定すると、IPv4 アドレスが IPv6 アドレスの ServicePublicIP としてリンクされます。 これは、クラスターで IPv6 が有効になっている場合にのみ True に設定できます。 [bool]
fabricSettings クラスターを構成するためのカスタム ファブリック設定の一覧。 SettingsSectionDescription[]
httpGatewayConnectionPort クラスターへの HTTP 接続に使用されるポート。 INT
ipTags クラスターの既定のパブリック IP アドレスに関連付けられている IP タグの一覧。 IPTag[]
loadBalancingRules クラスターのパブリック ロード バランサーに適用される負荷分散規則。 LoadBalancingRule[]
networkSecurityRules クラスターのVirtual Networkに適用されるカスタム ネットワーク セキュリティ規則。 NetworkSecurityRule[]
serviceEndpoints クラスター内のサブネットのサービス エンドポイント。 ServiceEndpoint[]
subnetId 指定した場合、クラスターのノードの種類は、既定の VNet ではなく、このサブネットに作成されます。 クラスターに指定された networkSecurityRules もこのサブネットに適用されます。 この設定は、クラスターが作成された後は変更できません。 string
zonalResiliency クラスターにゾーンの回復性があるかどうかを示します。 [bool]

ApplicationTypeVersionsCleanupPolicy

名前 説明
maxUnusedVersionsToKeep 保持するアプリケーションの種類ごとの未使用バージョンの数。 int (必須)

制約:
最小値 = 0

Subnet

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

AzureActiveDirectory

名前 説明
clientApplication Azure Active Directory クライアント アプリケーション ID。 string
clusterApplication Azure Active Directory クラスター アプリケーション ID。 string
tenantId Azure Active Directory テナント ID。 string

ClientCertificate

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

SettingsSectionDescription

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

SettingsParameterDescription

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

IPTag

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

LoadBalancingRule

名前 説明
backendPort エンドポイント上の内部接続に使用されるポート。 使用できる値は 1 ~ 65535 です。 int (必須)

制約:
最小値 = 1
最大値 = 65534
frontendPort 外部エンドポイントのポートです。 各規則のポート番号は、Load Balancer内で一意である必要があります。 使用できる値は 1 ~ 65534 です。 int (必須)

制約:
最小値 = 1
最大値 = 65534
loadDistribution このルールの負荷分散ポリシー。 string
probePort 負荷分散規則によって使用されるプローブ ポート。 使用できる値は 1 ~ 65535 です。 INT

制約:
最小値 = 1
最大値 = 65534
probeProtocol 負荷分散規則で使用されるロード バランサー プローブへの参照。 'http'
'https'
'tcp' (必須)
probeRequestPath プローブ要求パス。 HTTP/HTTPS プローブでのみサポートされます。 string
protocol 負荷分散規則で使用されるトランスポート プロトコルへの参照。 'tcp'
'udp' (必須)

NetworkSecurityRule

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

制約:
最小値 = 1000
最大値 = 3000
protocol この規則が適用されるネットワーク プロトコル。 'ah'
'esp'
'http'
'https'
'icmp'
'tcp'
'udp' (必須)
sourceAddressPrefix CIDR またはソース IP 範囲。 また、すべてのソース IP に一致させるためにアスタリスク '*' を使用することもできます。 "VirtualNetwork"、"AzureLoadBalancer"、"Internet" などの既定のタグも使用できます。 これがイングレス ルールの場合は、ネットワーク トラフィックの発信元を指定します。 string
sourceAddressPrefixes CIDR またはソース IP 範囲。 string[]
sourcePortRange ソース ポートまたは範囲。 整数または 0 ~ 65535 の範囲。 アスタリスク '*' を使用して、すべてのポートを照合することもできます。 string
sourcePortRanges ソース ポートの範囲。 string[]

ServiceEndpoint

名前 説明
locations 場所の一覧。 string[]
サービス (service) エンドポイント サービスの種類。 string (必須)

Sku

名前 説明
name Sku 名。 'Basic'
'Standard' (必須)

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

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

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

リソース形式

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

{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "apiVersion": "2022-01-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "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" ]
      }
    ],
    "serviceEndpoints": [
      {
        "locations": [ "string" ],
        "service": "string"
      }
    ],
    "subnetId": "string",
    "zonalResiliency": "bool"
  }
}

プロパティ値

managedClusters

名前 説明
type リソースの種類 'Microsoft.ServiceFabric/managedClusters'
apiVersion リソース API のバージョン '2022-01-01'
name リソース名 string (必須)
location Azure リソースの場所。 string (必須)
tags Azure リソース タグ。 タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
sku マネージド クラスターの SKU SKU
properties マネージド クラスター リソースのプロパティ ManagedClusterProperties

ManagedClusterProperties

名前 説明
addonFeatures クラスターで有効にするアドオン機能の一覧。 次のいずれかを含む文字列配列:
'BackupRestoreService'
'DnsService'
'ResourceMonitorService'
adminPassword VM 管理者ユーザー のパスワード。 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとしてを渡します。
adminUserName VM 管理者ユーザー名。 string (必須)
allowRdpAccess これを true に設定すると、VM への RDP アクセスが有効になります。 既定の NSG 規則は、カスタム ネットワーク セキュリティ規則でオーバーライドできるインターネットへの RDP ポートを開きます。 この設定の既定値は false です。 [bool]
applicationTypeVersionsCleanupPolicy 未使用のバージョンをクリーンするために使用されるポリシー。 ApplicationTypeVersionsCleanupPolicy
auxiliarySubnets クラスターの補助サブネット。 Subnet[]
azureActiveDirectory クラスターの AAD 認証設定。 AzureActiveDirectory
clientConnectionPort クラスターへのクライアント接続に使用されるポート。 INT
クライアント クラスターの管理が許可されているクライアント証明書。 ClientCertificate[]
clusterCodeVersion クラスターの Service Fabric ランタイム バージョン。 このプロパティは、 clusterUpgradeMode が 'Manual' に設定されている場合に必要です。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、ClusterVersion API を使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、 availableClusterVersions を使用します string
clusterUpgradeCadence 新しいクラスター ランタイム バージョンのアップグレードがリリース後に適用されるタイミングを示します。 既定では Wave0 です。 clusterUpgradeMode が 'Automatic' に設定されている場合にのみ適用されます。 'Wave0'
'Wave1'
'Wave2'
clusterUpgradeMode 新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。 'Automatic'
'Manual'
dnsName クラスターの DNS 名。 string (必須)
enableAutoOSUpgrade これを true に設定すると、バージョン 'latest' のプラットフォーム OS イメージを使用して作成されたノードの種類に対して OS の自動アップグレードが有効になります。 この設定の既定値は false です。 [bool]
enableIpv6 これを true に設定すると、クラスターで使用される既定の VNet の IPv6 アドレス空間が作成されます。 この設定は、クラスターを作成した後は変更できません。 この設定の既定値は false です。 [bool]
enableServicePublicIP これを true に設定すると、IPv4 アドレスが IPv6 アドレスの ServicePublicIP としてリンクされます。 これは、クラスターで IPv6 が有効になっている場合にのみ True に設定できます。 [bool]
fabricSettings クラスターを構成するためのカスタム ファブリック設定の一覧。 SettingsSectionDescription[]
httpGatewayConnectionPort クラスターへの HTTP 接続に使用されるポート。 INT
ipTags クラスターの既定のパブリック IP アドレスに関連付けられている IP タグの一覧。 IPTag[]
loadBalancingRules クラスターのパブリック ロード バランサーに適用される負荷分散規則。 LoadBalancingRule[]
networkSecurityRules クラスターのVirtual Networkに適用されるカスタム ネットワーク セキュリティ規則。 NetworkSecurityRule[]
serviceEndpoints クラスター内のサブネットのサービス エンドポイント。 ServiceEndpoint[]
subnetId 指定した場合、クラスターのノードの種類は、既定の VNet ではなく、このサブネットに作成されます。 クラスターに指定された networkSecurityRules もこのサブネットに適用されます。 この設定は、クラスターを作成した後は変更できません。 string
zonalResiliency クラスターにゾーンの回復性があるかどうかを示します。 [bool]

ApplicationTypeVersionsCleanupPolicy

名前 説明
maxUnusedVersionsToKeep 保持するアプリケーションの種類ごとの未使用バージョンの数。 int (必須)

制約:
最小値 = 0

Subnet

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

AzureActiveDirectory

名前 説明
clientApplication Azure Active Directory クライアント アプリケーション ID。 string
clusterApplication Azure Active Directory クラスター アプリケーション ID。 string
tenantId Azure Active Directory テナント ID。 string

ClientCertificate

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

SettingsSectionDescription

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

SettingsParameterDescription

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

IPTag

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

LoadBalancingRule

名前 説明
backendPort エンドポイント上の内部接続に使用されるポート。 使用できる値は 1 ~ 65535 です。 int (必須)

制約:
最小値 = 1
最大値 = 65534
frontendPort 外部エンドポイントのポートです。 各規則のポート番号は、Load Balancer内で一意である必要があります。 使用できる値は 1 ~ 65534 です。 int (必須)

制約:
最小値 = 1
最大値 = 65534
loadDistribution このルールの負荷分散ポリシー。 string
probePort 負荷分散規則によって使用されるプローブ ポート。 使用できる値は 1 ~ 65535 です。 INT

制約:
最小値 = 1
最大値 = 65534
probeProtocol 負荷分散規則で使用されるロード バランサー プローブへの参照。 'http'
'https'
'tcp' (必須)
probeRequestPath プローブ要求パス。 HTTP/HTTPS プローブでのみサポートされます。 string
protocol 負荷分散規則で使用されるトランスポート プロトコルへの参照。 'tcp'
'udp' (必須)

NetworkSecurityRule

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

制約:
最小値 = 1000
最大値 = 3000
protocol この規則が適用されるネットワーク プロトコル。 'ah'
'esp'
'http'
'https'
'icmp'
'tcp'
'udp' (必須)
sourceAddressPrefix CIDR またはソース IP 範囲。 また、すべてのソース IP に一致させるためにアスタリスク '*' を使用することもできます。 "VirtualNetwork"、"AzureLoadBalancer"、"Internet" などの既定のタグも使用できます。 これがイングレス ルールの場合は、ネットワーク トラフィックの発信元を指定します。 string
sourceAddressPrefixes CIDR またはソース IP 範囲。 string[]
sourcePortRange ソース ポートまたは範囲。 0 から 65535 までの整数または範囲。 アスタリスク '*' を使用して、すべてのポートを照合することもできます。 string
sourcePortRanges ソース ポートの範囲。 string[]

ServiceEndpoint

名前 説明
locations 場所の一覧。 string[]
サービス (service) エンドポイント サービスの種類。 string (必須)

Sku

名前 説明
name Sku 名。 'Basic'
'Standard' (必須)

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

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

  • リソース グループ

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

リソース形式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedClusters@2022-01-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      addonFeatures = [
        "string"
      ]
      adminPassword = "string"
      adminUserName = "string"
      allowRdpAccess = bool
      applicationTypeVersionsCleanupPolicy = {
        maxUnusedVersionsToKeep = int
      }
      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"
          ]
        }
      ]
      serviceEndpoints = [
        {
          locations = [
            "string"
          ]
          service = "string"
        }
      ]
      subnetId = "string"
      zonalResiliency = bool
    }
    sku = {
      name = "string"
    }
  })
}

プロパティ値

managedClusters

名前 説明
type リソースの種類 "Microsoft.ServiceFabric/managedClusters@2022-01-01"
name リソース名 string (必須)
location Azure リソースの場所。 string (必須)
parent_id リソース グループにデプロイするには、そのリソース グループの ID を使用します。 string (必須)
tags Azure リソース タグ。 タグの名前と値のディクショナリ。
sku マネージド クラスターの SKU SKU
properties マネージド クラスター リソースのプロパティ ManagedClusterProperties

ManagedClusterProperties

名前 説明
addonFeatures クラスターで有効にするアドオン機能の一覧。 次のいずれかを含む文字列配列:
"BackupRestoreService"
"DnsService"
"ResourceMonitorService"
adminPassword VM 管理者ユーザー のパスワード。 string

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとしてを渡します。
adminUserName VM 管理者ユーザー名。 string (必須)
allowRdpAccess これを true に設定すると、VM への RDP アクセスが有効になります。 既定の NSG 規則は、カスタム ネットワーク セキュリティ規則でオーバーライドできるインターネットへの RDP ポートを開きます。 この設定の既定値は false です。 [bool]
applicationTypeVersionsCleanupPolicy 未使用のバージョンをクリーンするために使用されるポリシー。 ApplicationTypeVersionsCleanupPolicy
auxiliarySubnets クラスターの補助サブネット。 Subnet[]
azureActiveDirectory クラスターの AAD 認証設定。 AzureActiveDirectory
clientConnectionPort クラスターへのクライアント接続に使用されるポート。 INT
クライアント クラスターの管理が許可されているクライアント証明書。 ClientCertificate[]
clusterCodeVersion クラスターの Service Fabric ランタイム バージョン。 このプロパティは、 clusterUpgradeMode が 'Manual' に設定されている場合に必要です。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、ClusterVersion API を使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、 availableClusterVersions を使用します string
clusterUpgradeCadence 新しいクラスター ランタイム バージョンのアップグレードがリリース後に適用されるタイミングを示します。 既定では Wave0 です。 clusterUpgradeMode が 'Automatic' に設定されている場合にのみ適用されます。 "Wave0"
"Wave1"
"Wave2"
clusterUpgradeMode 新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。 "自動"
"Manual"
dnsName クラスターの DNS 名。 string (必須)
enableAutoOSUpgrade これを true に設定すると、バージョン 'latest' のプラットフォーム OS イメージを使用して作成されたノードの種類に対して OS の自動アップグレードが有効になります。 この設定の既定値は false です。 [bool]
enableIpv6 これを true に設定すると、クラスターで使用される既定の VNet の IPv6 アドレス空間が作成されます。 この設定は、クラスターを作成した後は変更できません。 この設定の既定値は false です。 [bool]
enableServicePublicIP これを true に設定すると、IPv4 アドレスが IPv6 アドレスの ServicePublicIP としてリンクされます。 これは、クラスターで IPv6 が有効になっている場合にのみ True に設定できます。 [bool]
fabricSettings クラスターを構成するためのカスタム ファブリック設定の一覧。 SettingsSectionDescription[]
httpGatewayConnectionPort クラスターへの HTTP 接続に使用されるポート。 INT
ipTags クラスターの既定のパブリック IP アドレスに関連付けられている IP タグの一覧。 IPTag[]
loadBalancingRules クラスターのパブリック ロード バランサーに適用される負荷分散規則。 LoadBalancingRule[]
networkSecurityRules クラスターのVirtual Networkに適用されるカスタム ネットワーク セキュリティ規則。 NetworkSecurityRule[]
serviceEndpoints クラスター内のサブネットのサービス エンドポイント。 ServiceEndpoint[]
subnetId 指定した場合、クラスターのノードの種類は、既定の VNet ではなく、このサブネットに作成されます。 クラスターに指定された networkSecurityRules もこのサブネットに適用されます。 この設定は、クラスターを作成した後は変更できません。 string
zonalResiliency クラスターにゾーンの回復性があるかどうかを示します。 [bool]

ApplicationTypeVersionsCleanupPolicy

名前 説明
maxUnusedVersionsToKeep 保持するアプリケーションの種類ごとの未使用バージョンの数。 int (必須)

制約:
最小値 = 0

Subnet

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

AzureActiveDirectory

名前 説明
clientApplication Azure Active Directory クライアント アプリケーション ID。 string
clusterApplication Azure Active Directory クラスター アプリケーション ID。 string
tenantId Azure Active Directory テナント ID。 string

ClientCertificate

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

SettingsSectionDescription

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

SettingsParameterDescription

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

IPTag

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

LoadBalancingRule

名前 説明
backendPort エンドポイント上の内部接続に使用されるポート。 使用できる値は 1 ~ 65535 です。 int (必須)

制約:
最小値 = 1
最大値 = 65534
frontendPort 外部エンドポイントのポートです。 各ルールのポート番号は、Load Balancer内で一意である必要があります。 使用できる値は 1 ~ 65534 です。 int (必須)

制約:
最小値 = 1
最大値 = 65534
loadDistribution このルールの負荷分散ポリシー。 string
probePort 負荷分散規則で使用されるプローブ ポート。 使用できる値は 1 ~ 65535 です。 INT

制約:
最小値 = 1
最大値 = 65534
probeProtocol 負荷分散規則で使用されるロード バランサー プローブへの参照。 "http"
"https"
"tcp" (必須)
probeRequestPath プローブ要求パス。 HTTP/HTTPS プローブでのみサポートされます。 string
protocol 負荷分散規則で使用されるトランスポート プロトコルへの参照。 "tcp"
"udp" (必須)

NetworkSecurityRule

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

制約:
最小値 = 1000
最大値 = 3000
protocol この規則が適用されるネットワーク プロトコル。 "ah"
"esp"
"http"
"https"
"icmp"
"tcp"
"udp" (必須)
sourceAddressPrefix CIDR またはソース IP 範囲。 また、すべてのソース IP に一致させるためにアスタリスク '*' を使用することもできます。 "VirtualNetwork"、"AzureLoadBalancer"、"Internet" などの既定のタグも使用できます。 これがイングレス ルールの場合は、ネットワーク トラフィックの発信元を指定します。 string
sourceAddressPrefixes CIDR またはソース IP 範囲。 string[]
sourcePortRange ソース ポートまたは範囲。 整数または 0 ~ 65535 の範囲。 アスタリスク '*' を使用して、すべてのポートを照合することもできます。 string
sourcePortRanges ソース ポートの範囲。 string[]

ServiceEndpoint

名前 説明
locations 場所の一覧。 string[]
サービス (service) エンドポイント サービスの種類。 string (必須)

Sku

名前 説明
name Sku 名。 "Basic"
"Standard" (必須)