Agent Pools - Get Upgrade Profile

Hizmet:

AKS

API Sürümü:

2026-08-01

Aracı havuzu için yükseltme profilini alır.

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

URI Parametreleri

Veri Akışı Adı	İçinde	Gerekli	Tür	Description
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Aracı havuzunun adı.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
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]$	Yönetilen küme kaynağının adı.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Veri Akışı Adı	Tür	Description
200 OK	AgentPoolUpgradeProfile	Azure işlemi başarıyla tamamlandı.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Veri Akışı Adı	Description
user_impersonation	kullanıcı hesabınızı taklit etme

Örnekler

Get Upgrade Profile for Agent Pool

Örnek isteği

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-08-01

Java

/**
 * Samples for AgentPools GetUpgradeProfile.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-08-01/AgentPoolsGetUpgradeProfile.json
     */
    /**
     * Sample code: Get Upgrade Profile for Agent Pool.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        getUpgradeProfileForAgentPool(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().getUpgradeProfileWithResponse("rg1", "clustername1", "agentpool1",
            com.azure.core.util.Context.NONE);
    }
}

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

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-containerservice
# USAGE
    python agent_pools_get_upgrade_profile.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.agent_pools.get_upgrade_profile(
        resource_group_name="rg1",
        resource_name="clustername1",
        agent_pool_name="agentpool1",
    )
    print(response)


# x-ms-original-file: 2026-08-01/AgentPoolsGetUpgradeProfile.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

Go

package armcontainerservice_test

import (
	"context"
	"log"

	"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-08-01/AgentPoolsGetUpgradeProfile.json
func ExampleAgentPoolsClient_GetUpgradeProfile() {
	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)
	}
	res, err := clientFactory.NewAgentPoolsClient().GetUpgradeProfile(ctx, "rg1", "clustername1", "agentpool1", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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.AgentPoolsClientGetUpgradeProfileResponse{
	// 	AgentPoolUpgradeProfile: armcontainerservice.AgentPoolUpgradeProfile{
	// 		Name: to.Ptr("default"),
	// 		Type: to.Ptr("Microsoft.ContainerService/managedClusters/agentPools/upgradeProfiles"),
	// 		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/upgradeprofiles/default"),
	// 		Properties: &armcontainerservice.AgentPoolUpgradeProfileProperties{
	// 			KubernetesVersion: to.Ptr("1.12.8"),
	// 			LatestNodeImageVersion: to.Ptr("AKSUbuntu:1604:2020.03.11"),
	// 			OSType: to.Ptr(armcontainerservice.OSTypeLinux),
	// 			Upgrades: []*armcontainerservice.AgentPoolUpgradeProfilePropertiesUpgradesItem{
	// 				{
	// 					KubernetesVersion: to.Ptr("1.13.5"),
	// 				},
	// 			},
	// 		},
	// 	},
	// }
}

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

Örnek yanıt

Durum kodu:

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"
      }
    ]
  }
}

Tanımlar

Veri Akışı Adı	Description
AgentPoolRecentlyUsedVersion	Geri alma işlemleri için kullanılabilecek geçmiş bir sürüm.
AgentPoolUpgradeProfile	Aracı havuzu için kullanılabilir yükseltmelerin listesi.
AgentPoolUpgradeProfilePropertiesUpgradesItem	Agent Pool için mevcut yükseltmeler.
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorAdditionalInfo	Kaynak yönetimi hatasına ilişkin ek bilgiler.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
OSType	İşletim sistemi türü. Varsayılan değer Linux'tır.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

AgentPoolRecentlyUsedVersion

Nesne

Geri alma işlemleri için kullanılabilecek geçmiş bir sürüm.

Veri Akışı Adı	Tür	Description
nodeImageVersion	string	Geri alma için kullanılabilen düğüm görüntüsü sürümü.
orchestratorVersion	string	Geri alma için kullanılabilen Kubernetes sürümü (major.minor.patch).
timestamp	string (date-time)	Bu sürümün en son kullanıldığı zaman damgası.

AgentPoolUpgradeProfile

Nesne

Aracı havuzu için kullanılabilir yükseltmelerin listesi.

Veri Akışı Adı	Tür	Default value	Description
id	string (arm-id)		Kaynağın tam nitelikli kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string		Kaynağın adı
properties.kubernetesVersion	string		Kubernetes sürümü (major.minor.patch).
properties.latestNodeImageVersion	string		Aks tarafından desteklenen en son düğüm görüntüsü sürümü.
properties.osType	OSType	Linux	İşletim sistemi türü. Varsayılan değer Linux'tır.
properties.recentlyUsedVersions	AgentPoolRecentlyUsedVersion[]		Geri alma işlemleri için geçmiş iyi sürümlerin listesi.
properties.upgrades	AgentPoolUpgradeProfilePropertiesUpgradesItem[]		Yükseltme için kullanılabilen düzenleyici türlerinin ve sürümlerinin listesi.
systemData	systemData		createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string		Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

AgentPoolUpgradeProfilePropertiesUpgradesItem

Nesne

Agent Pool için mevcut yükseltmeler.

Veri Akışı Adı	Tür	Description
isPreview	boolean	Kubernetes sürümünün şu anda önizleme aşamasında olup olmadığı.
kubernetesVersion	string	Kubernetes sürümü (major.minor.patch).

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatasına ilişkin ek bilgiler.

Veri Akışı Adı	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Veri Akışı Adı	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgisi.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi

ErrorResponse

Nesne

Hata yanıtı

Veri Akışı Adı	Tür	Description
error	ErrorDetail	Hata nesnesi.

OSType

Numaralandırma

İşletim sistemi türü. Varsayılan değer Linux'tır.

Değer	Description
Linux	Linux kullanın.
Windows	Windows kullanın.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Veri Akışı Adı	Tür	Description
createdAt	string (date-time)	Kaynak oluşturmanın zaman damgası (UTC).
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.