次の方法で共有


Microsoft.NetworkCloud kubernetesクラスター

Bicep リソース定義

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

  • リソース グループの - リソース グループのデプロイ コマンド 参照

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

リソースの形式

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

resource symbolicname 'Microsoft.NetworkCloud/kubernetesClusters@2026-01-01-preview' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    aadConfiguration: {
      adminGroupObjectIds: [
        'string'
      ]
    }
    administratorConfiguration: {
      adminUsername: 'string'
      sshPublicKeys: [
        {
          keyData: 'string'
        }
      ]
    }
    controlPlaneNodeConfiguration: {
      administratorConfiguration: {
        adminUsername: 'string'
        sshPublicKeys: [
          {
            keyData: 'string'
          }
        ]
      }
      availabilityZones: [
        'string'
      ]
      count: int
      vmSkuName: 'string'
    }
    initialAgentPoolConfigurations: [
      {
        administratorConfiguration: {
          adminUsername: 'string'
          sshPublicKeys: [
            {
              keyData: 'string'
            }
          ]
        }
        agentOptions: {
          hugepagesCount: int
          hugepagesSize: 'string'
        }
        attachedNetworkConfiguration: {
          l2Networks: [
            {
              networkId: 'string'
              pluginType: 'string'
            }
          ]
          l3Networks: [
            {
              ipamEnabled: 'string'
              networkId: 'string'
              pluginType: 'string'
            }
          ]
          trunkedNetworks: [
            {
              networkId: 'string'
              pluginType: 'string'
            }
          ]
        }
        availabilityZones: [
          'string'
        ]
        count: int
        labels: [
          {
            key: 'string'
            value: 'string'
          }
        ]
        mode: 'string'
        name: 'string'
        taints: [
          {
            key: 'string'
            value: 'string'
          }
        ]
        upgradeSettings: {
          drainTimeout: int
          maxSurge: 'string'
          maxUnavailable: 'string'
        }
        vmSkuName: 'string'
      }
    ]
    kubernetesVersion: 'string'
    managedResourceGroupConfiguration: {
      location: 'string'
      name: 'string'
    }
    networkConfiguration: {
      attachedNetworkConfiguration: {
        l2Networks: [
          {
            networkId: 'string'
            pluginType: 'string'
          }
        ]
        l3Networks: [
          {
            ipamEnabled: 'string'
            networkId: 'string'
            pluginType: 'string'
          }
        ]
        trunkedNetworks: [
          {
            networkId: 'string'
            pluginType: 'string'
          }
        ]
      }
      bgpServiceLoadBalancerConfiguration: {
        bgpAdvertisements: [
          {
            advertiseToFabric: 'string'
            communities: [
              'string'
            ]
            ipAddressPools: [
              'string'
            ]
            peers: [
              'string'
            ]
          }
        ]
        bgpPeers: [
          {
            bfdEnabled: 'string'
            bgpMultiHop: 'string'
            holdTime: 'string'
            keepAliveTime: 'string'
            myAsn: int
            name: 'string'
            password: 'string'
            peerAddress: 'string'
            peerAsn: int
            peerPort: int
          }
        ]
        fabricPeeringEnabled: 'string'
        ipAddressPools: [
          {
            addresses: [
              'string'
            ]
            autoAssign: 'string'
            name: 'string'
            onlyUseHostIps: 'string'
          }
        ]
      }
      cloudServicesNetworkId: 'string'
      cniNetworkId: 'string'
      dnsServiceIp: 'string'
      l2ServiceLoadBalancerConfiguration: {
        ipAddressPools: [
          {
            addresses: [
              'string'
            ]
            autoAssign: 'string'
            name: 'string'
            onlyUseHostIps: 'string'
          }
        ]
      }
      podCidrs: [
        'string'
      ]
      serviceCidrs: [
        'string'
      ]
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.NetworkCloud/kubernetesClusters (Kubernetes クラスター)

名前 形容 価値
拡張ロケーション 資源の広がった位置。 この性質はリソース作成時に必要です。 AzureResourceManagerCommonTypesExtendedLocation (required)
位置 リソースが存在する地理的な場所 string (必須)
名前 リソース名

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (必須)
プロパティ リソースのプロパティの一覧。 KubernetesClusterProperties (必須)
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください

アードコンフィグレーション

名前 形容 価値
adminGroupObjectIds(管理者グループオブジェクトIDS) Kubernetes クラスターで管理ロールを持つ Azure Active Directory グループ オブジェクト ID の一覧。 string[] (必須)

管理者構成

名前 形容 価値
管理者ユーザー名 Kubernetes ノードを実行するオペレーティング システムに適用される管理者のユーザー名。 指定しない場合は、サービスによってユーザー名が選択されます。 文字列
sshPublicKeys(sshPublicKeys) Kubernetes クラスター内のノードを実行するオペレーティング システムの SSH 構成。 場合によっては、作業環境を生成するために公開キーの指定が必要になる場合があります。 SshPublicKey[]

エージェントオプション

名前 形容 価値
hugepagesCount 割り当てる hugepage の数。 int (必須)
巨大なページサイズ 割り当てる hugepage のサイズ。 「1G」
「2M」

AgentPoolアップグレード設定

名前 形容 価値
ドレインタイムアウト エージェント プールのアップグレードに進む前にノードドレインが完了するまでに許容される最大時間 (秒)。 作成時に指定しない場合は、1800 秒の値が使用されます。 int

制約:
最小値 = 60
最大値 = 86400
マックスサージ アップグレード中に急増したノードの最大数または割合。 これは、整数 (例: '5') またはパーセンテージ (例: '50%') に設定できます。 パーセンテージを指定すると、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージになります。 パーセンテージの場合、小数部のノードは切り上げられます。 作成時に指定しない場合は、値 1 が使用されます。 MaxSurge と MaxUnavailable の 1 つが 0 より大きい必要があります。 文字列
max利用不可 アップグレード中に使用できないノードの最大数または割合。 これは、整数 (例: '5') またはパーセンテージ (例: '50%') に設定できます。 パーセンテージを指定すると、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージになります。 パーセンテージの場合、小数部のノードは切り上げられます。 作成時に指定しない場合は、値 0 が使用されます。 MaxSurge と MaxUnavailable の 1 つが 0 より大きい必要があります。 文字列

AttachedNetworkConfiguration (アタッチされたネットワーク構成)

名前 形容 価値
l2Networks レイヤー 2 ネットワークと添付ファイルの関連構成の一覧。 L2NetworkAttachmentConfiguration[]
l3Networks レイヤー 3 ネットワークと添付ファイルの関連する構成の一覧。 L3NetworkAttachmentConfiguration[]
trunkedNetworks トランクされたネットワークと添付ファイルの関連する構成の一覧。 TrunkedNetworkAttachmentConfiguration[]

AzureResourceManagerCommonTypesExtendedLocation

名前 形容 価値
名前 拡張された場所の名前。 string (必須)
拡張された場所の種類。 「カスタムロケーション」
'EdgeZone' (必須)

Bgp広告

名前 形容 価値
advertiseToFabric(アドバタイトファブリック) このアドバタイズが、ネットワーク クラウド クラスターに関連付けられているネットワーク ファブリックにも行われるかどうかを示すインジケーター。 fabricPeeringEnabled が False に設定されている場合、このフィールドは無視されます。
「本当」
コミュニティ 1234:1234 形式の BGP コミュニティ文字列を使用して、アナウンスに関連付ける BGP コミュニティの名前。 文字列[]
ipAddressPools このお知らせに関連付けられている IP アドレス プールの名前。 string[] (必須)
仲間 このアドバタイズを制限する BGP ピアの名前。 値が指定されていない場合、すべての BGP ピアがこのアドバタイズを受信します。 文字列[]

BgpServiceLoadBalancerConfiguration (BgpServiceLoadBalancerConfiguration)

名前 形容 価値
bgp広告 IP アドレス プールをコミュニティとピアに関連付け、IP の発表を可能にします。 Bgp広告[]
bgpピアーズ Kubernetes クラスターがピアリングする追加の BgpPeer エンティティの一覧。 すべてのピアリングを明示的に定義する必要があります。 サービスロードバランサーBgpPeer[]
ファブリックピアリング対応 ロード バランサーがネットワーク ファブリックとピアリングするかどうかを指定するインジケーター。
「本当」
ipAddressPools ロード バランサー サービスに割り当てることができる IP アドレスのプールの一覧。 IpAddressPool[]

ControlPlaneNodeConfiguration (コントロールプレーンノード構成)

名前 形容 価値
管理者設定 コントロール プレーン内のノードに使用する管理者資格情報。 管理者構成
可用性ゾーン コントロール プレーン内のノードのプロビジョニングに使用するネットワーク クラウド クラスターの可用性ゾーンの一覧。 指定しない場合は、すべての可用性ゾーンが使用されます。 文字列[]
数える この構成を使用する仮想マシンの数。 int

制約:
最小値 = 1 (必須)
vmSkuName さん 作成時に指定された VM SKU の名前。 string (必須)

InitialAgentPoolConfiguration (初期エージェントプール構成)

名前 形容 価値
管理者設定 このエージェント プール内のノードに使用する管理者の資格情報。 管理者構成
agentOptions (エージェントオプション) このエージェント プール内の各エージェントに適用される構成。 エージェントオプション
attachedNetworkConfiguration (接続ネットワーク構成) この Kubernetes クラスターで実行されるワークロードで使用するためにエージェント プールに接続されているネットワークの構成。 AttachedNetworkConfiguration (アタッチされたネットワーク構成)
可用性ゾーン このエージェント プール内のノードのプロビジョニングに使用されるネットワーク クラウド クラスターの可用性ゾーンの一覧。 指定しない場合は、すべての可用性ゾーンが使用されます。 文字列[]
数える この構成を使用する仮想マシンの数。 int (必須)
ラベル このエージェント プール内のノードに適用されるラベル。 Kubernetesラベル[]
モード このエージェント プールをシステム プールまたはユーザー プールとして使用する方法の選択。 システム プールは Kubernetes クラスターの機能と重要なサービスを実行しますが、ユーザー プールはユーザー ワークロード専用です。 すべての Kubernetes クラスターには、少なくとも 1 つのノードを含む少なくとも 1 つのシステム ノード プールが含まれている必要があります。 「該当なし」
「システム」
'User' (必須)
名前 このエージェント プールを表すエージェント プール リソースに使用される名前。

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (必須)
汚染 このエージェント プール内のノードに適用されるテイント。 Kubernetesラベル[]
upgradeSettings (アップグレード設定) エージェント プールの構成。 AgentPoolアップグレード設定
vmSkuName さん ノード VM に割り当てられたリソースのサイズを決定する VM SKU の名前。 string (必須)

IpAddressPool (英語)

名前 形容 価値
アドレス IP アドレス範囲の一覧。 各範囲には、CIDR 形式のサブネットまたは IP アドレスの明示的な開始範囲を指定できます。 BGP サービス ロード バランサーの構成では、CIDR 形式のみがサポートされ、/32 (IPv4) プレフィックスと /128 (IPv6) プレフィックスは除外されます。 string[] (必須)
自動割り当て プールからの自動割り当てが行われるかどうかを判断するインジケーター。
「本当」
名前 BGP アドバタイズメントとの関連付けにこの IP アドレス プールを識別するために使用される名前。

制約:
パターン = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (必須)
onlyUseHostIps (ホストイプスを使用) このプールで .0 と .255 で終わる IP アドレスの使用を防ぐためのインジケーター。 このオプションを有効にすると、.1 から .254 までの間の IP アドレスのみが使用されます。
「本当」

KubernetesClusterProperties の

名前 形容 価値
aad設定 Azure Active Directory 統合プロパティ。 アードコンフィグレーション
管理者設定 コントロール プレーンと、独自の値を指定しないエージェント プール ノードに適用される管理資格情報。 管理者構成
controlPlaneNodeConfiguration この Kubernetes クラスターのコントロール プレーンの定義特性。 ControlPlaneNodeConfiguration (必須)
initialAgentPoolConfigurationsの 重要なシステム サービスとワークロードを実行するために、この Kubernetes クラスターで作成されたエージェント プール。 このフィールドのこのデータは作成時にのみ使用され、Kubernetes クラスターの作成後、フィールドは空になります。 作成後、エージェント プールの管理は agentPools サブリソースを使用して行われます。 InitialAgentPoolConfiguration[] (必須)
kubernetesバージョン このクラスターの Kubernetes バージョン。 string (必須)
managedResourceGroupConfiguration リソースに関連付けられているマネージド リソース グループの構成。 ManagedResourceGroupConfiguration の
ネットワーク構成 Kubernetes クラスター ネットワークの構成 (クラスターにまたがるネットワークの添付ファイルを含む)。 NetworkConfiguration (必須)

Kubernetesラベル

名前 形容 価値
キー ラベルまたはテイントの名前。 string (必須)
価値 ラベルまたはテイントの値。 string (必須)

L2NetworkAttachmentConfiguration (L2ネットワーク添付ファイル設定)

名前 形容 価値
ネットワークID 添付ファイル用に構成されているネットワークのリソース ID。 string (必須)
プラグインタイプ Kubernetes クラスターでこのネットワークがどのように利用されるかを示すインジケーター。 「DPDK」
「IPVLAN」
「MACVLAN」
「OSDevice」
「スリオフ」

L2ServiceLoadBalancerConfiguration (L2サービスロードバランサー設定)

名前 形容 価値
ipAddressPools ロード バランサー サービスに割り当てることができる IP アドレスのプールの一覧。 IpAddressPool[]

L3NetworkAttachmentConfiguration (L3ネットワーク添付ファイル設定)

名前 形容 価値
ipam対応 このネットワークが IP アドレス管理を実行し、接続時に IP アドレスを割り当てるかどうかを示します。
「本当」
ネットワークID 添付ファイル用に構成されているネットワークのリソース ID。 string (必須)
プラグインタイプ Kubernetes クラスターでこのネットワークがどのように利用されるかを示すインジケーター。 「DPDK」
「IPVLAN」
「MACVLAN」
「OSDevice」
「スリオフ」

ManagedResourceGroupConfiguration (管理リソースグループ構成)

名前 形容 価値
位置 マネージド リソース グループの場所。 指定しない場合は、親リソースの場所が選択されます。 文字列
名前 マネージド リソース グループの名前。 指定しない場合、一意の名前が自動的に生成されます。

制約:
最大長 = 75

ネットワーク構成

名前 形容 価値
attachedNetworkConfiguration (接続ネットワーク構成) この Kubernetes クラスターで実行されるワークロードで使用するためにクラスターに接続されているネットワークの構成。 AttachedNetworkConfiguration (アタッチされたネットワーク構成)
bgpServiceLoadBalancerConfiguration この Kubernetes クラスターの BGP サービス ロード バランサーの構成。 最大 1 つのサービス ロード バランサー (レイヤー 2 または BGP) を指定できます。 BgpServiceLoadBalancerConfiguration の
cloudServicesNetworkId(クラウドサービスネットワークID) 関連付けられている Cloud Services ネットワークのリソース ID。 string (必須)
cniNetworkIdの コンテナー ネットワーク インターフェイス ネットワークの作成に使用されるレイヤー 3 ネットワークのリソース ID。 string (必須)
dnsServiceIpの Kubernetes DNS サービスに割り当てられた IP アドレス。 これは、サービス CIDR で指定された Kubernetes サービス アドレス範囲内にある必要があります。 文字列
l2ServiceLoadBalancerConfiguration この Kubernetes クラスターのレイヤー 2 サービス ロード バランサーの構成。 最大 1 つのサービス ロード バランサー (レイヤー 2 または BGP) を指定できます。 L2ServiceLoadBalancerConfiguration の
ポッドシドル ポッド IP の割り当て元となる CIDR 表記 IP 範囲。 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 文字列[]
サービスシドル サービス IP の割り当て元となる CIDR 表記 IP 範囲。 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 文字列[]

サービスロードバランサーBgpPeer

名前 形容 価値
bfd有効 この BgpPeer の BFD 有効化のインジケーター。
「本当」
bgpマルチホップ マルチホップ ピアリングのサポートを有効にするインジケーター。
「本当」
ホールドタイム フィールドは非推奨です。 このフィールドは以前は省略可能でしたが、現在は動作が定義されていないため、無視されます。 要求された BGP 保留時間の値。 このフィールドでは、ISO 8601 期間形式 (P1H など) が使用されます。 文字列
キープアライブタイム フィールドは非推奨です。 このフィールドは以前は省略可能でしたが、現在は動作が定義されていないため、無視されます。 要求された BGP キープアライブ時間の値。 このフィールドでは、ISO 8601 期間形式 (P1H など) が使用されます。 文字列
myAsnさん BGP セッションのローカル終了に使用される自律システム番号。 int

制約:
最小値 = 0
最大値 = 4294967295
名前 BGP アドバタイズメントとの関連付けにこの BGP ピアを識別するために使用される名前。

制約:
パターン = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (必須)
パスワード TCP MD5 認証セッションを適用するルーターの認証パスワード。

制約:
最大長 = 80
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
パターン = ^[a-zA-Z0-9]{0,80}$
ピアアドレス この BGP セッションの接続に使用される IPv4 または IPv6 アドレス。 string (必須)
peerAsn さん BGP セッションのリモート終了から予期される自律システム番号。 int

制約:
最小値 = 0
最大値 = 4294967295 (必須)
ピアポート この BGP セッションの接続に使用されるポート。 整数 (int)

SshPublicKey (英語)

名前 形容 価値
キーデータ SSH 公開キー データ。

制約:
最小長 = 1 (必須)

追跡リソースタグ

名前 形容 価値

TrunkedNetworkAttachmentConfiguration

名前 形容 価値
ネットワークID 添付ファイル用に構成されているネットワークのリソース ID。 string (必須)
プラグインタイプ Kubernetes クラスターでこのネットワークがどのように利用されるかを示すインジケーター。 「DPDK」
「IPVLAN」
「MACVLAN」
「OSDevice」
「スリオフ」

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

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

  • リソース グループの - リソース グループのデプロイ コマンド 参照

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

リソースの形式

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

{
  "type": "Microsoft.NetworkCloud/kubernetesClusters",
  "apiVersion": "2026-01-01-preview",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "aadConfiguration": {
      "adminGroupObjectIds": [ "string" ]
    },
    "administratorConfiguration": {
      "adminUsername": "string",
      "sshPublicKeys": [
        {
          "keyData": "string"
        }
      ]
    },
    "controlPlaneNodeConfiguration": {
      "administratorConfiguration": {
        "adminUsername": "string",
        "sshPublicKeys": [
          {
            "keyData": "string"
          }
        ]
      },
      "availabilityZones": [ "string" ],
      "count": "int",
      "vmSkuName": "string"
    },
    "initialAgentPoolConfigurations": [
      {
        "administratorConfiguration": {
          "adminUsername": "string",
          "sshPublicKeys": [
            {
              "keyData": "string"
            }
          ]
        },
        "agentOptions": {
          "hugepagesCount": "int",
          "hugepagesSize": "string"
        },
        "attachedNetworkConfiguration": {
          "l2Networks": [
            {
              "networkId": "string",
              "pluginType": "string"
            }
          ],
          "l3Networks": [
            {
              "ipamEnabled": "string",
              "networkId": "string",
              "pluginType": "string"
            }
          ],
          "trunkedNetworks": [
            {
              "networkId": "string",
              "pluginType": "string"
            }
          ]
        },
        "availabilityZones": [ "string" ],
        "count": "int",
        "labels": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "mode": "string",
        "name": "string",
        "taints": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "upgradeSettings": {
          "drainTimeout": "int",
          "maxSurge": "string",
          "maxUnavailable": "string"
        },
        "vmSkuName": "string"
      }
    ],
    "kubernetesVersion": "string",
    "managedResourceGroupConfiguration": {
      "location": "string",
      "name": "string"
    },
    "networkConfiguration": {
      "attachedNetworkConfiguration": {
        "l2Networks": [
          {
            "networkId": "string",
            "pluginType": "string"
          }
        ],
        "l3Networks": [
          {
            "ipamEnabled": "string",
            "networkId": "string",
            "pluginType": "string"
          }
        ],
        "trunkedNetworks": [
          {
            "networkId": "string",
            "pluginType": "string"
          }
        ]
      },
      "bgpServiceLoadBalancerConfiguration": {
        "bgpAdvertisements": [
          {
            "advertiseToFabric": "string",
            "communities": [ "string" ],
            "ipAddressPools": [ "string" ],
            "peers": [ "string" ]
          }
        ],
        "bgpPeers": [
          {
            "bfdEnabled": "string",
            "bgpMultiHop": "string",
            "holdTime": "string",
            "keepAliveTime": "string",
            "myAsn": "int",
            "name": "string",
            "password": "string",
            "peerAddress": "string",
            "peerAsn": "int",
            "peerPort": "int"
          }
        ],
        "fabricPeeringEnabled": "string",
        "ipAddressPools": [
          {
            "addresses": [ "string" ],
            "autoAssign": "string",
            "name": "string",
            "onlyUseHostIps": "string"
          }
        ]
      },
      "cloudServicesNetworkId": "string",
      "cniNetworkId": "string",
      "dnsServiceIp": "string",
      "l2ServiceLoadBalancerConfiguration": {
        "ipAddressPools": [
          {
            "addresses": [ "string" ],
            "autoAssign": "string",
            "name": "string",
            "onlyUseHostIps": "string"
          }
        ]
      },
      "podCidrs": [ "string" ],
      "serviceCidrs": [ "string" ]
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.NetworkCloud/kubernetesClusters (Kubernetes クラスター)

名前 形容 価値
apiVersion (英語) API のバージョン 『2026-01-01-プレビュー』
拡張ロケーション 資源の広がった位置。 この性質はリソース作成時に必要です。 AzureResourceManagerCommonTypesExtendedLocation (required)
位置 リソースが存在する地理的な場所 string (必須)
名前 リソース名

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (必須)
プロパティ リソースのプロパティの一覧。 KubernetesClusterProperties (必須)
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください
リソースの種類 「Microsoft.NetworkCloud/kubernetesClusters」

アードコンフィグレーション

名前 形容 価値
adminGroupObjectIds(管理者グループオブジェクトIDS) Kubernetes クラスターで管理ロールを持つ Azure Active Directory グループ オブジェクト ID の一覧。 string[] (必須)

管理者構成

名前 形容 価値
管理者ユーザー名 Kubernetes ノードを実行するオペレーティング システムに適用される管理者のユーザー名。 指定しない場合は、サービスによってユーザー名が選択されます。 文字列
sshPublicKeys(sshPublicKeys) Kubernetes クラスター内のノードを実行するオペレーティング システムの SSH 構成。 場合によっては、作業環境を生成するために公開キーの指定が必要になる場合があります。 SshPublicKey[]

エージェントオプション

名前 形容 価値
hugepagesCount 割り当てる hugepage の数。 int (必須)
巨大なページサイズ 割り当てる hugepage のサイズ。 「1G」
「2M」

AgentPoolアップグレード設定

名前 形容 価値
ドレインタイムアウト エージェント プールのアップグレードに進む前にノードドレインが完了するまでに許容される最大時間 (秒)。 作成時に指定しない場合は、1800 秒の値が使用されます。 int

制約:
最小値 = 60
最大値 = 86400
マックスサージ アップグレード中に急増したノードの最大数または割合。 これは、整数 (例: '5') またはパーセンテージ (例: '50%') に設定できます。 パーセンテージを指定すると、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージになります。 パーセンテージの場合、小数部のノードは切り上げられます。 作成時に指定しない場合は、値 1 が使用されます。 MaxSurge と MaxUnavailable の 1 つが 0 より大きい必要があります。 文字列
max利用不可 アップグレード中に使用できないノードの最大数または割合。 これは、整数 (例: '5') またはパーセンテージ (例: '50%') に設定できます。 パーセンテージを指定すると、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージになります。 パーセンテージの場合、小数部のノードは切り上げられます。 作成時に指定しない場合は、値 0 が使用されます。 MaxSurge と MaxUnavailable の 1 つが 0 より大きい必要があります。 文字列

AttachedNetworkConfiguration (アタッチされたネットワーク構成)

名前 形容 価値
l2Networks レイヤー 2 ネットワークと添付ファイルの関連構成の一覧。 L2NetworkAttachmentConfiguration[]
l3Networks レイヤー 3 ネットワークと添付ファイルの関連する構成の一覧。 L3NetworkAttachmentConfiguration[]
trunkedNetworks トランクされたネットワークと添付ファイルの関連する構成の一覧。 TrunkedNetworkAttachmentConfiguration[]

AzureResourceManagerCommonTypesExtendedLocation

名前 形容 価値
名前 拡張された場所の名前。 string (必須)
拡張された場所の種類。 「カスタムロケーション」
'EdgeZone' (必須)

Bgp広告

名前 形容 価値
advertiseToFabric(アドバタイトファブリック) このアドバタイズが、ネットワーク クラウド クラスターに関連付けられているネットワーク ファブリックにも行われるかどうかを示すインジケーター。 fabricPeeringEnabled が False に設定されている場合、このフィールドは無視されます。
「本当」
コミュニティ 1234:1234 形式の BGP コミュニティ文字列を使用して、アナウンスに関連付ける BGP コミュニティの名前。 文字列[]
ipAddressPools このお知らせに関連付けられている IP アドレス プールの名前。 string[] (必須)
仲間 このアドバタイズを制限する BGP ピアの名前。 値が指定されていない場合、すべての BGP ピアがこのアドバタイズを受信します。 文字列[]

BgpServiceLoadBalancerConfiguration (BgpServiceLoadBalancerConfiguration)

名前 形容 価値
bgp広告 IP アドレス プールをコミュニティとピアに関連付け、IP の発表を可能にします。 Bgp広告[]
bgpピアーズ Kubernetes クラスターがピアリングする追加の BgpPeer エンティティの一覧。 すべてのピアリングを明示的に定義する必要があります。 サービスロードバランサーBgpPeer[]
ファブリックピアリング対応 ロード バランサーがネットワーク ファブリックとピアリングするかどうかを指定するインジケーター。
「本当」
ipAddressPools ロード バランサー サービスに割り当てることができる IP アドレスのプールの一覧。 IpAddressPool[]

ControlPlaneNodeConfiguration (コントロールプレーンノード構成)

名前 形容 価値
管理者設定 コントロール プレーン内のノードに使用する管理者資格情報。 管理者構成
可用性ゾーン コントロール プレーン内のノードのプロビジョニングに使用するネットワーク クラウド クラスターの可用性ゾーンの一覧。 指定しない場合は、すべての可用性ゾーンが使用されます。 文字列[]
数える この構成を使用する仮想マシンの数。 int

制約:
最小値 = 1 (必須)
vmSkuName さん 作成時に指定された VM SKU の名前。 string (必須)

InitialAgentPoolConfiguration (初期エージェントプール構成)

名前 形容 価値
管理者設定 このエージェント プール内のノードに使用する管理者の資格情報。 管理者構成
agentOptions (エージェントオプション) このエージェント プール内の各エージェントに適用される構成。 エージェントオプション
attachedNetworkConfiguration (接続ネットワーク構成) この Kubernetes クラスターで実行されるワークロードで使用するためにエージェント プールに接続されているネットワークの構成。 AttachedNetworkConfiguration (アタッチされたネットワーク構成)
可用性ゾーン このエージェント プール内のノードのプロビジョニングに使用されるネットワーク クラウド クラスターの可用性ゾーンの一覧。 指定しない場合は、すべての可用性ゾーンが使用されます。 文字列[]
数える この構成を使用する仮想マシンの数。 int (必須)
ラベル このエージェント プール内のノードに適用されるラベル。 Kubernetesラベル[]
モード このエージェント プールをシステム プールまたはユーザー プールとして使用する方法の選択。 システム プールは Kubernetes クラスターの機能と重要なサービスを実行しますが、ユーザー プールはユーザー ワークロード専用です。 すべての Kubernetes クラスターには、少なくとも 1 つのノードを含む少なくとも 1 つのシステム ノード プールが含まれている必要があります。 「該当なし」
「システム」
'User' (必須)
名前 このエージェント プールを表すエージェント プール リソースに使用される名前。

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (必須)
汚染 このエージェント プール内のノードに適用されるテイント。 Kubernetesラベル[]
upgradeSettings (アップグレード設定) エージェント プールの構成。 AgentPoolアップグレード設定
vmSkuName さん ノード VM に割り当てられたリソースのサイズを決定する VM SKU の名前。 string (必須)

IpAddressPool (英語)

名前 形容 価値
アドレス IP アドレス範囲の一覧。 各範囲には、CIDR 形式のサブネットまたは IP アドレスの明示的な開始範囲を指定できます。 BGP サービス ロード バランサーの構成では、CIDR 形式のみがサポートされ、/32 (IPv4) プレフィックスと /128 (IPv6) プレフィックスは除外されます。 string[] (必須)
自動割り当て プールからの自動割り当てが行われるかどうかを判断するインジケーター。
「本当」
名前 BGP アドバタイズメントとの関連付けにこの IP アドレス プールを識別するために使用される名前。

制約:
パターン = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (必須)
onlyUseHostIps (ホストイプスを使用) このプールで .0 と .255 で終わる IP アドレスの使用を防ぐためのインジケーター。 このオプションを有効にすると、.1 から .254 までの間の IP アドレスのみが使用されます。
「本当」

KubernetesClusterProperties の

名前 形容 価値
aad設定 Azure Active Directory 統合プロパティ。 アードコンフィグレーション
管理者設定 コントロール プレーンと、独自の値を指定しないエージェント プール ノードに適用される管理資格情報。 管理者構成
controlPlaneNodeConfiguration この Kubernetes クラスターのコントロール プレーンの定義特性。 ControlPlaneNodeConfiguration (必須)
initialAgentPoolConfigurationsの 重要なシステム サービスとワークロードを実行するために、この Kubernetes クラスターで作成されたエージェント プール。 このフィールドのこのデータは作成時にのみ使用され、Kubernetes クラスターの作成後、フィールドは空になります。 作成後、エージェント プールの管理は agentPools サブリソースを使用して行われます。 InitialAgentPoolConfiguration[] (必須)
kubernetesバージョン このクラスターの Kubernetes バージョン。 string (必須)
managedResourceGroupConfiguration リソースに関連付けられているマネージド リソース グループの構成。 ManagedResourceGroupConfiguration の
ネットワーク構成 Kubernetes クラスター ネットワークの構成 (クラスターにまたがるネットワークの添付ファイルを含む)。 NetworkConfiguration (必須)

Kubernetesラベル

名前 形容 価値
キー ラベルまたはテイントの名前。 string (必須)
価値 ラベルまたはテイントの値。 string (必須)

L2NetworkAttachmentConfiguration (L2ネットワーク添付ファイル設定)

名前 形容 価値
ネットワークID 添付ファイル用に構成されているネットワークのリソース ID。 string (必須)
プラグインタイプ Kubernetes クラスターでこのネットワークがどのように利用されるかを示すインジケーター。 「DPDK」
「IPVLAN」
「MACVLAN」
「OSDevice」
「スリオフ」

L2ServiceLoadBalancerConfiguration (L2サービスロードバランサー設定)

名前 形容 価値
ipAddressPools ロード バランサー サービスに割り当てることができる IP アドレスのプールの一覧。 IpAddressPool[]

L3NetworkAttachmentConfiguration (L3ネットワーク添付ファイル設定)

名前 形容 価値
ipam対応 このネットワークが IP アドレス管理を実行し、接続時に IP アドレスを割り当てるかどうかを示します。
「本当」
ネットワークID 添付ファイル用に構成されているネットワークのリソース ID。 string (必須)
プラグインタイプ Kubernetes クラスターでこのネットワークがどのように利用されるかを示すインジケーター。 「DPDK」
「IPVLAN」
「MACVLAN」
「OSDevice」
「スリオフ」

ManagedResourceGroupConfiguration (管理リソースグループ構成)

名前 形容 価値
位置 マネージド リソース グループの場所。 指定しない場合は、親リソースの場所が選択されます。 文字列
名前 マネージド リソース グループの名前。 指定しない場合、一意の名前が自動的に生成されます。

制約:
最大長 = 75

ネットワーク構成

名前 形容 価値
attachedNetworkConfiguration (接続ネットワーク構成) この Kubernetes クラスターで実行されるワークロードで使用するためにクラスターに接続されているネットワークの構成。 AttachedNetworkConfiguration (アタッチされたネットワーク構成)
bgpServiceLoadBalancerConfiguration この Kubernetes クラスターの BGP サービス ロード バランサーの構成。 最大 1 つのサービス ロード バランサー (レイヤー 2 または BGP) を指定できます。 BgpServiceLoadBalancerConfiguration の
cloudServicesNetworkId(クラウドサービスネットワークID) 関連付けられている Cloud Services ネットワークのリソース ID。 string (必須)
cniNetworkIdの コンテナー ネットワーク インターフェイス ネットワークの作成に使用されるレイヤー 3 ネットワークのリソース ID。 string (必須)
dnsServiceIpの Kubernetes DNS サービスに割り当てられた IP アドレス。 これは、サービス CIDR で指定された Kubernetes サービス アドレス範囲内にある必要があります。 文字列
l2ServiceLoadBalancerConfiguration この Kubernetes クラスターのレイヤー 2 サービス ロード バランサーの構成。 最大 1 つのサービス ロード バランサー (レイヤー 2 または BGP) を指定できます。 L2ServiceLoadBalancerConfiguration の
ポッドシドル ポッド IP の割り当て元となる CIDR 表記 IP 範囲。 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 文字列[]
サービスシドル サービス IP の割り当て元となる CIDR 表記 IP 範囲。 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 文字列[]

サービスロードバランサーBgpPeer

名前 形容 価値
bfd有効 この BgpPeer の BFD 有効化のインジケーター。
「本当」
bgpマルチホップ マルチホップ ピアリングのサポートを有効にするインジケーター。
「本当」
ホールドタイム フィールドは非推奨です。 このフィールドは以前は省略可能でしたが、現在は動作が定義されていないため、無視されます。 要求された BGP 保留時間の値。 このフィールドでは、ISO 8601 期間形式 (P1H など) が使用されます。 文字列
キープアライブタイム フィールドは非推奨です。 このフィールドは以前は省略可能でしたが、現在は動作が定義されていないため、無視されます。 要求された BGP キープアライブ時間の値。 このフィールドでは、ISO 8601 期間形式 (P1H など) が使用されます。 文字列
myAsnさん BGP セッションのローカル終了に使用される自律システム番号。 int

制約:
最小値 = 0
最大値 = 4294967295
名前 BGP アドバタイズメントとの関連付けにこの BGP ピアを識別するために使用される名前。

制約:
パターン = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (必須)
パスワード TCP MD5 認証セッションを適用するルーターの認証パスワード。

制約:
最大長 = 80
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
パターン = ^[a-zA-Z0-9]{0,80}$
ピアアドレス この BGP セッションの接続に使用される IPv4 または IPv6 アドレス。 string (必須)
peerAsn さん BGP セッションのリモート終了から予期される自律システム番号。 int

制約:
最小値 = 0
最大値 = 4294967295 (必須)
ピアポート この BGP セッションの接続に使用されるポート。 整数 (int)

SshPublicKey (英語)

名前 形容 価値
キーデータ SSH 公開キー データ。

制約:
最小長 = 1 (必須)

追跡リソースタグ

名前 形容 価値

TrunkedNetworkAttachmentConfiguration

名前 形容 価値
ネットワークID 添付ファイル用に構成されているネットワークのリソース ID。 string (必須)
プラグインタイプ Kubernetes クラスターでこのネットワークがどのように利用されるかを示すインジケーター。 「DPDK」
「IPVLAN」
「MACVLAN」
「OSDevice」
「スリオフ」

使用例

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

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

  • リソース グループ

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

リソースの形式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.NetworkCloud/kubernetesClusters@2026-01-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      aadConfiguration = {
        adminGroupObjectIds = [
          "string"
        ]
      }
      administratorConfiguration = {
        adminUsername = "string"
        sshPublicKeys = [
          {
            keyData = "string"
          }
        ]
      }
      controlPlaneNodeConfiguration = {
        administratorConfiguration = {
          adminUsername = "string"
          sshPublicKeys = [
            {
              keyData = "string"
            }
          ]
        }
        availabilityZones = [
          "string"
        ]
        count = int
        vmSkuName = "string"
      }
      initialAgentPoolConfigurations = [
        {
          administratorConfiguration = {
            adminUsername = "string"
            sshPublicKeys = [
              {
                keyData = "string"
              }
            ]
          }
          agentOptions = {
            hugepagesCount = int
            hugepagesSize = "string"
          }
          attachedNetworkConfiguration = {
            l2Networks = [
              {
                networkId = "string"
                pluginType = "string"
              }
            ]
            l3Networks = [
              {
                ipamEnabled = "string"
                networkId = "string"
                pluginType = "string"
              }
            ]
            trunkedNetworks = [
              {
                networkId = "string"
                pluginType = "string"
              }
            ]
          }
          availabilityZones = [
            "string"
          ]
          count = int
          labels = [
            {
              key = "string"
              value = "string"
            }
          ]
          mode = "string"
          name = "string"
          taints = [
            {
              key = "string"
              value = "string"
            }
          ]
          upgradeSettings = {
            drainTimeout = int
            maxSurge = "string"
            maxUnavailable = "string"
          }
          vmSkuName = "string"
        }
      ]
      kubernetesVersion = "string"
      managedResourceGroupConfiguration = {
        location = "string"
        name = "string"
      }
      networkConfiguration = {
        attachedNetworkConfiguration = {
          l2Networks = [
            {
              networkId = "string"
              pluginType = "string"
            }
          ]
          l3Networks = [
            {
              ipamEnabled = "string"
              networkId = "string"
              pluginType = "string"
            }
          ]
          trunkedNetworks = [
            {
              networkId = "string"
              pluginType = "string"
            }
          ]
        }
        bgpServiceLoadBalancerConfiguration = {
          bgpAdvertisements = [
            {
              advertiseToFabric = "string"
              communities = [
                "string"
              ]
              ipAddressPools = [
                "string"
              ]
              peers = [
                "string"
              ]
            }
          ]
          bgpPeers = [
            {
              bfdEnabled = "string"
              bgpMultiHop = "string"
              holdTime = "string"
              keepAliveTime = "string"
              myAsn = int
              name = "string"
              password = "string"
              peerAddress = "string"
              peerAsn = int
              peerPort = int
            }
          ]
          fabricPeeringEnabled = "string"
          ipAddressPools = [
            {
              addresses = [
                "string"
              ]
              autoAssign = "string"
              name = "string"
              onlyUseHostIps = "string"
            }
          ]
        }
        cloudServicesNetworkId = "string"
        cniNetworkId = "string"
        dnsServiceIp = "string"
        l2ServiceLoadBalancerConfiguration = {
          ipAddressPools = [
            {
              addresses = [
                "string"
              ]
              autoAssign = "string"
              name = "string"
              onlyUseHostIps = "string"
            }
          ]
        }
        podCidrs = [
          "string"
        ]
        serviceCidrs = [
          "string"
        ]
      }
    }
  }
}

