Compute Node - Upload Batch Service Logs

Ссылка

Service:: Batch Service

API Version:: 2022-01-01.15.0

Отправьте пакетная служба Azure файлы журнала службы из указанного вычислительного узла в Хранилище BLOB-объектов Azure.
Это предназначено для сбора пакетная служба Azure файлов журналов службы автоматически с вычислительных узлов, если возникает ошибка и вы хотите передать их в поддержка Azure. Файлы журнала пакетная служба Azure службы должны предоставляться совместно с поддержка Azure, чтобы помочь в отладке проблем с пакетной службой.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2022-01-01.15.0

With optional parameters:

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?timeout={timeout}&api-version=2022-01-01.15.0

Параметры URI

Name	In	Required	Type	Description
batchUrl	path	True	string	Базовый URL-адрес для всех запросов на обслуживание пакетная служба Azure.
nodeId	path	True	string	Идентификатор вычислительного узла, с которого требуется передать файлы журнала пакетная служба Azure службы.
poolId	path	True	string	Идентификатор пула, содержащего вычислительный узел.
api-version	query	True	string	Версия API клиента.
timeout	query		integer int32	Максимальное время, которое сервер может потратить на обработку запроса в секундах. По умолчанию это 30 секунд.

Заголовок запроса

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

Name	Type	Description
client-request-id	string uuid	Удостоверение запроса, созданное вызывающим абонентом, в виде GUID без оформления, например фигурных скобок, например 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Должен ли сервер возвращать идентификатор client-request-id в ответе.
ocp-date	string date-time-rfc1123	Время выдачи запроса. Клиентские библиотеки обычно задают для текущего системного времени часов; Задайте его явным образом, если вы вызываете REST API напрямую.

Текст запроса

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

Name	Required	Type	Description
containerUrl	True	string	URL-адрес контейнера в Хранилище BLOB-объектов Azure, в который отправляются файлы журнала пакетной службы. Если управляемое удостоверение, назначаемое пользователем, не используется, URL-адрес должен включать подписанный URL-адрес (SAS), предоставляющий разрешения на запись контейнеру. Длительность SAS должна разрешать достаточно времени для завершения отправки. Время начала SAS является необязательным и рекомендуется не указывать.
startTime	True	string	Начало диапазона времени для отправки файлов журнала пакетной службы. Будет отправлен любой файл журнала, содержащий сообщение журнала в диапазоне времени. Это означает, что операция может получить больше журналов, чем запрошено, так как весь файл журнала всегда передается, но операция не должна извлекать меньше журналов, чем запрошено.
endTime		string	Конец диапазона времени для отправки файлов журнала пакетной службы. Будет отправлен любой файл журнала, содержащий сообщение журнала в диапазоне времени. Это означает, что операция может получить больше журналов, чем запрошено, так как весь файл журнала всегда передается, но операция не должна извлекать меньше журналов, чем запрошено. Если этот параметр опущен, по умолчанию отправляется все журналы, доступные после startTime.
identityReference		ComputeNodeIdentityReference	Ссылка на назначенное пользователем удостоверение, используемое для доступа к Хранилище BLOB-объектов Azure, заданному containerUrl. Удостоверение должно иметь доступ на запись к контейнеру Хранилище BLOB-объектов Azure.

Ответы

Name	Type	Description
200 OK	UploadBatchServiceLogsResult	Запрос пакетной службы выполнен успешно. Headers client-request-id: string request-id: string
Other Status Codes	BatchError	Ошибка из пакетной службы.

Name

Type

Description

200 OK

UploadBatchServiceLogsResult

Запрос пакетной службы выполнен успешно.

Headers

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

Other Status Codes

BatchError

Ошибка из пакетной службы.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	Олицетворение учетной записи пользователя

Authorization

Type: apiKey
In: header

Примеры

Upload BatchService Logs

Sample Request

HTTP

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/uploadbatchservicelogs?api-version=2022-01-01.15.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

Status code:: 200

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

Определения

