すべてのプロダクト
Search

このプロダクト

    :DescribeCdnUserBillPrediction

    ドキュメントセンター

    :DescribeCdnUserBillPrediction

    最終更新日:Mar 17, 2026

    当月のリソース使用量を推定します。

    操作説明

    この操作を呼び出すことで、当月の初日に指定された課金方法に基づいて、当月のリソース使用量を推定できます。 この操作は、ご利用の Alibaba Cloud アカウント内の当月のリソース使用量のみを推定するために呼び出すことができます。 推定に使用される時間範囲は、当月の初日の 00:00 に開始し、現在時刻の 2 時間前に終了します。

    • 月次 95 パーセンタイルによる支払い：開始時刻と終了時刻の間の上位 5% の値は除外されます。 推定値は、残りの値の中の最大値です。

    • 月次日次ピーク帯域幅の平均による支払い：推定値 = 日次ピーク帯域幅の合計値 / 日数。 当日は除外されます。

    • 月次 4 番目のピーク帯域幅による支払い：推定値は、開始時刻と終了時刻の間の 4 番目のピーク帯域幅の値です。 時間範囲が 4 日未満の場合、推定値は 0 になります。

    • 月次日次 95 パーセンタイル帯域幅の平均による支払い：推定値 = 日次 95 パーセンタイル帯域幅の合計値 / 日数。 当日は除外されます。

    • 00:00 から 08:00 まで 50% オフの 95 パーセンタイル帯域幅による支払い：開始時刻と終了時刻の間の上位 5% の値は除外されます。 推定値は、残りの値の中の最大値です。

    説明

    この操作は、アカウントごとに 1 秒に 1 回しか呼び出すことができません。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    cdn:DescribeCdnUserBillPrediction

    none

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    StartTime

    string

    任意

    推定の開始時刻。 デフォルト値は、当月の初日の 00:00 です。 時刻は、yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 標準で指定する必要があります。 時刻は協定世界時 (UTC) である必要があります。

    2018-09-30T16:00:00Z
    EndTime

    string

    任意

    推定の終了時刻。 デフォルト値は現在時刻です。 時刻は、yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 標準で指定する必要があります。 時刻は協定世界時 (UTC) である必要があります。

    説明

    終了時刻は開始時刻より後である必要があります。

    2018-10-25T10:00:00Z
    Dimension

    string

    任意

    課金項目。 値 `flow` は帯域幅を指定します。

    flow
    Area

    string

    任意

    課金リージョン。 有効な値：

    • CN：中国本土

    • OverSeas：中国本土以外

    • AP1：アジアパシフィック 1

    • AP2：アジアパシフィック 2

    • AP3：アジアパシフィック 3

    • NA：北米

    • SA：南米

    • EU：ヨーロッパ

    • MEAA：中東およびアフリカ

    デフォルトでは、このパラメーターの値は現在使用されている課金方法によって決まります。 中国本土内外のリージョンは、CN と OverSeas の課金リージョンに分類されます。 中国本土内の課金リージョンには CN が含まれます。 中国本土以外の課金リージョンには、AP1、AP2、AP3、NA、SA、EU、MEAA が含まれます。

    説明

    課金リージョンの詳細については、「課金リージョン」をご参照ください。

    CN,OverSeas

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    EndTime

    string

    推定の終了時刻。

    2018-10-25T10:00:00Z
    StartTime

    string

    推定の開始時刻。

    2018-09-30T16:00:00Z
    RequestId

    string

    リクエスト ID。

    C370DAF1-C838-4288-A1A0-9A87633D248E
    BillType

    string

    課金方法。

    説明

    課金方法が _overseas で終わる場合、課金リージョンは中国本土以外です。 たとえば、`BillType": "month_avg_day_bandwidth_overseas"` は、課金リージョンが中国本土以外であり、課金方法が月次日次ピーク帯域幅による支払いであることを指定します。

    有効な値：

    • hour_flow：時間単位のデータ転送量による支払い

    • day_bandwidth：日次帯域幅による支払い

    • month_95：月次 95 パーセンタイル帯域幅による支払い

    • month_avg_day_bandwidth：月次日次ピーク帯域幅の平均による支払い

    • month_4th_day_bandwidth：月次 4 番目のピーク帯域幅による支払い

    • month_avg_day_95：月次日次 95 パーセンタイル帯域幅の平均による支払い

    • month_95_night_half：00:00 から 08:00 まで 50% オフの 95 パーセンタイル帯域幅による支払い

    • hour_vas：時間単位の付加価値サービスによる支払い

    • day_count：日次リクエスト数による支払い

    month_95_overseas
    BillPredictionData

    object

    BillPredictionDataItem

    array<object>

    推定請求データ。

    object

    Value

    number

    推定値。

    10000
    TimeStp

    string

    推定値として使用される値が生成された時刻。 このパラメーターは、課金方法が月次 95 パーセンタイルによる支払い、00:00 から 08:00 まで 50% オフの 95 パーセンタイル帯域幅による支払い、または月次 4 番目のピーク帯域幅による支払いの場合にのみ返されます。

    2018-10-15T16:00:00Z
    Area

    string

    課金リージョン。

    CN

    例

    成功レスポンス

    JSONJSON

    {
  "EndTime": "2018-10-25T10:00:00Z",
  "StartTime": "2018-09-30T16:00:00Z",
  "RequestId": "C370DAF1-C838-4288-A1A0-9A87633D248E",
  "BillType": "month_95_overseas",
  "BillPredictionData": {
    "BillPredictionDataItem": [
      {
        "Value": 10000,
        "TimeStp": "2018-10-15T16:00:00Z",
        "Area": "CN"
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter The specified parameter is invalid.
    400 BillTypeNotFound The user billing type is not found or the billing type of this user is not the monthly billing type.
    400 InvalidStartTime.Malformed The specified value of parameter StartTime is malformed.
    400 InvalidEndTime.Malformed The specified value of parameter EndTime is malformed.
    400 InvalidStartTime.ValueNotSupported The specified value of parameter StartTime is not supported.
    400 InvalidTime.Malformed Specified Time is malformed.
    400 InvalidEndTime.Mismatch Specified EndTime does not match the specified StartTime.
    400 InvalidTimeSpan The time span exceeds the limit.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。