您目前查看的是 Apigee Edge 說明文件。
參閱 Apigee X說明文件。 資訊
簡介
現有房價方案發布後，您只能變更結束日期。 不過，您可以建立新的方案版本，並在其中加入變更的屬性 (例如變更費率方案費率)。您可以設定日後的修訂版本生效。原始費率方案會在修訂版本生效後結束。
舉例來說，假設您建立了一項於 2019 年 12 月 31 日到期的標準費率方案，並想替換為於 2020 年 1 月 1 日生效的另一個方案。如要這麼做，請建立未來費率方案，並設定為在 2020 年 1 月 1 日生效。
如果目前的費率方案未設定結束日期，您可以將現有費率方案換成最早從今天開始的未來費率方案。您需要過期目前的費率方案，詳情請參閱「過期的費率方案」。
開發人員會收到有關修訂費率方案的通知。這些開發人員接受原始費率方案後，系統會自動為該修訂版本註冊 (但您可以選擇拒絕修訂版本)。
您可以按照下列各節所述，透過管理 UI 或營利 API 建立未來的費率方案。
透過使用者介面製定未來費率方案
按照下方說明建立未來的費率方案。
Edge
如要建立日後透過 Edge UI 從今天之後開始的費率方案版本，請執行下列步驟。
- 在費率方案頁面中，找出要建立未來費率方案的費率方案，然後將滑鼠遊標移到對應的資料列中。
房價方案必須設有結束日期。 - 按一下「+ Future」。
- 在「未來費率方案」部分，選取下列其中一個選項：
- 在新的生效日期重新開始完整合約期：未來的費率方案會在生效日期生效。未來費率方案的續約約期與目前費率方案相同。
- 將舊合約的花費時間從新週期起算 (生效日期)：未來的費率方案會在生效日期生效。目前費率方案的使用時間會從未來費率方案的續約期中扣除。也就是說，如果開發人員使用現行方案 3 個月，續訂期減少 3 個月。
- 在頂端面板中設定下列欄位：
注意：其他欄位為唯讀欄位。欄位 說明 預設 必要 費率方案名稱 房價方案的名稱。
注意：這個名稱不必與原始房價方案的名稱相同。
現有方案名稱 是 開始日期 房價方案生效的日期。輸入開始日期，或使用日曆選取日期。 今天 否 結束日期 房價方案的結束日期。如要指定結束日期，請啟用「有結束日期」切換鈕，然後輸入結束日期，或使用日曆選取日期。 注意：房價方案將於指定日期的當天結束前生效。舉例來說，如果您想在 2018 年 12 月 1 日到期費率方案，請將 endDate 值設為 2018-11-30。在這種情況下，費率方案將於 2018 年 11 月 30 日當天結束時到期，2018 年 12 月 1 日的所有要求都會遭到封鎖。
無 否 入口網站皆可檢視 將房價方案設為「公開」或「私人」。請參閱公開與不公開費率方案。 已啟用 否 - 設定房價方案的費用。請參閱設定費用一節。
注意：不適用於可調整的通知方案。 - 如果所選產品套裝組合包含多個 API 產品，請在「特別或一般費率方案」部分中設定下列偏好設定：
注意：這個步驟不適用於可調整的通知方案。
欄位 說明 預設 個別設定每項產品 此標記可指定是否要為每個 API 產品設定個別費率方案。 已停用 個別設定各項產品的免費增值方案 此標記可指定是否要為每個 API 產品設定免費增值方案。 已停用 選取產品 如果您啟用其中一或兩種標記，就必須在下拉式清單中選取個別產品，並設定費率方案詳細資料。 注意：請務必設定產品套裝組合中的所有產品。
無 - 根據所選費率方案類型設定費率方案詳細資料：
- 點選下列其中一個選項：
按鈕 說明 更新草稿 將費率方案儲存為草稿。 在你發布費率方案之前，應用程式開發人員不會看到費率方案。您可以編輯費率方案中的任何欄位。
發布草稿 發布方案。 注意：發布費率方案後，如果結束日期尚未設定，就只能修改結束日期。費率方案一經發布即無法刪除，但可以過期，而替換為日後的費率方案，詳情請參閱「過期已發布的費率方案」一節。
傳統版 Edge (Private Cloud)
如要使用傳統版 Edge UI 建立從今天之後某個時間點開始的費率方案版本，請執行下列步驟。
- 在套件目錄中，找到要取代的費率方案，然後在「草稿/未來」欄中，按一下「+Future」。
系統隨即會開啟未來的費率方案視窗。
未來費率方案期間與目前費率方案期間的主要差異，在於新增現有訂閱者專區。
- 採用各種費率方案的方式如下：
- 在「現有訂閱者」部分中，選取下列其中一個選項：
- 在新生效日期重新開始完整合約期間。未來的費率方案會在生效日期生效。未來費率方案的續約約期與目前費率方案相同。
- 從新週期開始，扣除舊合約的花費時間，也就是生效日期。未來的費率方案將於生效日期生效。目前費率方案的使用時間會從未來費率方案的續約期中扣除。也就是說，如果開發人員使用現行方案 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