Pool - Remove Nodes

Ссылка

Service:: Batch Service

API Version:: 2022-01-01.15.0

Удаляет вычислительные узлы из указанного пула.
Эта операция может выполняться только в том случае, если состояние распределения пула стабильное. При выполнении этой операции состояние выделения изменяется с устойчивого на изменение размера. Каждый запрос может удалить до 100 узлов.

POST {batchUrl}/pools/{poolId}/removenodes?api-version=2022-01-01.15.0

With optional parameters:

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

Параметры URI

Name	In	Required	Type	Description
batchUrl	path	True	string	Базовый URL-адрес для всех запросов на обслуживание пакетная служба 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 напрямую.
If-Match	string	Значение ETag, связанное с версией ресурса, известного клиенту. Операция выполняется только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.
If-None-Match	string	Значение ETag, связанное с версией ресурса, известного клиенту. Операция выполняется только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.
If-Modified-Since	string date-time-rfc1123	Метка времени, указывающая время последнего изменения ресурса, известного клиенту. Операция будет выполняться только в том случае, если ресурс в службе был изменен с указанного времени.
If-Unmodified-Since	string date-time-rfc1123	Метка времени, указывающая время последнего изменения ресурса, известного клиенту. Операция будет выполнена только в том случае, если ресурс в службе не был изменен с указанного времени.

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

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

Name	Required	Type	Description
nodeList	True	string[]	Список, содержащий идентификаторы вычислительных узлов, которые будут удалены из указанного пула. На запрос может быть удалено не более 100 узлов.
nodeDeallocationOption		ComputeNodeDeallocationOption	Определяет, что делать с вычислительным узлом и выполняемыми задачами после выбора для освобождения. По умолчанию используется значение requeue.
resizeTimeout		string	Время ожидания удаления вычислительных узлов в пул. Значение по умолчанию — 15 минут. Минимальное значение — 5 минут. Если указать значение менее 5 минут, пакетная служба возвращает ошибку; Если вы вызываете REST API напрямую, код состояния HTTP — 400 (недопустимый запрос).

Ответы

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

Name

Type

Description

202 Accepted

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

Headers

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

Примеры

Pool remove nodes

Sample Request

HTTP

POST account.region.batch.azure.com/pools/poolId/removenodes?api-version=2022-01-01.15.0



{
  "nodeList": [
    "tvm-1695681911_1-20161122t224741z",
    "tvm-1695681911_2-20161122t224741z"
  ]
}

Sample Response

Status code:: 202

Определения

BatchError	Ответ об ошибке, полученный от службы пакетная служба Azure.
BatchErrorDetail	Элемент дополнительных сведений, включенных в ответ на ошибку пакетная служба Azure.
ComputeNodeDeallocationOption	Определяет, что делать с вычислительным узлом и выполняемыми задачами после выбора для освобождения.
ErrorMessage	Сообщение об ошибке, полученное в ответе на ошибку пакетная служба Azure.
NodeRemoveParameter	Параметры удаления вычислительных узлов из пула.

BatchError

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

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

BatchErrorDetail

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

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

ComputeNodeDeallocationOption

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

Name	Type	Description
requeue	string	Завершение выполнения процессов задач и повторная постановка задач. Задачи будут выполняться снова при наличии вычислительного узла. Удалите вычислительные узлы сразу после завершения задач.
retaineddata	string	Разрешите выполнение задач, а затем дождитесь истечения срока хранения всех данных задачи. Не планируйте новые задачи во время ожидания. Удалите вычислительные узлы, когда истек срок хранения всех задач.
taskcompletion	string	Разрешить выполнение задач в данный момент. Не планируйте новые задачи во время ожидания. Удалите вычислительные узлы после завершения всех задач.
terminate	string	Завершение выполнения задач. Задачи будут завершены с помощью failureInfo, указывая, что они были завершены и не будут выполняться снова. Удалите вычислительные узлы сразу после завершения задач.

ErrorMessage

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

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

NodeRemoveParameter

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

Name	Type	Description
nodeDeallocationOption	ComputeNodeDeallocationOption	Определяет, что делать с вычислительным узлом и выполняемыми задачами после выбора для освобождения. По умолчанию используется значение requeue.
nodeList	string[]	Список, содержащий идентификаторы вычислительных узлов, которые будут удалены из указанного пула. На запрос может быть удалено не более 100 узлов.
resizeTimeout	string	Время ожидания удаления вычислительных узлов в пул. Значение по умолчанию — 15 минут. Минимальное значение — 5 минут. Если указать значение менее 5 минут, пакетная служба возвращает ошибку; Если вы вызываете REST API напрямую, код состояния HTTP — 400 (недопустимый запрос).