プロパティ値

Microsoft.NetworkCloud/kubernetesClusters (Kubernetes クラスター)

名前 形容 価値
拡張ロケーション 資源の広がった位置。 この性質はリソース作成時に必要です。 AzureResourceManagerCommonTypesExtendedLocation (required)
位置 リソースが存在する地理的な場所 string (必須)
名前 リソース名

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (必須)
プロパティ リソースのプロパティの一覧。 KubernetesClusterProperties (必須)
タグ リソース タグ タグ名と値のディクショナリ。
リソースの種類 「Microsoft.NetworkCloud/kubernetesClusters@2026-01-01-preview」

アードコンフィグレーション

名前 形容 価値
adminGroupObjectIds(管理者グループオブジェクトIDS) Kubernetes クラスターで管理ロールを持つ Azure Active Directory グループ オブジェクト ID の一覧。 string[] (必須)

管理者構成

名前 形容 価値
管理者ユーザー名 Kubernetes ノードを実行するオペレーティング システムに適用される管理者のユーザー名。 指定しない場合は、サービスによってユーザー名が選択されます。 文字列
sshPublicKeys(sshPublicKeys) Kubernetes クラスター内のノードを実行するオペレーティング システムの SSH 構成。 場合によっては、作業環境を生成するために公開キーの指定が必要になる場合があります。 SshPublicKey[]

