您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
简介
现有费率方案发布后，您只能更改其结束日期。 不过，您可以创建包含已更改属性（例如已更改的费率方案费率）的新版方案。您可以设置修订版本在未来的某个日期生效。当修订版本生效时，原费率方案即会结束。
例如，假设您创建了一个标准费率方案，该方案将于 2019 年 12 月 31 日到期，并且您想将其替换为另一个将于 2020 年 1 月 1 日生效的方案。为此，您可以创建一个未来的费率方案，并将其设置为在 2020 年 1 月 1 日生效。
如果当前费率方案未设置结束日期，您可以将现有费率方案替换为未来的费率方案，该方案最早可于今天开始生效。您需要使当前费率方案过期，如使已发布的费率方案过期中所述。
我们会通知开发者有关费率方案的修订。接受原费率方案的开发者会自动注册修订后的方案（但可以选择拒绝修订后的方案）。
您可以使用管理界面或创收 API 创建未来的费率方案，如以下部分所述。
使用界面创建未来费率方案
创建未来的费率方案，如下所述。
Edge
如需使用 Edge 界面创建从今天之后的某个时间开始的费率方案未来版本，请执行以下步骤。
- 在“费率方案”页面上，将光标放在与您要创建未来费率方案的费率方案关联的行内。
该费率方案必须有结束日期。 - 点击 +Future。
- 在未来费率方案部分，选择以下选项之一：
- 在新生效日期重新开始整个合同期：未来的费率方案会在生效日期生效。未来费率方案的续订期限与当前费率方案的续订期限相同。
- 在生效日期，从新期限中扣除之前合同的期限：未来的费率方案在生效日期生效。使用当前费率方案的时间会从未来费率方案的续订期限中扣除。这意味着，如果开发者使用当前方案 3 个月，续订期限会缩短 3 个月。
- 在顶部面板中配置以下字段：
注意：其他字段为只读字段。字段 说明 默认 必需 价格方案名称 费率方案的名称。
注意：名称不必与原始费率方案名称一致。
现有方案名称 是 开始日期 费率方案生效的日期。输入开始日期或使用日历选择日期。 今天 否 结束日期 费率方案的结束日期。如需指定结束日期，请启用有结束日期切换开关，然后输入结束日期或使用日历选择日期。 注意：费率方案将一直有效，直到指定日期当天结束。例如，如果您想让某个费率方案在 2018 年 12 月 1 日过期，则应将 endDate 值设置为 2018-11-30。在这种情况下，费率方案将于 2018 年 11 月 30 日结束时过期；2018 年 12 月 1 日的所有请求都将被阻止。
无 否 对门户可见 设置费率方案是公开还是不公开。请参阅公开费率方案与非公开价格方案。 已启用 否 - 为费率方案配置费用。请参阅配置费用。
注意：不适用于可调整的通知方案。 - 如果您选择的产品包包含多个 API 产品，请在特定或通用费率方案部分中设置以下偏好设置：
注意：此步骤不适用于可调整的通知方案。
字段 说明 默认 单独配置每件商品 用于指定是否为每个 API 产品配置单独的费率方案的标志。 已停用 单独配置每件商品的免费增值优惠 用于指定是否为每个 API 产品配置免费增值方案的标志。 已停用 选择商品 如果您启用一个或两个标志，则必须从下拉列表中单独选择每个商品，并配置其费率方案详细信息。 注意：请确保您已配置商品套装中的所有商品。
不适用 - 根据所选的费率方案类型配置费率方案详细信息：
- 点击下列选项之一：
按钮 说明 更新草稿 将费率方案保存为草稿。 在您发布费率方案之前，应用开发者将无法看到该方案。您可以修改草稿费率方案中的任何字段。
发布草稿 发布方案。 注意：发布费率方案后，您只能修改尚未设置的结束日期。发布费率方案后，您无法将其删除，但可以使其过期，并将其替换为未来的费率方案，如使已发布的费率方案过期中所述。
经典边缘（私有云）
如需使用经典版 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指定原始费率方案的 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