Обновление отдельного домена

Статья
07/19/2023

Асинхронная операция Walk Upgrade Domain указывает домен обновления, в котором необходимо обновить экземпляр роли.

Запрос

Запрос Walk Upgrade Domain можно указать следующим образом. замените <subscription-id> идентификатором подписки, <cloudservice-name> именем облачной службы, <deployment-slot>staging или production, а <deployment-name> — именем развертывания.

Метод	Универсальный код ресурса (URI) запроса
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/?comp=walkupgradedomain`
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/?comp=walkupgradedomain`

Параметры URI

Параметр URI	Описание
`comp=walkupgradedomain`	Обязательный. Указывает, что экземпляры роли в развертывании обновлены в одном домене обновления за раз во время обновления на месте вручную.

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

В следующей таблице описаны заголовки запросов.

Заголовок запроса	Описание
`Content-Type`	Обязательный. Задайте для этого заголовка значение `application/xml`.
`x-ms-version`	Обязательный. Задает версию операции, используемой для этого запроса. Этот заголовок должен иметь значение `2009-10-01` или выше.

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

Далее приведен формат текста запроса.

  
<?xml version="1.0" encoding="utf-8"?>  
<WalkUpgradeDomain xmlns="http://schemas.microsoft.com/windowsazure">  
  <UpgradeDomain>update-domain-id</UpgradeDomain>  
</WalkUpgradeDomain>

В следующей таблице описываются элементы текста запроса.

Имя элемента	Описание
UpgradeDomain	Обязательный. Указывает целочисленное значение, которое определяет домен обновления для обновления. Домены обновления идентифицируются с отсчитываемого от нуля индекса: первый домен обновления имеет идентификатор 0, второй — идентификатор 1 и т. д.

Имя элемента

Описание

UpgradeDomain

Обязательный. Указывает целочисленное значение, которое определяет домен обновления для обновления. Домены обновления идентифицируются с отсчитываемого от нуля индекса: первый домен обновления имеет идентификатор 0, второй — идентификатор 1 и т. д.

Ответ

Ответ включает код состояния HTTP и набор заголовков ответа.

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

Успешная операция возвращает код состояния 200 (ОК).

Заголовки откликов

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP.

Заголовок ответа Описание

x-ms-request-id Значение, которое однозначно определяет запрос к службе управления. Для асинхронной операции можно вызвать Get Operation Status со значением заголовка, чтобы определить, завершена ли операция, завершилась ли она сбоем или все еще выполняется.

Заголовок ответа	Описание
`x-ms-request-id`	Значение, которое однозначно определяет запрос к службе управления. Для асинхронной операции можно вызвать Get Operation Status со значением заголовка, чтобы определить, завершена ли операция, завершилась ли она сбоем или все еще выполняется.

Текст ответа

Нет.

Remarks

Перед вызовом Walk Upgrade Domain операции необходимо вызвать развертывание обновления, изменить конфигурацию развертывания или откат обновления или обновления.

По умолчанию служба разворачивается с 5 доменами обновления, которые обновляются поочередно во время обновления на месте.

Для ручного обновления развертывания выполните следующие действия.

Вызовите Upgrade Deployment с элементом Mode , для свойства задано значение manual.
Вызовите Walk Upgrade Domain, чтобы обновить каждый домен в пределах развертывания. Домены обновления должны обновляться по порядку. Например, начав с домена 0, переходите к домену 1 и т. д.

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

Пока выполняется обновление, вызовите командлет Get Deployment , чтобы определить его состояние. Если обновление еще выполняется, Get Deployment вернет элемент UpgradeStatus, содержащий сведения об обновлении. Если обновление завершено или обновление не выполняется, элемент UpgradeStatus будет иметь значение NULL.

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