Agent Pools - Get Upgrade Profile

Service:: AKS

API バージョン:: 2026-07-01

エージェントプールのアップグレードプロファイルを取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/upgradeProfiles/default?api-version=2026-07-01

URI パラメーター

Name	/	必須	型	説明
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	エージェントプールの名前。
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 バージョン。

応答

Name	型	説明
200 OK	AgentPoolUpgradeProfile	Azureの運用は無事に完了しました。
Other Status Codes	ErrorResponse	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

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

スコープ

Name	説明
user_impersonation	あなたのユーザーアカウントになりすます

例

Get Upgrade Profile for Agent Pool

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/upgradeProfiles/default?api-version=2026-07-01

応答のサンプル

状態コード:: 200

{
  "name": "default",
  "type": "Microsoft.ContainerService/managedClusters/agentPools/upgradeProfiles",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/upgradeprofiles/default",
  "properties": {
    "kubernetesVersion": "1.12.8",
    "latestNodeImageVersion": "AKSUbuntu:1604:2020.03.11",
    "osType": "Linux",
    "upgrades": [
      {
        "kubernetesVersion": "1.13.5"
      }
    ]
  }
}

定義

Name	説明
AgentPoolRecentlyUsedVersion	ロールバック操作に使用できる履歴バージョン。
AgentPoolUpgradeProfile	エージェントプールで使用可能なアップグレードの一覧。
AgentPoolUpgradeProfilePropertiesUpgradesItem	エージェントプールの利用可能なアップグレード。
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
OSType	オペレーティングシステムの種類。既定値は Linux です。
systemData	リソースの作成と最後の変更に関連するメタデータ。

AgentPoolRecentlyUsedVersion

Object

ロールバック操作に使用できる履歴バージョン。

Name	型	説明
nodeImageVersion	string	ロールバックに使用できるノードイメージのバージョン。
orchestratorVersion	string	ロールバックに使用できるKubernetesバージョン(major.minor.patch)。
timestamp	string (date-time)	このバージョンが最後に使用されたタイムスタンプ。

AgentPoolUpgradeProfile

Object

エージェントプールで使用可能なアップグレードの一覧。

Name	型	規定値	説明
id	string (arm-id)		リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string		リソースの名前
properties.kubernetesVersion	string		Kubernetes バージョン (major.minor.patch)。
properties.latestNodeImageVersion	string		AKS でサポートされているノードイメージの最新バージョン。
properties.osType	OSType	Linux	オペレーティングシステムの種類。既定値は Linux です。
properties.recentlyUsedVersions	AgentPoolRecentlyUsedVersion[]		ロールバック操作の過去の正常なバージョンのリスト。
properties.upgrades	AgentPoolUpgradeProfilePropertiesUpgradesItem[]		アップグレードに使用できるオーケストレーターの種類とバージョンの一覧。
systemData	systemData		createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string		リソースの種類。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

AgentPoolUpgradeProfilePropertiesUpgradesItem

Object

エージェントプールの利用可能なアップグレード。

Name	型	説明
isPreview	boolean	Kubernetes バージョンが現在プレビュー段階にあるかどうか。
kubernetesVersion	string	Kubernetes バージョン (major.minor.patch)。

createdByType

列挙

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

値	説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

エラーの詳細。

Name	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーに関する追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーの対象。

ErrorResponse

Object

エラー応答

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

OSType

列挙

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

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

systemData

Object

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

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