Nodes - List Node Extensions

Služba:: Batch Service

Verze rozhraní API:: 2025-06-01

Uvádí rozšíření Compute Nodes ve specifikovaném poolu.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string (uri)	Koncový bod účtu Batch (například: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	ID Compute Node, u kterého chcete uvádět rozšíření.
poolId	path	True	string	ID poolu, který obsahuje Compute Node.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
$select	query		string[]	Klauzule $select OData.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Maximální počet položek, které se mají vrátit v odpovědi. Maximálně 1000 žádostí lze vrátit.
timeOut	query		integer (int32)	Maximální doba, po kterou může server strávit zpracováním požadavku v sekundách. Výchozí hodnota je 30 sekund. Pokud je hodnota větší než 30, použije se výchozí hodnota.".

Hlavička požadavku

Name	Typ	Description
client-request-id	string	Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Určuje, jestli má server v odpovědi vrátit ID požadavku klienta.
ocp-date	string (date-time-rfc7231)	Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas; explicitně ji nastavte, pokud voláte přímo rozhraní REST API.

Odpovědi

Name	Typ	Description
200 OK	BatchNodeVMExtensionListResult	Požadavek byl úspěšný. Hlavičky ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

BatchNodeVMExtensionListResult

Požadavek byl úspěšný.

Hlavičky

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

Other Status Codes

BatchError

Neočekávaná chybová odpověď

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Rozsahy

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

Příklady

List compute node extensions

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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
      }
    }
  ]
}

Definice

Name	Description
BatchError	Odpověď na chybu přijatá ze služby Azure Batch
BatchErrorDetail	Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch
BatchErrorMessage	V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.
BatchNodeVMExtension	Konfigurace zobrazení instance rozšíření virtuálního počítače.
BatchNodeVMExtensionListResult	Výsledek výpisu rozšíření výpočetních uzlů v uzlu.
InstanceViewStatus	Stav zobrazení instance.
StatusLevelTypes	Kód úrovně.
VMExtension	Konfigurace rozšíření virtuálních počítačů.
VMExtensionInstanceView	Zobrazení instance rozšíření virtuálního počítače.

BatchError

Objekt

Odpověď na chybu přijatá ze služby Azure Batch

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
message	BatchErrorMessage	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
values	BatchErrorDetail[]	Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Objekt

Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch

Name	Typ	Description
key	string	Identifikátor určující význam vlastnosti Value.
value	string	Další informace zahrnuté v odpovědi na chybu.

BatchErrorMessage

Objekt

V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

Name	Typ	Description
lang	string	Jazykový kód chybové zprávy.
value	string	Text zprávy.

BatchNodeVMExtension

Objekt

Konfigurace zobrazení instance rozšíření virtuálního počítače.

Name	Typ	Description
instanceView	VMExtensionInstanceView	Zobrazení instance rozšíření virtuálního počítače.
provisioningState	string	Stav provisioningu rozšíření virtuálního stroje.
vmExtension	VMExtension	Rozšíření virtuálního stroje.

BatchNodeVMExtensionListResult

Objekt

Výsledek výpisu rozšíření výpočetních uzlů v uzlu.

Name	Typ	Description
odata.nextLink	string (uri)	Adresa URL pro získání další sady výsledků.
value	BatchNodeVMExtension[]	Seznam rozšíření Compute Node.

InstanceViewStatus

Objekt

Stav zobrazení instance.

Name	Typ	Description
code	string	Stavový kód.
displayStatus	string	Lokalizovaný štítek pro stav.
level	StatusLevelTypes	Kód úrovně.
message	string	Podrobná stavová zpráva.
time	string (date-time)	Čas stavu.

StatusLevelTypes

Výčet

Kód úrovně.

Hodnota	Description
Error	Error
Info	Informace
Warning	Výstraha

VMExtension

Objekt

Konfigurace rozšíření virtuálních počítačů.

Name	Typ	Description
autoUpgradeMinorVersion	boolean	Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.
enableAutomaticUpgrade	boolean	Určuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze rozšíření.
name	string	Název rozšíření virtuálního počítače
protectedSettings	object	Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení.
provisionAfterExtensions	string[]	Kolekce názvů rozšíření. Kolekce názvů rozšíření, po kterých je potřeba toto rozšíření zřídit.
publisher	string	Název vydavatele obslužné rutiny rozšíření.
settings	object	Veřejná nastavení ve formátu JSON pro rozšíření
type	string	Typ prodloužení.
typeHandlerVersion	string	Verze obslužné rutiny skriptu.

VMExtensionInstanceView

Objekt

Zobrazení instance rozšíření virtuálního počítače.

Name	Typ	Description
name	string	Název instance zobrazení rozšíření VM.
statuses	InstanceViewStatus[]	Informace o stavu zdroje
subStatuses	InstanceViewStatus[]	Informace o stavu zdroje