Краткое руководство. Добавление ресурсов или контейнеров ресурсов в группы служб с связями членов группы служб

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

Это важно

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

Предпосылки

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

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

  • Чтобы развернуть отношение участника группы служб, необходимо иметь разрешения Microsoft.Relationship/ServiceGroupMember/write на исходном объекте и роль Microsoft.ServiceGroup Contributor в целевой группе служб.

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

[scope] в ПРИВЕДЕННЫх ниже URL-адресах ссылается на полный путь Azure Resource Manager ресурса, который вы хотите добавить в качестве члена. Область зависит от типа ресурса:

Тип ресурса Формат области
Subscription subscriptions/{subscriptionId}
Группа ресурсов subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}
Ресурс subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProvider}/{resourceType}/{resourceName}

Для REST API используйте Service Groups Member - Create or Update endpoint для создания нового участника группы служб.

В этом примере мы добавим виртуальную машину [VM1] в группу служб [Contoso].

  1. Группа служб: groupId — Contoso
  2. Виртуальная машина: идентификатор ресурса — VM1
  3. Член группы служб: идентификатор связи — SGM1

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

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

    PUT https://management.azure.com/[scope]/providers/Microsoft.Relationships/serviceGroupMember/SGM1?api-version=2023-09-01-preview

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

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

    PUT https://management.azure.com/subscriptions/[SUBID]/resourceGroups/[RGID]/providers/microsoft.compute/virtualmachine/[VMID]/providers/Microsoft.Relationships/serviceGroupMember/SGM1?api-version=2023-09-01-preview

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

      {
    "properties": {
     "targetId": "providers/microsoft.management/servicegroups/Contoso"
    }
  }

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

Чтобы удалить группу служб, созданную в этом документе, используйте конечную точку Service Group Member - Delete.

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

    DELETE https://management.azure.com/[scope]/providers/Microsoft.Relationships/serviceGroupMember/SGM1?api-version=2023-09-01-preview

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

Проверьте члена вашей группы служб

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

  1. Найдите заголовок Azure-AsyncOperation в ответе запроса PUT.
  2. Выполните запрос GET к URL-адресу в этом заголовке, чтобы проверить состояние операции.
{
    "status": "Succeeded"
}

Возможные значения состояния включают Succeeded, Failedи InProgress. Дождитесь завершения операции, прежде чем полагаться на связь членства.

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

Следующий шаг

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

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

Управление ресурсами с помощью групп служб

  • Last updated on