Partilhar via

Nodes - Upload Node Logs

Serviço:
Batch Service
Versão da API:
2025-06-01

Carregar ficheiros de registo do serviço Azure Batch do Compute Node especificado para o Azure Blob Storage.
Isto serve para recolher ficheiros de registo do Azure Batch de forma automatizada a partir dos Compute Nodes caso esteja a experienciar um erro e pretenda escalar para o suporte Azure. Os arquivos de log do serviço Batch do Azure devem ser compartilhados com o suporte do Azure para ajudar na depuração de problemas com o serviço em lote.

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2025-06-01
Com parâmetros opcionais: 
POST {endpoint}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2025-06-01&timeOut={timeOut}

Parâmetros do URI

Name Em Necessário Tipo Description
endpoint
 path True

string (uri)

Ponto de extremidade da conta em lote (por exemplo: https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

O ID do Nó de Computação para o qual queres obter o ficheiro do Protocolo de Ambiente de Trabalho Distante.
poolId
 path True

string

A ID do Pool que contém o Nó de Computação.
api-version
 query True

string

minLength: 1

A versão da API a utilizar para esta operação.
timeOut
 query

integer (int32)

O tempo máximo que o servidor pode gastar processando a solicitação, em segundos. O padrão é 30 segundos. Se o valor for superior a 30, será usado o padrão em vez disso.".

Cabeçalho do Pedido

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

Name Necessário Tipo Description
client-request-id

string

A identidade de solicitação gerada pelo chamador, na forma de um GUID sem decoração, como chaves encaracoladas, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Se o servidor deve retornar o client-request-id na resposta.
ocp-date

string (date-time-rfc7231)

A hora em que o pedido foi emitido. As bibliotecas de cliente normalmente definem isso para a hora atual do relógio do sistema; defina-o explicitamente se você estiver chamando a API REST diretamente.

Corpo do Pedido

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

Name Necessário Tipo Description
containerUrl True

string (uri)

A URL do contentor dentro do Azure Blob Storage para onde carregar o(s) ficheiro(s) de registo do Batch Service. Se uma identidade gerida atribuída pelo utilizador não estiver a ser utilizada, o URL deve incluir uma Assinatura de Acesso Partilhada (SAS) que concede permissões de escrita ao contentor. A duração do SAS deve permitir tempo suficiente para o upload terminar. A hora de início do SAS é opcional e recomenda-se não ser especificada.
startTime True

string (date-time)

O início do intervalo de tempo a partir do qual se deve carregar ficheiro(s) de registo de Batch Service. Qualquer ficheiro de registo contendo uma mensagem de registo no intervalo de tempo será carregado. Isto significa que a operação pode recuperar mais registos do que os solicitados, uma vez que todo o ficheiro de registo é sempre carregado, mas a operação não deve recuperar menos registos do que os solicitados.
endTime

string (date-time)

O fim do intervalo de tempo a partir do qual se deve carregar ficheiro(s) de registo do Serviço Batch. Qualquer ficheiro de registo contendo uma mensagem de registo no intervalo de tempo será carregado. Isto significa que a operação pode recuperar mais registos do que os solicitados, uma vez que todo o ficheiro de registo é sempre carregado, mas a operação não deve recuperar menos registos do que os solicitados. Se for omitido, o padrão é carregar todos os registos disponíveis após o Tempo de Início.
identityReference

BatchNodeIdentityReference

A referência à identidade atribuída pelo utilizador para aceder ao Azure Blob Storage especificada pelo containerUrl. A identidade deve ter acesso de escrita ao contentor Azure Blob Storage.

Respostas

Name Tipo Description
200 OK

UploadBatchServiceLogsResult

O pedido foi bem-sucedido.

Cabeçalhos

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

BatchError

Uma resposta de erro inesperada.

Segurança

OAuth2Auth

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Âmbitos

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

Exemplos

Upload BatchService Logs

Pedido de amostra

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"
}

Resposta da amostra

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

Definições

Name Description
BatchError

Uma resposta de erro recebida do serviço Batch do Azure.
BatchErrorDetail

Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.
BatchErrorMessage

Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.
BatchNodeIdentityReference

A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará.
UploadBatchServiceLogsOptions

Os arquivos de log do serviço Lote do Azure carregam parâmetros para um nó de computação.
UploadBatchServiceLogsResult

O resultado do carregamento de arquivos de log do serviço em lote de um nó de computação específico.

BatchError

Object

Uma resposta de erro recebida do serviço Batch do Azure.

Name Tipo Description
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
message

BatchErrorMessage

Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.
values

BatchErrorDetail[]

Uma coleção de pares chave-valor contendo detalhes adicionais sobre o erro.

BatchErrorDetail

Object

Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.

Name Tipo Description
key

string

Um identificador que especifica o significado da propriedade Value.
value

string

As informações adicionais incluídas com a resposta de erro.

BatchErrorMessage

Object

Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.

Name Tipo Description
lang

string

O código da linguagem da mensagem de erro.
value

string

O texto da mensagem.

BatchNodeIdentityReference

Object

A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará.

Name Tipo Description
resourceId

string (arm-id)

O ID de recurso ARM da identidade atribuída ao usuário.

UploadBatchServiceLogsOptions

Object

Os arquivos de log do serviço Lote do Azure carregam parâmetros para um nó de computação.

Name Tipo Description
containerUrl

string (uri)

A URL do contentor dentro do Azure Blob Storage para onde carregar o(s) ficheiro(s) de registo do Batch Service. Se uma identidade gerida atribuída pelo utilizador não estiver a ser utilizada, o URL deve incluir uma Assinatura de Acesso Partilhada (SAS) que concede permissões de escrita ao contentor. A duração do SAS deve permitir tempo suficiente para o upload terminar. A hora de início do SAS é opcional e recomenda-se não ser especificada.
endTime

string (date-time)

O fim do intervalo de tempo a partir do qual se deve carregar ficheiro(s) de registo do Serviço Batch. Qualquer ficheiro de registo contendo uma mensagem de registo no intervalo de tempo será carregado. Isto significa que a operação pode recuperar mais registos do que os solicitados, uma vez que todo o ficheiro de registo é sempre carregado, mas a operação não deve recuperar menos registos do que os solicitados. Se for omitido, o padrão é carregar todos os registos disponíveis após o Tempo de Início.
identityReference

BatchNodeIdentityReference

A referência à identidade atribuída pelo utilizador para aceder ao Azure Blob Storage especificada pelo containerUrl. A identidade deve ter acesso de escrita ao contentor Azure Blob Storage.
startTime

string (date-time)

O início do intervalo de tempo a partir do qual se deve carregar ficheiro(s) de registo de Batch Service. Qualquer ficheiro de registo contendo uma mensagem de registo no intervalo de tempo será carregado. Isto significa que a operação pode recuperar mais registos do que os solicitados, uma vez que todo o ficheiro de registo é sempre carregado, mas a operação não deve recuperar menos registos do que os solicitados.

UploadBatchServiceLogsResult

Object

O resultado do carregamento de arquivos de log do serviço em lote de um nó de computação específico.

Name Tipo Description
numberOfFilesUploaded

integer (int32)

O número de ficheiros de registo que serão carregados.
virtualDirectoryName

string

O diretório virtual dentro do contentor Azure Blob Storage para onde o(s) ficheiro(s) de registo do Batch Service serão carregados. O nome do diretório virtual faz parte do nome do blob para cada ficheiro de registo carregado, e é construído com base em poolId, nodeId e um identificador único.