Compute Node - Reimage

  • Ссылка
Служба:
Batch Service
Версия API:
2024-07-01.20.0

Переустановка операционной системы на указанном вычислительном узле.
Вы можете переустановить операционную систему на вычислительном узле, только если она находится в состоянии простоя или выполнения.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2024-07-01.20.0
С использованием необязательных параметров: 
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?timeout={timeout}&api-version=2024-07-01.20.0

Параметры URI

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

string

Базовый URL-адрес для всех запросов пакетной службы Azure.
nodeId
 path True

string

Идентификатор вычислительного узла, который требуется перезапустить.
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"

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

ComputeNodeReimageOption

Когда необходимо повторно использовать вычислительный узел и что делать с текущими задачами.
Значение по умолчанию повторно задается.

Ответы

Имя Тип Описание
202 Accepted

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

Заголовки

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: 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

Примеры

Node reimage

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

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reimage?api-version=2024-07-01.20.0



{
  "nodeReimageOption": "terminate"
}

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

Код состояния:
202

Определения

Имя Описание
BatchError

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

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

Когда необходимо повторно использовать вычислительный узел и что делать с текущими задачами.
ErrorMessage

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

Параметры повторного создания образа вычислительного узла.

BatchError

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

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

string

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

ErrorMessage

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

BatchErrorDetail[]

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

BatchErrorDetail

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

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

string

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

string

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

ComputeNodeReimageOption

Когда необходимо повторно использовать вычислительный узел и что делать с текущими задачами.

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

string

Завершите выполнение процессов задач и повторно ввели задачи. Задачи будут выполняться снова при доступности вычислительного узла. Повторное управление вычислительным узлом после завершения задач.
retaineddata

string

Разрешите выполнение задач, а затем дождитесь истечения срока хранения всех данных задачи. Запланируйте новые задачи во время ожидания. Повторное управление вычислительным узлом при истечении всех периодов хранения задач.
taskcompletion

string

Разрешить выполнение задач в настоящее время. Запланируйте новые задачи во время ожидания. Повторное управление вычислительным узлом после завершения всех задач.
terminate

string

Завершение выполнения задач. Задачи будут завершены с помощью failureInfo, указывающего, что они были завершены и не будут выполняться снова. Повторное управление вычислительным узлом после завершения задач.

ErrorMessage

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

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

string

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

string

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

NodeReimageParameter

Параметры повторного создания образа вычислительного узла.

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

ComputeNodeReimageOption

Когда необходимо повторно использовать вычислительный узел и что делать с текущими задачами.
Значение по умолчанию повторно задается.