Compute Node - Reimage

  • Ссылка
Service:
Batch Service
API Version:
2022-01-01.15.0

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

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2022-01-01.15.0
With optional parameters: 
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?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

Идентификатор вычислительного узла, который требуется перезапустить.
poolId
 path True
  • string

Идентификатор пула, содержащего вычислительный узел.
api-version
 query True
  • string

Версия КЛИЕНТСКОго API.
timeout
 query
  • integer
int32

Максимальное время, затрачивается сервером на обработку запроса в секундах. По умолчанию это 30 секунд.

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

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

Name Required 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 Type Description
nodeReimageOption

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

Ответы

Name Type Description
202 Accepted

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

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

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

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

azure_auth

Flow OAuth2 Azure Active Directory

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

Scopes

Name Description
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=2022-01-01.15.0



{
  "nodeReimageOption": "terminate"
}

Sample Response

Status code:
202

Определения

BatchError

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

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

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

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

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

BatchError

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

Name Type Description
code
  • string

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

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

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

BatchErrorDetail

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

Name Type Description
key
  • string

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

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

ComputeNodeReimageOption

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

Name Type Description
requeue
  • string

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

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

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

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

ErrorMessage

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

Name Type Description
lang
  • string

Код языка сообщения об ошибке
value
  • string

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

NodeReimageParameter

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

Name Type Description
nodeReimageOption

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