すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Live:DescribeLiveUserBillPrediction

    ドキュメントセンター

    ApsaraVideo Live:DescribeLiveUserBillPrediction

    最終更新日:Dec 16, 2025

    ライブストリーミングユーザーの請求予測を取得します。

    操作説明

    この操作では、当月の使用量データを予測します。予測は、月の初日に有効な課金方法に基づいています。この操作は、月次課金方法の予測のみをサポートし、ユーザーレベルでデータを提供します。クエリ時間範囲は、月の初日の 00:00 から始まり、現在の時刻の 2 時間前に終了します。

    • 月次 95 パーセンタイル：指定された時間範囲から上位 5% のデータポイントを削除した後の最も高いデータポイント。

    • 日次ピーク帯域幅の月間平均：日次ピーク帯域幅の値の合計を、時間範囲内の日数で割った値。当日のデータは含まれません。

    • 月次 4 番目ピーク：指定された時間範囲内で 4 番目に高いピーク帯域幅。時間範囲が 4 日未満の場合、予測値は 0 になります。

    • 日次 95 パーセンタイルピークの月間平均：日次 95 パーセンタイルピーク値の合計を、時間範囲内の日数で割った値。当日のデータは含まれません。

    • 夜間 95 パーセンタイル：指定された時間範囲から上位 5% のデータポイントを削除した後の最も高いデータポイント。

    QPS 制限

    1 ユーザーあたりのクエリ/秒 (QPS) 制限は 1 です。この制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響が及ぶ可能性があります。API 呼び出しは、適切なレートで行うようにしてください。詳細については、「QPS 制限」をご参照ください。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    live:DescribeLiveUserBillPrediction

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    任意

    リージョン ID。

    cn-shanghai
    StartTime

    string

    任意

    開始時刻。時刻は UTC で、yyyy-mm-ddThh:mm:ssZ 形式に従う必要があります。

    2015-12-01T05:40:00Z
    EndTime

    string

    任意

    終了時刻。時刻は UTC で、yyyy-MM-ddTHH:mm:ssZ 形式に従う必要があります。

    2015-12-01T05:45:00Z

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    EndTime

    string

    クエリの終了時刻。時刻は UTC で、ISO 8601 規格に準拠しています。 形式：YYYY-MM-DDThh:mm:ssZ。デフォルト値は現在の時刻です。

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

    string

    クエリの開始時刻。時刻は UTC で、ISO 8601 規格に準拠しています。 形式：YYYY-MM-DDThh:mm:ssZ。デフォルト値は、当月の初日の 00:00 です。

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

    string

    リクエスト ID。

    B95BE680-5A6A-1CAD-8AB1-09DFF5D6****
    BillType

    string

    課金方法。次の課金方法がサポートされています：

    • 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：夜間 95 パーセンタイルピーク帯域幅課金 (50% 割引)。

    • hour_vas：時間単位の付加価値サービス課金。

    • day_count：日単位のリクエスト数課金。

    day_bandwidth
    BillPredictionData

    object

    BillPredictionDataItem

    array<object>

    請求予測データ。

    object

    請求予測データ。

    Value

    number

    予測値。

    10000
    TimeStp

    string

    予測値のタイムスタンプ。このパラメーターは、課金方法が month_95、month_95_night_half、month_4th_day_bandwidth の場合にのみ返されます。

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

    string

    リージョンコード。有効な値：

    • CN：中国本土。

    • OverSeas：中国以外のリージョン。

    • AP1：アジア太平洋 1。このリージョンには、中国 (香港)、中国 (マカオ)、中国 (台湾)、日本、およびベトナムとインドネシアを除く東南アジア諸国が含まれます。

    • AP2：アジア太平洋 2。このリージョンには、インドネシア、韓国、ベトナムが含まれます。

    • AP3：アジア太平洋 3。このリージョンには、オーストラリアとニュージーランドが含まれます。

    • NA：北米。このリージョンには、米国とカナダが含まれます。

    • SA：南米。このリージョンには、ブラジルが含まれます。

    • EU：ヨーロッパ。このリージョンには、ウクライナ、イギリス、フランス、オランダ、スペイン、イタリア、スウェーデン、ドイツが含まれます。

    • MEAA：中東およびアフリカ。このリージョンには、南アフリカ、オマーン、アラブ首長国連邦、クウェートが含まれます。

    このパラメーターを指定しない場合、すべてのリージョンのデータが集計されて返されます。

    CN

    例

    成功レスポンス

    JSONJSON

    {
  "EndTime": "2018-10-25T10:00:00Z",
  "StartTime": "2018-09-30T16:00:00Z",
  "RequestId": "B95BE680-5A6A-1CAD-8AB1-09DFF5D6****",
  "BillType": "day_bandwidth",
  "BillPredictionData": {
    "BillPredictionDataItem": [
      {
        "Value": 10000,
        "TimeStp": "2018-10-15T16:00:00Z",
        "Area": "CN"
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter InvalidParameter.
    400 InvalidStartTime.Malformed The specified StartTime parameter is invalid.
    400 InvalidEndTime.Malformed The specified EndTime is invalid.
    400 InvalidStartTime.ValueNotSupported The StartTime cannot exceed 31 days before the current time.
    400 InvalidTime.Malformed Specified Time is malformed.
    400 InvalidEndTime.Mismatch Specified end time does not math the specified start time.
    400 InvalidTimeSpan The time span exceeds the limit.
    400 BillTypeNotFound User bill type not found or is not monthly bill type.

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

    変更履歴

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