Ресурсы подписки

Применимо к: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud для государственных организаций США

Подписка позволяет клиенту использовать службу в течение определенного периода времени. Не все поля применяются ко всем подпискам. Многие поля применяются только в определенных точках жизненного цикла, например, если подписка приостановлена или отменена.

Подписка

Заметка

Ресурс подписки имеет лимит количества запросов: 500 запросов в минуту на идентификатор арендатора.

Ресурс подписки представляет жизненный цикл подписки и включает свойства, определяющие состояния в течение жизненного цикла подписки.

Имущество	Тип	Описание
Идентификатор	струна	Идентификатор подписки.
идентификатор предложения	струна	Идентификатор предложения.
идентификатор права	струна	Идентификатор права (идентификатор подписки Azure).
название предложения	струна	Название предложения.
удобочитаемое имя	струна	Удобное для восприятия имя подписки, определенной партнером, чтобы помочь дезамбигуировать.
количество	число	Количество. Это свойство установлено на количество лицензий для выставления счетов по количеству лицензий.
тип единицы	струна	Единицы, определяющие количество для подписки: "Лицензии", "На основе использования" или "Преимущество".
Id родительской подписки	струна	Возвращает или задает идентификатор родительской подписки.
дата создания	струна	Возвращает или задает дату создания в формате даты и времени.
дата начала действия	строка в формате даты и времени UTC	Задает или возвращает фактическую дату начала для этой подписки, установленную в формате даты и времени. Это свойство используется для корректировки даты задним числом перенесенной подписки или согласования её с другой подпиской.
дата начала обязательства	строка в формате даты и времени UTC	Дата начала обязательства по этой подписке в формате "дата-время".
Дата окончания обязательства	строка в формате даты и времени UTC	Дата окончания периода обязательств для этой подписки в формате даты и времени. Для подписок, которые не являются автоматически обновляемыми, это свойство представляет дату далеко в будущем. Новые даты окончания коммерческих операций являются включительными, то есть конец срока приходится на конец всего дня. Устаревшие даты окончания не являются инклюзивными.
Дата и время окончания обязательства	строка в формате даты и времени UTC	Дата и время окончания обязательств для этой подписки в формате даты и времени. Для подписок, которые не являются автоматически обновляемыми, это свойство представляет дату далеко в будущем.
датаВремяОкончанияЛьготногоПериода	строка в формате даты и времени UTC	Дата окончания льготного периода, если подписка не продлеваться в конце срока.
статус	струна	Состояние подписки: "none", "активный", "ожидающий", "приостановлено", "истек срок действия", "отключено" или "удалено".
включено автообновление	булев	Возвращает значение, указывающее, обновляется ли подписка автоматически.
тип_платежа	струна	Указывает, как взимается плата за подписку: "none", "использование", "лицензия" или "преимущество".
платежный цикл	струна	Указывает частоту выставления счетов партнером за этот заказ. Поддерживаемые значения — это имена элементов, найденные в BillingCycleType.
имеетПокупаемыеМодули	булев	Возвращает или задает значение, указывающее, имеет ли подписка доступные для покупки надстройки.
isTrial	булев	Значение, указывающее, является ли подписка пробной версией.
isMicrosoftProduct	булев	Значение, указывающее, является ли подписка продуктом Microsoft.
Имя издателя	струна	Имя издателя.
Действия	массив строк	Возвращает или задает допустимые действия. Возможные значения: "edit", "cancel"
partnerId	струна	PartnerID зарегистрированного реселлера, используемого в модели непрямого сотрудничества.
дополнительныеPartnerIds	массив строк	Коллекция идентификаторов PartnerID, используемых только распространителями в ЕС/EFTA.
причины приостановки	массив строк	Только для чтения. Если подписка была приостановлена, указывает, почему.
тип контракта	струна	Только для чтения. Тип контракта: "подписка", "productKey" или "redemptionCode".
варианты возврата	массив ресурсов RefundOption	Только для чтения. Набор вариантов возврата средств, доступных для этой подписки.
инструкции по расписанию для следующего семестра	Инструкции для запланированного следующего семестра	Возвращает или задает запланированные инструкции, выполняемые при запуске следующего термина.
инструкции по следующей зарядке	инструкцииПоСледующейЗарядке	Возвращает сведения о следующих инструкциях по выставлению счетов для изменений расчетного цикла в конце текущего срока.
ссылки	SubscriptionLinks	Получает или устанавливает ссылки подписки.
номерЗаказа	струна	Идентификатор заказа, размещенного для начала подписки.
срок действия	струна	Представление продолжительности термина в формате ISO 8601. Текущие поддерживаемые значения : P1M (1 месяц), P1Y (1 год) и P3Y (3 года).
termLifeCycleState	струна	Представление стадии жизненного цикла срока подписки. Текущие поддерживаемые значения GA (общедоступная версия), EndOfSale и EndOfSaleWithConversions (можно конвертировать в).
Атрибуты	ResourceAttributes	Атрибуты метаданных, соответствующие подписке.
продолжительностьСрокаОбновления	струна	Представление продолжительности термина в формате ISO 8601. Текущие поддерживаемые значения: P1M (1 месяц) и P1Y (1 год).
Тип продукта	ТипЭлемента	Только для чтения. Тип продукта, для который используется подписка.
тип потребления	массив избыточных ресурсов	Возвращает или задает превышение параметров для данного клиента.
promotionId	струна	Идентификатор акции, если он применяется к подписке. Пример формата: "39NFJQT1PJQB:0001:39NFJQT1Q5KN"
Отмена разрешена до даты	ДатаВремя	Последний день для отмены.
Дата окончания платежного цикла	ДатаВремя	Возвращает или задает дату окончания цикла выставления счетов для этой подписки в формате даты и времени.
Дата и время окончания расчетного цикла	ДатаВремя	Получает время окончания цикла выставления счетов для этой подписки в формате даты и времени.
Заявка на продукт (productOrderId)	струна	Идентификатор для конкретной покупки продукта (например, резервирования или плана экономии Azure).
элементы строки	Элемент подписки	Элемент строки содержит сведения о покупке определенной подписки.