エージェントオプション

名前 形容 価値
hugepagesCount 割り当てる hugepage の数。 int (必須)
巨大なページサイズ 割り当てる hugepage のサイズ。 「1G」
「2M」

AgentPoolアップグレード設定

名前 形容 価値
ドレインタイムアウト エージェント プールのアップグレードに進む前にノードドレインが完了するまでに許容される最大時間 (秒)。 作成時に指定しない場合は、1800 秒の値が使用されます。 int

制約:
最小値 = 60
最大値 = 86400
マックスサージ アップグレード中に急増したノードの最大数または割合。 これは、整数 (例: '5') またはパーセンテージ (例: '50%') に設定できます。 パーセンテージを指定すると、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージになります。 パーセンテージの場合、小数部のノードは切り上げられます。 作成時に指定しない場合は、値 1 が使用されます。 MaxSurge と MaxUnavailable の 1 つが 0 より大きい必要があります。 文字列
max利用不可 アップグレード中に使用できないノードの最大数または割合。 これは、整数 (例: '5') またはパーセンテージ (例: '50%') に設定できます。 パーセンテージを指定すると、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージになります。 パーセンテージの場合、小数部のノードは切り上げられます。 作成時に指定しない場合は、値 0 が使用されます。 MaxSurge と MaxUnavailable の 1 つが 0 より大きい必要があります。 文字列

