Содержание

Редактирование подписки

Позволяет изменить значения полей существующего объекта Subscription.

Запрос

Синтаксис

Метод URI
PUT /subscriptions/

Параметры URI

Нет.

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

См. Vendor API

Тело запроса

Редактируемый объект Subscription. Контракты сервиса.
Обязательные поля: Id.
Разрешенные к редактированию поля: Quantity.
Изменения (как и отсутствие значений) других полей следует игнорировать.

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

PUT /subscriptions/
{
	"Id": "81844649-4a04-49dc-85a8-56c975597ded",
	"Quantity": 123.45,
	...
}

Ответ

Успех

Стандартный код HTTP: 200 OK.

Тело ответа: изменённый объект Subscription. Контракты сервиса

Ошибка

Для указания типа ошибки в ответе сервера, используются стандартные HTTP-коды 4xx-5xx.

Тело ответа: возвращается общий для сервиса набор данных, содержащий сообщение об ошибке и дополнительную информацию. Дополнительная информация в разделе Ошибки сервиса.

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

{
	"Id": "0a0ae92f-f5f1-4349-9d51-fdb7d971602b",
	"ProfileId": "3a0ae92f-f5f1-4349-9d51-fdb7d971602b",
	"OfferId": "3a0ae92f-f5f1-4349-9d51-fdb7d971602c",
    ...
	"Childs": [{
        	"Id": "9asde92f-f5f1-4349-9d51-fdb7d971602b",
		"ProfileId": "3a0ae92f-f5f1-4349-9d51-fdb7d971602b",
		"OfferId": "3a0ae92f-f5f1-4349-9d51-fdb7d971602c",
        ...
	}]
}

Контракт данных

Subscription (Подписка)

ПолеТипОписание
IdGUIDГенерация уникальных идентификаторов для объектов
Quantitynumber
StatestringВозможные значения: Starting, Started, Stopping, Stopped, Suspending, Suspended, Deleting, Deleted
OfferIdGUID ID продаваемой услуги (тарифный план). Примеры услуг: Office 365 Business, SharePoint Online (Plan 2)
ParentIdGUIDID родительской подписки (указывается только для дочерних подписок - аддонов)
ProfileIdGUIDID подписчика
ChildsJSON arrayМассив дочерних подписок (аддонов). Контракты родительской и дочерних подписок абсолютно идентичны по структуре. Вложенность свыше 1 уровня не поддерживается (т.е. у дочерних подписок детей быть не может).
DynamicPropertiesJSON array Динамические свойства контрактов
CreateDate datetime дата-время создания
StartDate datetime дата-время начала работы (биллингового периода?)
ActiveTill datetime дата-время окончания работы