Machines - Create Or Update

サービス:: AKS

API バージョン:: 2026-01-02-preview

指定したエージェントプール内のマシンを作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/machines/{machineName}?api-version=2026-01-02-preview

URI パラメーター

名前	/	必須	型	説明
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	エージェントプールの名前。
machineName	path	True	string pattern: ^[a-z][a-z0-9]{0,11}$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,39}$	マシンのホスト名。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	管理対象クラスター・リソースの名前。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求ヘッダー

名前	必須	型	説明
if-match		string	要求は、エンティティがこの文字列と一致する場合にのみ続行する必要があります。
if-none-match		string	要求は、この文字列に一致するエンティティがない場合にのみ続行する必要があります。

要求本文

名前	型	説明
properties	MachineProperties	マシンのプロパティ

応答

名前	型	説明
200 OK	Machine	リソース「マシン」更新操作が成功しました
201 Created	Machine	リソース「マシン」作成操作成功ヘッダー Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	予期しないエラー応答。

名前

型

説明

200 OK

Machine

リソース「マシン」更新操作が成功しました

201 Created

Machine

リソース「マシン」作成操作成功

ヘッダー

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

Create/Update Machine

要求のサンプル

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1?api-version=2026-01-02-preview

{
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "tags": {
      "name1": "val1"
    }
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-containerservice
# USAGE
    python machine_create_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerServiceClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.machines.begin_create_or_update(
        resource_group_name="rg1",
        resource_name="clustername1",
        agent_pool_name="agentpool1",
        machine_name="machine1",
        parameters={
            "properties": {
                "hardware": {"vmSize": "Standard_DS1_v2"},
                "kubernetes": {
                    "kubeletDiskType": "OS",
                    "maxPods": 110,
                    "nodeLabels": {"key1": "val1"},
                    "nodeTaints": ["Key1=Value1:NoSchedule"],
                    "orchestratorVersion": "1.30",
                },
                "mode": "User",
                "operatingSystem": {"enableFIPS": False, "osSKU": "Ubuntu", "osType": "Linux"},
                "priority": "Spot",
                "tags": {"name1": "val1"},
            }
        },
    ).result()
    print(response)


# x-ms-original-file: 2026-01-02-preview/MachineCreate_Update.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcontainerservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerservice/armcontainerservice/v9"
)

