Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация
Введение
После публикации существующего тарифного плана единственное свойство, которое вы можете изменить, — это дата его окончания. Однако вы можете создать новую версию плана, включающую измененные свойства, например измененные тарифы тарифного плана. Вы можете настроить изменение, чтобы оно вступило в силу в будущем. Исходный тарифный план прекращает свое действие с вступлением в силу пересмотренной версии.
Например, предположим, что вы создали стандартный тарифный план, срок действия которого истекает 31 декабря 2019 года, и хотите заменить его другим планом, который вступит в силу 1 января 2020 года. Для этого вы создаете будущий тарифный план и настраиваете его. вступит в силу с 1 января 2020 года.
Если для текущего тарифного плана не установлена дата окончания, вы можете заменить существующий тарифный план будущим тарифным планом, который начнет действовать уже сегодня. Вам необходимо будет прекратить действие текущего тарифного плана, как описано в разделе Срок действия опубликованного тарифного плана .
Разработчики уведомлены об изменении тарифного плана. Те разработчики, которые принимают исходный тарифный план, автоматически регистрируются для участия в новой версии (но имеют возможность отклонить ее).
Вы можете создать будущий тарифный план с помощью пользовательского интерфейса управления или API монетизации, как описано в следующих разделах.
Создание будущего тарифного плана с помощью пользовательского интерфейса
Создайте будущий тарифный план, как описано ниже.
Край
Чтобы создать будущую версию тарифного плана, который начнется где-то после сегодняшнего дня, с использованием пользовательского интерфейса Edge, выполните следующие действия.
- На странице «Тарифные планы» поместите курсор в строку, связанную с тарифным планом, для которого вы хотите создать будущий тарифный план.
Тарифный план должен иметь дату окончания. - Нажмите +Будущее .
- В разделе «Будущий тарифный план» выберите один из следующих вариантов:
- Перезапустить полный период действия договора с новой даты вступления в силу : будущий тарифный план вступает в силу с даты вступления в силу. Срок продления будущего тарифного плана такой же, как и для текущего тарифного плана.
- Вычтите время, потраченное на предыдущий контракт, из нового периода на дату вступления в силу : будущий тарифный план вступает в силу с даты вступления в силу. Время, потраченное на использование текущего тарифного плана, вычитается из срока продления будущего тарифного плана. Это означает, что если разработчик использует текущий план в течение 3 месяцев, то период продления сокращается на 3 месяца.
- Настройте следующие поля на верхней панели:
Примечание . Остальные поля доступны только для чтения.Поле Описание По умолчанию Необходимый Название тарифного плана Название вашего тарифного плана.
Примечание . Имя не обязательно должно совпадать с названием исходного тарифного плана.
Название существующего плана Да Дата начала Дата вступления тарифного плана в силу. Введите дату начала или выберите дату с помощью календаря. Сегодня Нет Дата окончания Дата окончания действия тарифного плана. Чтобы указать дату окончания, включите параметр «Есть дата окончания», переключите переключатель и введите дату окончания или выберите дату с помощью календаря. Примечание . Тарифный план будет действовать до конца дня указанной даты. Например, если вы хотите истечь срок действия тарифного плана 1 декабря 2018 г., вам следует установить значение endDate на 2018-11-30. В этом случае срок действия тарифного плана истечет в конце дня 30 ноября 2018 года; все запросы 1 декабря 2018 года будут заблокированы.
Никто Нет Виден порталам Укажите, является ли тарифный план публичным или частным. См. раздел Государственные и частные тарифные планы . Включено Нет - Настройте комиссию для тарифного плана. См. Настройка сборов .
Примечание . Не применимо к настраиваемым планам уведомлений. - Если вы выбираете пакет продуктов, который содержит более одного продукта API, установите следующие настройки в разделе «Специальный или общий тарифный план» :
Примечание . Этот шаг неприменим к настраиваемым планам уведомлений.Поле Описание По умолчанию Настраивайте каждый продукт индивидуально Флаг, указывающий, нужно ли настраивать индивидуальный тарифный план для каждого продукта API. Неполноценный Настройте бесплатное предложение каждого продукта индивидуально. Флаг, указывающий, следует ли настраивать план Freemium для каждого продукта API. Неполноценный Выберите продукт Если вы включите один или оба флага, вам необходимо выбрать каждый продукт отдельно из раскрывающегося списка и настроить детали его тарифного плана. Примечание . Убедитесь, что вы настроили все продукты в комплекте продуктов.
Н/Д - Настройте детали тарифного плана в зависимости от выбранного типа тарифного плана:
- Нажмите один из следующих вариантов:
Кнопка Описание Обновить черновик Сохраните тарифный план как черновик. Тарифный план не будет виден разработчикам приложений, пока вы его не опубликуете. Вы можете редактировать любое поле в проекте тарифного плана.
Опубликовать черновик Опубликуйте план. Примечание . После публикации тарифного плана вы можете изменить дату окончания только в том случае, если она еще не установлена. Вы не можете удалить тарифный план после его публикации, но можете прекратить действие тарифного плана и заменить его будущим тарифным планом, как описано в разделе Срок действия опубликованного тарифного плана .
Классический Edge (частное облако)
Чтобы создать будущую версию тарифного плана, который начнется где-то после сегодняшнего дня, с использованием пользовательского интерфейса Classic Edge, выполните следующие действия.
- В каталоге пакетов нажмите +Будущее в столбце Черновик/Будущее для тарифного плана, который вы хотите заменить.
Откроется окно будущего тарифного плана.
Основное различие между окном будущего тарифного плана и окном текущего тарифного плана заключается в добавлении раздела «Существующие подписчики».
- Как и для любого тарифного плана:
- Введите название тарифного плана в поле «Название тарифного плана». Имя не обязательно должно совпадать с названием исходного тарифного плана.
- Настройка тарифов для тарифного плана (опционально).
- Настройте детали тарифного плана в зависимости от выбранного типа тарифного плана:
- Укажите дату вступления будущего тарифного плана в силу (см. Публикация тарифных планов ) и дату окончания (вы также можете выбрать «Без даты окончания», если не хотите, чтобы будущий тарифный план заканчивался в определенную дату). Если для текущего плана установлена дата окончания, то дата вступления в силу будущего плана должна быть после даты окончания текущего плана.
- В разделе «Существующие подписчики» выберите один из следующих вариантов:
- Возобновить полный период действия контракта с новой даты вступления в силу. Будущий тарифный план вступает в силу с даты вступления в силу. Срок продления будущего тарифного плана такой же, как и для текущего тарифного плана.
- Вычтите время, потраченное на предыдущий контракт, из нового периода, на дату вступления в силу. Будущий тарифный план вступает в силу с даты вступления в силу. Время, потраченное на использование текущего тарифного плана, вычитается из срока продления будущего тарифного плана. Это означает, что если разработчик использует текущий план в течение 3 месяцев, то период продления сокращается на 3 месяца.
- В поле «Дата вступления в силу» введите дату начала, которая наступает после даты окончания существующего тарифного плана.
Создание будущего тарифного плана с помощью API
Вы можете создать будущий тарифный план с помощью API, отправив POST
запрос к /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision
.
Где:
-
{org_id}
— название организации. -
{package_id}
— это идентификатор пакета API. -
{plan_Id}
— идентификатор тарифного плана.
-
parentRatePlan
указывает идентификатор исходного тарифного плана. -
startDate
указывает дату вступления в силу нового плана.
Название будущего тарифного плана не должно совпадать с названием исходного плана. Кроме того, он должен быть уникальным среди всех ваших тарифных планов. Если вы хотите, чтобы исходная дата начала записывалась для разработчиков, установите для флага keepOriginalStartDate
значение true
. По умолчанию этот флаг имеет значение false
.
Дополнительную информацию о настройках конфигурации см. в разделе Настройки конфигурации для тарифных планов .
Например, следующий запрос создает будущий тарифный план:
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "parentRatePlan": { "id": "monetization_package_flat_rate_card_plan_1379513833409" }, "name": "Flat rate card plan", "developer":null, "developerCategory":null, "advance": "false", "currency": { "id" : "usd" }, "description": "Flat rate card plan", "displayName" : "Flat rate card plan", "frequencyDuration": "30", "frequencyDurationType": "DAY", "earlyTerminationFee": "10", "monetizationPackage": { "id": "location" }, "organization": { "id": "{org_name}" }, "paymentDueDays": "30", "prorate": "false", "published": "true", "ratePlanDetails": [ { "currency": { "id" : "usd" }, "paymentDueDays": "30", "meteringType": "UNIT", "organization": { "id": "myorg" }, "ratePlanRates": [ { "type": "RATECARD", "rate": "0.05", "startUnit": "0" } ], "ratingParameter": "VOLUME", "type": "RATECARD" }], "recurringStartUnit": 1, "recurringType": "CALENDAR", "recurringFee": "10", "setUpFee": "10", "startDate": "2014-01-01 00:00:00", "type": "STANDARD" }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans/monetization_package_flat_rate_card_plan_1379513833409/revision" \ -u email:password