全部產品
Search

搜尋本產品

    Serverless App Engine：DescribeGreyTagRoute - DescribeGreyTagRoute

    文件中心

    Serverless App Engine：DescribeGreyTagRoute - DescribeGreyTagRoute

    更新時間：Apr 22, 2026

    根據規則ID查詢灰階規則詳情。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    sae:DescribeGreyTagRoute

    get

    *全部資源

    *

    		 無 無

    請求文法

    GET /pop/v1/sam/tagroute/greyTagRoute HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    GreyTagRouteId

    integer

    是

    規則 ID。

    1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回資料。

    RequestId

    string

    請求 ID。

    9D29CBD0-45D3-410B-9826-52F86F90****
    Message

    string

    調用結果的附加資訊。

    success
    TraceId

    string

    調用鏈 ID，用於精確查詢調用資訊。

    0a98a02315955564772843261e****
    Data

    object

    灰階規則資訊。

    GreyTagRouteId

    integer

    灰階規則 ID，全域唯一。

    16
    Name

    string

    規則名稱。

    rule-name
    Description

    string

    規則描述。

    test
    ScRules

    array<object>

    Spring Cloud 應用的灰階規則。

    array<object>

    灰階規則資料。

    path

    string

    Spring Cloud 應用灰階規則對應的路徑。

    /path
    condition

    string

    灰階規則的條件模式，取值說明如下：

    • AND：表示與，即同時滿足條件列表中的所有條件。

    • OR：表示或，即滿足條件列表中的任一條件。

    OR
    items

    array<object>

    條件列表。

    object

    條件列表資料。

    type

    string

    比較類型。取值說明如下：

    • param：表示 Parameter。

    • cookie：表示 Cookie。

    • header：表示 Header。

    cookie
    name

    string

    參數名。

    test
    operator

    string

    運算子。取值說明如下：

    • rawvalue：直接比較。

    • list：白名單。

    • mod：對 100 模數。

    • deterministic_proportional_steaming_division：百分比。

    rawvalue
    value

    string

    參數取值，根據 type 和 name 得到的值跟這個值進行比較。

    test
    cond

    string

    比較操作符。可取值：>、<、>=、<=、==以及!=。

    ==
    index

    integer

    Spring Cloud 應用不涉及。

    N/A
    expr

    string

    Spring Cloud 應用不涉及。

    N/A
    AlbRules

    array<object>

    array<object>

    serviceId

    string

    路由服務 ID。

    22
    ingressId

    string

    網關路由 ID。

    23
    condition

    string

    灰階規則的條件模式，當前只支援 AND：表示同時滿足條件列表中的所有條件。

    AND
    items

    array<object>

    object

    type

    string

    比較類型。取值說明如下：

    • sourceIp：表示 SourceIp。

    • cookie：表示 Cookie。

    • header：表示 Header。

    cookie
    name

    string

    參數名。

    example
    operator

    string

    運算子。取值說明如下：目前只支援 rawvalue：直接比較。

    rawvalue
    value

    string

    參數取值，根據 type 和 name 得到的值跟這個值進行比較。

    test
    cond

    string

    暫支援==。

    ==
    index

    integer

    Alb 應用無需填寫。

    N/A
    expr

    string

    Alb 應用無需填寫。

    N/A
    DubboRules

    array<object>

    Dubbo 服務的灰階規則。

    array<object>

    灰階規則資料。

    serviceName

    string

    Dubbo 服務名稱。

    com.alibaba.edas.boot.EchoService
    group

    string

    灰階規則對應的 Dubbo 服務的分組。

    DUBBO
    version

    string

    Dubbo 服務版本。

    1.0.0
    methodName

    string

    Dubbo 服務的方法名。

    echo
    condition

    string

    灰階規則的條件模式，取值說明如下：

    • AND：表示與，即同時滿足條件列表中的所有條件。

    • OR：表示或，即滿足條件列表中的任一條件。

    OR
    items

    array<object>

    條件列表。

    object

    條件列表資料。

    index

    integer

    參數編號，0 表示第一個參數。

    0
    expr

    string

    參數值擷取運算式。取值說明如下：

    • 留空：直接取當前參數的值。

    • .name：取參數的 name 屬性，相當於 args0.getName()。

    • .isEnabled() ：取參數的 enabled 屬性，相當於 args0.isEnabled()。

    • [0]：當前參數應是一個數組，取數組的第一個值，相當於 args0[0]，注意開始沒有英文句點（.）。

    • .get(0)：當前參數應是一個 List，取 List 的第一個值，相當於 args0.get(0)。

    • .get("key")：當前參數是一個 Map，擷取 key 對應的值，相當於 args0.get("key")。

    .name
    operator

    string

    運算子。取值說明如下：

    • rawvalue：直接比較。

    • list：白名單。

    • mod：對 100 模數。

    • deterministic_proportional_steaming_division：百分比。

    rawvalue
    value

    string

    參數取值，根據 expr 和 index 得到的值跟這個值進行比較。

    test
    cond

    string

    比較操作符。可取值：>、<、>=、<=、==以及!=。

    ==
    type

    string

    Dubbo 服務不涉及。

    N/A
    name

    string

    Dubbo 服務不涉及。

    N/A
    CreateTime

    integer

    規則被建立的時間戳記。單位：毫秒。

    1619007592013
    UpdateTime

    integer

    規則被更新的時間戳記。單位：毫秒。

    1609434061000
    AppId

    string

    應用 ID。

    3faaf993-7aed-4bcd-b189-625e6a5a****
    ErrorCode

    string

    錯誤碼。取值說明如下：

    • 請求成功：不返回 ErrorCode 欄位。

    • 請求失敗：返回 ErrorCode 欄位。具體資訊，請參見本文的錯誤碼列表。

    Code

    string

    介面狀態或 POP 錯誤碼。取值說明如下：

    • 2xx：成功。

    • 3xx：重新導向。

    • 4xx：請求錯誤。

    • 5xx：伺服器錯誤。

    200
    Success

    boolean

    查詢變更單資訊是否成功。取值說明如下：

    • true：查詢成功。

    • false：查詢失敗。

    true

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "9D29CBD0-45D3-410B-9826-52F86F90****",
  "Message": "success",
  "TraceId": "0a98a02315955564772843261e****",
  "Data": {
    "GreyTagRouteId": 16,
    "Name": "rule-name",
    "Description": "test",
    "ScRules": [
      {
        "path": "/path",
        "condition": "OR",
        "items": [
          {
            "type": "cookie",
            "name": "test",
            "operator": "rawvalue",
            "value": "test",
            "cond": "==",
            "index": 0,
            "expr": "N/A"
          }
        ]
      }
    ],
    "AlbRules": [
      {
        "serviceId": "22",
        "ingressId": "23",
        "condition": "AND",
        "items": [
          {
            "type": "cookie",
            "name": "example",
            "operator": "rawvalue",
            "value": "test",
            "cond": "==",
            "index": 0,
            "expr": "N/A"
          }
        ]
      }
    ],
    "DubboRules": [
      {
        "serviceName": "com.alibaba.edas.boot.EchoService",
        "group": "DUBBO",
        "version": "1.0.0",
        "methodName": "echo",
        "condition": "OR",
        "items": [
          {
            "index": 0,
            "expr": ".name",
            "operator": "rawvalue",
            "value": "test",
            "cond": "==",
            "type": "N/A",
            "name": "N/A"
          }
        ]
      }
    ],
    "CreateTime": 1619007592013,
    "UpdateTime": 1609434061000,
    "AppId": "3faaf993-7aed-4bcd-b189-625e6a5a****"
  },
  "ErrorCode": "",
  "Code": "200",
  "Success": true
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidParameter.NotEmpty You must specify the parameter %s. 不合法的參數：%s不可為空。
    400 InvalidParameter.Obviously The specified parameter is invalid {%s}. 不合法的參數{%s}。
    400 InvalidParameter.WithMessage The parameter is invalid {%s}: %s 不合法的參數{%s}：%s。

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

    變更歷史

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