Compute Node - Upload Batch Service Logs

Cargue Azure Batch archivos de registro del servicio desde el nodo de proceso especificado en Azure Blob Storage.
Esto es para recopilar Azure Batch archivos de registro de servicio de forma automatizada desde nodos de proceso si experimenta un error y desea escalar a Soporte técnico de Azure. Los archivos de registro del servicio Azure Batch deben compartirse con Soporte técnico de Azure para ayudar a depurar problemas con el servicio Batch.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?timeout={timeout}&api-version=2023-11-01.18.0

Parámetros de identificador URI

Nombre En Requerido Tipo Description
batchUrl
path True

string

Dirección URL base de todas las solicitudes de servicio de Azure Batch.

nodeId
path True

string

Identificador del nodo de proceso desde el que desea cargar los archivos de registro del servicio Azure Batch.

poolId
path True

string

Identificador del grupo que contiene el nodo de proceso.

api-version
query True

string

Versión de la API de cliente.

timeout
query

integer

int32

Tiempo máximo que el servidor puede dedicar a procesar la solicitud, en segundos. El valor predeterminado es 30 segundos.

Encabezado de la solicitud

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

Nombre Requerido Tipo Description
client-request-id

string

uuid

La identidad de solicitud generada por el autor de la llamada, en forma de GUID sin decoración como llaves, por ejemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Si el servidor debe devolver el client-request-id en la respuesta.

ocp-date

string

date-time-rfc1123

Hora en que se emitió la solicitud. Las bibliotecas cliente suelen establecer esto en la hora del reloj del sistema actual; establézcalo explícitamente si llama directamente a la API REST.

Cuerpo de la solicitud

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

Nombre Requerido Tipo Description
containerUrl True

string

La dirección URL del contenedor dentro de Azure Blob Storage a la que cargar los archivos de registro del servicio Batch.
Si no se usa una identidad administrada asignada por el usuario, la dirección URL debe incluir una firma de acceso compartido (SAS) que conceda permisos de escritura al contenedor. La duración de SAS debe permitir tiempo suficiente para que finalice la carga. La hora de inicio de SAS es opcional y se recomienda no especificar.

startTime True

string

Inicio del intervalo de tiempo desde el que se cargan los archivos de registro del servicio Batch.
Se cargará cualquier archivo de registro que contenga un mensaje de registro en el intervalo de tiempo. Esto significa que la operación podría recuperar más registros de los que se han solicitado, ya que todo el archivo de registro siempre se carga, pero la operación no debe recuperar menos registros de los que se han solicitado.

endTime

string

El final del intervalo de tiempo desde el que se cargan los archivos de registro del servicio Batch.
Se cargará cualquier archivo de registro que contenga un mensaje de registro en el intervalo de tiempo. Esto significa que la operación podría recuperar más registros de los que se han solicitado, ya que todo el archivo de registro siempre se carga, pero la operación no debe recuperar menos registros de los que se han solicitado. Si se omite, el valor predeterminado es cargar todos los registros disponibles después de startTime.

identityReference

ComputeNodeIdentityReference

Referencia a la identidad asignada por el usuario que se va a usar para acceder a Azure Blob Storage especificados por containerUrl.
La identidad debe tener acceso de escritura al contenedor de Azure Blob Storage.

Respuestas

Nombre Tipo Description
200 OK

UploadBatchServiceLogsResult

La solicitud al servicio Batch se realizó correctamente.

Headers

  • client-request-id: string
  • request-id: string
Other Status Codes

BatchError

Error del servicio Batch.

Seguridad

azure_auth

Microsoft Entra flujo de código de autenticación de OAuth 2.0

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre Description
user_impersonation Suplantación de su cuenta de usuario

Authorization

Type: apiKey
In: header

Ejemplos

Upload BatchService Logs

Sample Request

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/uploadbatchservicelogs?api-version=2023-11-01.18.0



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

Sample Response

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

Definiciones

Nombre Description
BatchError

Respuesta de error recibida del servicio Azure Batch.

BatchErrorDetail

Elemento de información adicional incluida en una respuesta de error Azure Batch.

ComputeNodeIdentityReference

Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso.

ErrorMessage

Mensaje de error recibido en una respuesta de error Azure Batch.

UploadBatchServiceLogsConfiguration

Los archivos de registro del servicio Azure Batch cargan la configuración de un nodo de proceso.

UploadBatchServiceLogsResult

Resultado de cargar los archivos de registro del servicio Batch desde un nodo de proceso específico.

BatchError

Respuesta de error recibida del servicio Azure Batch.

Nombre Tipo Description
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.

message

ErrorMessage

Mensaje que describe el error, diseñado para ser adecuado para su presentación en una interfaz de usuario.

values

BatchErrorDetail[]

Colección de pares clave-valor que contienen detalles adicionales sobre el error.

BatchErrorDetail

Elemento de información adicional incluida en una respuesta de error Azure Batch.

Nombre Tipo Description
key

string

Identificador que especifica el significado de la propiedad Value.

value

string

Información adicional incluida con la respuesta de error.

ComputeNodeIdentityReference

Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso.

Nombre Tipo Description
resourceId

string

Identificador de recurso de ARM de la identidad asignada por el usuario.

ErrorMessage

Mensaje de error recibido en una respuesta de error Azure Batch.

Nombre Tipo Description
lang

string

Código de idioma del mensaje de error

value

string

Texto del mensaje.

UploadBatchServiceLogsConfiguration

Los archivos de registro del servicio Azure Batch cargan la configuración de un nodo de proceso.

Nombre Tipo Description
containerUrl

string

La dirección URL del contenedor dentro de Azure Blob Storage a la que cargar los archivos de registro del servicio Batch.
Si no se usa una identidad administrada asignada por el usuario, la dirección URL debe incluir una firma de acceso compartido (SAS) que conceda permisos de escritura al contenedor. La duración de SAS debe permitir tiempo suficiente para que finalice la carga. La hora de inicio de SAS es opcional y se recomienda no especificar.

endTime

string

El final del intervalo de tiempo desde el que se cargan los archivos de registro del servicio Batch.
Se cargará cualquier archivo de registro que contenga un mensaje de registro en el intervalo de tiempo. Esto significa que la operación podría recuperar más registros de los que se han solicitado, ya que todo el archivo de registro siempre se carga, pero la operación no debe recuperar menos registros de los que se han solicitado. Si se omite, el valor predeterminado es cargar todos los registros disponibles después de startTime.

identityReference

ComputeNodeIdentityReference

Referencia a la identidad asignada por el usuario que se va a usar para acceder a Azure Blob Storage especificados por containerUrl.
La identidad debe tener acceso de escritura al contenedor de Azure Blob Storage.

startTime

string

Inicio del intervalo de tiempo desde el que se cargan los archivos de registro del servicio Batch.
Se cargará cualquier archivo de registro que contenga un mensaje de registro en el intervalo de tiempo. Esto significa que la operación podría recuperar más registros de los que se han solicitado, ya que todo el archivo de registro siempre se carga, pero la operación no debe recuperar menos registros de los que se han solicitado.

UploadBatchServiceLogsResult

Resultado de cargar los archivos de registro del servicio Batch desde un nodo de proceso específico.

Nombre Tipo Description
numberOfFilesUploaded

integer

Número de archivos de registro que se cargarán.

virtualDirectoryName

string

El directorio virtual de Azure Blob Storage contenedor al que se cargarán los archivos de registro del servicio Batch.
El nombre del directorio virtual forma parte del nombre del blob para cada archivo de registro cargado y se basa en poolId, nodeId y un identificador único.