Активация подписки песочницы для продуктов SaaS коммерческой платформы для включения выставления счетов

Статья
03/14/2024

Как активировать подписку на продукты коммерческой платформы marketplace как услуга (SaaS) из учетных записей песочницы интеграции, чтобы включить выставление счетов.

Примечание.

Можно активировать подписку только для продуктов SaaS коммерческой платформы из учетных записей песочницы интеграции. Если у вас есть рабочая подписка, необходимо посетить сайт издателя, чтобы завершить процесс установки. Выставление счетов за подписку начнется только после завершения настройки.

Необходимые компоненты

Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с помощью автономных учетных данных приложения и приложения и пользователя.
Учетная запись партнера песочницы интеграции с клиентом с активной подпиской для продуктов SaaS коммерческой платформы.
Для партнеров, использующих пакет SDK для .NET Для Центра партнеров, необходимо использовать пакет SDK версии 1.14.0 или более поздней, чтобы получить доступ к этой возможности.

Важно!

По состоянию на июнь 2023 г. последняя версия пакета SDK для .NET для Центра партнеров 3.4.0 теперь архивируется. Вы можете скачать выпуск пакета SDK из GitHub вместе с файлом чтения, содержащим полезные сведения.

Партнерам рекомендуется продолжать использовать REST API Центра партнеров.

C#

Выполните следующие действия, чтобы активировать подписку для продуктов SaaS коммерческой платформы:

Сделайте интерфейс доступными для операций подписки. Необходимо определить клиента и указать идентификатор подписки пробной подписки.
```
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
```
Активируйте подписку с помощью операции активации.
```
var subscriptionActivationResult = subscriptionOperations.Activate();
```

Запрос REST

Синтаксис запроса

Метод	URI запроса
POST	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

Параметр универсального кода ресурса

Имя.	Тип	Обязательное поле	Description
customer-tenant-id	guid	Y	Значением является идентификатор клиента с форматом GUID (customer-tenant-id), который позволяет указать клиента.
subscription-id	guid	Y	Значением является идентификатор подписки с форматом GUID (идентификатор подписки), который позволяет указать подписку.

Заголовки запросов

Дополнительные сведения см. в статье о заголовках REST Центра партнеров.

Текст запроса

Нет.

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

POST https://api.partnercenter.microsoft.com/v1/customers/42b5f772-5c5c-4bce-b9d7-bdadeecca411/subscriptions/87363db7-39ab-dd25-d371-94340aaa2f97/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

Ответ REST

Этот метод возвращает свойства идентификатора подписки и состояния .

Коды успешного выполнения и ошибок в ответе

Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. Полный список ответов есть в статье Коды ошибок REST в Центре партнеров.

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

HTTP/1.1 200 OK
Content-Length: 79
Content-Type: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"87363db7-39ab-dd25-d371-94340aaa2f97",
    "status":"Success"
}

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