Nodes - List Node Extensions

Usługa:: Batch Service

Wersja interfejsu API:: 2025-06-01

Lista rozszerzeń węzłów obliczeniowych w określonej puli.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string (uri)	Punkt końcowy konta usługi Batch (na przykład: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	ID węzła obliczeniowego, na którym chcesz wymienić rozszerzenia.
poolId	path	True	string	ID puli, która zawiera węzeł obliczeniowy.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.
$select	query		string[]	Klauzula OData $select.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Maksymalna liczba elementów do zwrócenia w odpowiedzi. Maksymalnie można zwrócić 1000 wniosków.
timeOut	query		integer (int32)	Maksymalny czas przetwarzania żądania przez serwer w sekundach. Wartość domyślna to 30 sekund. Jeśli wartość jest większa niż 30, zostanie użyta domyślna wersja domyślna.".

Nagłówek żądania

Nazwa	Typ	Opis
client-request-id	string	Tożsamość żądania wygenerowanego przez obiekt wywołujący w postaci identyfikatora GUID bez dekoracji, takiej jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Czy serwer powinien zwrócić identyfikator żądania klienta w odpowiedzi.
ocp-date	string (date-time-rfc7231)	Czas wystawienia żądania. Biblioteki klienckie zazwyczaj ustawiają tę wartość na bieżący czas zegara systemowego; ustaw go jawnie, jeśli bezpośrednio wywołujesz interfejs API REST.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	BatchNodeVMExtensionListResult	Żądanie zakończyło się pomyślnie. Nagłówki ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Nieoczekiwana odpowiedź na błąd.

Nazwa

Typ

Opis

200 OK

BatchNodeVMExtensionListResult

Żądanie zakończyło się pomyślnie.

Nagłówki

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

Other Status Codes

BatchError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Zakresy

Nazwa	Opis
https://batch.core.windows.net//.default

Przykłady

List compute node extensions

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:: 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
      }
    }
  ]
}

Definicje

Nazwa	Opis
BatchError	Odebrano odpowiedź o błędzie z usługi Azure Batch.
BatchErrorDetail	Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch.
BatchErrorMessage	Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.
BatchNodeVMExtension	Konfiguracja widoku wystąpienia rozszerzenia maszyny wirtualnej.
BatchNodeVMExtensionListResult	Wynik wyświetlania listy rozszerzeń węzła obliczeniowego w węźle.
InstanceViewStatus	Stan widoku wystąpienia.
StatusLevelTypes	Kod poziomu.
VMExtension	Konfiguracja rozszerzeń maszyn wirtualnych.
VMExtensionInstanceView	Widok wystąpienia rozszerzenia maszyny wirtualnej.

BatchError

Objekt

Odebrano odpowiedź o błędzie z usługi Azure Batch.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
message	BatchErrorMessage	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.
values	BatchErrorDetail[]	Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu.

BatchErrorDetail

Objekt

Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch.

Nazwa	Typ	Opis
key	string	Identyfikator określający znaczenie właściwości Value.
value	string	Dodatkowe informacje zawarte w odpowiedzi na błąd.

BatchErrorMessage

Objekt

Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.

Nazwa	Typ	Opis
lang	string	Kod językowy komunikatu o błędzie.
value	string	Tekst wiadomości.

BatchNodeVMExtension

Objekt

Konfiguracja widoku wystąpienia rozszerzenia maszyny wirtualnej.

Nazwa	Typ	Opis
instanceView	VMExtensionInstanceView	Widok wystąpienia rozszerzenia maszyny wirtualnej.
provisioningState	string	Stan udostępniania rozszerzenia maszyny wirtualnej.
vmExtension	VMExtension	Rozszerzenie maszyny wirtualnej.

BatchNodeVMExtensionListResult

Objekt

Wynik wyświetlania listy rozszerzeń węzła obliczeniowego w węźle.

Nazwa	Typ	Opis
odata.nextLink	string (uri)	Adres URL, aby uzyskać następny zestaw wyników.
value	BatchNodeVMExtension[]	Lista rozszerzeń Compute Node.

InstanceViewStatus

Objekt

Stan widoku wystąpienia.

Nazwa	Typ	Opis
code	string	Kod stanu.
displayStatus	string	Lokalna etykieta statusu.
level	StatusLevelTypes	Kod poziomu.
message	string	Szczegółowy komunikat statusu.
time	string (date-time)	Czas stanu.

StatusLevelTypes

Wyliczenie

Kod poziomu.

Wartość	Opis
Error	Error
Info	Informacje
Warning	Ostrzeżenie

VMExtension

Objekt

Konfiguracja rozszerzeń maszyn wirtualnych.

Nazwa	Typ	Opis
autoUpgradeMinorVersion	boolean	Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true.
enableAutomaticUpgrade	boolean	Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja rozszerzenia.
name	string	Nazwa rozszerzenia maszyny wirtualnej.
protectedSettings	object	Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione.
provisionAfterExtensions	string[]	Kolekcja nazw rozszerzeń. Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie.
publisher	string	Nazwa wydawcy programu obsługi rozszerzeń.
settings	object	Ustawienia publiczne w formacie JSON dla rozszerzenia.
type	string	Rodzaj przedłużenia.
typeHandlerVersion	string	Wersja programu obsługi skryptów.

VMExtensionInstanceView

Objekt

Widok wystąpienia rozszerzenia maszyny wirtualnej.

Nazwa	Typ	Opis
name	string	Nazwa widoku instancji rozszerzenia VM.
statuses	InstanceViewStatus[]	Informacje o stanie zasobu.
subStatuses	InstanceViewStatus[]	Informacje o stanie zasobu.

Udostępnij przez

Nodes - List Node Extensions

Parametry identyfikatora URI

Nagłówek żądania

Odpowiedzi

Zabezpieczenia

OAuth2Auth

Zakresy

Przykłady

List compute node extensions

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

BatchError

BatchErrorDetail

BatchErrorMessage

BatchNodeVMExtension

BatchNodeVMExtensionListResult

InstanceViewStatus

StatusLevelTypes

VMExtension

VMExtensionInstanceView