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