Delen via

Nodes - List Node Extensions

Service:
Batch Service
API-versie:
2025-06-01

Geeft een lijst van de extensies van de Compute Nodes in de opgegeven pool.

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

URI-parameters

Name In Vereist Type Description
endpoint
 path True

string (uri)

Batch-accounteindpunt (bijvoorbeeld: https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

De ID van de Compute Node die je extensies wilt vermelden.
poolId
 path True

string

De ID van de pool die de rekenknoop bevat.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.
$select
 query

string[]

Een OData-$select-component.
maxresults
 query

integer (int32)

minimum: 1
maximum: 1000

Het maximum aantal items dat moet worden geretourneerd in het antwoord. Maximaal 1000 aanvragen kunnen worden teruggestuurd.
timeOut
 query

integer (int32)

De maximale tijd die de server kan besteden aan het verwerken van de aanvraag, in seconden. De standaardwaarde is 30 seconden. Als de waarde groter is dan 30, wordt de standaard in plaats daarvan gebruikt."

Aanvraagkoptekst

Name Vereist Type Description
client-request-id

string

De door de aanroeper gegenereerde aanvraagidentiteit, in de vorm van een GUID zonder decoratie, zoals accolades, bijvoorbeeld 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Of de server de clientaanvraag-id in het antwoord moet retourneren.
ocp-date

string (date-time-rfc7231)

Het tijdstip waarop de aanvraag is uitgegeven. Clientbibliotheken stellen dit doorgaans in op de huidige kloktijd van het systeem; stel deze expliciet in als u de REST API rechtstreeks aanroept.

Antwoorden

Name Type Description
200 OK

BatchNodeVMExtensionListResult

De aanvraag is voltooid.

Kopteksten

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

BatchError

Een onverwachte foutreactie.

Beveiliging

OAuth2Auth

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiken

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

Voorbeelden

List compute node extensions

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:
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
      }
    }
  ]
}

Definities

Name Description
BatchError

Er is een foutbericht ontvangen van de Azure Batch-service.
BatchErrorDetail

Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.
BatchErrorMessage

Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.
BatchNodeVMExtension

De configuratie voor de exemplaarweergave van de virtuele-machineextensie.
BatchNodeVMExtensionListResult

Het resultaat van het weergeven van de compute-knooppuntextensies in een knooppunt.
InstanceViewStatus

De status van de instantieweergave.
StatusLevelTypes

Levelcode.
VMExtension

De configuratie voor extensies van virtuele machines.
VMExtensionInstanceView

De weergave vm-extensie-exemplaar.

BatchError

Object

Er is een foutbericht ontvangen van de Azure Batch-service.

Name Type Description
code

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
message

BatchErrorMessage

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
values

BatchErrorDetail[]

Een verzameling sleutel-waardeparen met aanvullende informatie over de fout.

BatchErrorDetail

Object

Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.

Name Type Description
key

string

Een id die de betekenis van de eigenschap Waarde aangeeft.
value

string

De aanvullende informatie die is opgenomen in het foutbericht.

BatchErrorMessage

Object

Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.

Name Type Description
lang

string

De taalcode van het foutbericht.
value

string

De tekst van het bericht.

BatchNodeVMExtension

Object

De configuratie voor de exemplaarweergave van de virtuele-machineextensie.

Name Type Description
instanceView

VMExtensionInstanceView

De weergave vm-extensie-exemplaar.
provisioningState

string

De provisioning-status van de virtual machine-extensie.
vmExtension

VMExtension

De virtuele machine-extensie.

BatchNodeVMExtensionListResult

Object

Het resultaat van het weergeven van de compute-knooppuntextensies in een knooppunt.

Name Type Description
odata.nextLink

string (uri)

De URL om de volgende reeks resultaten te krijgen.
value

BatchNodeVMExtension[]

De lijst met Compute Node-extensies.

InstanceViewStatus

Object

De status van de instantieweergave.

Name Type Description
code

string

De statuscode.
displayStatus

string

Het gelokaliseerde label voor de status.
level

StatusLevelTypes

Levelcode.
message

string

Het gedetailleerde statusbericht.
time

string (date-time)

Het tijdstip van de status.

StatusLevelTypes

Opsomming

Levelcode.

Waarde Description
Error

Fout
Info

Informatie
Warning

Waarschuwing

VMExtension

Object

De configuratie voor extensies van virtuele machines.

Name Type Description
autoUpgradeMinorVersion

boolean

Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true.
enableAutomaticUpgrade

boolean

Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie van de extensie beschikbaar is.
name

string

De naam van de extensie van de virtuele machine.
protectedSettings

object

De extensie kan protectedSettings of protectedSettingsFromKeyVault of helemaal geen beveiligde instellingen bevatten.
provisionAfterExtensions

string[]

De verzameling extensienamen. Verzameling extensienamen waarna deze extensie moet worden ingericht.
publisher

string

De naam van de uitgever van de extensie-handler.
settings

object

Openbare instellingen met JSON-indeling voor de extensie.
type

string

Het type verlenging.
typeHandlerVersion

string

De versie van de scripthandler.

VMExtensionInstanceView

Object

De weergave vm-extensie-exemplaar.

Name Type Description
name

string

De naam van de instance view van de VM-extensie.
statuses

InstanceViewStatus[]

De informatie over de resourcestatus.
subStatuses

InstanceViewStatus[]

De informatie over de resourcestatus.