Compute Node - Upload Batch Service Logs

Referencia

Servicio:: Batch Service

Versión de la API:: 2024-07-01.20.0

Cargue los archivos de registro del servicio Azure Batch desde el nodo de proceso especificado en Azure Blob Storage.
Esto es para recopilar archivos de registro del servicio Azure Batch de forma automatizada desde nodos de proceso si experimenta un error y desea escalar al 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=2024-07-01.20.0

Con parámetros opcionales:

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?timeout={timeout}&api-version=2024-07-01.20.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. Si el valor es mayor que 30, se usará el valor predeterminado en su lugar.

Encabezado de la solicitud

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

Nombre	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 en la que se cargan 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 (date-time)	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 puede recuperar más registros de los solicitados, ya que todo el archivo de registro siempre se carga, pero la operación no debe recuperar menos registros de los solicitados.
endTime		string (date-time)	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 puede recuperar más registros de los solicitados, ya que todo el archivo de registro siempre se carga, pero la operación no debe recuperar menos registros de los solicitados. 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 especificado 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. Encabezados client-request-id: string request-id: string
Other Status Codes	BatchError	Error del servicio Batch.

Nombre

Tipo

Description

200 OK

UploadBatchServiceLogsResult

La solicitud al servicio Batch se realizó correctamente.

Encabezados

client-request-id: string
request-id: string

Other Status Codes

BatchError

Error del servicio Batch.

Seguridad

azure_auth

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

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	Suplantar la cuenta de usuario

Authorization

Tipo: apiKey
En: header

Ejemplos

Upload BatchService Logs

Solicitud de ejemplo

HTTP

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/uploadbatchservicelogs?api-version=2024-07-01.20.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"
}

Respuesta de muestra

status code:: 200

{
  "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	Un elemento de información adicional incluida en una respuesta de error de 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 de Azure Batch.
UploadBatchServiceLogsConfiguration	La configuración de carga de archivos de registro del servicio Azure Batch para un nodo de proceso.
UploadBatchServiceLogsResult	Resultado de cargar archivos de registro del servicio Batch desde un nodo de proceso específico.

BatchError

Object

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 mostrarse en una interfaz de usuario.
values	BatchErrorDetail[]	Colección de pares clave-valor que contienen detalles adicionales sobre el error.

BatchErrorDetail

Object

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

Nombre	Tipo	Description
key	string	Identificador que especifica el significado de la propiedad Value.
value	string	La información adicional incluida con la respuesta de error.

ComputeNodeIdentityReference

Object

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

Object

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

Nombre	Tipo	Description
lang	string	El código de idioma del mensaje de error
value	string	Texto del mensaje.

UploadBatchServiceLogsConfiguration

Object

La configuración de carga de archivos de registro del servicio Azure Batch para un nodo de proceso.

Nombre	Tipo	Description
containerUrl	string	La dirección URL del contenedor dentro de Azure Blob Storage en la que se cargan 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 (date-time)	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 puede recuperar más registros de los solicitados, ya que todo el archivo de registro siempre se carga, pero la operación no debe recuperar menos registros de los solicitados. 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 especificado por containerUrl. La identidad debe tener acceso de escritura al contenedor de Azure Blob Storage.
startTime	string (date-time)	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 puede recuperar más registros de los solicitados, ya que todo el archivo de registro siempre se carga, pero la operación no debe recuperar menos registros de los solicitados.

UploadBatchServiceLogsResult

Object

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

Nombre	Tipo	Description
numberOfFilesUploaded	integer (int32)	Número de archivos de registro que se cargarán.
virtualDirectoryName	string	Directorio virtual dentro del contenedor de Azure Blob Storage 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 crea poolId, nodeId y un identificador único.

Compartir a través de

Compute Node - Upload Batch Service Logs

Parámetros de identificador URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Authorization

Ejemplos

Upload BatchService Logs

Solicitud de ejemplo

Respuesta de muestra

Definiciones

BatchError

BatchErrorDetail

ComputeNodeIdentityReference

ErrorMessage

UploadBatchServiceLogsConfiguration

UploadBatchServiceLogsResult

Recursos adicionales