REST API: Rate Plans（料金プラン）

Rate Planは個々のSIMに関連づけられている機能および制限を表しています。

複数のSIMを同一のRate Planを使用するよう構成することができます。 これは、これらのSIMが同じ機能と制限を継承することを意味します。 しかし、各SIMの使用状況はRate Planに対して独立して計測され、Rate Planで指定された制限は個々のSIMのレベルで計測、適用されます。 たとえば、Rate Planに5MBの場合、このRateの適用された各SIMは5MBのデータ消費が許可されます。

現在、いったん作成されたRate Planの編集は制限されています。 有効化された後にSIMの機能を変更するには、別のRate Planに関連づけし直すことが必要です。

一般的なタスク

• Rate Planインスタンスを取得する
• Rate Planインスタンスを更新する
• Rate Planを削除する
• アカウントの全Rate Planを一覧する
• Rate Planを作成する

HTTPリソースとメソッド

Rate Planインスタンスリソース

リソースURL

https://wireless.twilio.com/v1/RatePlans/{RatePlanSid}
https://wireless.twilio.com/v1/RatePlans/{RatePlanUniqueName}

リソースのプロパティ

Rate Planインスタンスリソースは下記のプロパティーによって表現されます:

Explanation of PAYG vs Quota

For low usage devices, the "Pay as you go" (PAYG) Data Metering plan is provided. With PAYG data, you'll only pay for the data you consume, with no minimum data spend per SIM per month.

For higher usage devices, it is probably more cost effective to use a Quota-based Data Metering plan. With a Quota-based plan, you agree to a minimum data spend, or "Quota" level per SIM per month. In return, you will receive discount rates in every country, with more significant discounts for higher Quotas.

Even on a Quota plan, data is still priced per megabyte and metered at byte-level. But at the end of your SIM's billing month, you either pay for exactly what you consumed, or the Quota price, whichever is higher.

See Pricing for more information.

HTTP GET

SidまたはUniqueNameプロパティーで識別されるRate Planの表現を返します。

例

Sidを使用して、JSON形式で表されるRate Planインスタンスをリクエストします。

例

一意な名前を使用して、JSON形式で表されるRate Planインスタンスをリクエストします。

HTTP POST

POSTメソッドでRate Planインスタンスリソースの更新を行えます。

オプションパラメーター

下記パラメーターの一部、または全部が提供できます。 リクエストパラメーターがインスタンスリソースのプロパティーに対応する場合、そのプロパティーが与えられた値によって更新されます。

HTTP PUT

サポートされていません。

HTTP DELETE

DELETEメソッドを使用すると、Rate Planインスタンスリソースを削除できます。

Rate Planは、それに関連づけられたアクティブなSIMがない場合においてのみ削除できる点にご注意ください。

Rate Planの削除に成功すると、APIはHTTP 204 NO CONTENTレスポンスを返します。

Rate Plansリストリソース

リソース URL

https://wireless.twilio.com/v1/RatePlans

HTTP GET

アカウント内のRate Planの一覧を返します。 一覧にはページング情報が含まれます。

例 1

アカウント内の全Rate Planを一覧します。

HTTP POST

Rate PlanリストリソースにPOSTすることで、Rate Planを新規作成できます。

必須パラメーター

必須パラメーターはありません。

オプションパラメーター

下記パラメーターの一部、または全部が指定できます。 インスタンスリソースのプロパティーに対応するリクエストパラメーターに関しては、プロパティーは指定された値に設定されます。 新規作成されたインスタンスリソースに対する既定値については、下記の表を参照してください。

例

「SmartMeterCA」というUniqueName、「California SmartMeter Plan」というフレンドリー名（分かりやすい名前）、月々5MBのデータ使用量制限、そしてCommandを使用してメッセージング機能がオンにされたRate Planを新規作成します。

HTTP PUT

サポートされていません。

HTTP DELETE

サポートされていません。

国内ローミング

National roaming grants a SIM the ability to roam onto other domestic carrier networks in certain low coverage situations. This will allow a SIM to roam onto regional US networks like GCI in Alaska.

National roaming pricing is different to standard data and Commands pricing. Before enabling national roaming on your Rate Plan, it is recommended to review the pricing.