Nodes - List Node Extensions

Servizio:: Batch Service

Versione API:: 2025-06-01

Elenca le estensioni dei nodi di calcolo nel pool specificato.

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/extensions?api-version=2025-06-01

Con parametri facoltativi:

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/extensions?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$select={$select}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	Endpoint dell'account Batch (ad esempio: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	L'ID del nodo di calcolo che vuoi elencare come estensioni.
poolId	path	True	string	L'ID del Pool che contiene il Nodo di Calcolo.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
$select	query		string[]	Clausola di $select OData.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Numero massimo di elementi da restituire nella risposta. Possono essere restituite un massimo di 1000 domande.
timeOut	query		integer (int32)	Tempo massimo di elaborazione della richiesta da parte del server, espresso in secondi. Il valore predefinito è 30 secondi. Se il valore è superiore a 30, verrà utilizzato il valore predefinito.".

Intestazione della richiesta

Nome	Tipo	Descrizione
client-request-id	string	Identità della richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Indica se il server deve restituire l'ID richiesta client nella risposta.
ocp-date	string (date-time-rfc7231)	Ora di emissione della richiesta. Le librerie client in genere impostano questo valore sull'ora corrente dell'orologio di sistema; impostarla in modo esplicito se si chiama direttamente l'API REST.

Risposte

Nome	Tipo	Descrizione
200 OK	BatchNodeVMExtensionListResult	La richiesta ha avuto esito positivo. Intestazioni ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

BatchNodeVMExtensionListResult

La richiesta ha avuto esito positivo.

Intestazioni

ETag: string
Last-Modified: string
client-request-id: string
request-id: string

Other Status Codes

BatchError

Risposta di errore imprevista.

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Ambiti

Nome	Descrizione
https://batch.core.windows.net//.default

Esempio

List compute node extensions

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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
      }
    }
  ]
}

Definizioni

Nome	Descrizione
BatchError	Risposta di errore ricevuta dal servizio Azure Batch.
BatchErrorDetail	Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.
BatchErrorMessage	Messaggio di errore ricevuto in una risposta di errore di Azure Batch.
BatchNodeVMExtension	Configurazione per la visualizzazione dell'istanza dell'estensione della macchina virtuale.
BatchNodeVMExtensionListResult	Risultato dell'elenco delle estensioni del nodo di calcolo in un nodo.
InstanceViewStatus	Stato della visualizzazione dell'istanza.
StatusLevelTypes	Livellato il codice.
VMExtension	Configurazione per le estensioni della macchina virtuale.
VMExtensionInstanceView	Visualizzazione dell'istanza dell'estensione della macchina virtuale.

BatchError

Oggetto

Risposta di errore ricevuta dal servizio Azure Batch.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
message	BatchErrorMessage	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
values	BatchErrorDetail[]	Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore.

BatchErrorDetail

Oggetto

Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.

Nome	Tipo	Descrizione
key	string	Identificatore che specifica il significato della proprietà Value.
value	string	Informazioni aggiuntive incluse nella risposta di errore.

BatchErrorMessage

Oggetto

Messaggio di errore ricevuto in una risposta di errore di Azure Batch.

Nome	Tipo	Descrizione
lang	string	Il codice linguistico del messaggio di errore.
value	string	Testo del messaggio.

BatchNodeVMExtension

Oggetto

Configurazione per la visualizzazione dell'istanza dell'estensione della macchina virtuale.

Nome	Tipo	Descrizione
instanceView	VMExtensionInstanceView	Visualizzazione dell'istanza dell'estensione della macchina virtuale.
provisioningState	string	Lo stato di provisioning dell'estensione della macchina virtuale.
vmExtension	VMExtension	L'estensione della macchina virtuale.

BatchNodeVMExtensionListResult

Oggetto

Risultato dell'elenco delle estensioni del nodo di calcolo in un nodo.

Nome	Tipo	Descrizione
odata.nextLink	string (uri)	L'URL per ottenere il set di risultati successivo.
value	BatchNodeVMExtension[]	L'elenco delle estensioni del nodo di calcolo.

InstanceViewStatus

Oggetto

Stato della visualizzazione dell'istanza.

Nome	Tipo	Descrizione
code	string	Codice di stato.
displayStatus	string	L'etichetta localizzata per lo status.
level	StatusLevelTypes	Livellato il codice.
message	string	Il messaggio di stato dettagliato.
time	string (date-time)	Ora dello stato.

StatusLevelTypes

Enumerazione

Livellato il codice.

Valore	Descrizione
Error	Errore
Info	Informazioni
Warning	Avvertimento

VMExtension

Oggetto

Configurazione per le estensioni della macchina virtuale.

Nome	Tipo	Descrizione
autoUpgradeMinorVersion	boolean	Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true.
enableAutomaticUpgrade	boolean	Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione.
name	string	Nome dell'estensione macchina virtuale.
protectedSettings	object	L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta.
provisionAfterExtensions	string[]	Raccolta di nomi di estensione. Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione.
publisher	string	Nome del server di pubblicazione del gestore dell'estensione.
settings	object	Impostazioni pubbliche in formato JSON per l'estensione.
type	string	Il tipo di proroga.
typeHandlerVersion	string	Versione del gestore di script.

VMExtensionInstanceView

Oggetto

Visualizzazione dell'istanza dell'estensione della macchina virtuale.

Nome	Tipo	Descrizione
name	string	Il nome della vista di istanza dell'estensione VM.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
subStatuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.

Condividi tramite

Nodes - List Node Extensions

Parametri dell'URI

Intestazione della richiesta

Risposte

Sicurezza

OAuth2Auth

Ambiti

Esempio

List compute node extensions

Esempio di richiesta

Risposta di esempio

Definizioni

BatchError

BatchErrorDetail

BatchErrorMessage

BatchNodeVMExtension

BatchNodeVMExtensionListResult

InstanceViewStatus

StatusLevelTypes

VMExtension

VMExtensionInstanceView