将来の料金プランを作成する

現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。 情報

はじめに

既存の料金プランが公開された後、変更できるプロパティは終了日のみです。ただし、料金プランの料金の変更など、変更されたプロパティを含む新しいバージョンのプランを作成することはできます。将来の日付で有効になるようにリビジョンを設定できます。リビジョンが有効になると、元の料金プランは終了します。

たとえば、2019 年 12 月 31 日に期限が切れる標準料金プランを作成し、それを 2020 年 1 月 1 日から有効な別のプランに置き換えるとします。これを行うには、将来の料金プランを作成し、2020 年 1 月 1 日から有効になるように設定します。

デベロッパーには、変更された料金プランが通知されます。元の料金プランを受け入れるデベロッパーは、自動的にリビジョンに登録されます（リビジョンを拒否することもできます）。

以降のセクションで説明するように、管理 UI または Monetization API を使用して将来の料金プランを作成できます。

UI を使用して将来の料金プランを作成する

以下で説明するように、将来の料金プランを作成します。

API を使用して将来の料金プランを作成する

API を使用して将来の料金プランを作成するには、POST リクエストを /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision に発行します。

ここで

• {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