建立未來費率方案

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

簡介

現有的房價方案發布後,您只能變更其結束日期。不過,您可以建立新版方案,並在當中加入已變更屬性 (例如變更費率方案費率)。您可以設定日後要生效的修訂版本。原始費率方案會在修訂內容生效後終止。

舉例來說,假設您建立了將於 2019 年 12 月 31 日到期的標準費率方案,但想改用在 2020 年 1 月 1 日生效的其他方案。如要這麼做,請建立未來費率方案,並將其設為在 2020 年 1 月 1 日生效。

如果目前費率方案尚未設定結束日期,您可以將現有的費率方案替換成從今天開始的未來費率方案。您必須到期目前的費率方案,詳情如「過期的費率方案」一節所述。

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

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

透過使用者介面建立未來費率方案

建立未來費率方案,詳情請見下方說明。

Edge

如要透過 Edge UI 建立在今天過後一段時間的費率方案,請執行下列步驟。

  1. 費率方案頁面中,將遊標移到您要建立未來費率方案的費率方案相關資料列中。
    費率方案必須包含結束日期。
  2. 按一下「+ 未來」
  3. 在「未來費率方案」部分中,選取下列其中一個選項:
    • 在新的生效日期重新啟動完整合約期:未來費率方案將於生效日期生效。未來費率方案的續約期限與現行費率方案相同。
    • 從新的期間 (生效日期) 扣除先前合約花費的時間:未來費率方案自生效日期起生效。使用現行費率方案所花費的時間,將從未來費率方案的續約期中扣除。也就是說,如果開發人員使用現行方案達 3 個月,而續訂期限減少 3 個月,就代表這種情況。
  4. 在頂端面板中設定下列欄位:
    注意:其他欄位為唯讀欄位。
    欄位 說明 預設 必要
    房價方案名稱

    房價方案的名稱。

    注意:名稱不必與原始費率方案名稱相符。

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

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

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

    注意:請確認您已設定產品套裝組合中的所有產品。

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

    在你發布費率方案後,應用程式開發人員才能看到這項方案。您可以編輯費率方案草稿中的任何欄位。

    發布草稿 發布企劃書。

    注意:發布費率方案後,只能在尚未設定結束日期的情況下修改。費率方案一經發布即無法刪除,但您可以到期費率方案,並替換為未來的費率方案,詳情請參閱「取得已發布的費率方案」一文。

傳統邊緣 (Private Cloud)

如要透過傳統版 Edge UI 建立在今天過後一段時間的費率方案,請執行下列步驟。

  1. 在套件目錄中,找出要取代的費率方案,然後點選「草稿/未來」欄中的「+ 未來」

    系統隨即會開啟日後的費率方案視窗。

    未來費率方案期間與目前費率方案期間的主要差異,在於新增「現有訂閱者」區段。

  2. 任何費率方案的計費方式如下:
    • 在「費率方案名稱」欄位中輸入方案名稱。名稱不一定要與原始費率方案的名稱相符。
    • 設定費率方案的費用 (選用)。
    • 根據所選房價方案類型設定費率方案詳細資料:
    • 指定未來方案的生效日期 (請參閱「發布費率方案」),以及結束日期。如果不想讓日後的費率方案在特定日期結束,也可以選取「無結束日期」。如果為目前方案設定結束日期,未來方案的生效日期必須晚於目前方案的結束日期。
  3. 在「現有訂閱者」部分中,選取下列其中一個選項:
    • 以新的生效日期重新開始完整合約期。未來費率方案將於生效日期生效。未來費率方案的續約期限與現行費率方案相同。
    • 從新的週期開始計算,從新的週期開始計算,並用掉原先合約所花費的時間。未來費率方案將於生效日期生效。使用現行費率方案所花費的時間,將從未來費率方案的續約期中扣除。也就是說,如果開發人員使用現行方案達 3 個月,而續訂期限減少 3 個月,就代表這種情況。
  4. 在「生效日期」欄位中,輸入的開始日期晚於現有費率方案的結束日期。

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