全部產品
Search

搜尋本產品

    Microservices Engine：CreateOrUpdateSwimmingLaneGroup - 建立或者更新全鏈路灰階泳道組

    文件中心

    Microservices Engine：CreateOrUpdateSwimmingLaneGroup - 建立或者更新全鏈路灰階泳道組

    更新時間：Apr 21, 2026

    用於建立或者更新全鏈路灰階泳道組。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    mse:CreateOrUpdateSwimmingLaneGroup

    update

    *GovernanceNamespace

    acs:mse:{#regionId}:{#accountId}:namespace/{#Namespace}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Region

    string

    否

    Region。

    cn-shanghai
    Namespace

    string

    否

    MSE 命名空間名字。

    default
    Id

    integer

    否

    泳道組 ID。-1 時為建立泳道組，大於 0 時為修改指定泳道組。

    120
    Name

    string

    是

    泳道組名稱。

    group1
    Status

    integer

    否

    取值為 0 表示未生效，取值為 1 表示生效。

    0
    EntryApp

    string

    否

    入口應用。格式 "來源系統:id"。比如：

    • mse:${mse 應用 id}

    • mse-gw:${mse 雲原生網關 id}

    • apig:${雲原生 API Gateway id}

    mse-gw:gw-2b1407e050f1446xxxcd2a65fd9xxxx
    AppIds

    string

    否

    應用集合。以 "," 分割應用 id

    xxxxn1po62@492b8f98d4bxxxx,xxxxn1po62@2d8f5d1b7f2xxxx
    MessageQueueGrayEnable

    boolean

    否

    是否開啟訊息灰階。

    枚舉值：

    • true :

      true

    • false :

      false

    true
    MessageQueueFilterSide

    string

    否

    訊息灰階過濾側。

    Server
    DbGrayEnable

    boolean

    否

    已廢棄，是否開啟資料庫灰階。

    枚舉值：

    • true :

      true

    • false :

      false

    true
    RecordCanaryDetail

    boolean

    否

    是否開啟記錄請求詳情。

    false
    Paths

    array

    否

    已廢棄，java 網關為入口時填寫該參數

    string

    否

    已廢棄，path

    a
    RouteIds

    array

    否

    路由 ID 列表（以雲原生網關為入口時，在建立泳道組的泳道前，需調用本介面傳入選擇的雲原生網關路由 ID 列表）

    integer

    否

    路由 Id

    111
    CanaryModel

    integer

    否

    全鏈路灰階模式：

    • 0: 按請求內容路由

    • 1: 按比例路由

    1
    SwimVersion

    integer

    否

    全鏈路灰階版本，取值範圍：0（不推薦使用，需要指定路由）,2(推薦使用，無需指定路由)

    2
    AcceptLanguage

    string

    否

    返回資訊的語言類型：

    • zh：中文

    • en：英文

    zh

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RestResult。

    RequestId

    string

    請求 ID。

    EE5C32A1-BC0E-4B79-817C-103E4EDF****
    Success

    boolean

    請求結果，取值如下：

    true：請求成功。 false：請求失敗。

    true
    ErrorCode

    string

    錯誤碼。

    Success
    Message

    string

    返回資訊。

    Succ
    Data

    object

    資料概覽。

    {}
    Name

    string

    應用程式名稱

    example-app
    DbGrayEnable

    string

    是否開啟資料庫灰階

    true
    UserId

    string

    應用所屬的使用者 id。

    12345
    MessageQueueFilterSide

    string

    訊息灰階過濾側。

    Client
    AppIds

    string

    應用 id 列表，逗號分隔。

    abcd1@abcde123,abcd1@abcde124
    Namespace

    string

    MSE 命名空間名字。

    prod
    RecordCanaryDetail

    boolean

    是否開啟記錄請求詳情。

    true
    Id

    integer

    泳道組 id。

    2047
    EntryApp

    string

    入口應用。

    mse:abcd1@a2345
    Region

    string

    應用所屬地區。

    cn-hangzhou
    MessageQueueGrayEnable

    boolean

    是否開啟訊息灰階。

    true
    paths

    string

    已廢棄，java 網關為入口時該參數為 Path 列表

    ["/a"]
    Paths

    string

    已廢棄，java 網關為入口時該參數為 Path 列表

    ["/a"]
    canaryModel

    integer

    全鏈路灰階模式：

    • 0: 按請求內容路由

    • 1: 按比例路由

    0
    CanaryModel

    integer

    全鏈路灰階模式：

    • 0: 按請求內容路由

    • 1: 按比例路由

    0

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "EE5C32A1-BC0E-4B79-817C-103E4EDF****",
  "Success": true,
  "ErrorCode": "Success",
  "Message": "Succ",
  "Data": {
    "Name": "example-app",
    "DbGrayEnable": "true",
    "UserId": "12345",
    "MessageQueueFilterSide": "Client",
    "AppIds": "abcd1@abcde123,abcd1@abcde124",
    "Namespace": "prod",
    "RecordCanaryDetail": true,
    "Id": 2047,
    "EntryApp": "mse:abcd1@a2345",
    "Region": "cn-hangzhou",
    "MessageQueueGrayEnable": true,
    "paths": "[\"/a\"]",
    "Paths": "[\"/a\"]",
    "canaryModel": 0,
    "CanaryModel": 0
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 IllegalRequest Invalid request:%s 非法請求： %s
    400 InvalidParameter Parameter error:%s 請求參數錯誤：%s
    500 InternalError Console error. Try again later:%s 控制台錯誤.稍後重試：%s
    403 NoPermission You are not authorized to perform this operation:%s 沒有許可權使用此介面：%s
    404 NotFound Not found:%s 資源不存在：%s

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。