AttachedNetworkConfiguration (アタッチされたネットワーク構成)

名前 形容 価値
l2Networks レイヤー 2 ネットワークと添付ファイルの関連構成の一覧。 L2NetworkAttachmentConfiguration[]
l3Networks レイヤー 3 ネットワークと添付ファイルの関連する構成の一覧。 L3NetworkAttachmentConfiguration[]
trunkedNetworks トランクされたネットワークと添付ファイルの関連する構成の一覧。 TrunkedNetworkAttachmentConfiguration[]

AzureResourceManagerCommonTypesExtendedLocation

名前 形容 価値
名前 拡張された場所の名前。 string (必須)
拡張された場所の種類。 「カスタムロケーション」
'EdgeZone' (必須)

Bgp広告

名前 形容 価値
advertiseToFabric(アドバタイトファブリック) このアドバタイズが、ネットワーク クラウド クラスターに関連付けられているネットワーク ファブリックにも行われるかどうかを示すインジケーター。 fabricPeeringEnabled が False に設定されている場合、このフィールドは無視されます。
「本当」
コミュニティ 1234:1234 形式の BGP コミュニティ文字列を使用して、アナウンスに関連付ける BGP コミュニティの名前。 文字列[]
ipAddressPools このお知らせに関連付けられている IP アドレス プールの名前。 string[] (必須)
仲間 このアドバタイズを制限する BGP ピアの名前。 値が指定されていない場合、すべての BGP ピアがこのアドバタイズを受信します。 文字列[]