BatchError	Ответ об ошибке, полученный от службы пакетная служба Azure.
BatchErrorDetail	Элемент дополнительных сведений, включенных в ответ на ошибку пакетная служба Azure.
ComputeNodeIdentityReference	Ссылка на назначенное пользователем удостоверение, связанное с пулом пакетной службы, который будет использовать вычислительный узел.
ErrorMessage	Сообщение об ошибке, полученное в ответе на ошибку пакетная служба Azure.
UploadBatchServiceLogsConfiguration	Конфигурация отправки файлов журнала службы пакетная служба Azure для вычислительного узла.
UploadBatchServiceLogsResult	Результат отправки файлов журнала пакетной службы с определенного вычислительного узла.

BatchError

Ответ об ошибке, полученный от службы пакетная служба Azure.

Name	Type	Description
code	string	Идентификатор ошибки. Коды инвариантны и предназначены для программного использования.
message	ErrorMessage	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
values	BatchErrorDetail[]	Коллекция пар "ключ-значение", содержащая дополнительные сведения об ошибке.

BatchErrorDetail

Элемент дополнительных сведений, включенных в ответ на ошибку пакетная служба Azure.

Name	Type	Description
key	string	Идентификатор, указывающий значение свойства Value.
value	string	Дополнительные сведения, включенные в ответ на ошибку.

ComputeNodeIdentityReference

Ссылка на назначенное пользователем удостоверение, связанное с пулом пакетной службы, который будет использовать вычислительный узел.

Name	Type	Description
resourceId	string	Идентификатор ресурса ARM назначенного пользователем удостоверения.

ErrorMessage

Сообщение об ошибке, полученное в ответе на ошибку пакетная служба Azure.

Name	Type	Description
lang	string	Код языка сообщения об ошибке
value	string	Текст сообщения.

UploadBatchServiceLogsConfiguration

Конфигурация отправки файлов журнала службы пакетная служба Azure для вычислительного узла.

Name	Type	Description
containerUrl	string	URL-адрес контейнера в Хранилище BLOB-объектов Azure, в который отправляются файлы журнала пакетной службы. Если управляемое удостоверение, назначаемое пользователем, не используется, URL-адрес должен включать подписанный URL-адрес (SAS), предоставляющий разрешения на запись контейнеру. Длительность SAS должна разрешать достаточно времени для завершения отправки. Время начала SAS является необязательным и рекомендуется не указывать.
endTime	string	Конец диапазона времени для отправки файлов журнала пакетной службы. Будет отправлен любой файл журнала, содержащий сообщение журнала в диапазоне времени. Это означает, что операция может получить больше журналов, чем запрошено, так как весь файл журнала всегда передается, но операция не должна извлекать меньше журналов, чем запрошено. Если этот параметр опущен, по умолчанию отправляется все журналы, доступные после startTime.
identityReference	ComputeNodeIdentityReference	Ссылка на назначенное пользователем удостоверение, используемое для доступа к Хранилище BLOB-объектов Azure, заданному containerUrl. Удостоверение должно иметь доступ на запись к контейнеру Хранилище BLOB-объектов Azure.
startTime	string	Начало диапазона времени для отправки файлов журнала пакетной службы. Будет отправлен любой файл журнала, содержащий сообщение журнала в диапазоне времени. Это означает, что операция может получить больше журналов, чем запрошено, так как весь файл журнала всегда передается, но операция не должна извлекать меньше журналов, чем запрошено.

UploadBatchServiceLogsResult

Результат отправки файлов журнала пакетной службы с определенного вычислительного узла.

Name	Type	Description
numberOfFilesUploaded	integer	Количество файлов журнала, которые будут отправлены.
virtualDirectoryName	string	Виртуальный каталог в Хранилище BLOB-объектов Azure контейнере, в который будут отправляться файлы журнала пакетной службы. Имя виртуального каталога является частью имени большого двоичного объекта для каждого отправленного файла журнала и создается на основе poolId, nodeId и уникального идентификатора.