Partilhar via

Nodes - List Node Extensions

Serviço:
Batch Service
Versão da API:
2025-06-01

Lista as extensões dos nós de computação no pool especificado.

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/extensions?api-version=2025-06-01
Com parâmetros opcionais: 
GET {endpoint}/pools/{poolId}/nodes/{nodeId}/extensions?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$select={$select}

Parâmetros do URI

Name Em Necessário Tipo Description
endpoint
 path True

string (uri)

Ponto de extremidade da conta em lote (por exemplo: https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

O ID do Nó de Computação que queres listar extensões.
poolId
 path True

string

O ID do Pool que contém o Nó de Computação.
api-version
 query True

string

minLength: 1

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

string[]

Uma cláusula OData $select.
maxresults
 query

integer (int32)

minimum: 1
maximum: 1000

O número máximo de itens a serem retornados na resposta. Podem ser devolvidos um máximo de 1000 candidaturas.
timeOut
 query

integer (int32)

O tempo máximo que o servidor pode gastar processando a solicitação, em segundos. O padrão é 30 segundos. Se o valor for superior a 30, será usado o padrão em vez disso.".

Cabeçalho do Pedido

Name Necessário Tipo Description
client-request-id

string

A identidade de solicitação gerada pelo chamador, na forma de um GUID sem decoração, como chaves encaracoladas, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Se o servidor deve retornar o client-request-id na resposta.
ocp-date

string (date-time-rfc7231)

A hora em que o pedido foi emitido. As bibliotecas de cliente normalmente definem isso para a hora atual do relógio do sistema; defina-o explicitamente se você estiver chamando a API REST diretamente.

Respostas

Name Tipo Description
200 OK

BatchNodeVMExtensionListResult

O pedido foi bem-sucedido.

Cabeçalhos

  • ETag: string
  • Last-Modified: string
  • client-request-id: string
  • request-id: string
Other Status Codes

BatchError

Uma resposta de erro inesperada.

Segurança

OAuth2Auth

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

Âmbitos

Name Description
https://batch.core.windows.net//.default

Exemplos

List compute node extensions

Pedido de amostra

GET {endpoint}/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z/extensions?api-version=2025-06-01

Resposta da amostra

Código de estado:
200 
{
  "value": [
    {
      "instanceView": {
        "name": "batchNodeExtension",
        "statuses": [
          {
            "code": "ProvisioningState/succeeded",
            "level": "Info",
            "displayStatus": "Provisioning succeeded",
            "message": "Enable succeeded: Enabling and starting agent and controller"
          }
        ]
      },
      "vmExtension": {
        "name": "batchNodeExtension",
        "publisher": "Microsoft.Azure.Extensions",
        "type": "CustomScript",
        "typeHandlerVersion": "2.0",
        "autoUpgradeMinorVersion": true
      }
    },
    {
      "instanceView": {
        "name": "customExtension",
        "statuses": [
          {
            "code": "ProvisioningState/succeeded",
            "level": "Info",
            "displayStatus": "Provisioning succeeded",
            "message": "ExtensionOperation:enable. Status:Success"
          }
        ]
      },
      "vmExtension": {
        "name": "customExtension",
        "publisher": "Microsoft.Azure.Geneva",
        "type": "GenevaMonitoring",
        "typeHandlerVersion": "2.0",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true
      }
    }
  ]
}

Definições

Name Description
BatchError

Uma resposta de erro recebida do serviço Batch do Azure.
BatchErrorDetail

Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.
BatchErrorMessage

Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.
BatchNodeVMExtension

A configuração para exibição de instância de extensão de máquina virtual.
BatchNodeVMExtensionListResult

O resultado da listagem das extensões do Nó de Computação em um Nó.
InstanceViewStatus

O status da exibição da instância.
StatusLevelTypes

Código de nível.
VMExtension

A configuração para extensões de máquina virtual.
VMExtensionInstanceView

A exibição da instância de extensão vm.

BatchError

Object

Uma resposta de erro recebida do serviço Batch do Azure.

Name Tipo Description
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
message

BatchErrorMessage

Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.
values

BatchErrorDetail[]

Uma coleção de pares chave-valor contendo detalhes adicionais sobre o erro.

BatchErrorDetail

Object

Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.

Name Tipo Description
key

string

Um identificador que especifica o significado da propriedade Value.
value

string

As informações adicionais incluídas com a resposta de erro.

BatchErrorMessage

Object

Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.

Name Tipo Description
lang

string

O código da linguagem da mensagem de erro.
value

string

O texto da mensagem.

BatchNodeVMExtension

Object

A configuração para exibição de instância de extensão de máquina virtual.

Name Tipo Description
instanceView

VMExtensionInstanceView

A exibição da instância de extensão vm.
provisioningState

string

O estado de provisionamento da extensão da máquina virtual.
vmExtension

VMExtension

A extensão da máquina virtual.

BatchNodeVMExtensionListResult

Object

O resultado da listagem das extensões do Nó de Computação em um Nó.

Name Tipo Description
odata.nextLink

string (uri)

O URL para obter o próximo conjunto de resultados.
value

BatchNodeVMExtension[]

A lista de extensões do Compute Node.

InstanceViewStatus

Object

O status da exibição da instância.

Name Tipo Description
code

string

O código de status.
displayStatus

string

A etiqueta localizada para o estado.
level

StatusLevelTypes

Código de nível.
message

string

A mensagem detalhada de estado.
time

string (date-time)

A hora do status.

StatusLevelTypes

Enumeração

Código de nível.

Valor Description
Error

Erro
Info

Informações
Warning

Advertência

VMExtension

Object

A configuração para extensões de máquina virtual.

Name Tipo Description
autoUpgradeMinorVersion

boolean

Indica se a extensão deve usar uma versão secundária mais recente, se uma estiver disponível no momento da implantação. Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true.
enableAutomaticUpgrade

boolean

Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível.
name

string

O nome da extensão da máquina virtual.
protectedSettings

object

A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida.
provisionAfterExtensions

string[]

A coleção de nomes de extensão. Coleção de nomes de extensão após a qual essa extensão precisa ser provisionada.
publisher

string

O nome do editor do manipulador de extensão.
settings

object

Configurações públicas formatadas em JSON para a extensão.
type

string

O tipo da extensão.
typeHandlerVersion

string

A versão do manipulador de script.

VMExtensionInstanceView

Object

A exibição da instância de extensão vm.

Name Tipo Description
name

string

O nome da vista de instância da extensão VM.
statuses

InstanceViewStatus[]

As informações de status do recurso.
subStatuses

InstanceViewStatus[]

As informações de status do recurso.