BgpServiceLoadBalancerConfiguration (BgpServiceLoadBalancerConfiguration)

名前 形容 価値
bgp広告 IP アドレス プールをコミュニティとピアに関連付け、IP の発表を可能にします。 Bgp広告[]
bgpピアーズ Kubernetes クラスターがピアリングする追加の BgpPeer エンティティの一覧。 すべてのピアリングを明示的に定義する必要があります。 サービスロードバランサーBgpPeer[]
ファブリックピアリング対応 ロード バランサーがネットワーク ファブリックとピアリングするかどうかを指定するインジケーター。
「本当」
ipAddressPools ロード バランサー サービスに割り当てることができる IP アドレスのプールの一覧。 IpAddressPool[]

ControlPlaneNodeConfiguration (コントロールプレーンノード構成)

名前 形容 価値
管理者設定 コントロール プレーン内のノードに使用する管理者資格情報。 管理者構成
可用性ゾーン コントロール プレーン内のノードのプロビジョニングに使用するネットワーク クラウド クラスターの可用性ゾーンの一覧。 指定しない場合は、すべての可用性ゾーンが使用されます。 文字列[]
数える この構成を使用する仮想マシンの数。 int

制約:
最小値 = 1 (必須)
vmSkuName さん 作成時に指定された VM SKU の名前。 string (必須)

