您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info
簡介
現有費率方案發布後，你只能變更結束日期。 不過，您可以建立新版本的方案，其中包含變更的屬性，例如變更的費率方案費率。您可以設定修訂內容在日後生效。修訂生效後，原費率方案就會終止。
舉例來說，假設您建立的標準費率方案將於 2019 年 12 月 31 日到期，並想以 2020 年 1 月 1 日生效的另一個方案取代。為此，您建立未來的費率方案，並設定於 2020 年 1 月 1 日生效。
如果目前的費率方案未設定結束日期，您可以將現有費率方案替換為未來的費率方案，最早可從今天開始。如要這麼做，請按照「使已發布的費率方案失效」一文的說明，使目前的費率方案失效。
開發人員會收到費率方案修訂通知。接受原始費率方案的開發人員會自動註冊修訂版本 (但可選擇拒絕修訂版本)。
如以下章節所述，您可以使用管理使用者介面或營利 API 建立未來的費率方案。
使用使用者介面建立未來的費率方案
請按照下文說明建立未來的費率方案。
邊緣
如要使用 Edge UI 建立費率方案的未來版本，並在今天之後的某個時間開始生效，請按照下列步驟操作。
- 在「費率方案」頁面，將游標放在要建立未來費率方案的費率方案相關列中。
費率方案必須有結束日期。 - 按一下「+Future」。
- 在「未來費率方案」部分中，選取下列其中一個選項：
- 自新的生效日期重新開始完整合約期：未來的費率方案會在生效日期生效。未來費率方案的續訂期限與目前的費率方案相同。
- 在生效日當天，從新週期扣除先前合約的剩餘時間：未來的費率方案會在生效日當天生效。使用現行費率方案的時間會從未來費率方案的續約期扣除。也就是說，如果開發人員使用目前的方案 3 個月，續約期就會縮短 3 個月。
- 在頂端面板中設定下列欄位：
注意：其他欄位為唯讀。欄位 說明 預設 必要 房價方案名稱 房價方案名稱。
注意：名稱不必與原始費率方案名稱相符。
現有方案名稱 是 開始日期 費率方案生效日期。輸入開始日期，或使用日曆選取日期。 今天 否 結束日期 費率方案的結束日期。如要指定結束日期，請啟用「Has End Date」(有結束日期) 切換開關，然後輸入結束日期，或使用日曆選取日期。 注意：費率方案將在指定日期的當天結束前生效。舉例來說，如要讓費率方案在 2018 年 12 月 1 日到期，endDate 值應設為 2018-11-30。在此情況下，費率方案將於 2018 年 11 月 30 日當天結束，2018 年 12 月 1 日的所有要求都會遭到封鎖。
無 否 入口網站可見 設定房價方案為公開或不公開。請參閱「公開與不公開費率方案」。 已啟用 否 - 為費率方案設定費用。請參閱「設定費用」。
注意：不適用於可調整通知方案。 - 如果選取的產品組合包含多個 API 產品，請在「特定或一般費率方案」部分設定下列偏好設定：
注意：這個步驟不適用於可調整的通知方案。
欄位 說明 預設 個別設定每項產品 這個旗標會指定是否要為每個 API 產品設定個別費率方案。 已停用 個別設定每項產品的買一送一優惠 這個標記會指定是否要為每個 API 產品設定免費增值方案。 已停用 選取產品 如果啟用一或多個標記，請從下拉式選單中個別選取每個產品，並設定費率方案詳細資料。 注意：請務必設定產品組合中的所有產品。
N/A - 根據所選房價方案類型，設定房價方案詳細資料：
- 點選下列其中一個選項：
按鈕 說明 更新草稿 將費率方案儲存為草稿。 費率方案發布後，應用程式開發人員才會看到。您可以編輯費率方案草稿中的任何欄位。
發布草稿 發布計畫。 注意：發布費率方案後，如果尚未設定結束日期，您只能修改結束日期。費率方案發布後就無法刪除，但可以讓費率方案過期，並以未來的費率方案取代，詳情請參閱「讓已發布的費率方案過期」。
Classic Edge (Private Cloud)
如要使用 Classic Edge UI 建立費率方案的未來版本，並在今天之後的某個時間開始生效，請按照下列步驟操作。
- 在套裝組合目錄中，找出要更換的費率方案，然後點選「草稿/未來」欄中的「+未來」。
系統會開啟未來的費率方案視窗。
未來費率方案視窗與目前費率方案視窗的主要差異在於新增了「現有訂閱者」部分。
- 與任何費率方案相同：
- 在「現有訂閱者」部分中，選取下列任一選項：
- 自新的生效日期起重新計算完整合約期。未來的費率方案會在生效日當天生效。未來費率方案的續訂期限與目前的費率方案相同。
- 在生效日期當天，從新約期扣除先前合約的時數。未來的費率方案會在生效日當天生效。使用現行費率方案的時間會從未來費率方案的續約期扣除。也就是說，如果開發人員使用目前的方案 3 個月，續訂期就會縮短 3 個月。
- 在「生效日期」欄位中，輸入的開始日期必須晚於現有費率方案的結束日期。
使用 API 建立未來的費率方案
如要使用 API 建立未來的費率方案，請向 /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision 發出 POST 要求。
其中：
{org_id}是機構名稱。{package_id}是 API 套件的 ID。{plan_Id}是房價方案的 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