Managed Clusters - Get Upgrade Profile

Hizmet:

AKS

API Sürümü:

2026-08-01

Yönetilen kümenin yükseltme profilini alır.

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

URI Parametreleri

Veri Akışı Adı	İçinde	Gerekli	Tür	Description
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	ManagedClusterUpgradeProfile	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 Managed Cluster

Örnek isteği

HTTP

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

Java

/**
 * Samples for ManagedClusters GetUpgradeProfile.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-08-01/ManagedClustersGetUpgradeProfile.json
     */
    /**
     * Sample code: Get Upgrade Profile for Managed Cluster.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        getUpgradeProfileForManagedCluster(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getManagedClusters().getUpgradeProfileWithResponse("rg1", "clustername1",
            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 managed_clusters_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.managed_clusters.get_upgrade_profile(
        resource_group_name="rg1",
        resource_name="clustername1",
    )
    print(response)


# x-ms-original-file: 2026-08-01/ManagedClustersGetUpgradeProfile.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/ManagedClustersGetUpgradeProfile.json
func ExampleManagedClustersClient_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.NewManagedClustersClient().GetUpgradeProfile(ctx, "rg1", "clustername1", 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.ManagedClustersClientGetUpgradeProfileResponse{
	// 	ManagedClusterUpgradeProfile: armcontainerservice.ManagedClusterUpgradeProfile{
	// 		Name: to.Ptr("default"),
	// 		Type: to.Ptr("Microsoft.ContainerService/managedClusters/upgradeprofiles"),
	// 		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/upgradeprofiles/default"),
	// 		Properties: &armcontainerservice.ManagedClusterUpgradeProfileProperties{
	// 			AgentPoolProfiles: []*armcontainerservice.ManagedClusterPoolUpgradeProfile{
	// 				{
	// 					Name: to.Ptr("agent"),
	// 					KubernetesVersion: to.Ptr("1.7.7"),
	// 					OSType: to.Ptr(armcontainerservice.OSTypeLinux),
	// 					Upgrades: []*armcontainerservice.ManagedClusterPoolUpgradeProfileUpgradesItem{
	// 						{
	// 							KubernetesVersion: to.Ptr("1.7.9"),
	// 						},
	// 						{
	// 							IsPreview: to.Ptr(true),
	// 							KubernetesVersion: to.Ptr("1.7.11"),
	// 						},
	// 					},
	// 				},
	// 			},
	// 			ControlPlaneProfile: &armcontainerservice.ManagedClusterPoolUpgradeProfile{
	// 				Name: to.Ptr("master"),
	// 				KubernetesVersion: to.Ptr("1.7.7"),
	// 				OSType: to.Ptr(armcontainerservice.OSTypeLinux),
	// 				Upgrades: []*armcontainerservice.ManagedClusterPoolUpgradeProfileUpgradesItem{
	// 					{
	// 						IsPreview: to.Ptr(true),
	// 						KubernetesVersion: to.Ptr("1.7.9"),
	// 					},
	// 					{
	// 						KubernetesVersion: to.Ptr("1.7.11"),
	// 					},
	// 				},
	// 			},
	// 		},
	// 	},
	// }
}

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/upgradeprofiles",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/upgradeprofiles/default",
  "properties": {
    "agentPoolProfiles": [
      {
        "name": "agent",
        "kubernetesVersion": "1.7.7",
        "osType": "Linux",
        "upgrades": [
          {
            "kubernetesVersion": "1.7.9"
          },
          {
            "isPreview": true,
            "kubernetesVersion": "1.7.11"
          }
        ]
      }
    ],
    "controlPlaneProfile": {
      "name": "master",
      "kubernetesVersion": "1.7.7",
      "osType": "Linux",
      "upgrades": [
        {
          "isPreview": true,
          "kubernetesVersion": "1.7.9"
        },
        {
          "kubernetesVersion": "1.7.11"
        }
      ]
    }
  }
}

Tanımlar

Veri Akışı Adı	Description
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ı
ManagedClusterPoolUpgradeProfile	Kullanılabilir yükseltme sürümlerinin listesi.
ManagedClusterPoolUpgradeProfileUpgradesItem	Agent Pool için mevcut yükseltmeler.
ManagedClusterUpgradeProfile	İşlem havuzları için kullanılabilir yükseltmelerin listesi.
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.

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.

ManagedClusterPoolUpgradeProfile

Nesne

Kullanılabilir yükseltme sürümlerinin listesi.

Veri Akışı Adı	Tür	Default value	Description
kubernetesVersion	string		Kubernetes sürümü (major.minor.patch).
name	string		Aracı Havuzu adı.
osType	OSType	Linux	İşletim sistemi türü. Varsayılan değer Linux'tır.
upgrades	ManagedClusterPoolUpgradeProfileUpgradesItem[]		Yükseltme için kullanılabilen düzenleyici türlerinin ve sürümlerinin listesi.

ManagedClusterPoolUpgradeProfileUpgradesItem

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).

ManagedClusterUpgradeProfile

Nesne

İşlem havuzları için kullanılabilir yükseltmelerin listesi.

Veri Akışı Adı	Tür	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.agentPoolProfiles	ManagedClusterPoolUpgradeProfile[]	Aracı havuzları için kullanılabilir yükseltme sürümlerinin listesi.
properties.controlPlaneProfile	ManagedClusterPoolUpgradeProfile	Denetim düzlemi için kullanılabilir yükseltme 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"

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ü.