관리되는 클러스터의 업그레이드 프로필을 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/upgradeProfiles/default?api-version=2024-09-01
URI 매개 변수
| Name |
In(다음 안에) |
필수 |
형식 |
Description |
|
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 버전입니다.
|
응답
보안
azure_auth
Azure Active Directory OAuth2 Flow
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name |
Description |
|
user_impersonation
|
사용자 계정 가장
|
예제
Get Upgrade Profile for Managed Cluster
샘플 요청
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/upgradeProfiles/default?api-version=2024-09-01
/**
* Samples for ManagedClusters GetUpgradeProfile.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2024-09-01/examples/
* ManagedClustersGetUpgradeProfile.json
*/
/**
* Sample code: Get Upgrade Profile for Managed Cluster.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void getUpgradeProfileForManagedCluster(com.azure.resourcemanager.AzureResourceManager azure) {
azure.kubernetesClusters().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
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="00000000-0000-0000-0000-000000000000",
)
response = client.managed_clusters.get_upgrade_profile(
resource_group_name="rg1",
resource_name="clustername1",
)
print(response)
# x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2024-09-01/examples/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
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/v6"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/e838027e88cca634c1545e744630de9262a6e72a/specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2024-09-01/examples/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("<subscription-id>", 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.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
const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Gets the upgrade profile of a managed cluster.
*
* @summary Gets the upgrade profile of a managed cluster.
* x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2024-09-01/examples/ManagedClustersGetUpgradeProfile.json
*/
async function getUpgradeProfileForManagedCluster() {
const subscriptionId =
process.env["CONTAINERSERVICE_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
const resourceGroupName = process.env["CONTAINERSERVICE_RESOURCE_GROUP"] || "rg1";
const resourceName = "clustername1";
const credential = new DefaultAzureCredential();
const client = new ContainerServiceClient(credential, subscriptionId);
const result = await client.managedClusters.getUpgradeProfile(resourceGroupName, resourceName);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
샘플 응답
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/upgradeprofiles/default",
"name": "default",
"properties": {
"agentPoolProfiles": [
{
"kubernetesVersion": "1.7.7",
"name": "agent",
"osType": "Linux",
"upgrades": [
{
"kubernetesVersion": "1.7.9"
},
{
"kubernetesVersion": "1.7.11",
"isPreview": true
}
]
}
],
"controlPlaneProfile": {
"kubernetesVersion": "1.7.7",
"name": "master",
"osType": "Linux",
"upgrades": [
{
"kubernetesVersion": "1.7.9",
"isPreview": true
},
{
"kubernetesVersion": "1.7.11"
}
]
}
},
"type": "Microsoft.ContainerService/managedClusters/upgradeprofiles"
}
정의
CloudError
Object
컨테이너 서비스의 오류 응답입니다.
CloudErrorBody
Object
컨테이너 서비스의 오류 응답입니다.
| Name |
형식 |
Description |
|
code
|
string
|
오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
|
|
details
|
CloudErrorBody[]
|
오류에 대한 추가 세부 정보 목록입니다.
|
|
message
|
string
|
사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
|
|
target
|
string
|
특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.
|
ManagedClusterPoolUpgradeProfile
Object
사용 가능한 업그레이드 버전 목록입니다.
| Name |
형식 |
Default value |
Description |
|
kubernetesVersion
|
string
|
|
Kubernetes 버전(major.minor.patch).
|
|
name
|
string
|
|
에이전트 풀 이름입니다.
|
|
osType
|
OSType
|
Linux
|
운영 체제 유형입니다. 기본값은 Linux입니다.
|
|
upgrades
|
Upgrades[]
|
|
업그레이드에 사용할 수 있는 오케스트레이터 유형 및 버전 목록입니다.
|
ManagedClusterUpgradeProfile
Object
컴퓨팅 풀에 사용할 수 있는 업그레이드 목록입니다.
OSType
열거형
운영 체제 유형입니다. 기본값은 Linux입니다.
| 값 |
Description |
|
Linux
|
Linux를 사용합니다.
|
|
Windows
|
Windows를 사용합니다.
|
Upgrades
Object
업그레이드에 사용할 수 있는 오케스트레이터 유형 및 버전 목록입니다.
| Name |
형식 |
Description |
|
isPreview
|
boolean
|
Kubernetes 버전이 현재 미리 보기 상태인지 여부입니다.
|
|
kubernetesVersion
|
string
|
Kubernetes 버전(major.minor.patch).
|