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