すべてのプロダクト
Search

このプロダクト

    Edge Security Acceleration:UpdateTransportLayerApplication

    ドキュメントセンター

    Edge Security Acceleration:UpdateTransportLayerApplication

    最終更新日:Jun 24, 2026

    指定されたサイト配下のレイヤー 4 アプリケーションの転送ルール設定を変更します。

    操作説明

    ListTransportLayerApplications が空のレイヤー 4 アクセラレーションアプリケーション一覧を返した場合、CreateTransportLayerApplication を使用してレイヤー 4 アクセラレーションアプリケーションを作成し、その後この API を使用してレイヤー 4 アクセラレーションアプリケーションの設定を変更します。

    レイヤー 4 アクセラレーションアプリケーションを作成する際、選択するサイトはアクティブ化されたサイトである必要があります。サイトを作成した後、VerifySite API を呼び出して検証します。検証に合格したサイトは自動的にアクティブ化され、レスポンスパラメーター Passed=true で示されます。

    今すぐお試しください

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

    update

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    SiteId

    integer

    必須

    サイト ID。 ListSites 操作を呼び出してサイト ID を取得できます。

    123456****
    ApplicationId

    integer

    必須

    レイヤー 4 アプリケーション ID。 ListTransportLayerApplications 操作を呼び出してアプリケーション ID を取得できます。

    165503967****
    Rules

    array<object>

    任意

    転送ルールのリスト。各ルールについて、コメント以外のすべてのパラメーターは必須です。

    object

    任意

    ルールの詳細。各ルールについて、コメント以外のすべてのパラメーターは必須です。

    Protocol

    string

    任意

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

    • TCP: TCP プロトコル。

    • UDP: UDP プロトコル。

    列挙値:

    • 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: 負荷分散。

    列挙値:

    • OP :

      源地址池

    • LB :

      负载均衡器

    • ip :

      IP

    • domain :

      域名

    ip
    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 パススルーをサポートします。

    列挙値:

    • SPP :

      Simple Proxy Protocol 协议

    • PPv2 :

      PROXY Protocol v2 协议

    • off :

      不传递

    • PPv1 :

      PROXY Protocol v1 协议

    SPP
    Source

    string

    任意

    オリジンの具体的な値。

    1.1.1.1
    Comment

    string

    任意

    ルールのコメント。

    123
    IpAccessRule

    string

    任意

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

    • on: 有効。

    • off: 無効。

    列挙値:

    • off :

      無効。

    • on :

      有効。

    on
    Ipv6

    string

    任意

    IPv6 スイッチ。有効な値:

    • on: 有効。

    • off: 無効。

    列挙値:

    • off :

      無効。

    • on :

      有効。

    on
    CrossBorderOptimization

    string

    任意

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

    • on: 有効。

    • off: 無効。

    列挙値:

    • off :

      無効。

    • on :

      有効。

    on
    StaticIp

    string

    任意

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

    • on: 有効。

    • off: 無効。

    off
    KeepAliveProtection

    string

    任意

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

    • on: 有効。

    • off: 無効。

    列挙値:

    • off :

      無効。

    • on :

      有効。

    off

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    リクエスト成功時の応答。

    RequestId

    string

    リクエスト ID。

    9e5448c7-edaf-49aa-9887-0fcd0832306c

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "9e5448c7-edaf-49aa-9887-0fcd0832306c"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter The specified parameter is invalid.
    400 ApplyVipError Failed to apply for ip resources, please contact customer service.
    400 InternalException Failed to call the service. Try again later or contact technical support.
    400 InvalidParameter.RecordData Invalid record content. Adjust your configurations based on the API documentation.
    400 InvalidParameter.RecordType Invalid record type. Adjust your configurations based on the API documentation.
    400 Instance.NotOnline Your plan is unavailable due to an overdue payment. Complete the payment first.
    400 QuotaExceed.RecordCount The maximum number of records has been reached. Delete some and try again or upgrade your plan.
    400 Record.Conflict The specified record content conflicts with existing records. Adjust your configurations based on the related product documentation.
    400 Site.ServiceBusy This website is being configured. Try again later.
    400 TransportLayerApplicationNotExist The layer -4 accelerated application of the current operation does not exist. Modify it and try again.
    400 TransportLayerRulesExceedLimit The configured forwarding rules have exceeded the maximum limit. Delete useless forwarding rules and try again.
    400 SourceCircleExist The host record of the resource to be operated on is already the source station of another resource, or the source station of the current resource has been added as a host record. To avoid loopback, modify the host record or source station and retry.
    400 InvalidParameter.InvalidRecordName The record name you entered does not meet the specifications. Change the record name according to the product documentation.
    400 EdgePortsOverlap There is overlap between multiple edge ports, please check and try again after modification.
    400 InvalidParameter.ClientIpPassThroughMode Invalid client IP transfer protocol, please refer to the interface document and pass in valid parameters.
    400 InvalidParameter.RuleSource The origin of the forwarding rule does not exist or is invalid. Enter the correct origin and try again.
    400 InvalidParameter.Port Invalid edge port or origin port. Enter a valid port as required in the interface document.
    400 InvalidParameter.Protocol Invalid port protocol. Enter a valid port protocol as required by the interface documentation.
    400 InternalError An internal exception occurred, please try again later.
    400 IpaNotActive The ipa application is not active.
    400 Record.NoResource Failed to allocate resources for the record. Please submit a ticket for processing.
    400 InvalidParameter.PrivateIpAsSourceUnsupported The provided source is an invalid private IP address. Please verify and resubmit.
    400 InvalidParameter.SourceIpInBlacklist The provided source is an invalid private IP address. Please verify and resubmit.
    400 IPA.KeepAliveProtectionConflict KeepAliveProtection is conflicted with StaticIp and CrossBorderOptimization, can not open at same time.
    400 IPA.CanNotEnableKeepAliveProtection The site has one or more TCP/UDP proxied applications with keep-alive-protection enabled. Its acceleration region or plan can't be edited.

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

    変更履歴

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