すべてのプロダクト
Search

このプロダクト

    Cloud Firewall:DescribeOutgoingDestinationIP

    ドキュメントセンター

    Cloud Firewall:DescribeOutgoingDestinationIP

    最終更新日:Jun 09, 2026

    1 つのアクティブなアウトバウンド接続の宛先 IP を表示します。

    今すぐお試しください

    この 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:DescribeOutgoingDestinationIP

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Lang

    string

    任意

    応答メッセージの言語。有効な値は次のとおりです：

    • zh (デフォルト)： 中国語。

    • en： 英語。

    列挙値:

    • en :

      English

    • zh :

      Chinese

    zh
    StartTime

    string

    必須

    クエリ対象の時間範囲の開始時刻。値は秒単位のタイムスタンプです。

    1656837360
    EndTime

    string

    必須

    クエリ対象の時間範囲の終了時刻。値は秒単位のタイムスタンプです。

    1656923760
    PageSize

    string

    任意

    各ページに返すエントリ数。

    デフォルト値： 6、最大値： 10。

    10
    CurrentPage

    string

    任意

    返すページ番号。

    デフォルト値： 1。

    1
    CategoryId

    string

    任意

    サービスカテゴリの ID。有効な値は次のとおりです：

    • All： すべてのカテゴリ

    • RiskDomain： リスクドメイン

    • RiskIP： リスク IP

    • AliYun： Alibaba Cloud サービス

    • NotAliYun： Alibaba Cloud 以外のサービス

    All
    DstIP

    string

    任意

    アウトバウンド接続の宛先 IP アドレス。

    10.0.XX.XX
    PublicIP

    string

    任意

    アウトバウンド接続を開始する ECS インスタンスのパブリック IP アドレス。

    192.0.XX.XX
    PrivateIP

    string

    任意

    アウトバウンド接続を開始する ECS インスタンスのプライベート IP アドレス。

    192.168.XX.XX
    Port

    string

    任意

    ポート番号。

    80
    Sort

    string

    任意

    結果のソート基準となるフィールド。有効な値は次のとおりです：

    • SessionCount (デフォルト)： リクエスト数。

    • TotalBytes： 合計トラフィック。

    SessionCount
    Order

    string

    任意

    ソート順。有効な値は次のとおりです：

    • asc： 昇順。

    • desc (デフォルト)： 降順。

    desc
    TagIdNew

    string

    任意

    脅威インテリジェンスタグの ID。有効な値は次のとおりです：

    • AliYun： Alibaba Cloud サービス

    • RiskDomain： リスクドメイン

    • RiskIP： リスク IP

    • TrustedDomain： 信頼済みウェブサイト

    • AliPay： Alipay

    • DingDing： DingTalk

    • WeChat： WeChat

    • QQ： Tencent QQ

    • SecurityService： セキュリティサービス

    • Microsoft： Microsoft

    • Amazon： Amazon

    • Pan： クラウドドライブ

    • Map： マップ

    • Code： コードホスティング

    • SystemService： システムサービス

    • Taobao： Taobao

    • Google： Google

    • ThirdPartyService： サードパーティサービス

    • FirstFlow： 初回アクセス

    • Downloader： 悪意のあるダウンローダー

    • Alexa Top1M： 著名なウェブサイト

    • Miner： マイニングプール

    • Intelligence： 脅威インテリジェンス

    • DDoS： DDoS トロイの木馬

    • Ransomware： ランサムウェア

    • Spyware： スパイウェア

    • Rogue： 不正ソフトウェア

    • Botnet： ボットネット

    • Suspicious： 不審なウェブサイト

    • C&C： コマンド & コントロール (C&C)

    • Gang： 攻撃者グループ

    • CVE： CVE

    • Backdoor： バックドア

    • Phishing： フィッシングサイト

    • APT： APT 攻撃

    • Supply Chain Attack： サプライチェーン攻撃

    • Malicious software： マルウェア

    AliYun
    ApplicationName

    string

    任意

    アクセス制御ポリシーでサポートされているアプリケーションタイプ。

    • FTP

    • HTTP

    • HTTPS

    • Memcache

    • MongoDB

    • MQTT

    • MySQL

    • RDP

    • Redis

    • SMTP

    • SMTPS

    • SSH

    • SSL_No_Cert

    • SSL

    • VNC

    説明

    サポートされているアプリケーションタイプは、Proto パラメーターで指定されたプロトコルタイプによって異なります。Proto が TCP に設定されている場合、上記のすべてのアプリケーションタイプがサポートされます。ApplicationName と ApplicationNameList の両方が指定されている場合、ApplicationNameList の値が優先されます。

    FTP

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    TotalCount

    integer

    アウトバウンド IP の総数。

    50
    RequestId

    string

    リクエスト ID。

    F0F82705-CFC7-5F83-86C8-A063892F****
    DstIPList

    array<object>

    アウトバウンド接続の宛先 IP アドレスのリスト。

    array<object>

    AclCoverage

    string

    アクセス制御ポリシーが適用されているかどうかを示します。有効な値は次のとおりです：

    • Uncovered：ポリシーは適用されていません。

    • FullCoverage：ポリシーが適用されています。

    Uncovered
    DstIP

    string

    アウトバウンド接続の宛先 IP アドレス。

    10.0.XX.XX
    AclRecommendDetail

    string

    アクセス制御の推奨事項の詳細。

    建议放行
    HasAclRecommend

    boolean

    アクセス制御が推奨されるかどうかを示します。有効な値は次のとおりです：

    • true：アクセス制御が推奨されます。

    • false：アクセス制御は推奨されません。

    true
    InBytes

    integer

    合計インバウンドトラフィック量 (バイト)。

    472
    CategoryName

    string

    宛先 IP アドレスのサービスカテゴリ。有効な値は次のとおりです：

    • Alibaba Cloud product

    • non-Alibaba Cloud product

    阿里云产品
    RuleName

    string

    アクセス制御ルールの名前。

    默认规则
    RuleId

    string

    アクセス制御ルールの UUID。

    fadsfd-dfadf-df****
    SessionCount

    integer

    リクエスト数。

    4
    GroupName

    string

    ルールグループの名前。

    rules_test
    SecuritySuggest

    string

    アウトバウンド接続に推奨されるセキュリティアクション。有効な値は次のとおりです：

    • pass：接続を許可します。

    • alert：接続を拒否します。

    • drop：接続をドロップします。

    pass
    OutBytes

    integer

    合計アウトバウンドトラフィック量 (バイト)。

    965
    AclStatus

    string

    アクセス制御ポリシーのヘルスステータス。有効な値は次のとおりです：

    • Normal：正常。

    • Abnormal：異常。

    Normal
    IsMarkNormal

    boolean

    宛先 IP アドレスが許可リストに追加されているかどうかを示します。有効な値は次のとおりです：

    • true：宛先 IP アドレスは許可リストにあります。

    • false：宛先 IP アドレスは許可リストにありません。

    true
    CategoryId

    string

    サービスカテゴリの ID。有効な値は次のとおりです：

    • Aliyun：宛先は Alibaba Cloud product です。

    • NotAliyun：宛先は Alibaba Cloud 以外の製品です。

    Aliyun
    TagList

    array<object>

    宛先 IP アドレスに関連付けられたタグのリスト。

    object

    RiskLevel

    integer

    リスクレベル。有効な値は次のとおりです：

    • 1：低

    • 2：中

    • 3：高

    1
    TagName

    string

    脅威インテリジェンスタグの名前。

    ReleaseLabel
    TagId

    string

    脅威インテリジェンスタグの ID。

    ReleaseLabel
    TagDescribe

    string

    脅威インテリジェンスタグの説明。

    ReleaseLabel
    ClassId

    string

    脅威インテリジェンスタグのカテゴリ。有効な値は次のとおりです：

    • Suspicious

    • Malicious

    • Trusted

    Trusted
    ApplicationPortList

    array<object>

    アプリケーションポートのリスト。

    説明

    この応答では、最大で 99 個のアプリケーションポートが返されます。99 個を超えるポートが存在する場合、最初の 99 個のみが返されます。

    object

    アプリケーションポートの詳細。

    Port

    integer

    アプリケーションポート。

    80
    ApplicationName

    string

    接続で検出されたアプリケーションプロトコル。有効な値は次のとおりです：

    • FTP

    • HTTP

    • HTTPS

    • Memcache

    • MongoDB

    • MQTT

    • MySQL

    • RDP

    • Redis

    • SMTP

    • SMTPS

    • SSH

    • SSL_No_Cert

    • SSL

    • VNC

    説明

    HTTP
    UnknownReason

    array

    アプリケーションプロトコルが識別されなかった理由のリスト。

    string

    プロトコル分析が失敗した理由。

    tcp_not_establish
    CategoryClassId

    string

    宛先 IP アドレスの脅威インテリジェンスカテゴリ。有効な値は次のとおりです：

    • Suspicious

    • Malicious

    • Trusted

    Trusted
    SecurityReason

    string

    セキュリティ推奨の理由。

    智能策略：该目的域名所属组织为阿里云计算有限公司，主要业务为阿里云，未发现安全风险，可用于配置外联白名单。
    TotalBytes

    string

    合計トラフィック量 (バイト)。

    800
    HasAcl

    string

    アクセス制御ルールが存在するかどうかを示します。有効な値は次のとおりです：

    • true：アクセス制御ルールが存在します。

    • false：アクセス制御ルールは存在しません。

    true
    AddressGroupList

    array<object>

    この宛先 IP アドレスが含まれるアドレスグループのリスト。

    object

    AddressGroupUUID

    string

    アドレスグループの UUID。

    f04ac7ce-628b-4cb7-be61-310222b7****
    AddressGroupName

    string

    アドレスグループの名前。

    IP地址簿
    AssetCount

    integer

    この宛先 IP アドレスへのアウトバウンド接続を開始したアセットの総数。

    20
    PrivateAssetCount

    integer

    この宛先 IP アドレスへのアウトバウンド接続を開始したプライベートアセットの総数。

    20
    LocationName

    string

    宛先 IP アドレスの所在地。

    山东省青岛市

    例

    成功レスポンス

    JSONJSON

    {
  "TotalCount": 50,
  "RequestId": "F0F82705-CFC7-5F83-86C8-A063892F****",
  "DstIPList": [
    {
      "AclCoverage": "Uncovered",
      "DstIP": "10.0.XX.XX",
      "AclRecommendDetail": "建议放行",
      "HasAclRecommend": true,
      "InBytes": 472,
      "CategoryName": "阿里云产品",
      "RuleName": "默认规则",
      "RuleId": "fadsfd-dfadf-df****",
      "SessionCount": 4,
      "GroupName": "rules_test",
      "SecuritySuggest": "pass",
      "OutBytes": 965,
      "AclStatus": "Normal",
      "IsMarkNormal": true,
      "CategoryId": "Aliyun",
      "TagList": [
        {
          "RiskLevel": 1,
          "TagName": "ReleaseLabel",
          "TagId": "ReleaseLabel",
          "TagDescribe": "ReleaseLabel",
          "ClassId": "Trusted"
        }
      ],
      "ApplicationPortList": [
        {
          "Port": 80,
          "ApplicationName": "HTTP",
          "UnknownReason": [
            "tcp_not_establish"
          ]
        }
      ],
      "CategoryClassId": "Trusted",
      "SecurityReason": "智能策略：该目的域名所属组织为阿里云计算有限公司，主要业务为阿里云，未发现安全风险，可用于配置外联白名单。",
      "TotalBytes": "800",
      "HasAcl": "true",
      "AddressGroupList": [
        {
          "AddressGroupUUID": "f04ac7ce-628b-4cb7-be61-310222b7****",
          "AddressGroupName": "IP地址簿"
        }
      ],
      "AssetCount": 20,
      "PrivateAssetCount": 20,
      "LocationName": "山东省青岛市"
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ErrorAliUid Aliuid invalid.
    400 ErrorTimeError The time is invalid.
    400 ErrorIpFormat The IP address is invalid.
    400 ErrorDBSelectError A database select error occurred.
    400 ErrorPortError The port is invalid.
    400 ErrorSecuritySuggest The security suggest is invalid.
    400 ErrorSortError The sort is invalid.
    400 ErrorOrderFailed The order is invalid.
    400 ErrorPageNo Either page number or page size is invalid.
    400 ErrorIntervalError The interval is invalid.
    400 ErrorDataTypeError The data type is invalid.
    400 ErrorMarshalJSON internal error.

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

    変更履歴

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