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 |
|---|---|---|---|---|
|
agent
|
path | True |
string minLength: 1maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$ |
O nome do pool de agentes. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
resource
|
path | True |
string minLength: 1maxLength: 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. |
|
subscription
|
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 |
Operação do Azure concluída com sucesso. |
|
| Other Status Codes |
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 |
|---|---|
|
Agent |
Uma versão histórica que pode ser usada para operações de reversão. |
|
Agent |
A lista de atualizações disponíveis para um pool de agentes. |
|
Agent |
Upgrades disponíveis para um AgentPool. |
|
created |
O tipo de identidade que criou o recurso. |
|
Error |
Informações adicionais sobre o erro de gestão de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
| OSType |
O tipo de sistema operacional. O padrão é Linux. |
|
system |
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 | Linux |
O tipo de sistema operacional. O padrão é Linux. |
|
| properties.recentlyUsedVersions |
Lista de boas versões históricas para operações de reversão. |
||
| properties.upgrades |
Lista de tipos e versões de orquestradores disponíveis para atualização. |
||
| 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 |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
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 |
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 |
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 |
O tipo de identidade que modificou o recurso pela última vez. |