建立未來費率方案

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件
資訊

簡介

現有房價方案發布後,您只能變更結束日期。 不過,您可以建立包含變更屬性的新版方案,例如: 費率方案變更費率您可以設定日後的修訂版本生效。 原始費率方案會在修訂版本生效後結束。

舉例來說,假設您建立的標準費率方案到期日為 2019 年 12 月 31 日 而是您希望替換為於 2020 年 1 月 1 日生效的另一個方案。方法如下 並制定未來費率方案,並在 2020 年 1 月 1 日生效。

如果目前費率方案未設定結束日期,您可以將現有費率方案替換為 未來的費率方案 (最快從今天開始)目前的費率方案設有到期日,詳情請參閱「到期日為 已發布的費率方案

開發人員會收到有關修訂費率方案的通知。接受原始版本的開發人員 系統會自動為修訂版本註冊費率方案 (但您也可以選擇拒絕 修訂版本)。

您可以使用管理 UI 或營利 API 建立未來的費率方案,方法如下: 以下各節。

透過使用者介面製定未來費率方案

按照下方說明建立未來的費率方案。

Edge

針對從今天之後開始的費率方案建立日後推出的費率方案 使用 Edge UI 執行下列步驟

  1. 費率方案頁面中: 針對要建立未來費率方案的費率方案,找到相關聯的資料列。
    房價方案必須設有結束日期。
  2. 按一下「+ Future」
  3. 在「未來費率方案」部分,選取下列其中一個選項:
    • 在新的生效日期重新開始完整合約期:未來費率方案要採用 生效日期未來費率方案的續約期限與 目前的費率方案。
    • 將舊合約的花費時間從新週期起算 (生效日期): 未來的房價方案會在生效日期生效。使用目前指標的時間 從未來費率方案的續約期開始扣除房價方案。也就是說 開發人員使用現行方案 3 個月,續約期減少 3 個月 每月。
  4. 在頂端面板中設定下列欄位:
    注意:其他欄位為唯讀欄位。
    欄位 說明 預設 必要
    房價方案名稱

    房價方案的名稱。

    注意:這個名稱不必與原始房價方案的名稱相同。

    現有企劃書名稱
    開始日期 房價方案生效的日期。輸入開始日期,或使用日曆選取日期。 今天
    結束日期 房價方案的結束日期。如要指定結束日期,請啟用「含結束日期」切換鈕,然後輸入結束日期,或使用日曆選取日期。

    注意:房價方案將於指定日期的當天結束前生效。舉例來說,如果您想在 2018 年 12 月 1 日到期費率方案,請將 endDate 值設為 2018-11-30。在這種情況下,房價方案將於 2018 年 11 月 30 日結束時到期。2018 年 12 月 1 日提出的所有要求都會遭到封鎖。

    入口網站皆可檢視 將房價方案設為「公開」或「私人」。請參閱公開與不公開費率方案 已啟用
  5. 設定房價方案的費用。請參閱設定費用一節。
    注意:不適用於可調整的通知方案。
  6. 如果所選產品套裝組合包含多個 API 產品,請在「特定或一般費率方案」部分中設定下列偏好設定:
    注意:這個步驟不適用於可調整的通知計畫。
    欄位 說明 預設
    逐一設定每項產品 此標記可指定是否要為每個 API 產品設定個別費率方案。 已停用
    個別設定各項產品的免費增值方案 此標記可指定是否要為每個 API 產品設定免費增值方案。 已停用
    選取產品 如果你啟用其中一或兩種標記,就必須在下拉式清單中選取各項產品,並設定費率方案詳細資料。

    注意:請務必設定產品套裝組合中的所有產品。

  7. 根據所選費率方案類型設定費率方案詳細資料:
  8. 點選下列其中一個選項:
    按鈕 說明
    更新草稿 將費率方案儲存為草稿。

    在你發布費率方案之前,應用程式開發人員不會看到費率方案。您可以編輯費率方案草稿中的任何欄位。

    發布草稿 發布企劃書。

    注意:發布費率方案後,如果結束日期尚未設定,就只能修改結束日期。費率方案一經發布即無法刪除,但可以過期,並以日後推出的費率方案取代,詳情請參閱「過期已發布的費率方案」一節。

傳統版 Edge (Private Cloud)

針對從今天之後開始的費率方案建立日後推出的費率方案 使用傳統版 Edge UI 執行下列步驟

  1. 在套件目錄中,按一下「草稿/未來」欄中的「+Future」, 做為要替換的房價方案。

    系統隨即會開啟未來的費率方案視窗。

    未來費率方案期間與目前費率方案期間的主要差異: 加上現有訂閱者專區

  2. 套用費率方案的方式如下:
    • 在「費率方案名稱」欄位中輸入方案的名稱。名稱不需要 原始費率方案的名稱
    • 設定房價方案的費用 (選用)。
    • 根據所選費率方案類型設定費率方案詳細資料:
    • 指定未來方案生效的日期 (請參閱「發布房價方案」)。 和結束日期 (如果不想顯示結束日期,也可以選取 [無結束日期] 日後費率方案的結束日期)。如果為目前方案設定結束日期 則未來方案的生效日期必須晚於目前方案的結束日期 計畫。
  3. 在「現有訂閱者」部分中,選取下列其中一個選項:
    • 在新生效日期重新開始完整合約期間。日後的費率方案 生效日期未來費率方案的續約期限與 目前的費率方案。
    • 從新週期開始,扣除舊合約的花費時間,也就是生效日期。 未來的房價方案會在生效日期生效。使用目前指標的時間 從未來費率方案的續約期開始扣除房價方案。也就是說 開發人員使用現行方案 3 個月,續約期減少 3 個月 每月。
  4. 在 [生效日期] 欄位中,輸入開始日期晚於結束日期的開始日期 現有的費率方案。

使用 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