Compute Node - Reimage

  • Ссылка
Service:
Batch Service
API Version:
2023-11-01.18.0

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

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2023-11-01.18.0
With optional parameters: 
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?timeout={timeout}&api-version=2023-11-01.18.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 секунд.

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

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

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

Ответы

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

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

Headers

  • 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

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

Scopes

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

Authorization

Type: apiKey
In: header

Примеры

Node reimage

Sample Request

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reimage?api-version=2023-11-01.18.0



{
  "nodeReimageOption": "terminate"
}

Sample Response

Status code:
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

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