すべてのプロダクト
Search

このプロダクト

    Serverless App Engine:CreateOrUpdateSwimmingLane

    ドキュメントセンター

    Serverless App Engine:CreateOrUpdateSwimmingLane

    最終更新日:Apr 22, 2026

    スイムレーンを作成または更新します。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    sae:CreateOrUpdateSwimmingLane

    create

    *All Resource

    *

    		 なし なし

    リクエスト構文

    POST /pop/v1/cas/gray/createOrUpdateSwimmingLane HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    LaneId

    integer

    任意

    スイムレーンの ID。

    13857
    LaneName

    string

    任意

    スイムレーンの名前。

    test
    LaneTag

    string

    任意

    スイムレーンのタグ。

    g1
    GroupId

    integer

    任意

    スイムレーングループの ID。

    b2a8a925-477a-eswa-b823-d5e22500****
    NamespaceId

    string

    任意

    名前空間の ID。

    cn-beijing:test
    CanaryModel

    integer

    任意

    エンドツーエンドカナリアリリースモード。

    • 0：コンテンツベースのルーティング

    • 1：パーセンテージベースのルーティング

    0
    Enable

    boolean

    任意

    スイムレーンのステータス。

    • true：有効

    • false：無効

    true
    AppEntryRule

    object

    任意

    ゲートウェイルートの構成。

    説明

    スイムレーングループのゲートウェイエントリアプリケーションが Java アプリケーションの場合、このパラメーターは必須です。

    Paths

    array

    任意

    一致させるリクエストパス。

    string

    任意

    リクエストパス。

    /A
    Percentage

    integer

    任意

    パーセンテージベースのルーティングのトラフィックの割合。有効な値：0～100。

    50
    ConditionJoiner

    string

    任意

    条件を結合するために使用される論理演算子。

    • AND：すべての条件を満たす必要があります。

    • OR：少なくとも 1 つの条件を満たす必要があります。

    AND
    Conditions

    array<object>

    任意

    一致条件。

    object

    任意

    一致条件。

    Type

    string

    任意

    一致させるリクエスト属性のタイプ。

    • header：リクエストヘッダー。

    • param：リクエストパラメーター。

    • cookie：リクエスト Cookie。

    Header
    Name

    string

    任意

    ヘッダー、パラメーター、または Cookie の名前。

    t
    Condition

    string

    任意

    一致ルール。

    • ==：完全に一致。属性の値は、指定された値と同一である必要があります。

    • !=：否定完全一致。属性の値は、指定された値と同一であってはなりません。

    • in：包含一致。属性の値は、指定されたカンマ区切りの値のリストに存在する必要があります。

    • percentage：パーセンテージベースの一致。式 hash(get(key)) % 100 < value が true である必要があります。

    • regex：正規表現一致。属性の値は、指定された正規表現と一致する必要があります。

    ==
    Value

    string

    任意

    リクエスト属性と照合する値。

    g1
    IndependentPercentageEnable

    boolean

    任意

    パーセンテージベースのルーティングを有効にするかどうかを指定します。

    • true：パーセンテージベースのルーティングを有効にします。PercentageByPath パラメーターも設定する必要があります。

    • false：パーセンテージベースのルーティングを無効にします。

    true
    PercentageByPath

    object

    任意

    リクエストパスをトラフィックの割合にマッピングするオブジェクト。

    integer

    任意

    設定されたパスのトラフィックの割合。有効な値：1～100。

    50
    MseGatewayEntryRule

    object

    任意

    MSE ゲートウェイルートの構成。

    説明

    EntryAppType パラメーターが apig または mse-gw に設定されている場合、このパラメーターは必須です。

    RouteIds

    array

    任意

    ルート ID。

    integer

    任意

    ゲートウェイルートの ID。ID を取得するには、ListGatewayRoute 操作を呼び出します。

    78830
    Percentage

    integer

    任意

    トラフィックミラーリングの割合。有効な値：0～100。

    100
    ConditionJoiner

    string

    任意

    条件を結合するために使用される論理演算子。

    • AND：すべての条件を満たす必要があります。

    • OR：少なくとも 1 つの条件を満たす必要があります。

    AND
    Conditions

    array<object>

    任意

    一致条件。

    object

    任意

    一致条件。

    Type

    string

    任意

    一致させるリクエスト属性のタイプ。

    • header：リクエストヘッダー。

    • param：リクエストパラメーター。

    • cookie：リクエスト Cookie。

    header

    Name

    string

    任意

    ヘッダー、パラメーター、または Cookie の名前。

    test
    Condition

    string

    任意

    一致ルール。

    • ==：完全に一致。属性の値は、指定された値と同一である必要があります。

    • !=：否定完全一致。属性の値は、指定された値と同一であってはなりません。

    • in：包含一致。属性の値は、指定されたカンマ区切りの値のリストに存在する必要があります。

    • percentage：パーセンテージベースの一致。式 hash(get(key)) % 100 < value が true である必要があります。

    • regex：正規表現一致。属性の値は、指定された正規表現と一致する必要があります。

    ==
    Value

    string

    任意

    リクエスト属性と照合する値。

    g1
    IndependentPercentageEnable

    boolean

    任意

    パーセンテージベースのルーティングを有効にするかどうかを指定します。

    • true：パーセンテージベースのルーティングを有効にします。PercentageByRoute パラメーターも設定する必要があります。

    • false：パーセンテージベースのルーティングを無効にします。

    true
    PercentageByRoute

    object

    任意

    ルート ID をトラフィックの割合にマッピングするオブジェクト。

    integer

    任意

    設定されたルートのトラフィックの割合。有効な値：1～100。

    100

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    スイムレーンを作成または更新した結果。

    RequestId

    string

    リクエスト ID。

    91F93257-7A4A-4BD3-9A7E-2F6EAE6D****
    Message

    string

    応答メッセージ。有効な値：

    • リクエストが成功した場合、success が返されます。

    • リクエストが失敗した場合、エラーメッセージが返されます。

    success
    TraceId

    string

    リクエストのトレース ID。この ID を使用して、リクエストの詳細をクエリできます。

    0a98a02315955564772843261e****
    Data

    object

    返されたデータ。

    LaneId

    integer

    スイムレーンの ID。

    22318
    ErrorCode

    string

    エラーコード。

    • このパラメーターは、リクエストが成功した場合は返されません。

    • 詳細については、このトピックの「エラーコード」セクションをご参照ください。

    Code

    string

    HTTP ステータスコードまたは PaaS (Platform as a Service) のエラーコード。有効な値：

    • 2xx：リクエストは成功です。

    • 3xx：リクエストはリダイレクトされます。

    • 4xx：リクエストエラーが発生しました。

    • 5xx：サーバーエラーが発生しました。

    200
    Success

    boolean

    スイムレーンが作成または更新されたかどうかを示します。有効な値：

    • true

    • false

    true

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message": "success",
  "TraceId": "0a98a02315955564772843261e****",
  "Data": {
    "LaneId": 22318
  },
  "ErrorCode": "",
  "Code": "200",
  "Success": true
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter.NotEmpty You must specify the parameter %s.
    400 InvalidParameter.Obviously The specified parameter is invalid {%s}.
    400 InvalidParameter.WithMessage The parameter is invalid {%s}: %s
    400 MseGatewayRule.CreateFailed Create MSE Gateway rule failed.
    400 InternalApiError An exception occurred when calling mse:%s, error message: %s.

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

    変更履歴

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