Compartilhar via

Nodes - Upload Node Logs

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

Faça upload dos arquivos de log do serviço Batch do Compute Node especificado para o Azure Blob Storage.
Isso é para coletar arquivos de log de serviço Batch do Azure de forma automatizada a partir dos Compute Nodes, caso você esteja enfrentando um erro e deseje escalar para o suporte do Azure. Os arquivos de log de serviço do Lote do Azure devem ser compartilhados com o suporte do Azure para ajudar na depuração de problemas com o serviço 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 de URI

Nome Em Obrigatório Tipo Description
endpoint
 path True

string (uri)

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

string

O ID do Nó de Computação para o qual você quer obter o arquivo do Protocolo de Área de Trabalho Remota.
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 ser usada 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 maior que 30, o padrão será usado em seu lugar.".

Cabeçalho da solicitação

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

Nome Obrigatório Tipo Description
client-request-id

string

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

boolean

Se o servidor deve retornar a ID de solicitação do cliente na resposta.
ocp-date

string (date-time-rfc7231)

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

Corpo da solicitação

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

Nome Obrigatório Tipo Description
containerUrl True

string (uri)

A URL do contêiner dentro do Azure Blob Storage para o qual é enviado o(s) arquivo(s) de log do Batch Service. Se uma identidade gerenciada atribuída pelo usuário não estiver sendo usada, a URL deve incluir uma Assinatura de Acesso Compartilhada (SAS) concedendo permissões de escrita ao contêiner. A duração do SAS deve permitir tempo suficiente para o upload ser concluído. O horário de início do SAS é opcional e recomenda-se não ser especificado.
startTime True

string (date-time)

O início do intervalo de tempo a partir do qual é necessário enviar arquivo(s) de log de Batch Service. Qualquer arquivo de log contendo uma mensagem de log dentro do intervalo de tempo será enviado. Isso significa que a operação pode recuperar mais logs do que os solicitados, já que todo o arquivo de log é sempre carregado, mas a operação não deve recuperar menos logs do que os solicitados.
endTime

string (date-time)

O intervalo de tempo para o upload dos arquivos de log do Batch Service. Qualquer arquivo de log contendo uma mensagem de log dentro do intervalo de tempo será enviado. Isso significa que a operação pode recuperar mais logs do que os solicitados, já que todo o arquivo de log é sempre carregado, mas a operação não deve recuperar menos logs do que os solicitados. Se omitido, o padrão é enviar todos os logs disponíveis após o startTime.
identityReference

BatchNodeIdentityReference

A referência à identidade atribuída pelo usuário para usar para acessar o Azure Blob Storage especificada pelo containerUrl. A identidade deve ter acesso de escrita ao contêiner Azure Blob Storage.

Respostas

Nome Tipo Description
200 OK

UploadBatchServiceLogsResult

A solicitação foi bem-sucedida.

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
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Escopos

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

Exemplos

Upload BatchService Logs

Solicitação de exemplo

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 de exemplo

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

Definições

Nome Description
BatchError

Uma resposta de erro recebida do serviço do Lote 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 pelo usuário associada ao pool do Lote que um nó de computação usará.
UploadBatchServiceLogsOptions

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

O resultado do carregamento de arquivos de log de serviço do Lote de um Nó de Computação específico.

BatchError

Objeto

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

Nome Tipo Description
code

string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
message

BatchErrorMessage

Uma mensagem que descreve 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

Objeto

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

Nome Tipo Description
key

string

Um identificador que especifica o significado da propriedade Value.
value

string

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

BatchErrorMessage

Objeto

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

Nome Tipo Description
lang

string

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

string

O texto da mensagem.

BatchNodeIdentityReference

Objeto

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

Nome Tipo Description
resourceId

string (arm-id)

A ID de recurso do ARM da identidade atribuída pelo usuário.

UploadBatchServiceLogsOptions

Objeto

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

Nome Tipo Description
containerUrl

string (uri)

A URL do contêiner dentro do Azure Blob Storage para o qual é enviado o(s) arquivo(s) de log do Batch Service. Se uma identidade gerenciada atribuída pelo usuário não estiver sendo usada, a URL deve incluir uma Assinatura de Acesso Compartilhada (SAS) concedendo permissões de escrita ao contêiner. A duração do SAS deve permitir tempo suficiente para o upload ser concluído. O horário de início do SAS é opcional e recomenda-se não ser especificado.
endTime

string (date-time)

O intervalo de tempo para o upload dos arquivos de log do Batch Service. Qualquer arquivo de log contendo uma mensagem de log dentro do intervalo de tempo será enviado. Isso significa que a operação pode recuperar mais logs do que os solicitados, já que todo o arquivo de log é sempre carregado, mas a operação não deve recuperar menos logs do que os solicitados. Se omitido, o padrão é enviar todos os logs disponíveis após o startTime.
identityReference

BatchNodeIdentityReference

A referência à identidade atribuída pelo usuário para usar para acessar o Azure Blob Storage especificada pelo containerUrl. A identidade deve ter acesso de escrita ao contêiner Azure Blob Storage.
startTime

string (date-time)

O início do intervalo de tempo a partir do qual é necessário enviar arquivo(s) de log de Batch Service. Qualquer arquivo de log contendo uma mensagem de log dentro do intervalo de tempo será enviado. Isso significa que a operação pode recuperar mais logs do que os solicitados, já que todo o arquivo de log é sempre carregado, mas a operação não deve recuperar menos logs do que os solicitados.

UploadBatchServiceLogsResult

Objeto

O resultado do carregamento de arquivos de log de serviço do Lote de um Nó de Computação específico.

Nome Tipo Description
numberOfFilesUploaded

integer (int32)

O número de arquivos de log que serão enviados.
virtualDirectoryName

string

O diretório virtual dentro do contêiner Azure Blob Storage para onde o(s) arquivo(s) de log do Batch Service serão enviados. O nome do diretório virtual faz parte do nome do blob para cada arquivo de log carregado, e ele é construído com base em poolId, nodeId e um identificador único.