Прочитать на английском

Поделиться через


Compute Node - Upload Batch Service Logs

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

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2024-07-01.20.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?timeout={timeout}&api-version=2024-07-01.20.0

Параметры URI

Имя В Обязательно Тип Описание
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 секунд. Если значение больше 30, вместо этого будет использоваться значение по умолчанию.

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

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

Имя Обязательно Тип Описание
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"

Имя Обязательно Тип Описание
containerUrl True

string

URL-адрес контейнера в хранилище BLOB-объектов Azure для отправки файлов журнала пакетной службы.
Если назначенное пользователем управляемое удостоверение не используется, URL-адрес должен включать подписанный URL-адрес (SAS), предоставляющий разрешения на запись контейнеру. Длительность SAS должна разрешить достаточно времени для завершения отправки. Время начала для SAS является необязательным и рекомендуется не указывать.

startTime True

string (date-time)

Начало диапазона времени для отправки файлов журнала пакетной службы.
Любой файл журнала, содержащий сообщение журнала в диапазоне времени, будет отправлен. Это означает, что операция может получить больше журналов, чем запрошено, так как весь файл журнала всегда отправляется, но операция не должна извлекать меньше журналов, чем запрошено.

endTime

string (date-time)

Конец диапазона времени, из которого необходимо отправить файлы журнала пакетной службы.
Любой файл журнала, содержащий сообщение журнала в диапазоне времени, будет отправлен. Это означает, что операция может получить больше журналов, чем запрошено, так как весь файл журнала всегда отправляется, но операция не должна извлекать меньше журналов, чем запрошено. Если опущено, значение по умолчанию — отправить все журналы, доступные после запускаTime.

identityReference

ComputeNodeIdentityReference

Ссылка на назначенное пользователем удостоверение, используемое для доступа к хранилищу BLOB-объектов Azure, заданному контейнеромUrl.
Удостоверение должно иметь доступ на запись к контейнеру хранилища BLOB-объектов Azure.

Ответы

Имя Тип Описание
200 OK

UploadBatchServiceLogsResult

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

Заголовки

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

BatchError

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

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

azure_auth

Поток кода проверки подлинности Microsoft Entra OAuth 2.0

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

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

Authorization

Тип: apiKey
В: header

Примеры

Upload BatchService Logs

Образец запроса

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

Пример ответа

{
  "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.

Имя Тип Описание
code

string

Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.

message

ErrorMessage

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

values

BatchErrorDetail[]

Коллекция пар "ключ-значение", содержащая дополнительные сведения об ошибке.

BatchErrorDetail

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

Имя Тип Описание
key

string

Идентификатор, указывающий значение свойства Value.

value

string

Дополнительные сведения, включенные в ответ на ошибку.

ComputeNodeIdentityReference

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

Имя Тип Описание
resourceId

string

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

ErrorMessage

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

Имя Тип Описание
lang

string

Языковой код сообщения об ошибке

value

string

Текст сообщения.

UploadBatchServiceLogsConfiguration

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

Имя Тип Описание
containerUrl

string

URL-адрес контейнера в хранилище BLOB-объектов Azure для отправки файлов журнала пакетной службы.
Если назначенное пользователем управляемое удостоверение не используется, URL-адрес должен включать подписанный URL-адрес (SAS), предоставляющий разрешения на запись контейнеру. Длительность SAS должна разрешить достаточно времени для завершения отправки. Время начала для SAS является необязательным и рекомендуется не указывать.

endTime

string (date-time)

Конец диапазона времени, из которого необходимо отправить файлы журнала пакетной службы.
Любой файл журнала, содержащий сообщение журнала в диапазоне времени, будет отправлен. Это означает, что операция может получить больше журналов, чем запрошено, так как весь файл журнала всегда отправляется, но операция не должна извлекать меньше журналов, чем запрошено. Если опущено, значение по умолчанию — отправить все журналы, доступные после запускаTime.

identityReference

ComputeNodeIdentityReference

Ссылка на назначенное пользователем удостоверение, используемое для доступа к хранилищу BLOB-объектов Azure, заданному контейнеромUrl.
Удостоверение должно иметь доступ на запись к контейнеру хранилища BLOB-объектов Azure.

startTime

string (date-time)

Начало диапазона времени для отправки файлов журнала пакетной службы.
Любой файл журнала, содержащий сообщение журнала в диапазоне времени, будет отправлен. Это означает, что операция может получить больше журналов, чем запрошено, так как весь файл журнала всегда отправляется, но операция не должна извлекать меньше журналов, чем запрошено.

UploadBatchServiceLogsResult

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

Имя Тип Описание
numberOfFilesUploaded

integer (int32)

Количество файлов журнала, которые будут отправлены.

virtualDirectoryName

string

Виртуальный каталог в контейнере хранилища BLOB-объектов Azure, в который будут отправлены файлы журнала пакетной службы.
Имя виртуального каталога является частью имени большого двоичного объекта для каждого отправленного файла журнала, и оно построено на основе poolId, nodeId и уникального идентификатора.