Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Соответствующие роли: агент администрирования
В этой статье показано, как активировать подписку на программное обеспечение как услуга (SaaS) для продуктов коммерческой платформы из учетных записей среды интеграционного тестирования для включения выставления счетов.
Заметка
Активировать подписку для продуктов SaaS коммерческого маркетплейса можно только из учетных записей интеграционной песочницы. Если у вас есть рабочая подписка, необходимо посетить сайт издателя, чтобы завершить процесс установки. Выставление счетов за подписку начнется только после завершения настройки.
Необходимые условия
- Учетные данные, как описано в аутентификации Центра партнеров. Этот сценарий поддерживает проверку подлинности как с автономными учетными данными приложения, так и с учетными данными приложения и пользователя.
- Учетная запись партнера для песочницы интеграции с клиентом, имеющим активную подписку на продукты коммерческой SaaS-платформы.
- Для партнеров, использующих .NET SDK для Центра партнеров, необходимо использовать SDK версии 1.14.0 или выше, чтобы получить доступ к этой возможности.
Важный
По состоянию на июнь 2023 г. последняя версия пакета SDK для .NET для Центра партнеров 3.4.0 теперь архивируется. Вы можете скачать релиз SDK с GitHubвместе с файлом readme, который содержит полезные сведения.
Партнерам рекомендуется продолжать использовать интерфейсы REST API центра партнеров.
Использование C#
Выполните следующие действия, чтобы активировать подписку для продуктов SaaS коммерческой платформы:
Сделайте интерфейс доступным для операций с подпиской. Необходимо определить клиента и указать идентификатор пробной подписки.
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
Активируйте подписку с помощью операции Активировать.
var subscriptionActivationResult = subscriptionOperations.Activate();
Отправка запроса REST
Используйте следующий синтаксис для отправки запроса REST.
Синтаксис запроса
Метод | URI запроса |
---|---|
ПОСТ | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1 |
Параметр URI
Имя | Тип | Обязательно | Описание |
---|---|---|---|
идентификатор клиента-арендатора | GUID (Globally Unique Identifier) | У | Это значение — идентификатор клиента-арендатора в формате GUID (идентификатор арендатора клиента), который позволяет указать клиента. |
идентификатор подписки | GUID (Globally Unique Identifier) | У | Значением является идентификатор подписки с форматом GUID (идентификатор подписки), который позволяет указать подписку. |
Заголовки запросов
Дополнительные сведения см. в заголовках REST Центра партнеров.
Текст запроса
Нет.
Пример запроса
POST https://api.partnercenter.microsoft.com/v1/customers/42b5f772-5c5c-4bce-b9d7-bdadeecca411/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
Проверьте ответ REST
Этот метод возвращает идентификатор подписки и состояния.
Коды успешных и ошибочных ответов
Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и дополнительных параметров. Для получения полного списка см. раздел Коды ошибок REST Центра партнеров.
Пример ответа
HTTP/1.1 200 OK
Content-Length: 79
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
{
"subscriptionId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"status":"Success"
}