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」 「スリオフ」 |