Перечисление семейств операционных систем
Свернуть оглавление
Развернуть оглавление

Перечисление семейств операционных систем

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

Операция List Operating System Families перечисляет семейства гостевой операционной системы, доступные в Microsoft Azure, а также версии операционной системы для каждого семейства.

Запрос List Operating System Families можно указать следующим образом. Замените <subscription-id> идентификатором подписки.

 

Метод URI запроса

GET

https://management.core.windows.net/<subscription-id>/operatingsystemfamilies

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

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

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

 

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

x-ms-version

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

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

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

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

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

 

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

x-ms-request-id

Значение, которое однозначно определяет запрос к службе управления.

Текст ответа имеет следующий формат:

<?xml version="1.0" encoding="utf-8"?>
<OperatingSystemFamilies xmlns="http://schemas.microsoft.com/windowsazure">
  <OperatingSystemFamily>
    <Name>osfamily-number</Name>
    <Label>base64-encoded-label</Label>
    <OperatingSystems>
      <OperatingSystem>
        <Version>operating-system-version</Version>
        <Label>base64-encoded-label</Label> 
        <IsDefault>true|false</IsDefault>
        <IsActive>true|false</IsActive>
      </OperatingSystem>
    </OperatingSystems>
  </OperatingSystemFamily>
</OperatingSystemFamilies>

В следующем примере показан формат текста ответа.

 

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

Название

Указывает, к какому семейству операционных систем принадлежит эта версия. Дополнительные сведения о поддерживаемых гостевых ОС см. в разделе Выпуски гостевой ОС Azure и матрица совместимости с пакетом SDK.

Метка

Указывает метку семейства операционной системы в кодировке base-64.

Версия

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

Метка

Указывает метку версии операционной системы в кодировке base-64.

IsDefault

Указывает, является ли данная версия операционной системы версией по умолчанию для службы, для которой не была иными способами указана определенная версия. Версия операционной системы по умолчанию применяется к службам, настроенным для автоматического обновления. В каждом семействе операционных систем в любой момент времени имеется точно одна версия операционной системы по умолчанию, для которой элемент IsDefault имеет значение true; для всех остальных версий IsDefault имеет значение false.

См. дополнительные сведения о настройке версий операционной системы для службы в разделе Параметры обновления гостевой ОС Azure.

IsActive

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

Версия операционной системы может быть неактивна по одной из двух причин.

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

  • Больше не поддерживается для запуска службы. В этом случае вам придется либо вручную настроить службу для запуска на более новой версии, либо настроить автоматическое обновление службы для управления обновлениями операционной системы.

Показ:
© 2016 Microsoft