すべてのプロダクト
Search

このプロダクト

    Edge Security Acceleration:GetTransportLayerApplication

    ドキュメントセンター

    Edge Security Acceleration:GetTransportLayerApplication

    最終更新日:Jun 25, 2026

    レイヤー4アプリケーションの詳細を照会します。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    esa:GetTransportLayerApplication

    get

    *Site

    acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    SiteId

    integer

    必須

    サイトID。 ListSites オペレーションを呼び出して取得できます。

    123456****
    ApplicationId

    integer

    必須

    アプリケーションID。 ListTransportLayerApplications オペレーションを呼び出して取得できます。

    170997271816****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンス。

    RequestId

    string

    リクエストID。

    EB635996-1FD6-5DFD-BA57-27A849599940
    SiteId

    integer

    サイトID。

    123456****
    ApplicationId

    integer

    レイヤー4アプリケーションID。

    17099311410****
    RulesCount

    integer

    レイヤー4アクセラレーションアプリケーションにおける転送ルールの数。

    1
    Rules

    array<object>

    転送ルールのリスト。

    object

    転送ルールの詳細。

    Source

    string

    オリジンサーバーの具体的な値。オリジンサーバータイプと一致する必要があります。

    1.1.1.1
    Protocol

    string

    転送ルールのプロトコル。有効な値：

    • TCP：TCPプロトコル。

    • UDP：UDPプロトコル。

    TCP
    EdgePort

    string

    エッジポート。以下の形式がサポートされています：

    • 単一ポート（例：80）。

    • ポート範囲（例：81-85）。ポート81、82、83、84、85を表します。

    • ポートとポート範囲の組み合わせ（カンマ区切り）。例：80,81-85,90はポート80、81、82、83、84、85、90を表します。

    80
    SourceType

    string

    オリジンサーバータイプ。有効な値：

    • ip：IPアドレス。

    • domain：ドメイン名。

    • OP：IPAMプール。

    • LB：ロードバランシング。

    domain
    SourcePort

    string

    オリジンサーバーポート。以下の形式がサポートされています：

    • 単一ポート。オリジンサーバーポートが単一ポートの場合、任意の有効なエッジポートの組み合わせがサポートされます。

    • ポート範囲。オリジンサーバーポートは、エッジポートがポート範囲の場合にのみポート範囲に設定できます。また、範囲のサイズはエッジポート範囲と同じである必要があります。例えば、エッジポートが90-93の場合、オリジンサーバーポートを81-85に設定することはできません。オリジンサーバーポート範囲が5でエッジポート範囲が4であり、一致しないためです。

    80
    ClientIPPassThroughMode

    string

    クライアントIPパススループロトコル。有効な値：

    • off：無効。

    • PPv1：PROXY Protocol v1。TCPのクライアントIPパススルーをサポートします。

    • PPv2：PROXY Protocol v2。TCPおよびUDPのクライアントIPパススルーをサポートします。

    • SPP：Simple Proxy Protocol。UDPのクライアントIPパススルーをサポートします。

    off
    Comment

    string

    ルールのコメント。

    Test
    RuleId

    integer

    ルールID。

    1234323***
    Cname

    string

    レイヤー4アクセラレーションアプリケーションのCNAMEドメイン名。このフィールドは、サイトがCNAME 方式で接続されている場合にのみ空ではありません。

    example.com.ialicdn.com
    RecordName

    string

    レイヤー4アプリケーションのドメイン名。

    test.example.com
    IpAccessRule

    string

    IPアクセスルールスイッチ。有効にすると、WAFのIPアクセスルールがレイヤー4アプリケーションに対して有効になります。有効な値：

    • on：有効。

    • off：無効。

    列挙値:

    • off :

      無効。

    • on :

      有効。

    on
    Ipv6

    string

    IPv6スイッチ。有効な値：

    • on：有効。

    • off：無効。

    列挙値:

    • off :

      無効。

    • on :

      有効。

    on
    Status

    string

    レイヤー4アプリケーションのステータス。有効な値：

    • deploying：デプロイ中。この状態では変更および削除はできません。

    • active：アクティブ。

    列挙値:

    • deploying :

      デプロイ中。

    • active :

      アクティブ。

    active
    CrossBorderOptimization

    string

    中国本土のネットワークアクセス最適化を有効にするかどうかを指定します。この機能はデフォルトで無効です。有効な値：

    • on：有効。

    • off：無効。

    列挙値:

    • off :

      無効。

    • on :

      有効。

    on
    StaticIp

    string

    静的 IPを有効にするかどうかを指定します。この機能はデフォルトで無効です。有効な値：

    • on：有効。

    • off：無効。

    off
    StaticIpV4List

    array<object>

    静的 IP 機能が有効になった後、このレイヤー4アプリケーションに割り当てられた静的 IPv4アドレスのリスト。

    object

    IPアドレスとそのステータスを含む単一の静的 IPv4エントリ。

    Address

    string

    IPアドレス。

    1.1.1.2
    Status

    string

    IPアドレスのステータス。有効な値：

    • healthy：正常。

    • unhealthy：異常。

    • unknown：IPアドレスを準備中です。

    healthy
    KeepAliveProtection

    string

    キープアライブ保護を有効にするかどうかを指定します。この機能はデフォルトで無効です。有効な値：

    • on：有効。

    • off：無効。

    列挙値:

    • off :

      無効。

    • on :

      有効。

    off

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "EB635996-1FD6-5DFD-BA57-27A849599940",
  "SiteId": 0,
  "ApplicationId": 0,
  "RulesCount": 1,
  "Rules": [
    {
      "Source": "1.1.1.1",
      "Protocol": "TCP",
      "EdgePort": "80",
      "SourceType": "domain",
      "SourcePort": "80",
      "ClientIPPassThroughMode": "off",
      "Comment": "Test",
      "RuleId": 0
    }
  ],
  "Cname": "example.com.ialicdn.com",
  "RecordName": "test.example.com",
  "IpAccessRule": "on",
  "Ipv6": "on",
  "Status": "active",
  "CrossBorderOptimization": "on",
  "StaticIp": "off",
  "StaticIpV4List": [
    {
      "Address": "1.1.1.2",
      "Status": "healthy"
    }
  ],
  "KeepAliveProtection": "off"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InternalException Failed to call the service. Try again later or contact technical support.
    400 TransportLayerApplicationNotExist The layer -4 accelerated application of the current operation does not exist. Modify it and try again.

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

    変更履歴

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