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

Краткое руководство. Создание группы служб (предварительная версия) с помощью REST API

С помощью групп служб Azure (предварительная версия) можно создавать группы ресурсов с низким уровнем привилегий в подписках. Они предоставляют способ управления ресурсами с минимальными разрешениями, обеспечивая группирование и управление ресурсами без предоставления чрезмерного доступа. Группы служб предназначены для дополнения существующих организационных структур, таких как группы ресурсов, подписки и группы управления, предлагая гибкий и безопасный способ агрегирования ресурсов для конкретных целей. Дополнительные сведения о группах служб см. в статье "Начало работы с группами служб".

Это важно

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

Предпосылки

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

  • Установите ARMClient, если его у вас еще нет. Это средство, которое отправляет HTTP-запросы к REST API на основе Azure Resource Manager.

Создание с помощью REST API

В этом примере группа служб — Contoso.

  • URI REST API (универсальный код ресурса)

    PUT https://management.azure.com/providers/Microsoft.Management/serviceGroups/Contoso?api-version=2024-02-01-preview

  • Тело запроса

GroupId — это уникальный создаваемый идентификатор. Этот идентификатор используется в других командах для обращения к этой группе. Его нельзя изменить позже.

Если вы хотите, чтобы группа служб отображала другое имя на портале Azure, добавьте свойство properties.displayName в текст запроса. Например, чтобы создать группу служб с идентификатором группыContoso и отображаемое имя группы Contoso, используйте следующую конечную точку и текст запроса:

{
  "properties": {
    "displayName": "_Contoso Group_",
    "parent": {
      "resourceId": "/providers/Microsoft.Management/serviceGroups/[tenantId]"
    }
  }
}

В предыдущих примерах новая группа служб создается в корневой группе служб. Чтобы указать другую группу служб в качестве родительской, используйте свойство properties.parent.resourceId .

  • URI REST API (универсальный код ресурса)

    PUT https://management.azure.com/providers/Microsoft.Management/serviceGroups/Contoso?api-version=2024-02-01-preview

  • Тело запроса

    {
  "properties": {
    "displayName": "Contoso Group",
    "parent": {
      "resourceId": "/providers/Microsoft.Management/serviceGroups/HoldingGroup"
    }
  }
}

Убедитесь, что ваша группа служб была создана

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

Чтобы проверить успешность операции, необходимо выполнить вызов GET по значению, возвращаемого в заголовке azure-asyncoperation . URL-адрес предоставляет состояние созданной операции.

Замечание

Чтобы избежать проблем в сценариях или шаблонах, автоматизация должна провести опрос по указанному URL-адресу перед переходом к следующему шагу. Если автоматизация переходит к следующему шагу, прежде чем операция успешно завершилась, следующая операция не удастся, так как группа служб не была создана.

Очистите ресурсы

Чтобы удалить группу служб, созданную в этом документе, используйте конечную точку удаления группы служб:

  • URI REST API (универсальный код ресурса)

    DELETE https://management.azure.com/providers/Microsoft.Management/serviceGroups/Contoso?api-version=2024-02-01-preview

  • Без текста запроса

Связанный контент

  • Last updated on