// Generated from example definition: 2026-01-02-preview/MachineCreate_Update.json
func ExampleMachinesClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcontainerservice.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewMachinesClient().BeginCreateOrUpdate(ctx, "rg1", "clustername1", "agentpool1", "machine1", armcontainerservice.Machine{
		Properties: &armcontainerservice.MachineProperties{
			Hardware: &armcontainerservice.MachineHardwareProfile{
				VMSize: to.Ptr("Standard_DS1_v2"),
			},
			Kubernetes: &armcontainerservice.MachineKubernetesProfile{
				KubeletDiskType: to.Ptr(armcontainerservice.KubeletDiskTypeOS),
				MaxPods:         to.Ptr[int32](110),
				NodeLabels: map[string]*string{
					"key1": to.Ptr("val1"),
				},
				NodeTaints: []*string{
					to.Ptr("Key1=Value1:NoSchedule"),
				},
				OrchestratorVersion: to.Ptr("1.30"),
			},
			Mode: to.Ptr(armcontainerservice.AgentPoolModeUser),
			OperatingSystem: &armcontainerservice.MachineOSProfile{
				EnableFIPS: to.Ptr(false),
				OSSKU:      to.Ptr(armcontainerservice.OSSKUUbuntu),
				OSType:     to.Ptr(armcontainerservice.OSTypeLinux),
			},
			Priority: to.Ptr(armcontainerservice.ScaleSetPrioritySpot),
			Tags: map[string]*string{
				"name1": to.Ptr("val1"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armcontainerservice.MachinesClientCreateOrUpdateResponse{
	// 	Machine: &armcontainerservice.Machine{
	// 		Name: to.Ptr("machine1"),
	// 		Type: to.Ptr("Microsoft.ContainerService/managedClusters/agentPools/machines"),
	// 		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1"),
	// 		Properties: &armcontainerservice.MachineProperties{
	// 			Hardware: &armcontainerservice.MachineHardwareProfile{
	// 				VMSize: to.Ptr("Standard_DS1_v2"),
	// 			},
	// 			Kubernetes: &armcontainerservice.MachineKubernetesProfile{
	// 				CurrentOrchestratorVersion: to.Ptr("1.30.6"),
	// 				KubeletDiskType: to.Ptr(armcontainerservice.KubeletDiskTypeOS),
	// 				MaxPods: to.Ptr[int32](110),
	// 				NodeLabels: map[string]*string{
	// 					"key1": to.Ptr("val1"),
	// 				},
	// 				NodeName: to.Ptr("aks-nodepool1-machine1-25481572-vm0"),
	// 				NodeTaints: []*string{
	// 					to.Ptr("Key1=Value1:NoSchedule"),
	// 				},
	// 				OrchestratorVersion: to.Ptr("1.30"),
	// 			},
	// 			Mode: to.Ptr(armcontainerservice.AgentPoolModeUser),
	// 			NodeImageVersion: to.Ptr("AKSUbuntu:1604:2023.03.11"),
	// 			OperatingSystem: &armcontainerservice.MachineOSProfile{
	// 				EnableFIPS: to.Ptr(false),
	// 				OSSKU: to.Ptr(armcontainerservice.OSSKUUbuntu),
	// 				OSType: to.Ptr(armcontainerservice.OSTypeLinux),
	// 			},
	// 			Priority: to.Ptr(armcontainerservice.ScaleSetPrioritySpot),
	// 			ProvisioningState: to.Ptr("Succeeded"),
	// 			Status: &armcontainerservice.MachineStatus{
	// 				CreationTimestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2025-04-02T12:00:00Z"); return t}()),
	// 				DriftAction: to.Ptr(armcontainerservice.DriftActionSynced),
	// 				VMState: to.Ptr(armcontainerservice.VMStateRunning),
	// 			},
	// 			Tags: map[string]*string{
	// 				"name1": to.Ptr("val1"),
	// 			},
	// 		},
	// 		Zones: []*string{
	// 			to.Ptr("1"),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

{
  "name": "machine1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools/machines",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1",
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "currentOrchestratorVersion": "1.30.6",
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeName": "aks-nodepool1-machine1-25481572-vm0",
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "nodeImageVersion": "AKSUbuntu:1604:2023.03.11",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "provisioningState": "Succeeded",
    "status": {
      "creationTimestamp": "2025-04-02T12:00:00Z",
      "driftAction": "Synced",
      "vmState": "Running"
    },
    "tags": {
      "name1": "val1"
    }
  },
  "zones": [
    "1"
  ]
}

状態コード:: 201

{
  "name": "machine1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools/machines",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1",
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "currentOrchestratorVersion": "1.30.6",
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeName": "aks-nodepool1-machine1-25481572-vm0",
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "nodeImageVersion": "AKSUbuntu:1604:2023.03.11",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "provisioningState": "Creating",
    "status": {
      "creationTimestamp": "2025-04-02T12:00:00Z",
      "driftAction": "Synced",
      "vmState": "Running"
    },
    "tags": {
      "name1": "val1"
    }
  },
  "zones": [
    "1"
  ]
}

定義

名前	説明
AgentPoolArtifactStreamingProfile	エージェントプール用のアーティファクトストリーミングプロファイル。
AgentPoolMode	エージェントプールのモード。クラスターには、常に少なくとも 1 つの "システム" エージェントプールが必要です。エージェントプールの制限とベストプラクティスの詳細については、「https://docs.microsoft.com/azure/aks/use-system-pools」を参照してください。
AgentPoolSSHAccess	エージェントプールのSSH accessメソッド。
AgentPoolWindowsProfile	Windows エージェントプールの特定のプロファイル。
createdByType	リソースを作成した ID の種類。
DriftAction	機械のドリフト動作。管理対象クラスタのプロパティの変更により、マシンが予期された状態から逸脱し、修正アクションが必要かどうかを示します。
DriverType	Windows エージェントプールの作成時にインストールする GPU ドライバーの種類を指定します。指定しない場合、AKS はシステムの互換性に基づいてドライバーを選択します。これは、AgentPool が作成された後は変更できません。これは Linux AgentPools では設定できません。 Linux AgentPools の場合、ドライバーはシステムの互換性に基づいて選択されます。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
GPUDriver	GPU ドライバーをインストールするかどうか。指定されていない場合、既定値は Install です。
GPUInstanceProfile	サポートされている GPU VM SKU の GPU MIG インスタンスプロファイルを指定するために使用される GPUInstanceProfile。
GPUProfile	エージェントプールの GPU 設定。
IPFamily	アドレスが IPv4 ファミリまたは IPv6 ファミリのどちらに属しているかを判断するには
IPTag	オブジェクトに関連付けられている IPTag を格納します。
KubeletConfig	エージェントノードの Kubelet 構成。詳細については、AKS カスタムノード構成を参照してください。
KubeletDiskType	emptyDir ボリュームの配置、コンテナランタイムデータのルート、Kubelet ephemeral storage の配置を決定します。
LinuxOSConfig	Linux エージェントノードの OS 構成。詳細については、AKS カスタムノード構成を参照してください。
LocalDNSForwardDestination	localDNS から転送される DNS クエリの宛先サーバー。
LocalDNSForwardPolicy	アップストリーム DNS サーバーを選択するための転送ポリシー。詳細については、フォワードプラグインを参照してください。
LocalDNSMode	localDNS の有効化モード。
LocalDNSOverride	localDNS プロファイルをオーバーライドします。
LocalDNSProfile	ノードごとのローカル DNS を VnetDNS と KubeDNS のオーバーライドを使用して構成します。 LocalDNS は、AKS クラスターでの DNS 解決のパフォーマンスと信頼性を向上させるのに役立ちます。詳細については、「aka.ms/aks/localdns」を参照してください。
LocalDNSProtocol	TCPを強制するか、localDNSからアップストリームDNSサーバーへの接続にUDPプロトコルを優先します。
LocalDNSQueryLogging	localDNS の DNS クエリのログレベル。
LocalDNSServeStale	古いデータを提供するためのポリシー。詳細については、キャッシュプラグインを参照してください。
LocalDNSState	localDNS のシステム生成状態。
Machine	機械です。基になる仮想マシンに関する詳細が含まれています。マシンはここに表示できますが、kubectl get ノードには表示されません。その場合は、マシンがまだ Kubernetes API Server に登録されていない可能性があります。
MachineBillingProfile	機械請求に関するプロパティです。
MachineHardwareProfile	マシンのハードウェアとGPUの設定。
MachineIpAddress	コンピューターの IP アドレスの詳細。
MachineKubernetesProfile	マシンで使用される Kubernetes 構成。
MachineNetworkProperties	マシンのネットワークプロパティ
MachineOSProfile	マシンが使用するオペレーティングシステムとディスク。
MachineOSProfileLinuxProfile	Linux マシンの特定のプロファイル。
MachineProperties	マシンのプロパティ
MachineSecurityProfile	マシンのセキュリティ設定。
MachineStatus	マシンに関する読み取り専用の情報が含まれます。
ManagementMode	マネージドGPU体験は、GPUドライバーの上にData Center GPUマネージャー(DCGM)メトリクスなどの監視用追加コンポーネントをインストールします。インストールされている内容の詳細については、aka.ms/aks/managed-gpu をご覧ください。
MigStrategy	マネージドMIGサポートに使用されるMIG(マルチインスタンスGPU)戦略を設定します。さまざまな戦略についての詳細は aka.ms/aks/managed-gpu をご覧ください。指定されていない場合、デフォルトは「None」となります。
NvidiaGPUProfile	NVIDIA専用GPU設定
OSDiskType	エージェントプール内のマシンに使用する OS ディスクの種類。 VM でサポートされていて、要求された OSDiskSizeGB より大きいキャッシュディスクがある場合、既定値は "エフェメラル" です。それ以外の場合、既定値は 'Managed' です。作成後に変更できない場合があります。詳細については、Ephemeral OSをご覧ください。
OSSKU	エージェントプールで使用される OS SKU を指定します。 OSType が Linux の場合、既定値は Ubuntu です。 OSType が Windows の場合、Kubernetes <= 1.24 の場合は Windows 2019、Kubernetes >= 1.25 の場合は Windows2022 が既定値です。
OSType	オペレーティングシステムの種類。既定値は Linux です。
ScaleSetEvictionPolicy	仮想マシンスケールセットの削除ポリシー。立ち退きポリシーには、VMが立ち退きした際の何to doかが指定されています。デフォルトは [削除] です。立ち退きに関する詳細はspot VMs
ScaleSetPriority	仮想マシンスケールセットの優先順位。
SeccompDefault	すべてのワークロードに適用される既定の seccomp プロファイルを指定します。指定しない場合は、既定で 'Notfined' が使用されます。
SysctlConfig	Linux エージェントノードの Sysctl 設定。
systemData	リソースの作成と最後の変更に関連するメタデータ。
VmState	仮想マシンの状態。基盤となる仮想マシンの現在の状態を示します。
WorkloadRuntime	ノードが実行できるワークロードの種類を決定します。

AgentPoolArtifactStreamingProfile

Object

エージェントプール用のアーティファクトストリーミングプロファイル。

名前	型	説明
enabled	boolean	アーティファクトストリーミングは、オンデマンドのイメージ読み込みを通じてノード上のコンテナーのコールドスタートを高速化します。この機能を使用するには、コンテナーイメージで ACR でのアーティファクトストリーミングも有効にする必要があります。指定しない場合、既定値は false です。

AgentPoolMode

列挙

エージェントプールのモード。クラスターには、常に少なくとも 1 つの "システム" エージェントプールが必要です。エージェントプールの制限とベストプラクティスの詳細については、「https://docs.microsoft.com/azure/aks/use-system-pools」を参照してください。

値	説明
System	システムエージェントプールは、主にCoreDNSやmetrics-serverなどの重要なシステムポッドをホストするためのものです。システムエージェントプールの osType は Linux である必要があります。システムエージェントプール VM SKU には、少なくとも 2vCPU と 4 GB のメモリが必要です。
User	ユーザー・エージェント・プールは、主にアプリケーション・ポッドをホストするためのものです。
Gateway	ゲートウェイ・エージェント・プールは、ポッドに静的エグレス IP を提供することに特化しています。詳細については、 https://aka.ms/aks/static-egress-gatewayを参照してください。
ManagedSystem	ManagedSystem は、AKS によって管理されるシステムプールです。プールはクラスターの使用状況に応じて動的にスケーリングされ、追加の自動監視および修復機能があります。 ManagedSystem プールは 1 つだけ存在できるため、最適なエクスペリエンスを得るために、他のすべてのシステムプールを削除することをお勧めします。
Machines	マシンエージェントプールは、ホストマシン専用です。プールレベルでは、作成や削除などの限られた操作のみが許可されます。マシンAPIを使用して、マシンのライフサイクル全体を管理してください。

AgentPoolSSHAccess

列挙

エージェントプールのSSH accessメソッド。

値	説明
LocalUser	秘密キーを使用してローカルユーザーとしてノードに SSH 接続できます。
Disabled	ノードで SSH サービスがオフになります。
EntraId	EntraId統合によるノードへのSSH接続。詳細については、 https://aka.ms/aks/ssh/aad

AgentPoolWindowsProfile

Object

Windows エージェントプールの特定のプロファイル。

名前	型	説明
disableOutboundNat	boolean	Windows ノードで OutboundNAT を無効にするかどうか。既定値は false です。送信 NAT を無効にできるのは、クラスターの outboundType が NAT ゲートウェイであり、Windows エージェントプールでノードパブリック IP が有効になっていない場合のみです。

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

DriftAction

列挙

機械のドリフト動作。管理対象クラスタのプロパティの変更により、マシンが予期された状態から逸脱し、修正アクションが必要かどうかを示します。

値	説明
Synced	機械は最新の状態です。
Recreate	マシンがドリフトしたため、削除して再作成する必要があります。

DriverType

列挙

Windows エージェントプールの作成時にインストールする GPU ドライバーの種類を指定します。指定しない場合、AKS はシステムの互換性に基づいてドライバーを選択します。これは、AgentPool が作成された後は変更できません。これは Linux AgentPools では設定できません。 Linux AgentPools の場合、ドライバーはシステムの互換性に基づいて選択されます。

値	説明
GRID	仮想化サポートを必要とするアプリケーションに適した GPU 用の GRID ドライバーをインストールします。
CUDA	科学コンピューティングやデータ集約型アプリケーションの計算タスクに最適化されたGPU用のCUDAドライバーをインストールします。

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

GPUDriver

列挙

GPU ドライバーをインストールするかどうか。指定されていない場合、既定値は Install です。

値	説明
Install	ドライバをインストールします。
None	ドライバーのインストールをスキップします。

GPUInstanceProfile

列挙

サポートされている GPU VM SKU の GPU MIG インスタンスプロファイルを指定するために使用される GPUInstanceProfile。

値	説明
MIG1g	MIG 1g GPUインスタンスプロファイル。
MIG2g	MIG 2G GPUインスタンスプロファイル。
MIG3g	MIG 3G GPUインスタンスプロファイル。
MIG4g	MIG 4G GPUインスタンスプロファイル。
MIG7g	MIG 7g GPUインスタンスプロファイル。

GPUProfile

Object

エージェントプールの GPU 設定。

名前	型	説明
driver	GPUDriver	GPU ドライバーをインストールするかどうか。指定されていない場合、既定値は Install です。
driverType	DriverType	Windows エージェントプールの作成時にインストールする GPU ドライバーの種類を指定します。指定しない場合、AKS はシステムの互換性に基づいてドライバーを選択します。これは、AgentPool が作成された後は変更できません。これは Linux AgentPools では設定できません。 Linux AgentPools の場合、ドライバーはシステムの互換性に基づいて選択されます。
nvidia	NvidiaGPUProfile	NVIDIA専用のGPU設定。

IPFamily

列挙

アドレスが IPv4 ファミリまたは IPv6 ファミリのどちらに属しているかを判断するには

値	説明
IPv4	IPv4 ファミリ
IPv6	IPv6 ファミリ

IPTag

Object

オブジェクトに関連付けられている IPTag を格納します。

名前	型	説明
ipTagType	string	IP タグの種類。例: RoutingPreference。
tag	string	パブリック IP に関連付けられている IP タグの値。例: インターネット。

KubeletConfig

Object

エージェントノードの Kubelet 構成。詳細については、AKS カスタムノード構成を参照してください。

名前	型	説明
allowedUnsafeSysctls	string[]	安全でない sysctl または安全でない sysctl パターンの許可されたリスト ( `*`で終わる)。
containerLogMaxFiles	integer (int32) minimum: 2	コンテナーに存在できるコンテナーログファイルの最大数。数値は 2 ≥する必要があります。
containerLogMaxSizeMB	integer (int32)	ローテーション前のコンテナーログファイルの最大サイズ (10Mi など)。
cpuCfsQuota	boolean	CPU 制限を指定するコンテナーに対して CPU CFS クォータの適用が有効になっている場合。既定値は true です。
cpuCfsQuotaPeriod	string	CPU CFS クォータ期間の値。既定値は '100 ミリ秒' です。有効な値は、省略可能な分数と単位サフィックスを持つ 10 進数のシーケンスです。例: '300ms'、'2h45m'。サポートされるユニットは、'ns'、'us'、'ms'、's'、'm'、および 'h' です。
cpuManagerPolicy	string	使用する CPU マネージャーポリシー。既定値は 'none' です。詳細については、 Kubernetes CPU 管理ポリシーを参照してください。使用できる値は 'none' と 'static' です。
failSwapOn	boolean	true に設定すると、ノードでスワップが有効になっている場合、Kubelet の起動に失敗します。
imageGcHighThreshold	integer (int32)	イメージガベージコレクションが常に実行された後のディスク使用率。イメージガベージコレクションを無効にするには、100 に設定します。既定値は 85%
imageGcLowThreshold	integer (int32)	イメージガベージコレクションが実行されない前のディスク使用率。 imageGcHighThreshold より高く設定することはできません。既定値は 80%
podMaxPids	integer (int32)	ポッドあたりのプロセスの最大数。
seccompDefault	SeccompDefault	すべてのワークロードに適用される既定の seccomp プロファイルを指定します。指定しない場合は、既定で 'Notfined' が使用されます。
topologyManagerPolicy	string	使用するトポロジマネージャーポリシー。詳細については、「 Kubernetes Topology Manager」を参照してください。既定値は 'none' です。使用できる値は、'none'、'best-effort'、'restricted'、および 'single-numa-node' です。

KubeletDiskType

列挙

emptyDir ボリュームの配置、コンテナランタイムデータのルート、Kubelet ephemeral storage の配置を決定します。

値	説明
OS	Kubeletは、そのデータにOSディスクを使用します。
Temporary	Kubelet は、そのデータに一時ディスクを使用します。

LinuxOSConfig

Object

Linux エージェントノードの OS 構成。詳細については、AKS カスタムノード構成を参照してください。

名前	型	説明
swapFileSizeMB	integer (int32)	各ノードに作成されるスワップファイルのサイズ (MB)。
sysctls	SysctlConfig	Linux エージェントノードの Sysctl 設定。
transparentHugePageDefrag	string	より多くの巨大なページを使用できるように、カーネルがメモリ圧縮を積極的に使用する必要があるかどうか。有効な値は、'always'、'defer'、'defer+madvise'、'madvise' および 'never' です。既定値は 'madvise' です。詳細については、「Transparent Hugepages」を参照してください。
transparentHugePageEnabled	string	透過的な hugepages が有効になっているかどうか。有効な値は、'always'、'madvise'、および 'never' です。既定値は "always" です。詳細については、「Transparent Hugepages」を参照してください。

LocalDNSForwardDestination

列挙

localDNS から転送される DNS クエリの宛先サーバー。

値	説明
ClusterCoreDNS	localDNS からクラスター CoreDNS に DNS クエリを転送します。
VnetDNS	localDNS から VNET で構成された DNS サーバーに DNS クエリを転送します。 VNET には、複数の DNS サーバーを構成できます。

LocalDNSForwardPolicy

列挙

アップストリーム DNS サーバーを選択するための転送ポリシー。詳細については、フォワードプラグインを参照してください。

値	説明
Sequential	アップストリーム DNS サーバーのシーケンシャル選択を実装します。詳細については、フォワードプラグインを参照してください。
RoundRobin	ラウンドロビンアップストリームDNSサーバの選択を実装します。詳細については、フォワードプラグインを参照してください。
Random	ランダムなアップストリーム DNS サーバーの選択を実装します。詳細については、フォワードプラグインを参照してください。

LocalDNSMode

列挙

localDNS の有効化モード。

値	説明
Preferred	現在のオーケストレーターバージョンがこの機能をサポートしている場合は、localDNS を有効にすることをお勧めします。
Required	localDNS を有効にします。
Disabled	localDNS を無効にします。

LocalDNSOverride

Object

localDNS プロファイルをオーバーライドします。

名前	型	規定値	説明
cacheDurationInSeconds	integer (int32)	3600	最大TTLを秒単位でキャッシュします。詳細については、キャッシュプラグインを参照してください。
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	localDNS から転送される DNS クエリの宛先サーバー。
forwardPolicy	LocalDNSForwardPolicy	Sequential	アップストリーム DNS サーバーを選択するための転送ポリシー。詳細については、フォワードプラグインを参照してください。
maxConcurrent	integer (int32)	1000	同時クエリの最大数。詳細については、フォワードプラグインを参照してください。
protocol	LocalDNSProtocol	PreferUDP	TCPを強制するか、localDNSからアップストリームDNSサーバーへの接続にUDPプロトコルを優先します。
queryLogging	LocalDNSQueryLogging	Error	localDNS の DNS クエリのログレベル。
serveStale	LocalDNSServeStale	Immediate	古いデータを提供するためのポリシー。詳細については、キャッシュプラグインを参照してください。
serveStaleDurationInSeconds	integer (int32)	3600	古い時間(秒単位)を提供します。詳細については、キャッシュプラグインを参照してください。

LocalDNSProfile

Object

ノードごとのローカル DNS を VnetDNS と KubeDNS のオーバーライドを使用して構成します。 LocalDNS は、AKS クラスターでの DNS 解決のパフォーマンスと信頼性を向上させるのに役立ちます。詳細については、「aka.ms/aks/localdns」を参照してください。

名前	型	規定値	説明
kubeDNSOverrides	<string, LocalDNSOverride>		KubeDNSのオーバーライドは、dnsPolicy:ClusterFirstを持つポッドからのDNSトラフィック(KubeDNSトラフィックと呼ばれます)に適用されます。
mode	LocalDNSMode	Preferred	localDNS の有効化モード。
state	LocalDNSState		localDNS のシステム生成状態。
vnetDNSOverrides	<string, LocalDNSOverride>		VnetDNS オーバーライドは、dnsPolicy:default または kubelet を持つポッドからの DNS トラフィック (VnetDNS トラフィックと呼ばれます) に適用されます。

LocalDNSProtocol

列挙

TCPを強制するか、localDNSからアップストリームDNSサーバーへの接続にUDPプロトコルを優先します。

値	説明
PreferUDP	localDNS からアップストリーム DNS サーバーへの接続には UDP プロトコルを優先します。
ForceTCP	localDNS からアップストリーム DNS サーバーへの接続に TCP プロトコルを適用します。

LocalDNSQueryLogging

列挙

localDNS の DNS クエリのログレベル。

値	説明
Error	localDNS でのエラーログを有効にします。詳細については、 errors プラグインを参照してください。
Log	localDNS でのクエリログを有効にします。詳細については、 log plugin を参照してください。

LocalDNSServeStale

列挙

古いデータを提供するためのポリシー。詳細については、キャッシュプラグインを参照してください。

値	説明
Verify	古いデータを検証で提供します。まず、期限切れのエントリをクライアントに送信する前に、ソースからエントリがまだ使用できないことを確認します。詳細については、キャッシュプラグインを参照してください。
Immediate	古いデータをすぐに提供します。期限切れのエントリをクライアントに送信してから、エントリがソースから使用可能かどうかを確認します。詳細については、キャッシュプラグインを参照してください。
Disable	古いデータの提供を無効にします。

LocalDNSState

列挙

localDNS のシステム生成状態。

値	説明
Enabled	localDNS が有効になっている場合。
Disabled	localDNS は無効です。

Machine

Object

機械です。基になる仮想マシンに関する詳細が含まれています。マシンはここに表示できますが、kubectl get ノードには表示されません。その場合は、マシンがまだ Kubernetes API Server に登録されていない可能性があります。

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	リソースの名前
properties	MachineProperties	マシンのプロパティ
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"
zones	string[]	マシンが配置されている可用性ゾーン。

MachineBillingProfile

Object

機械請求に関するプロパティです。

名前	型	規定値	説明
spotMaxPrice	number (float)	-1	スポットインスタンスに対して支払う最大価格 (米ドル)。使用できる値は、0 より大きい任意の 10 進値、または既定の価格がオンデマンドで up-to されることを示す -1 です。スポット価格の詳細については、spot VMsの価格

MachineHardwareProfile

Object

マシンのハードウェアとGPUの設定。

名前	型	説明
gpuInstanceProfile	GPUInstanceProfile	サポートされている GPU VM SKU の GPU MIG インスタンスプロファイルを指定するために使用される GPUInstanceProfile。
gpuProfile	GPUProfile	マシンのGPU設定。
ultraSsdEnabled	boolean	UltraSSD を有効にするかどうか
vmSize	string	VM のサイズ。 VM サイズの可用性はリージョンによって異なります。ノードに十分なコンピューティングリソース (メモリ、cpu など) が含まれている場合、ポッドが正常に実行されない可能性があります。制限付き VM サイズの詳細については、「https://docs.microsoft.com/azure/aks/quotas-skus-regions」を参照してください。

MachineIpAddress

Object

コンピューターの IP アドレスの詳細。

名前	型	説明
family	IPFamily	アドレスが IPv4 ファミリまたは IPv6 ファミリのどちらに属しているかを判断するには
ip	string	本機のIPv4またはIPv6アドレス

MachineKubernetesProfile

Object

マシンで使用される Kubernetes 構成。

名前	型	説明
artifactStreamingProfile	AgentPoolArtifactStreamingProfile	AKS でアーティファクトストリーミングを使用するための構成。
currentOrchestratorVersion	string	マシンで実行されている Kubernetes のバージョン。 orchestratorVersion が完全に指定されたバージョン <major.minor.patch> の場合、このフィールドは完全に同じになります。 orchestratorVersion が <major.minor> であった場合、このフィールドには使用されている完全な <major.minor.patch> バージョンが含まれます。
kubeletConfig	KubeletConfig	マシン上の Kubelet 構成。
kubeletDiskType	KubeletDiskType	emptyDir ボリュームの配置、コンテナランタイムデータのルート、Kubelet ephemeral storage の配置を決定します。
maxPods	integer (int32)	ノードで実行できるポッドの最大数。
nodeInitializationTaints	string[]	作成中にノードに追加されたテイントで、AKS によって調整されません。これらのテイントは AKS によって調整されず、kubectl 呼び出しで削除できます。これらのテイントを使用すると、ノードがワークロードを受け入れる準備が整う前に必要な構成を実行できます (例: 'key1=value1:NoSchedule' を使用して削除できます) `kubectl taint nodes node1 key1=value1:NoSchedule-`
nodeLabels	object	マシン上のノードラベル。
nodeName	string	Kubernetesクラスタ内のノード名。
nodeTaints	string[]	マシンの作成中に新しいノードに追加されたテイント。たとえば、key=value:NoSchedule です。
orchestratorVersion	string	ユーザーによって指定された Kubernetes のバージョン。パッチバージョン <major.minor.patch> と <major.minor> の両方がサポートされています。 <major.minor>を指定すると、サポートされている最新のパッチバージョンが自動的に選択されます。
workloadRuntime	WorkloadRuntime	ノードが実行できるワークロードの種類を決定します。

MachineNetworkProperties

Object

マシンのネットワークプロパティ

名前	型	説明
enableNodePublicIP	boolean	マシンに独自のパブリック IP が割り当てられているかどうか。一部のシナリオでは、マシンが独自の専用パブリック IP アドレスを受け取る必要がある場合があります。一般的なシナリオは、ホップを最小限に抑えるために、コンソールがクラウド仮想マシンに直接接続する必要があるゲームワークロードです。既定値は false です。
ipAddresses	MachineIpAddress[]	本機のIPv4、IPv6アドレス
nodePublicIPPrefixID	string (arm-id)	VM ノードが IP を使用するパブリック IP プレフィックス ID。これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} の形式です。
nodePublicIPTags	IPTag[]	インスタンスレベルのパブリック IP の IP タグ。
podSubnetID	string (arm-id)	起動時にポッドが参加するサブネットの ID。省略すると、ポッド IP はノードサブネットに静的に割り当てられます (詳細については、vnetSubnetID を参照してください)。これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。
vnetSubnetID	string (arm-id)	起動時にノードとオプションでポッドが参加するサブネットの ID。これが指定されていない場合は、VNET とサブネットが生成されて使用されます。 podSubnetID が指定されていない場合、これはノードとポッドに適用され、それ以外の場合はノードのみに適用されます。これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。

MachineOSProfile

Object

マシンが使用するオペレーティングシステムとディスク。

名前	型	規定値	説明
enableFIPS	boolean		FIPS 対応 OS を使用するかどうか。
linuxProfile	MachineOSProfileLinuxProfile		Linux マシンの特定のプロファイル。
osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		マスター/エージェントプール内のすべてのマシンのディスクサイズを指定するために使用する OS ディスクサイズ (GB)。 0 を指定すると、指定された vmSize に従って既定の osDisk サイズが適用されます。
osDiskType	OSDiskType		エージェントプール内のマシンに使用する OS ディスクの種類。 VM でサポートされていて、要求された OSDiskSizeGB より大きいキャッシュディスクがある場合、既定値は "エフェメラル" です。それ以外の場合、既定値は 'Managed' です。作成後に変更できない場合があります。詳細については、Ephemeral OSをご覧ください。
osSKU	OSSKU		エージェントプールで使用される OS SKU を指定します。指定しない場合、既定値は OSType=Linux の場合は Ubuntu、OSType=Windows の場合は Windows2019 です。また、Windows 2019 が非推奨になった後、既定の Windows OSSKU が Windows2022 に変更されます。
osType	OSType	Linux	オペレーティングシステムの種類。既定値は Linux です。
windowsProfile	AgentPoolWindowsProfile		Windows マシンの特定のプロファイル。

MachineOSProfileLinuxProfile

Object

Linux マシンの特定のプロファイル。

名前	型	説明
linuxOSConfig	LinuxOSConfig	LinuxマシンのOS構成。
messageOfTheDay	string	Base64 でエンコードされた Linux ノードの日のメッセージ。デコード後に /etc/motd に書き込まれる base64 でエンコードされた文字列。これにより、Linux ノードに対するその日のメッセージをカスタマイズできます。 Windows ノードには指定しないでください。静的文字列である必要があります (つまり、生で出力され、スクリプトとして実行されません)。

MachineProperties

Object

マシンのプロパティ

名前	型	規定値	説明
billing	MachineBillingProfile		機械請求に関するプロパティです。
eTag	string		オプティミスティックコンカレンシーを実装するために使用される一意の読み取り専用文字列。リソースが更新されると、eTag 値が変更されます。後続のリクエストの eTag 値を含む if-match または if-none-match ヘッダーを指定して、通常の eTag 規則に従ってオプティミスティック同時実行を有効にします。
evictionPolicy	ScaleSetEvictionPolicy	Delete	機械の立ち退きポリシー。これは優先度が「スポット」でない限り指定できません。指定しない場合、既定値は 'Delete' です。
hardware	MachineHardwareProfile		マシンのハードウェアとGPUの設定。
kubernetes	MachineKubernetesProfile		マシンで使用される Kubernetes 構成。
localDNSProfile	LocalDNSProfile		ノードごとのローカル DNS を VnetDNS と KubeDNS のオーバーライドを使用して構成します。 LocalDNS は、AKS クラスターでの DNS 解決のパフォーマンスと信頼性を向上させるのに役立ちます。詳細については、「aka.ms/aks/localdns」を参照してください。
mode	AgentPoolMode		マシンは「システム」モードと「ユーザー」モードのみを許可します。
network	MachineNetworkProperties		マシンのネットワークプロパティ
nodeImageVersion	string		ノードイメージのバージョン。
operatingSystem	MachineOSProfile		マシンが使用するオペレーティングシステムとディスク。
priority	ScaleSetPriority	Regular	マシンの優先度。指定しない場合、既定値は 'Regular' です。
provisioningState	string		現在のデプロイまたはプロビジョニングの状態。
resourceId	string (arm-id)		マシンの Azure リソース ID。基になるVMインスタンスをGETするために使用できます
security	MachineSecurityProfile		マシンのセキュリティ設定。
status	MachineStatus		マシンに関する読み取り専用の情報が含まれます。
tags	object		マシンに永続化するタグ。

MachineSecurityProfile

Object

マシンのセキュリティ設定。

名前	型	説明
enableEncryptionAtHost	boolean	ホストベースの OS とデータドライブの暗号化を有効にするかどうか。これは特定のVMサイズと特定のAzureリージョンでのみサポートされています。詳細については、次を参照してください。 https://docs.microsoft.com/azure/aks/enable-host-encryption
enableSecureBoot	boolean	セキュアブートは、署名されたオペレーティングシステムとドライバーのみが起動できるようにする、トラステッド起動の機能です。詳細については、aka.ms/aks/trustedlaunch を参照してください。指定しない場合、既定値は false です。
enableVTPM	boolean	vTPM は、ノード上でローカルに保持されているキーと測定用に専用のセキュリティで保護されたコンテナーを構成するための信頼できる起動機能です。詳細については、aka.ms/aks/trustedlaunch を参照してください。指定しない場合、既定値は false です。
sshAccess	AgentPoolSSHAccess	エージェントプールのSSH accessメソッド。

MachineStatus

Object

マシンに関する読み取り専用の情報が含まれます。

名前	型	説明
creationTimestamp	string (date-time)	マシンが作成された時刻を指定します。
driftAction	DriftAction	機械のドリフト動作。管理対象クラスタのプロパティの変更により、マシンが予期された状態から逸脱し、修正アクションが必要かどうかを示します。
driftReason	string	機械ドリフトの理由。マシンがドリフトした理由に関する詳細情報を提供します。このフィールドは、マシンが最新の場合、省略されます。
provisioningError	ErrorDetail	エラーの詳細情報は、マシンの情報です。失敗の詳細情報を保持します。エラーがなかった場合、このフィールドは省略されます。
vmState	VmState	仮想マシンの状態。基盤となる仮想マシンの現在の状態を示します。

ManagementMode

列挙

マネージドGPU体験は、GPUドライバーの上にData Center GPUマネージャー(DCGM)メトリクスなどの監視用追加コンポーネントをインストールします。インストールされている内容の詳細については、aka.ms/aks/managed-gpu をご覧ください。

値	説明
Unmanaged	NVIDIAのGPUでは管理GPU体験が無効になっています。
Managed	NVIDIAのGPUにはマネージドGPU体験が有効になっています。

MigStrategy

列挙

マネージドMIGサポートに使用されるMIG(マルチインスタンスGPU)戦略を設定します。さまざまな戦略についての詳細は aka.ms/aks/managed-gpu をご覧ください。指定されていない場合、デフォルトは「None」となります。

値	説明
None	MIG戦略を立てないでください。もし以前に1つのセットを持っていた場合、このセットは上書きし、セットMIG戦略を除去します。
Single	マネージドMIGのMIG戦略を単一に設定してください。
Mixed	マネージドMIGのMIG戦略を混合に設定してください。

NvidiaGPUProfile

Object

NVIDIA専用GPU設定

名前	型	説明
managementMode	ManagementMode	マネージドGPU体験は、GPUドライバーの上にData Center GPUマネージャー(DCGM)メトリクスなどの監視用追加コンポーネントをインストールします。インストールされている内容の詳細については、aka.ms/aks/managed-gpu をご覧ください。
migStrategy	MigStrategy	マネージドMIGサポートに使用されるMIG(マルチインスタンスGPU)戦略を設定します。さまざまな戦略についての詳細は aka.ms/aks/managed-gpu をご覧ください。指定されていない場合、デフォルトは「None」となります。

OSDiskType

列挙

エージェントプール内のマシンに使用する OS ディスクの種類。 VM でサポートされていて、要求された OSDiskSizeGB より大きいキャッシュディスクがある場合、既定値は "エフェメラル" です。それ以外の場合、既定値は 'Managed' です。作成後に変更できない場合があります。詳細については、Ephemeral OSをご覧ください。

値	説明
Managed	Azure は、仮想マシンのオペレーティングシステムディスクを Azure Storage にレプリケートして、VM を別のホストに再配置する必要がある場合のデータ損失を回避します。コンテナーはローカル状態を保持するように設計されていないため、この動作では値が制限されますが、ノードのプロビジョニング速度の低下や読み取り/書き込みの待機時間の長さなど、いくつかの欠点があります。
Ephemeral	エフェメラル OS ディスクは、一時ディスクと同様に、ホストマシンにのみ格納されます。これにより、読み取り/書き込みの待機時間が短くなり、ノードのスケーリングとクラスターのアップグレードが高速化されます。

値

説明

Managed

Azure は、仮想マシンのオペレーティングシステムディスクを Azure Storage にレプリケートして、VM を別のホストに再配置する必要がある場合のデータ損失を回避します。コンテナーはローカル状態を保持するように設計されていないため、この動作では値が制限されますが、ノードのプロビジョニング速度の低下や読み取り/書き込みの待機時間の長さなど、いくつかの欠点があります。

Ephemeral

エフェメラル OS ディスクは、一時ディスクと同様に、ホストマシンにのみ格納されます。これにより、読み取り/書き込みの待機時間が短くなり、ノードのスケーリングとクラスターのアップグレードが高速化されます。

OSSKU

列挙

エージェントプールで使用される OS SKU を指定します。 OSType が Linux の場合、既定値は Ubuntu です。 OSType が Windows の場合、Kubernetes <= 1.24 の場合は Windows 2019、Kubernetes >= 1.25 の場合は Windows2022 が既定値です。

値	説明
Ubuntu	ノードイメージの OS として Ubuntu を使用します。
AzureLinux	ノードイメージの OS として AzureLinux を使用します。 Azure Linux は、Microsoft によって構築されたコンテナー最適化 Linux ディストリビューションです。詳細については、https://aka.ms/azurelinux を参照してください。
AzureLinux3	ノードイメージの OS として AzureLinux3 を使用します。 Azure Linux は、Microsoft によって構築されたコンテナー最適化 Linux ディストリビューションです。詳細については、https://aka.ms/azurelinux を参照してください。制限事項については、 https://aka.ms/aks/node-images をご覧ください。 OS 移行のガイダンスについては、「 https://aka.ms/aks/upgrade-os-version」を参照してください。
Mariner	非推奨の OSSKU。新しいデプロイでは、代わりに "AzureLinux" を選択することをお勧めします。
Flatcar	ノードイメージのOSとしてFlatcar Container Linuxを使用します。 Flatcar は、コンテナに最適化され、セキュリティに重点を置いた Linux OS であり、不変のファイルシステムと Cloud Native Computing Foundation (CNCF) の一部を備えています。 Flatcar Container Linux for AKS の詳細については、「aka.ms/aks/flatcar-container-linux-for-aks」を参照してください。
CBLMariner	非推奨の OSSKU。新しいデプロイでは、代わりに "AzureLinux" を選択することをお勧めします。
Windows2019	ノードイメージの OS として Windows2019 を使用します。システムノードプールではサポートされていません。 Windows2019 では、Windows2019 コンテナーのみがサポートされます。Windows 2022 コンテナーを実行することはできません。その逆も同様です。
Windows2022	ノードイメージの OS として Windows2022 を使用します。システムノードプールではサポートされていません。 Windows2022 では、Windows2022 コンテナーのみがサポートされます。Windows 2019 コンテナーを実行することはできません。その逆も同様です。
Ubuntu2204	ノードイメージのOSとしてUbuntu2204を使用しますが、Ubuntu 22.04がすべてのノードプールでサポートされているとは限りません。制限事項とサポートされている Kubernetes のバージョンについては、 https://aka.ms/aks/supported-ubuntu-versions
Windows2025	ノードイメージのOSはWindows2025を使用します。システムノードプールではサポートされていません。 Windows2025 は、Windows2022 および Windows 2025 コンテナーをサポートします。Windows2019コンテナーを実行できず、その逆も同様です。
WindowsAnnual	ノードイメージの OS として Windows 年間チャネルバージョンを使用します。システムノードプールではサポートされていません。さまざまな AKS 年間チャネルバージョンでサポートされているコンテナーイメージと kubernetes バージョンの詳細については、https://aka.ms/aks/windows-annual-channel-detailsで確認できます。
Ubuntu2404	ノードイメージのOSとしてUbuntu2404を使用しますが、Ubuntu 24.04がすべてのノードプールでサポートされているとは限りません。制限事項とサポートされている kubernetes バージョンについては、以下を参照してください。 https://aka.ms/aks/supported-ubuntu-versions

OSType

列挙

オペレーティングシステムの種類。既定値は Linux です。

値	説明
Linux	Linux を使用します。
Windows	Windows を使用します。

ScaleSetEvictionPolicy

列挙

仮想マシンスケールセットの削除ポリシー。立ち退きポリシーには、VMが立ち退きした際の何to doかが指定されています。デフォルトは [削除] です。立ち退きに関する詳細はspot VMs

値	説明
Delete	ノードプールの基になるスケールセット内のノードは、削除されると削除されます。
Deallocate	ノードプールの基になるスケールセット内のノードは、削除時に stopped-deallocation 状態に設定されます。停止して割り当て解除された状態のノードは、コンピューティングクォータに対してカウントされ、クラスターのスケーリングまたはアップグレードに問題が発生する可能性があります。

ScaleSetPriority

列挙

仮想マシンスケールセットの優先順位。

値	説明
Spot	スポット優先度の VM が使用されます。スポットノードの SLA はありません。詳細については、AKS のスポットを参照してください。
Regular	通常の VM が使用されます。

SeccompDefault

列挙

すべてのワークロードに適用される既定の seccomp プロファイルを指定します。指定しない場合は、既定で 'Notfined' が使用されます。

値	説明
Unconfined	seccomp プロファイルは適用されず、すべてのシステムコールが許可されます。
RuntimeDefault	コンテナー・ランタイムのデフォルトの seccomp プロファイルが適用され、セキュリティーを強化するために特定のシステム・コールが制限されます。

SysctlConfig

Object

Linux エージェントノードの Sysctl 設定。

名前	型	説明
fsAioMaxNr	integer (int32)	sysctl setting fs.aio-max-nr.
fsFileMax	integer (int32)	sysctl 設定 fs.file-max.
fsInotifyMaxUserWatches	integer (int32)	sysctl setting fs.inotify.max_user_watches.
fsNrOpen	integer (int32)	Sysctl 設定fs.nr_open。
kernelThreadsMax	integer (int32)	sysctl setting kernel.threads-max.
netCoreNetdevMaxBacklog	integer (int32)	Sysctl 設定net.core.netdev_max_backlog。
netCoreOptmemMax	integer (int32)	Sysctl 設定net.core.optmem_max。
netCoreRmemDefault	integer (int32)	Sysctl 設定net.core.rmem_default。
netCoreRmemMax	integer (int32)	Sysctl 設定net.core.rmem_max。
netCoreSomaxconn	integer (int32)	sysctl setting net.core.somaxconn.
netCoreWmemDefault	integer (int32)	Sysctl 設定net.core.wmem_default。
netCoreWmemMax	integer (int32)	Sysctl 設定net.core.wmem_max。
netIpv4IpLocalPortRange	string	Sysctl 設定net.ipv4.ip_local_port_range。
netIpv4NeighDefaultGcThresh1	integer (int32)	Sysctl 設定net.ipv4.neigh.default.gc_thresh1。
netIpv4NeighDefaultGcThresh2	integer (int32)	Sysctl 設定net.ipv4.neigh.default.gc_thresh2。
netIpv4NeighDefaultGcThresh3	integer (int32)	Sysctl 設定net.ipv4.neigh.default.gc_thresh3。
netIpv4TcpFinTimeout	integer (int32)	Sysctl 設定net.ipv4.tcp_fin_timeout。
netIpv4TcpKeepaliveProbes	integer (int32)	Sysctl 設定net.ipv4.tcp_keepalive_probes。
netIpv4TcpKeepaliveTime	integer (int32)	Sysctl 設定net.ipv4.tcp_keepalive_time。
netIpv4TcpMaxSynBacklog	integer (int32)	Sysctl 設定net.ipv4.tcp_max_syn_backlog。
netIpv4TcpMaxTwBuckets	integer (int32)	Sysctl 設定net.ipv4.tcp_max_tw_buckets。
netIpv4TcpTwReuse	boolean	Sysctl 設定net.ipv4.tcp_tw_reuse。
netIpv4TcpkeepaliveIntvl	integer (int32) minimum: 10 maximum: 90	Sysctl 設定net.ipv4.tcp_keepalive_intvl。
netNetfilterNfConntrackBuckets	integer (int32) minimum: 65536 maximum: 524288	Sysctl 設定net.netfilter.nf_conntrack_buckets。
netNetfilterNfConntrackMax	integer (int32) minimum: 131072 maximum: 2097152	Sysctl 設定net.netfilter.nf_conntrack_max。
vmMaxMapCount	integer (int32)	sysctl setting vm.max_map_count.
vmSwappiness	integer (int32)	sysctl setting vm.swappiness.
vmVfsCachePressure	integer (int32)	Sysctl 設定vm.vfs_cache_pressure。

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

VmState

列挙

仮想マシンの状態。基盤となる仮想マシンの現在の状態を示します。

値	説明
Running	仮想マシンは現在実行中です。
Deleted	仮想マシンがユーザーによって削除されたか、スポットの削除が原因で削除されました。

WorkloadRuntime

列挙

ノードが実行できるワークロードの種類を決定します。

値	説明
OCIContainer	ノードは Kubelet を使用して、標準の OCI コンテナーワークロードを実行します。
WasmWasi	ノードは、WASI プロバイダー (プレビュー) を使用して WASM ワークロードを実行するために、クルースレットを使用します。
KataMshvVmIsolation	ノードは (Kata + Cloud Hypervisor + Hyper-V) を使用して、入れ子になった VM ベースのポッド (プレビュー) を有効にすることができます。 Hyper-V を使用するため、AKS ノード OS 自体は Hyper-V の入れ子になった VM (ルート OS) です。したがって、Dv3 シリーズなどの入れ子になった仮想化をサポートする VM シリーズでのみ使用できます。この命名規則は、KataVmIsolation を優先して、将来のリリースでは非推奨になります。
KataVmIsolation	ノードは (Kata + Cloud Hypervisor + Hyper-V) を使用して、ネストされた VM ベースのポッドを有効にすることができます。 Hyper-V を使用するため、AKS ノード OS 自体は Hyper-V の入れ子になった VM (ルート OS) です。したがって、Dv3 シリーズなどの入れ子になった仮想化をサポートする VM シリーズでのみ使用できます。

次の方法で共有

Machines - Create Or Update

URI パラメーター

要求ヘッダー

要求本文

応答

セキュリティ

azure_auth

スコープ

例

Create/Update Machine

要求のサンプル

応答のサンプル

定義

AgentPoolArtifactStreamingProfile

AgentPoolMode

AgentPoolSSHAccess

AgentPoolWindowsProfile

createdByType

DriftAction

DriverType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GPUDriver

GPUInstanceProfile

GPUProfile

IPFamily

IPTag

KubeletConfig

KubeletDiskType

LinuxOSConfig

LocalDNSForwardDestination

LocalDNSForwardPolicy

LocalDNSMode

LocalDNSOverride

LocalDNSProfile

LocalDNSProtocol

LocalDNSQueryLogging

LocalDNSServeStale

LocalDNSState

Machine

MachineBillingProfile

MachineHardwareProfile

MachineIpAddress

MachineKubernetesProfile

MachineNetworkProperties

MachineOSProfile

MachineOSProfileLinuxProfile

MachineProperties

MachineSecurityProfile

MachineStatus

ManagementMode

MigStrategy

NvidiaGPUProfile

OSDiskType

OSSKU

OSType

ScaleSetEvictionPolicy

ScaleSetPriority

SeccompDefault

SysctlConfig

systemData

VmState

WorkloadRuntime