Delen via

Nodes - Upload Node Logs

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

Upload Azure Batch service log files van de specificeerde Compute Node naar Azure Blob Storage.
Dit is bedoeld om Azure Batch-servicelogbestanden op geautomatiseerde wijze te verzamelen vanuit Compute Nodes als je een fout ervaart en wilt escaleren naar Azure-ondersteuning. De logboekbestanden van de Azure Batch-service moeten worden gedeeld met Azure-ondersteuning voor hulp bij het opsporen van fouten met de Batch-service.

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2025-06-01
Met optionele parameters: 
POST {endpoint}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2025-06-01&timeOut={timeOut}

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 waarvoor je het Remote Desktop Protocol-bestand wilt krijgen.
poolId
 path True

string

De id van de pool die het rekenknooppunt bevat.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.
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

Media Types: "application/json; odata=minimalmetadata"

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.

Aanvraagbody

Media Types: "application/json; odata=minimalmetadata"

Name Vereist Type Description
containerUrl True

string (uri)

De URL van de container binnen Azure Blob Storage waarop het Batch Service-logbestand (of de logbestanden) moet worden geüpload. Als een door de gebruiker toegewezen beheerde identiteit niet wordt gebruikt, moet de URL een Shared Access Signature (SAS) bevatten die schrijfrechten aan de container verleent. De SAS-duur moet voldoende tijd bieden om de upload te voltooien. De starttijd voor SAS is optioneel en wordt aanbevolen niet te specificeren.
startTime True

string (date-time)

Het begin van het tijdsbereik van waaruit het uploaden van het Batch Service-logbestand(en) moet worden geüpload. Elk logbestand met een logbericht binnen die tijdsperiode wordt geüpload. Dit betekent dat de operatie mogelijk meer logs ophaalt dan is gevraagd, aangezien het hele logbestand altijd wordt geüpload, maar de operatie zou niet minder logs moeten ophalen dan al is gevraagd.
endTime

string (date-time)

Het einde van het tijdsbereik om Batch Service-logbestanden te uploaden. Elk logbestand met een logbericht binnen die tijdsperiode wordt geüpload. Dit betekent dat de operatie mogelijk meer logs ophaalt dan is gevraagd, aangezien het hele logbestand altijd wordt geüpload, maar de operatie zou niet minder logs moeten ophalen dan al is gevraagd. Als dit wordt weggelaten, is de standaard om alle beschikbare logs na de startTime te uploaden.
identityReference

BatchNodeIdentityReference

De verwijzing naar de door de gebruiker toegewezen identiteit om toegang te krijgen tot Azure Blob Storage is gespecificeerd door containerUrl. De identiteit moet schrijftoegang hebben tot de Azure Blob Storage container.

Antwoorden

Name Type Description
200 OK

UploadBatchServiceLogsResult

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

Upload BatchService Logs

Voorbeeldaanvraag

POST {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/uploadbatchservicelogs?api-version=2025-06-01



{
  "containerUrl": "https://somestorageacct.blob.core.windows.net/batch-compute-node-logs?se=2025-12-09T18%3A51%3A00Z&sp=w&sv=2025-05-31&sr=c&sig",
  "startTime": "2025-11-27T00:00:00Z"
}

Voorbeeldrespons

Statuscode:
200 
{
  "virtualDirectoryName": "poolId/tvm-1695681911-1-20161121t182739z/0795539d-82fe-48e3-bbff-2964905b6de0",
  "numberOfFilesUploaded": 8
}

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.
BatchNodeIdentityReference

De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt.
UploadBatchServiceLogsOptions

De logboekbestanden van de Azure Batch-service uploaden parameters voor een rekenknooppunt.
UploadBatchServiceLogsResult

Het resultaat van het uploaden van Batch-servicelogboekbestanden van een specifiek rekenknooppunt.

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.

BatchNodeIdentityReference

Object

De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt.

Name Type Description
resourceId

string (arm-id)

De ARM-resource-id van de door de gebruiker toegewezen identiteit.

UploadBatchServiceLogsOptions

Object

De logboekbestanden van de Azure Batch-service uploaden parameters voor een rekenknooppunt.

Name Type Description
containerUrl

string (uri)

De URL van de container binnen Azure Blob Storage waarop het Batch Service-logbestand (of de logbestanden) moet worden geüpload. Als een door de gebruiker toegewezen beheerde identiteit niet wordt gebruikt, moet de URL een Shared Access Signature (SAS) bevatten die schrijfrechten aan de container verleent. De SAS-duur moet voldoende tijd bieden om de upload te voltooien. De starttijd voor SAS is optioneel en wordt aanbevolen niet te specificeren.
endTime

string (date-time)

Het einde van het tijdsbereik om Batch Service-logbestanden te uploaden. Elk logbestand met een logbericht binnen die tijdsperiode wordt geüpload. Dit betekent dat de operatie mogelijk meer logs ophaalt dan is gevraagd, aangezien het hele logbestand altijd wordt geüpload, maar de operatie zou niet minder logs moeten ophalen dan al is gevraagd. Als dit wordt weggelaten, is de standaard om alle beschikbare logs na de startTime te uploaden.
identityReference

BatchNodeIdentityReference

De verwijzing naar de door de gebruiker toegewezen identiteit om toegang te krijgen tot Azure Blob Storage is gespecificeerd door containerUrl. De identiteit moet schrijftoegang hebben tot de Azure Blob Storage container.
startTime

string (date-time)

Het begin van het tijdsbereik van waaruit het uploaden van het Batch Service-logbestand(en) moet worden geüpload. Elk logbestand met een logbericht binnen die tijdsperiode wordt geüpload. Dit betekent dat de operatie mogelijk meer logs ophaalt dan is gevraagd, aangezien het hele logbestand altijd wordt geüpload, maar de operatie zou niet minder logs moeten ophalen dan al is gevraagd.

UploadBatchServiceLogsResult

Object

Het resultaat van het uploaden van Batch-servicelogboekbestanden van een specifiek rekenknooppunt.

Name Type Description
numberOfFilesUploaded

integer (int32)

Het aantal logbestanden dat geüpload zal worden.
virtualDirectoryName

string

De virtuele directory binnen de Azure Blob Storage-container waaraan het Batch Service-logbestand wordt geüpload. De virtuele mapnaam maakt deel uit van de blobnaam voor elk geüpload logbestand, en wordt gebouwd op basis van poolId, nodeId en een unieke identificatie.