InitialAgentPoolConfiguration (初期エージェントプール構成)

名前 形容 価値
管理者設定 このエージェント プール内のノードに使用する管理者の資格情報。 管理者構成
agentOptions (エージェントオプション) このエージェント プール内の各エージェントに適用される構成。 エージェントオプション
attachedNetworkConfiguration (接続ネットワーク構成) この Kubernetes クラスターで実行されるワークロードで使用するためにエージェント プールに接続されているネットワークの構成。 AttachedNetworkConfiguration (アタッチされたネットワーク構成)
可用性ゾーン このエージェント プール内のノードのプロビジョニングに使用されるネットワーク クラウド クラスターの可用性ゾーンの一覧。 指定しない場合は、すべての可用性ゾーンが使用されます。 文字列[]
数える この構成を使用する仮想マシンの数。 int (必須)
ラベル このエージェント プール内のノードに適用されるラベル。 Kubernetesラベル[]
モード このエージェント プールをシステム プールまたはユーザー プールとして使用する方法の選択。 システム プールは Kubernetes クラスターの機能と重要なサービスを実行しますが、ユーザー プールはユーザー ワークロード専用です。 すべての Kubernetes クラスターには、少なくとも 1 つのノードを含む少なくとも 1 つのシステム ノード プールが含まれている必要があります。 「該当なし」
「システム」
'User' (必須)
名前 このエージェント プールを表すエージェント プール リソースに使用される名前。

