Agent Pools - Get Upgrade Profile

Obtém o perfil de atualização para um pool de agentes.

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

Parâmetros do URI

Name Em Obrigatório Tipo Descrição
agentPoolName
path True

string

minLength: 1
maxLength: 12
pattern: ^[a-z][a-z0-9]{0,11}$

O nome do pool de agentes.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

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]$

O nome do recurso de cluster gerenciado.

subscriptionId
path True

string (uuid)

O ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Respostas

Name Tipo Descrição
200 OK

AgentPoolUpgradeProfile

Operação do Azure concluída com sucesso.

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Descrição
user_impersonation assumir a identidade da sua conta de utilizador

Exemplos

Get Upgrade Profile for Agent Pool

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Descrição
AgentPoolRecentlyUsedVersion

Uma versão histórica que pode ser usada para operações de reversão.

AgentPoolUpgradeProfile

A lista de atualizações disponíveis para um pool de agentes.

AgentPoolUpgradeProfilePropertiesUpgradesItem

Upgrades disponíveis para um AgentPool.

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

OSType

O tipo de sistema operacional. O padrão é Linux.

systemData

Metadados referentes à criação e última modificação do recurso.

AgentPoolRecentlyUsedVersion

Uma versão histórica que pode ser usada para operações de reversão.

Name Tipo Descrição
nodeImageVersion

string

A versão da imagem do nó disponível para reversão.

orchestratorVersion

string

A versão do Kubernetes (major.minor.patch) disponível para reversão.

timestamp

string (date-time)

O carimbo de data/hora quando esta versão foi usada pela última vez.

AgentPoolUpgradeProfile

A lista de atualizações disponíveis para um pool de agentes.

Name Tipo Valor predefinido Descrição
id

string (arm-id)

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.kubernetesVersion

string

A versão do Kubernetes (major.minor.patch).

properties.latestNodeImageVersion

string

A última versão de imagem de nó suportada pelo AKS.

properties.osType

OSType

Linux

O tipo de sistema operacional. O padrão é Linux.

properties.recentlyUsedVersions

AgentPoolRecentlyUsedVersion[]

Lista de boas versões históricas para operações de reversão.

properties.upgrades

AgentPoolUpgradeProfilePropertiesUpgradesItem[]

Lista de tipos e versões de orquestradores disponíveis para atualização.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AgentPoolUpgradeProfilePropertiesUpgradesItem

Upgrades disponíveis para um AgentPool.

Name Tipo Descrição
isPreview

boolean

Se a versão do Kubernetes está atualmente em visualização.

kubernetesVersion

string

A versão do Kubernetes (major.minor.patch).

createdByType

O tipo de identidade que criou o recurso.

Valor Descrição
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Descrição
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O alvo do erro.

ErrorResponse

Resposta de erro

Name Tipo Descrição
error

ErrorDetail

O objeto de erro.

OSType

O tipo de sistema operacional. O padrão é Linux.

Valor Descrição
Linux

Usa Linux.

Windows

Usa o Windows.

systemData

Metadados referentes à criação e última modificação do recurso.

Name Tipo Descrição
createdAt

string (date-time)

A marca temporal da criação do recurso (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

A data e hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.