Получение списка лицензий, назначенных пользователю тенанта Microsoft

Метод используется для получения одностраничного списка лицензий, назначенных пользователю тенанта Microsoft (см. Получение списка пользователей тенанта Microsoft) для аккаунта, к которому есть доступ у текущего пользователя. Для вызова метода у аккаунта в платформе должны быть сохранены Tenant Name и Tenant ID. В результате вызова метода модуль MicrosoftCSPProductsPlugin запрашивает информацию о пользователе тенанта аккаунта на стороне Microsoft (см. Получение лицензий, назначенных пользователю в учетной записи клиента).

GET {reseller_domain}/plugin_microsoft_csp_products/internal_api/user_assigned_licenses

В этой статье:

Авторизация

Требуется авторизация с помощью access token пользователя.

Аргументы

Название	Тип параметра	Тип данных	Обязательный/ Опциональный	Описание
Content-Type	header	string	Обязательный	Тип данных, передаваемых в запросе. Укажите application/vnd.api+json
Accept	header	string	Обязательный	Поддерживаемые типы данных в ответе. Укажите application/vnd.api+json
X-Api-Locale	header	string	Опциональный	Двухбуквенный код языка данных в ответе
Authorization	header	string	Обязательный	Действующий access token пользователя. Формат: `Bearer <access token>`
reseller_domain	path	string	Обязательный	Доменное имя реселлера
account_id	query	integer	Обязательный	ID аккаунта, для тенанта Microsoft которого запрашивается информация
user_id	query	string	Обязательный	ID пользователя на стороне Microsoft, для которого запрашивается список назначенных лицензий (см. Получение списка пользователей тенанта Microsoft )

Модель ответа

Название			Тип данных	Описание	Параметр ответа от Microsoft
data			array of objects	Данные ответа. Список лицензий, назначенных пользователю тенанта Microsoft
	product_sku		object	Информация о продукте (лицензии)
		id	string	ID продукта (лицензии)	items.productSku.id
		name	string	Название продукта (лицензии)	items.productSku.name
		sku_part_number	string	SKU продукта (лицензии)	items.productSku.skuPartNumber
		license_group_id	string	Идентификатор группы лицензий: group1 — все продукты, лицензии которых могут управляться через Azure Active Directory (AAD). group2 — продукты, лицензии которых не могут управляться через Azure Active Directory (AAD).	items.productSku.licenseGroupId

Пример запроса

Bash

curl --location --request GET 'https://test.activeplatform.com/plugin_microsoft_csp_products/internal_api/user_assigned_licenses?account_id=1938&user_id=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' \
--header 'Content-Type: application/vnd.api+json' \
--header 'Accept: application/vnd.api+json' \
--header 'X-Api-Locale: en' \
--header 'Authorization: Bearer AccessTokenExample'

Пример ответа

JSON

{
  "data": [
    {
      "product_sku": {
        "id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "name": "Dynamics 365 Customer Service Enterprise",
        "sku_part_number": "DYN365_ENTERPRISE_CUSTOMER_SERVICE",
        "license_group_id": "group1"
      }
    }
  ]
}