Ссылки на подписку

Ресурс SubscriptionLinks описывает коллекцию ссылок, подключенных к ресурсу подписки.

Имущество	Тип	Описание
предложение	ссылка	Возвращает или задает предложение.
родительская подписка	ссылка	Возвращает или задает родительскую подписку.
продукт	ссылка	Возвращает продукт, связанный с подпиской.
SKU	ссылка	Возвращает номер SKU продукта, связанный с подпиской.
наличие	ссылка	Возвращает доступность номера SKU продукта, связанную с подпиской.
ссылки активации	ссылка	Возвращает список ссылок активации, связанных с подпиской.
сам	ссылка	URI для самостоятельного выполнения.
следующий	ссылка	Следующая страница товаров.
предыдущий	ссылка	Предыдущая страница элементов.

СтатусОрганизацииПодписки

Ресурс SubscriptionProvisioningStatus предоставляет сведения о состоянии подготовки подписки.

Имущество	Тип	Описание
skuId	струна	Строка, определяющая номер SKU продукта.
статус	струна	Указывает состояние подготовки: "удачно", "в ожидании" или "неудачно".
количество	число	Предоставляет число подписок после предоставления.
дата окончания	строка в формате даты и времени UTC	Дата окончания подписки.
Атрибуты	ResourceAttributes	Атрибуты метаданных.

инструкции по расписанию для следующего семестра

Ресурс scheduledNextTermInstructions определяет инструкции, которые необходимо применить в начале следующего срока подписки. Присутствует только в том случае, если установлены запланированные изменения или для всех пробных подписок.

Имущество	Тип	Описание
продукт	продукт	Отформатированная строка GUID, определяющая номер SKU продукта.
количество	число	Предоставляет число подписок после предоставления.
ПользовательскаяДатаОкончанияСрока	строка в формате даты и времени UTC	Установленная пользователем дата окончания подписки при совпадении с датой окончания другой подписки

Продукт

scheduledNextTermInstructions.product ресурс и атрибуты запланированного изменения будут применяться в следующем термине.

Имущество	Тип	Описание
productId	Струна	Идентификатор продукта.
skuId	Струна	Предоставляет число подписок после предоставления.
идентификатор доступности	Струна	Идентификатор этой доступности. Этот идентификатор является уникальным только в контексте связанного с ним продукта и артикула SKU. С течением времени идентификаторы доступности могут изменяться. Партнеры должны полагаться только на это значение в течение короткого промежутка времени после получения.
платежный цикл	Струна	Указывает частоту выставления счетов партнером за этот заказ. Поддерживаемые значения — это имена элементов, найденные в BillingCycleType.
срок действия	Струна	Представление продолжительности термина в формате ISO 8601. Текущие поддерживаемые значения: P1M (1 месяц) и P1Y (1 год).
promotionId	Струна	Идентификатор повышения, который будет применен к следующему запланированному термину. Пример формата: "39NFJQT1PJQB:0001:39NFJQT1Q5KN".

инструкции по следующей зарядке

Ресурс nextChargeInstructions определяет инструкции цикла выставления счетов, применяемые в начале следующего срока подписки. Присутствует только в случае ожидаемых изменений цикла выставления счетов.

