すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Service Mesh:CreateIstioGatewayRoutes

    ドキュメントセンター

    Alibaba Cloud Service Mesh:CreateIstioGatewayRoutes

    最終更新日:Nov 24, 2025

    ASM ゲートウェイのルートを作成します。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    servicemesh:CreateIstioGatewayRoutes

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ServiceMeshId

    string

    必須

    ASM インスタンスの ID。

    c08ba3fd1e6484b0f8cc1ad8fe10d****
    IstioGatewayName

    string

    任意

    ASM ゲートウェイの名前。

    ingressgateway
    GatewayRoute

    object

    任意

    ゲートウェイルートに関する情報。

    RouteName

    string

    任意

    ルートの名前。

    reviews-v2-routes
    RouteType

    string

    任意

    ルートタイプ。有効な値: HTTP、TLS、および TCP。

    HTTP
    MatchRequest

    object

    任意

    ルート照合ルール。

    URI

    object

    任意

    URI 照合ルール。

    MatchingMode

    string

    任意

    ルート規則の照合モード。有効な値:

    • exact: 完全一致。

    • prefix: プレフィックス一致。

    • regex: 正規表現一致。

    prefix
    MatchingContent

    string

    任意

    照合するコンテンツ。

    /ratings/v2/
    Headers

    array<object>

    任意

    照合するリクエストヘッダーのリスト。

    object

    任意

    照合するリクエストヘッダー。

    Name

    string

    任意

    照合するヘッダーのキー。

    x-request-id
    MatchingMode

    string

    任意

    ヘッダー値の照合モード。有効な値:

    • exact: 完全一致。

    • prefix: プレフィックス一致。

    • regex: 正規表現一致。

    exact
    MatchingContent

    string

    任意

    ヘッダー内で照合するコンテンツ。

    v1
    TLSMatchAttributes

    array<object>

    任意

    TLS 接続照合属性のリスト。

    object

    任意

    TLS 接続照合属性。

    TLSPort

    integer

    任意

    TLS ポート。

    443
    SNIHosts

    array

    任意

    SNI 値のリスト。

    string

    任意

    SNI 値ではワイルドカードプレフィックスを使用できます。たとえば、*.com は foo.example.com と example.com に一致します。

    説明

    SNI 値は、対応する仮想サービスのホストのサブセットである必要があります。

    *.com
    Ports

    array

    任意

    レイヤー 4 宛先ポートのリスト。

    integer

    任意

    アドレス指定されるホスト上のポート。

    443
    RouteDestinations

    array<object>

    任意

    レイヤー 4 ルーティングルールの重み付けされた宛先のリスト。

    array<object>

    任意

    レイヤー 4 ルーティングルールの重み付けされた宛先。

    Destination

    object

    任意

    リクエストまたは接続が転送されるサービスインスタンスを一意に識別する宛先。

    Host

    string

    任意

    サービスレジストリ内のサービスの名前。

    reviews
    Subset

    string

    任意

    サービス内のサブセットの名前。

    v1
    Port

    object

    任意

    ポート。

    Number

    integer

    任意

    ポート番号。

    80
    Weight

    integer

    任意

    サービスサブセットの重み。

    80
    HTTPAdvancedOptions

    object

    任意

    HTTP ルーティングの詳細オプション。

    HTTPRedirect

    object

    任意

    HTTP リダイレクト。

    Uri

    string

    任意

    リダイレクト中に URL のパスを上書きするために使用される値。

    /v1/getProductRatings
    Authority

    string

    任意

    リダイレクト中に URL の Authority/Host 部分を上書きするために使用される値。

    newratings.default.svc.cluster.local
    RedirectCode

    integer

    任意

    リダイレクト応答で使用する HTTP ステータスコード。デフォルトの応答コードは 301 です。

    301
    Delegate

    object

    任意

    トラフィックがデリゲートされる仮想サービス。

    Name

    string

    任意

    名前。

    reviews
    Namespace

    string

    任意

    名前空間。

    default
    Rewrite

    object

    任意

    リクエストの再書き込みルール。

    Uri

    string

    任意

    URI のパスまたはプレフィックスを書き換えるために使用される値。

    /v1/getProductRatings
    Authority

    string

    任意

    Authority または Host ヘッダーを書き換えるために使用される値。

    newratings.default.svc.cluster.local
    Timeout

    string

    任意

    タイムアウト期間。

    5s
    Retries

    object

    任意

    リクエストのリトライ設定。

    Attempts

    integer

    任意

    特定のリクエストで許可されるリトライ回数。

    3
    PerTryTimeout

    string

    任意

    特定のリクエストの各リトライのタイムアウト期間。例: 5s。

    5s
    RetryOn

    string

    任意

    リトライをトリガーする条件。例: connect-failure,refused-stream,503。

    connect-failure,refused-stream,503
    RetryRemoteLocalities

    object

    任意

    他の地域へのリクエストをリトライするかどうかを指定するフラグ。

    Value

    boolean

    任意

    他の地域へのリクエストをリトライするかどうかを指定するフラグ。有効な値:

    • true: 他の地域へのリクエストをリトライします。

    • false: 他の地域へのリクエストをリトライしません。

    デフォルト値: false。

    false
    Fault

    object

    任意

    フォールトインジェクション設定。

    Delay

    object

    任意

    遅延設定。

    FixedDelay

    string

    任意

    固定遅延時間。

    5s
    Percentage

    object

    任意

    遅延が注入されるリクエストの割合。

    Value

    number

    任意

    遅延が注入されるリクエストの割合 (10 進数)。

    0.1
    Abort

    object

    任意

    指定されたエラーコードでリクエストを事前に中止します。

    HttpStatus

    integer

    任意

    HTTP ステータスコード。

    400
    Percentage

    object

    任意

    指定されたエラーコードで中止するリクエストの割合。

    Value

    number

    任意

    指定されたエラーコードで中止するリクエストの割合 (10 進数)。

    0.1
    Mirror

    object

    任意

    リクエストを目的の宛先に転送することに加えて、HTTP トラフィックを別の宛先にミラーリングします。

    Host

    string

    任意

    サービスレジストリ内のサービスの名前。

    reviews.default.svc.cluster.local
    Subset

    string

    任意

    サービス内のサブセットの名前。

    v1
    MirrorPercentage

    object

    任意

    ミラーリングするトラフィックの割合。

    Value

    number

    任意

    ミラーリングするトラフィックの割合 (10 進数)。

    0.2
    Namespace

    string

    任意

    名前空間。

    default
    Domains

    array

    任意

    リクエストされたドメイン名のリスト。

    string

    任意

    ドメイン名。

    test.asm.aliyun.com
    RawVSRoute

    any

    任意

    仮想サービス内の 3 つのルートタイプに対応する JSON 文字列。詳細設定のエントリポイントを提供します。これらの設定は、RouteName、RouteType、MatchRequest、および HTTPAdvancedOptions の設定を上書きします。

    { "http": { "route": [ { "destination": { "host": "httpbin" } } ], "name": "httpbin", "match": [ { "uri": { "prefix": "/" } } ], "fault": { "delay": { "fixedDelay": "2s", "percentage": { "value": 70 } } } } }
    Priority

    integer

    任意

    ルートの優先度。整数が小さいほど、優先度が高くなります。

    1
    Status

    integer

    任意

    ゲートウェイルートのステータス。有効な値:

    • 0: オンライン。

    • 1: オフライン。

    • 2: 作成または更新エラー。

    1
    Description

    string

    任意

    ルートの説明。

    demo route

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    31d3a0f0-07ed-4f6e-9004-1804498c****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "31d3a0f0-07ed-4f6e-9004-1804498c****"
}

    エラーコード

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

    変更履歴

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