Была ли эта страница полезной?
Ваш отзыв об этом контенте важен для нас. Расскажите нам о том, что вы думаете.
Дополнительный отзыв?
1500 символов осталось
Экспорт (0) Печать
Развернуть все

Изменение конфигурации развертывания

Обновлено: Июнь 2015 г.

Асинхронная операция Change Deployment Configuration инициирует изменения конфигурации развертывания.

Запрос Change Deployment Configuration можно указать следующим образом. Замените <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>/

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/

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

 

Параметр URI Описание

comp=config

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

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

 

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

Content-Type

Обязательно. Задайте для этого заголовка значение application/xml.

x-ms-version

Обязательно. Задает версию операции, используемой для этого запроса. Этот заголовок должен быть установлен в значение 01.10.2009 или на более позднюю дату. Дополнительные сведения об управлении версиями заголовков см. в разделе Работа с версиями при управлении службами.

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


<?xml version="1.0" encoding="utf-8"?>
<ChangeConfiguration xmlns="http://schemas.microsoft.com/windowsazure">
  <Configuration>base-64-encoded-configuration-file</Configuration>
  <TreatWarningsAsError>warnings-as-errors</TreatWarningsAsError>
  <Mode>type-of-change</Mode>
  <ExtendedProperties>
    <ExtendedProperty>
      <Name>property-name</Name>
      <Value>property-value</Value>
    </ExtendedProperty>
  </ExtendedProperties>
  <ExtensionConfiguration>
    <AllRoles>
      <Extension>
        <Id>identifier-of-extension</Id>
        <State>state-of-extension</State>
      </Extension>
    </AllRoles>
    <NamedRoles>
      <Role>
        <RoleName>role_name1</RoleName>
        <Extensions>
          <Extension>
            <Id>identifier-of-extension</Id>
            <State>state-of-extension</State>
          </Extension>
        </Extensions>
      </Role>
    </NamedRoles>
  </ExtensionConfiguration>
</ChangeConfiguration>

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

 

Имя элемента Описание

Конфигурация

Обязательно. Задает файл конфигурации службы для развертывания (в кодировке Base64).

TreatWarningsAsError

Необязательно. Указывает, должны ли предупреждения обрабатываться как ошибки.

Возможные значения:

  • true

  • false

Если не указано, то значение по умолчанию равно - false. Если задано true, то обновление будет заблокировано при возникновении предупреждений.

Элемент TreatWarningsAsError доступен только при использовании версии 01.04.2011 или более поздней.

Режим

Необязательно. Возможные значения:

  • Auto

  • Manual

  • Simultaneous

Если не указано, то значение по умолчанию равно Auto. Если это значение равно Manual, то необходимо вызвать WalkUpgradeDomain для применения обновления. Если это значение равно Auto, то обновление автоматически применяется к каждому домену обновления для службы.

Элемент Mode доступен только при использовании версии 01.08.2011 или более поздней.

Параметр Simultaneous доступен только при использовании версии 01.03.2013 или более поздней версии.

Название

Необязательно. Представляет собой имя расширенного свойства облачной службы. Каждое расширенное свойство должно иметь и заданное имя, и значение. Может быть максимум 25 расширенных пар из имени свойства и значения.

Максимальная длина элемента Name — 64 символа, допустимы только буквенно-цифровые символы и знаки подчеркивания, имя должно начинаться с буквы. Попытка использовать другие символы, начать имя не с буквы или ввести имя, которое уже имеется у другого расширенного свойства в той же облачной службе, приведет к ошибке с кодом состояния 400 (неправильный запрос).

Элемент Name доступен только при использовании версии 01.03.2012 или более поздней.

Значение

Необязательно. Представляет собой значение расширенного свойства облачной службы. Каждое расширенное свойство должно иметь и заданное имя, и значение. Можно задать не более 25 пар из имени и значения расширенных свойств, максимальная длина каждого расширенного свойства — 255 символов.

Можно удалить расширенное свойство, задав для него значение NULL.

Элемент Value доступен только при использовании версии 01.03.2012 или более поздней.

ExtensionConfiguration

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

Элемент ExtensionConfiguration доступен только при использовании версии 01.03.2013 или более поздней.

Представляет собой расширение, добавляемое к облачной службе.

 

Имя элемента Описание

AllRoles

Необязательно. Задает список расширений, применяемых ко всем ролям в развертывании.

Расширение

Обязательно. Представляет расширение для развертывания в роли в облачной службе.

NamedRoles

Необязательно. Задает список расширений, применяемых к конкретным ролям в развертывании.

Представляет расширение для развертывания в роли в облачной службе.

 

Имя элемента Описание

Id

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

Область

Необязательно. Указывает состояние расширения. Этот элемент применяется только к настроенным расширениям JSON.

Возможные значения:

  • Enable

  • Disable

  • Uninstall

Значение по умолчанию — Enable.

Элемент State доступен только при использовании версии 01.06.2014 или более поздней.

Задает список расширений, применяемых к конкретным ролям в развертывании.

 

Имя элемента Описание

Роль

Обязательно. Представляет конкретную роль, в которую добавлено расширение.

RoleName

Обязательно. Указывает новое имя роли.

Расширение

Обязательно. Представляет расширение для развертывания в роли в облачной службе.

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

Поскольку Change Deployment Configuration является асинхронной операцией, необходимо вызвать метод Получение состояния операции, чтобы определить состояние операции: выполнена, завершена с ошибками или все еще выполняется.

Успешная операция возвращает код состояния 200 (ОК). Сведения о кодах состояния см. в разделе Коды состояний и ошибок управления службами.

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

 

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

x-ms-request-id

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

Отсутствует.

Показ:
© 2015 Microsoft