制約:
パターン = ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ (必須)
汚染 このエージェント プール内のノードに適用されるテイント。 Kubernetesラベル[]
upgradeSettings (アップグレード設定) エージェント プールの構成。 AgentPoolアップグレード設定
vmSkuName さん ノード VM に割り当てられたリソースのサイズを決定する VM SKU の名前。 string (必須)

IpAddressPool (英語)

名前 形容 価値
アドレス IP アドレス範囲の一覧。 各範囲には、CIDR 形式のサブネットまたは IP アドレスの明示的な開始範囲を指定できます。 BGP サービス ロード バランサーの構成では、CIDR 形式のみがサポートされ、/32 (IPv4) プレフィックスと /128 (IPv6) プレフィックスは除外されます。 string[] (必須)
自動割り当て プールからの自動割り当てが行われるかどうかを判断するインジケーター。
「本当」
名前 BGP アドバタイズメントとの関連付けにこの IP アドレス プールを識別するために使用される名前。

制約:
パターン = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (必須)
onlyUseHostIps (ホストイプスを使用) このプールで .0 と .255 で終わる IP アドレスの使用を防ぐためのインジケーター。 このオプションを有効にすると、.1 から .254 までの間の IP アドレスのみが使用されます。
「本当」

KubernetesClusterProperties の

