すべてのプロダクト
Search

このプロダクト

    Cloud Firewall:DescribeInternetTimeTop

    ドキュメントセンター

    Cloud Firewall:DescribeInternetTimeTop

    最終更新日:Jun 10, 2026

    本オペレーションは、時系列の Top-N インターネットトラフィックをクエリします。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    yundun-cloudfirewall:DescribeInternetTimeTop

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    SourceIp

    string

    任意

    ソース IP アドレス。

    60.179.179.XXX
    Lang

    string

    任意

    レスポンスの言語。

    列挙値:

    • en :

      英語

    • zh :

      中国語

    zh
    Lang

    string

    任意

    The language of the response.

    列挙値:

    • en :

      English

    • zh :

      Chinese

    zh
    Direction

    string

    必須

    トラフィックの方向。

    列挙値:

    • in :

      インバウンド

    • out :

      アウトバウンド

    out
    SourceCode

    string

    必須

    トレースソースの識別子。

    yundun
    Sort

    string

    任意

    結果のソートに使用するメトリック。

    列挙値:

    • out_pps :

      out_pps

    • in_bps :

      in_bps

    • out_bps :

      out_bps

    • in_pps :

      in_pps

    in_bps
    TrafficTime

    string

    任意

    クエリするトラフィックのタイムスタンプ。秒単位の UNIX タイムスタンプとして指定します。

    1745222880
    Limit

    string

    任意

    返すエントリの最大数。値の範囲は 1～50 です。デフォルト値： 50。

    5
    SrcIP

    string

    任意

    The source IP address.

    8.153.18.XX
    NatIP

    string

    任意

    NAT パブリック IP アドレス。省略した場合、すべてのアセットのトラフィックデータが返されます。

    47.97.66.XXX
    Order

    string

    任意

    ソート順。

    列挙値:

    • asc :

      昇順

    • desc :

      降順

    desc
    StartTime

    string

    任意

    クエリ時間範囲の開始時刻。秒単位の UNIX タイムスタンプとして指定します。

    1749434787
    EndTime

    string

    任意

    クエリ時間範囲の終了時刻。秒単位の UNIX タイムスタンプとして指定します。

    1733796528
    TrafficType

    string

    任意

    トラフィックタイプ。

    EIP_TRAFFIC
    IPType

    string

    任意

    IP アドレスのネットワークタイプ。

    列挙値:

    • Private :

      仮想プライベートクラウド

    • Public :

      パブリックネットワーク

    Public
    Interval

    integer

    任意

    時間間隔 (秒)。

    60

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    TrafficTime

    integer

    トラフィックデータのタイムスタンプ。単位：秒。

    1734399660
    RequestId

    string

    リクエスト ID。

    7F2D5C04-731F-50B0-ADE1-01637B3C****
    DataCount

    integer

    返されるエントリ数。

    19
    DataList

    array<object>

    データエントリのリスト。

    object

    データエントリ。

    ResourceInstanceName

    string

    資産の名前。

    test
    InBps

    integer

    インバウンド帯域幅。単位：ビット/秒。

    187
    ResourceInstanceId

    string

    資産インスタンスの ID。

    lb-bp14ue2rgktunncq****
    NewConn

    integer

    新規接続数。

    27
    RegionNo

    string

    リージョン ID。

    cn-shenzhen
    OutPps

    integer

    アウトバウンドのパケット転送レート。単位：秒間パケット数。

    2
    IP

    string

    パブリック IP アドレス。

    183.60.164.XXX
    OutBps

    integer

    アウトバウンド帯域幅。単位：ビット/秒。

    45
    PrivateIP

    string

    プライベート IP アドレス。

    10.21.186.XXX
    SessionCount

    integer

    セッション数。

    27
    ResourceType

    string

    パブリック IP アドレスのタイプ。

    列挙値:

    • EcsEIP :

      EcsEIP

    • EcsPublicIP :

      EcsPublicIP

    • NatPublicIP :

      NatPublicIP

    • NatEIP :

      NatEIP

    EcsPublicIP
    InPps

    integer

    インバウンドのパケット転送レート。単位：秒間パケット数。

    2
    TotalPps

    integer

    合計のパケット転送レート。単位：秒間パケット数。

    88
    TotalBps

    integer

    合計帯域幅。単位：ビット/秒。

    232
    VpcId

    string

    Virtual Private Cloud (VPC) インスタンスの ID。

    vpc-wz9o0uzfjuj81fx7m****
    NatGatewayId

    string

    NAT ゲートウェイの ID。

    ngw-wz98eedr5l5hkb8****e7
    NatGatewayName

    string

    NAT ゲートウェイ名。

    ngw-test
    NatIP

    string

    NAT ゲートウェイのパブリック IP アドレス。

    47.97.66.XXX

    例

    成功レスポンス

    JSONJSON

    {
  "TrafficTime": 1734399660,
  "RequestId": "7F2D5C04-731F-50B0-ADE1-01637B3C****",
  "DataCount": 19,
  "DataList": [
    {
      "ResourceInstanceName": "test",
      "InBps": 187,
      "ResourceInstanceId": "lb-bp14ue2rgktunncq****",
      "NewConn": 27,
      "RegionNo": "cn-shenzhen",
      "OutPps": 2,
      "IP": "183.60.164.XXX",
      "OutBps": 45,
      "PrivateIP": "10.21.186.XXX",
      "SessionCount": 27,
      "ResourceType": "EcsPublicIP",
      "InPps": 2,
      "TotalPps": 88,
      "TotalBps": 232,
      "VpcId": "vpc-wz9o0uzfjuj81fx7m****",
      "NatGatewayId": "ngw-wz98eedr5l5hkb8****e7",
      "NatGatewayName": "ngw-test",
      "NatIP": "47.97.66.XXX"
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ErrorSourceCodeError The source code is invalid.
    400 ErrorDirectionError The direction is invalid.
    400 ErrorTimeError The time is invalid.
    400 ErrorIpFormat The IP address is invalid.
    400 ErrorParameters A parameter error occurred.
    400 ErrorDBSelectError A database select error occurred.
    400 ErrorTrafficType The traffic type is invalid.
    400 ErrorSortError The sort is invalid.
    400 ErrorLimitFailed The limit is invalid.
    400 ErrorOrderFailed The order is invalid.
    400 ErrorMarshalJSON internal error.

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

    変更履歴

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