<ph type="x-smartling-placeholder"></ph>
您正在查看 Apigee Edge 文档。
转到
Apigee X 文档。 信息
简介
现有价格方案发布后,您只能更改该价格方案的结束日期。 不过,您可以创建一个包含已更改媒体资源的新版方案,例如 已更改价格方案费率。您可以将修订版本设置为在未来某个日期生效。通过 原始费率方案会在修订生效时结束。
例如,假设您创建了一个将于 2019 年 12 月 31 日到期的标准费率方案, 您想将其替换为另一个将于 2020 年 1 月 1 日生效的方案。为此, 您需要创建未来的费率方案,并将其设置为在 2020 年 1 月 1 日生效。
如果没有为当前价格方案设置结束日期,您可以将现有价格方案替换为 最早从今天开始的未来费率方案您需要让当前的费率方案到期,如到期 已发布的价格方案。
系统会通知开发者价格方案已修改。接受原始版本的开发者 系统会自动为修订注册费率方案(但可以选择拒绝 修订版本)。
您可以使用管理界面或 monetization API 创建未来的费率方案,如 以下部分。
使用界面创建未来的费率方案
按照下文所述创建未来的费率方案。
Edge
创建未来某个时间开始生效的价格方案 使用 Edge 界面,请执行以下步骤。
- 在“费率方案”页面上,
将光标放在与您要创建未来费率方案的费率方案相关联的行中。
此费率方案必须设有结束日期。 - 点击 + 未来。
- 在未来费率方案部分,选择以下选项之一:
<ph type="x-smartling-placeholder">
- </ph>
- 在新的生效日期重新开始整个合同期:未来费率方案会进入 对生效日期的影响。未来费率方案的续订期限与 当前价格方案
- 从生效日当天起,从新周期开始扣减上一份合同的工时: 您的未来费率方案将会生效。使用当前 价格方案会从未来价格方案的续订期限中扣除。这意味着,如果 开发者使用当前方案 3 个月,而续订期会缩短 3 个月。
- 在顶部面板中配置以下字段:
注意:其他字段为只读字段。字段 说明 默认 必需 价格方案名称 您的价格方案的名称。
注意:该名称无需与原始费率方案的名称一致。
现有方案名称 是 开始日期 费率方案的生效日期。输入开始日期或使用日历选择日期。 今天 否 结束日期 价格方案的结束日期。要指定结束日期,请启用包含结束日期切换开关,然后输入结束日期或使用日历选择日期。 注意:该费率方案的有效期会持续到指定日期的当天结束。例如,如果您想在 2018 年 12 月 1 日过期价格方案,则应将 endDate 值设置为 2018-11-30。在这种情况下,价格方案将于 2018 年 11 月 30 日结束时失效;2018 年 12 月 1 日的所有请求都将被屏蔽。
无 否 对门户可见 设置价格方案是公开还是不公开。请参阅公开价格方案与不公开价格方案。 已启用 否 - 配置价格方案的费用。请参阅配置费用。
注意:不适用于可调整的通知计划。 - 如果您选择的产品套装包含多个 API 产品,请在特定或通用费率方案部分设置以下偏好设置:
注意:此步骤不适用于可调整的通知计划。
字段 说明 默认 单独配置每个产品 用于指定是否为每个 API 产品配置单独的费率方案的标志。 已停用 单独配置每个产品的免费增值优惠 用于指定是否为每个 API 产品配置免费增值方案的标志。 已停用 选择产品 如果您启用了其中一个或两个标记,则必须从下拉列表中选择每个产品,并配置其价格方案详细信息。 注意:请务必配置商品套装中的所有商品。
不适用 - 根据所选的价格方案类型配置价格方案详情:
<ph type="x-smartling-placeholder"> - 点击下列选项之一:
按钮 说明 更新草稿 将该价格方案保存为草稿。 在您发布此价格方案之前,应用开发者不会看到此价格方案。您可以修改费率方案草稿中的任何字段。
发布草稿 发布方案。 注意:发布价格方案后,您只能修改尚未设置的结束日期。您无法删除已发布的价格方案,但可以使该价格方案失效,然后将其替换为未来的价格方案,如让已发布的价格方案到期中所述。
传统 Edge(私有云)
创建未来某个时间开始生效的价格方案 使用传统版 Edge 界面,请执行以下步骤。
- 在软件包目录中,点击“Draft/Future”(草稿/未来)列中的 +Future
替换当前价格方案
系统随即会打开未来的“费率方案”窗口。
未来费率方案时间范围和当前费率方案时间范围之间的主要区别为 添加了一个“现有订阅者”部分
- 与任何价格方案一样: <ph type="x-smartling-placeholder">
- 在 现有订阅者 部分,选择以下选项之一:
<ph type="x-smartling-placeholder">
- </ph>
- 在新的生效日期重新开始整个合同期。在未来的费率方案中 对生效日期的影响。未来费率方案的续订期限与 当前价格方案
- 自生效日期起,从新周期开始扣减先前合同的用时。通过 您的未来费率方案将会生效。使用当前 价格方案会从未来价格方案的续订期限中扣除。这意味着,如果 开发者使用当前方案 3 个月,而续订期会缩短 3 个月。
- 在“生效日期”字段中,输入一个晚于 现有价格方案
使用 API 创建未来的费率方案
您可以使用 API 创建未来费率方案,方法是向POST
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision
。
其中:
{org_id}
是组织的名称。{package_id}
是 API 软件包的标识。{plan_Id}
是费率方案的标识。
- </ph>
parentRatePlan
用于指定原始费率方案的 ID。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