查看 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 發出 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