名前 形容 価値
aad設定 Azure Active Directory 統合プロパティ。 アードコンフィグレーション
管理者設定 コントロール プレーンと、独自の値を指定しないエージェント プール ノードに適用される管理資格情報。 管理者構成
controlPlaneNodeConfiguration この Kubernetes クラスターのコントロール プレーンの定義特性。 ControlPlaneNodeConfiguration (必須)
initialAgentPoolConfigurationsの 重要なシステム サービスとワークロードを実行するために、この Kubernetes クラスターで作成されたエージェント プール。 このフィールドのこのデータは作成時にのみ使用され、Kubernetes クラスターの作成後、フィールドは空になります。 作成後、エージェント プールの管理は agentPools サブリソースを使用して行われます。 InitialAgentPoolConfiguration[] (必須)
kubernetesバージョン このクラスターの Kubernetes バージョン。 string (必須)
managedResourceGroupConfiguration リソースに関連付けられているマネージド リソース グループの構成。 ManagedResourceGroupConfiguration の
ネットワーク構成 Kubernetes クラスター ネットワークの構成 (クラスターにまたがるネットワークの添付ファイルを含む)。 NetworkConfiguration (必須)

Kubernetesラベル

名前 形容 価値
キー ラベルまたはテイントの名前。 string (必須)
価値 ラベルまたはテイントの値。 string (必須)

L2NetworkAttachmentConfiguration (L2ネットワーク添付ファイル設定)

名前 形容 価値
ネットワークID 添付ファイル用に構成されているネットワークのリソース ID。 string (必須)
プラグインタイプ Kubernetes クラスターでこのネットワークがどのように利用されるかを示すインジケーター。 「DPDK」
「IPVLAN」
「MACVLAN」
「OSDevice」
「スリオフ」

L2ServiceLoadBalancerConfiguration (L2サービスロードバランサー設定)

名前 形容 価値
ipAddressPools ロード バランサー サービスに割り当てることができる IP アドレスのプールの一覧。 IpAddressPool[]

L3NetworkAttachmentConfiguration (L3ネットワーク添付ファイル設定)

名前 形容 価値
ipam対応 このネットワークが IP アドレス管理を実行し、接続時に IP アドレスを割り当てるかどうかを示します。
「本当」
ネットワークID 添付ファイル用に構成されているネットワークのリソース ID。 string (必須)
プラグインタイプ Kubernetes クラスターでこのネットワークがどのように利用されるかを示すインジケーター。 「DPDK」
「IPVLAN」
「MACVLAN」
「OSDevice」
「スリオフ」

ManagedResourceGroupConfiguration (管理リソースグループ構成)

名前 形容 価値
位置 マネージド リソース グループの場所。 指定しない場合は、親リソースの場所が選択されます。 文字列
名前 マネージド リソース グループの名前。 指定しない場合、一意の名前が自動的に生成されます。

制約:
最大長 = 75

ネットワーク構成

名前 形容 価値
attachedNetworkConfiguration (接続ネットワーク構成) この Kubernetes クラスターで実行されるワークロードで使用するためにクラスターに接続されているネットワークの構成。 AttachedNetworkConfiguration (アタッチされたネットワーク構成)
bgpServiceLoadBalancerConfiguration この Kubernetes クラスターの BGP サービス ロード バランサーの構成。 最大 1 つのサービス ロード バランサー (レイヤー 2 または BGP) を指定できます。 BgpServiceLoadBalancerConfiguration の
cloudServicesNetworkId(クラウドサービスネットワークID) 関連付けられている Cloud Services ネットワークのリソース ID。 string (必須)
cniNetworkIdの コンテナー ネットワーク インターフェイス ネットワークの作成に使用されるレイヤー 3 ネットワークのリソース ID。 string (必須)
dnsServiceIpの Kubernetes DNS サービスに割り当てられた IP アドレス。 これは、サービス CIDR で指定された Kubernetes サービス アドレス範囲内にある必要があります。 文字列
l2ServiceLoadBalancerConfiguration この Kubernetes クラスターのレイヤー 2 サービス ロード バランサーの構成。 最大 1 つのサービス ロード バランサー (レイヤー 2 または BGP) を指定できます。 L2ServiceLoadBalancerConfiguration の
ポッドシドル ポッド IP の割り当て元となる CIDR 表記 IP 範囲。 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 文字列[]
サービスシドル サービス IP の割り当て元となる CIDR 表記 IP 範囲。 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 文字列[]

サービスロードバランサーBgpPeer

名前 形容 価値
bfd有効 この BgpPeer の BFD 有効化のインジケーター。
「本当」
bgpマルチホップ マルチホップ ピアリングのサポートを有効にするインジケーター。
「本当」
ホールドタイム フィールドは非推奨です。 このフィールドは以前は省略可能でしたが、現在は動作が定義されていないため、無視されます。 要求された BGP 保留時間の値。 このフィールドでは、ISO 8601 期間形式 (P1H など) が使用されます。 文字列
キープアライブタイム フィールドは非推奨です。 このフィールドは以前は省略可能でしたが、現在は動作が定義されていないため、無視されます。 要求された BGP キープアライブ時間の値。 このフィールドでは、ISO 8601 期間形式 (P1H など) が使用されます。 文字列
myAsnさん BGP セッションのローカル終了に使用される自律システム番号。 int

制約:
最小値 = 0
最大値 = 4294967295
名前 BGP アドバタイズメントとの関連付けにこの BGP ピアを識別するために使用される名前。

制約:
パターン = ^[a-z0-9]([a-z0-9.-]{0,61}[a-z0-9]){0,1}$ (必須)
パスワード TCP MD5 認証セッションを適用するルーターの認証パスワード。

制約:
最大長 = 80
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
パターン = ^[a-zA-Z0-9]{0,80}$
ピアアドレス この BGP セッションの接続に使用される IPv4 または IPv6 アドレス。 string (必須)
peerAsn さん BGP セッションのリモート終了から予期される自律システム番号。 int

制約:
最小値 = 0
最大値 = 4294967295 (必須)
ピアポート この BGP セッションの接続に使用されるポート。 整数 (int)

SshPublicKey (英語)

名前 形容 価値
キーデータ SSH 公開キー データ。

制約:
最小長 = 1 (必須)

追跡リソースタグ

名前 形容 価値

TrunkedNetworkAttachmentConfiguration

名前 形容 価値
ネットワークID 添付ファイル用に構成されているネットワークのリソース ID。 string (必須)
プラグインタイプ Kubernetes クラスターでこのネットワークがどのように利用されるかを示すインジケーター。 「DPDK」
「IPVLAN」
「MACVLAN」
「OSDevice」
「スリオフ」