Имущество	Тип	Описание
продукт	продукт	Отформатированная строка GUID, определяющая номер SKU продукта.
количество	число	Предоставляет число подписок после предоставления.

SubscriptionRegistrationStatus

Ресурс SubscriptionRegistrationStatus описывает коллекцию ссылок, подключенных к ресурсу подписки.

Имущество	Тип	Описание
ID подписки	струна	Идентификатор подписки.
статус	струна	Указывает состояние регистрации: "зарегистрировано", "регистрация" или "не зарегистрировано".

Контакт службы поддержки

Ресурс SupportContact представляет контакт службы поддержки для подписки клиента.

Имущество	Тип	Описание
supportTenantId	струна	Отформатированная строка GUID, указывающая идентификатор клиента контакта поддержки.
supportMpnId	струна	Идентификатор партнера контакта.
имя	струна	Имя контактного лица службы поддержки.
ссылки	СсылкиНаРесурсы	Связанные ссылки для контакта с поддержкой.
Атрибуты	ResourceAttributes	Атрибуты метаданных. Содержит "objectType": "SupportContact".

излишек

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

Имущество	Тип	Описание
azureEntitlementId (идентификатор прав на Azure)	струна	Отформатированная строка GUID, указывающая идентификатор подписки на потребление.
partnerId	струна	Идентификатор партнера торгового посредника, связанного с подпиской.
тип	струна	Тип превышения может быть "Услуги телефонной связи"
превышение	булев	Значение, указывающее, включено ли превышение лимита.
ссылки	СсылкиНаРесурсы	Избыточные связанные ссылки.
Атрибуты	ResourceAttributes	Атрибуты метаданных. Содержит "тип объекта": "Overage".

ЗарегистрироватьПодписку

Ресурс RegisterSubscription возвращает ссылку, которую можно использовать для запроса состояния регистрации подписки. Состояние регистрации возвращается в тексте ответа успешно принятого запроса на регистрацию подписки Azure.

Имущество	Тип	Описание
Сообщение HTTP-ответа	объект	Возвращает код состояния HTTP 202 "Принято" с заголовком расположения, содержащим ссылку для запроса состояния регистрации. Например, "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus"

Опция возврата средств

Ресурс RefundOption представляет собой возможный вариант возврата для подписки.

Имущество	Тип	Описание
тип	струна	Тип возврата. Поддерживаемые значения: "Частично" и "Полностью"
истекает после	строка в формате даты и времени UTC	Временная метка истечения срока действия этого параметра. Если значение null, операция возврата не имеет срока действия.

Права на Azure

Ресурс AzureEntitlement представляет Azure права для подписки.

Имущество	Тип	Описание
Идентификатор	струна	Идентификатор права
удобочитаемое имя	струна	Дружественное имя права.
статус	струна	Состояние права.
ID подписки	струна	Идентификатор подписки, к которому принадлежит право.

ЭлементСтрокиПодписки

Элемент строки содержит сведения о покупке определенной подписки.

свойство	типа	описание
Идентификатор	струна	Идентификатор элемента строки подписки.
удобочитаемое имя	струна	Дружелюбное имя для элемента строки подписки, определенного партнером, чтобы помочь устранить неопределенность.
размах	Объем	Область указывает, где применяются преимущества.
включено автообновление	Булев	Возвращает значение, указывающее, обновляется ли подписка автоматически.
статус	струна	Состояние подписки: "none", "активный", "ожидающий", "приостановлено", "истек срок действия", "отключено" или "удалено".
обязательство по покупке	обязательства на приобретение	Фиксированная сумма, выделенная на вычислительные услуги.

Размах

Область указывает, где применяются преимущества.

свойство	типа	описание
тип	струна	Тип области покупки: Single, Shared, Resource group или Management Group.
ID подписки	струна	Идентификатор плана Azure, который будет использоваться для покупки. Требуется для общего контекста.
идентификатор права	струна	Идентификатор подписки Azure, которая будет использоваться для покупки. Требуется для одной области применения.
идентификатор группы управления	струна	Идентификатор группы управления, которая будет использоваться для совершения покупки. Эту область можно выбрать только через портал Azure в настоящее время, но обновления отражаются на ПК.
идентификаторГруппыРесурсов	струна	Идентификатор группы ресурсов, которая будет использоваться для покупки. Эту область можно выбрать только через портал Azure в настоящее время, но обновления отражаются на ПК.

Обязательство по приобретению

Фиксированная сумма, выделенная на вычислительные услуги.

свойство	типа	описание
количество	струна	Обязательство фиксированной суммы.
зерно	струна	Период обязательства.
валюта	струна	Валюта обязательства.