Валидация дополнительных параметров Услуги для Тарифного плана Реселлера

Метод Validate the Reseller's Plan provisioning attributes используется при покупке новой Подписки для валидации значений дополнительных параметров, необходимых для провижининга Услуги, по указанному ID Тарифного плана текущего Реселлера или любого из его нижестоящих Реселлеров. См. также Получение списка дополнительных параметров Услуги для Тарифного плана Реселлера и Создание Заказа на покупку.

Если требуется, то одновременно с валидацией домена клиента в сети Microsoft (Tenant name) для указанного Клиента принимается соглашение Microsoft Customer Agreement от лица Сотрудника, API-токен которого использовался при отправке запроса.

Доступ к текущему Реселлеру, относительно которого формируется список нижестоящих Реселлеров, определяется по токену Сотрудника, указанному в заголовке запроса.

Метод Validate the Reseller's Plan provisioning attributes валидирует значения дополнительных параметров только для следующих Услуг:

POST {base_url}/api/v3/resellers/{reseller_id}/plans/{plan_id}/provisioning_attributes/validation

Аргументы

Название

Тип параметра

Тип данных

Обязательный/ 
Опциональный

Описание

X-Api-TokenheaderstringОбязательныйAPI токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике)
Content-TypeheaderstringОбязательныйПредназначен для идентификации формата и способа представления сущности
AcceptheaderstringОбязательныйПредназначен для информирования сервера о типах данных, которые поддерживаются клиентом (браузером)
reseller_idpathintegerОбязательныйID Реселлера. Возможно указать ID текущего Реселлера или ID любого из его нижестоящих Реселлеров (см. Просмотр информации о реселлере)
plan_idpathintegerОбязательный

ID Тарифного плана

dataformobjectОбязательныйИнформация об атрибутах операции

account_idformintegerОбязательныйID Клиента, для которого покупается Подписка

attributesformarrayОбязательныйСписок дополнительных параметров и их значений в зависимости от Услуги, связанной с указанным Тарифным планом (см. Получение списка дополнительных параметров Услуги для Тарифного плана Реселлера)


keyformstringОбязательныйКлюч дополнительного параметра


valueformЗависит от параметраОбязательныйЗначение дополнительного параметра

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

Название

Тип данных

Описание

keystringКлюч дополнительного параметра
valueЗависит от параметра
Значение дополнительного параметра
microsoft_customer_agreementbool

Информация о факте принятия соглашения Microsoft Customer Agreement:

  • true — соглашение принято.
  • false — соглашение не принято.

Указывается, если одновременно с валидацией домена клиента в сети Microsoft (Tenant name) для указанного Клиента было принято соглашение Microsoft Customer Agreement

Ошибки

Статус ошибкиТекст ошибкиКомментарий
422Ошибка при валидации параметровОшибка на стороне поставщика Услуги. Чтобы выполнить валидацию, повторите попытку позже
План не имеет дополнительных параметров услугиДля Услуги, связанной с указанным Тарифным планом, валидация дополнительных параметров с помощью этого запроса не требуется
Запрос содержит два типа доменов (новый и существующий)

Чтобы выполнить валидацию домена клиента в сети Microsoft (Tenant name), в запросе необходимо указать только один домен клиента — новый или существующий

Неверный субдомен. Должен быть '.onmicrosoft.com'Чтобы выполнить валидацию домена клиента в сети Microsoft (Tenant name), в запросе необходимо указать домен клиента, содержащий субдомен '.onmicrosoft.com' (например, example.onmicrosoft.com)
Для клиента уже существует домен в сети Microsoft <домен>
  • Домен клиента, указанный в запросе в качестве существующего, не найден в платформе, однако для указанного Клиента в платформе уже есть другой существующий домен. Чтобы выполнить валидацию существующего домена клиента в сети Microsoft (Tenant name), в запросе необходимо указать параметр существующего домена клиента и его значение <домен>
  • В запросе указан параметр нового домена клиента в сети Microsoft (Tenant name), однако для указанного Клиента в платформе уже есть существующий домен. Чтобы выполнить валидацию домена клиента, в запросе необходимо указать параметр существующего домена клиента и его значение <домен>
Должна быть указана подписка на услугу Microsoft AzureЧтобы выполнить валидацию Подписки для Услуги Microsoft Azure RI, в запросе необходимо указать существующую Подписку на Услугу Microsoft Azure, принадлежащую указанному Клиенту
Клиент должен быть владельцем подписки

Пример запроса (Microsoft Azure RI)

POST /api/v3/resellers/1/plans/1770/provisioning_attributes/validation
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json
{
    "data": {
        "account_id": 784,
        "attributes": [
            {
                "key": "reservation_scope",
                "value": "All Subscriptions"
            },
            {
                "key": "azure_subscriptions",
                "value": [
                    "#3007831 Azure (Office365 plugin) (XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX)"
                ]
            }
        ]
    }
}

Пример ответа (Microsoft Azure RI)

[
    {
        "key": "reservation_scope",
        "value": "All Subscriptions"
    },
    {
        "key": "azure_subscriptions",
        "value": [
            "3007831 Azure (Office365 plugin) (XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX)"
        ]
    }
]

Пример запроса (Microsoft Azure, новый домен клиента в сети Microsoft)

POST /api/v3/resellers/1/plans/1768/provisioning_attributes/validation
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json
{
    "data": {
        "account_id": 784,
        "attributes": [
            {
                "key": "new_customer_domain",
                "value": "example.onmicrosoft.com"
            }
        ]
    }
}

Пример ответа (Microsoft Azure, новый домен клиента в сети Microsoft)

[
    {
        "key": "new_customer_domain",
        "value": "example.onmicrosoft.com",
        "microsoft_customer_agreement": true
    }
]