Manage orders - Convert a trial subscription to paid

Ссылка

Служба:: Partner Center Rest

Версия API:: v1

Преобразует пробную подписку на целевое преобразование.

POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/subscriptions/{subscription_id}/conversions

Параметры URI

Имя	В	Обязательно	Тип	Описание
customer_id	path	True	string	Идентификатор клиента.
subscription_id	path	True	string	Идентификатор подписки.
version	path	True	string

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

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Имя	Обязательно	Тип	Описание
Authorization	True	string	Маркер носителя авторизации
ms-correlationid		string	Используется для отслеживания запросов внутри системы. Если ms-correlationid не указан, сервер создаст новый для каждого запроса.
ms-cv		string	Используется для отслеживания запросов внутри системы. Если ms-cv не предоставлено, сервер создаст новый для каждого запроса.
ms-requestid		string	Используется для идемпотентности запросов. Если ms-requestid не указан, сервер создаст новый для каждого запроса.

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

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Имя	Тип	Описание
attributes	Microsoft.Partner.Core.Collections.ResourceAttributes
billingCycle	enum: unknown monthly annual none one_time triennial
offerId	string
orderId	string
quantity	integer
targetOfferId	string

Ответы

Имя	Тип	Описание
200 OK	Microsoft.Partner.Services.Subscriptions.V1.Models.ConversionResult	Запрос выполнен успешно. Результат преобразования возвращается в тексте ответа. Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request		Отсутствуют или недопустимые входные данные. Текст ответа предоставит сведения об ошибке. Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized		Запрос не прошел проверку подлинности. Сначала клиент должен пройти проверку подлинности с помощью службы API партнеров. Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden		Запрос прошел проверку подлинности, но был отклонен, так как вызывающий объект не имеет прав на его вызов. Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found		Ресурс не найден или недоступен с заданными входными параметрами. Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error		Служба API партнера или одна из зависимостей не выполнила запрос. Вызывающие могут повторить это. Media Types: "application/json", "text/json", "application/xml", "text/xml"

Определения

Имя	Описание
Microsoft.Partner.Core.Collections.ResourceAttributes
Microsoft.Partner.Services.Subscriptions.V1.Models.Conversion
Microsoft.Partner.Services.Subscriptions.V1.Models.ConversionError
Microsoft.Partner.Services.Subscriptions.V1.Models.ConversionResult

Microsoft.Partner.Core.Collections.ResourceAttributes

Имя	Тип	Описание
etag	string
objectType	string

Microsoft.Partner.Services.Subscriptions.V1.Models.Conversion

Имя	Тип	Описание
attributes	Microsoft.Partner.Core.Collections.ResourceAttributes
billingCycle	enum: annual monthly none one_time triennial unknown
offerId	string
orderId	string
quantity	integer
targetOfferId	string

Microsoft.Partner.Services.Subscriptions.V1.Models.ConversionError

Имя	Тип	Описание
attributes	Microsoft.Partner.Core.Collections.ResourceAttributes
code	enum: 0 1
description	string

Microsoft.Partner.Services.Subscriptions.V1.Models.ConversionResult

Имя	Тип	Описание
attributes	Microsoft.Partner.Core.Collections.ResourceAttributes
error	Microsoft.Partner.Services.Subscriptions.V1.Models.ConversionError
offerId	string
subscriptionId	string
targetOfferId	string

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