ListGreyTagRoute查詢應用灰階規則API參考-Serverless 應用引擎-阿里雲 - Serverless App Engine

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

介面說明

說明

目前一個應用只能配置一條灰階規則。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

sae:ListGreyTagRoute

get

*全部資源

*

無

請求文法

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

請求參數

名稱	類型	必填	描述	樣本值
AppId	string	是	應用 ID。	7171a6ca-d1cd-4928-8642-7d5cfe69****

ScRule 參數說明

參數名稱	類型	樣本	描述
condition	String	OR	灰階規則的條件模式。取值說明如下： - AND：表示與，即同時滿足條件列表中的所有條件。 - OR：表示或，即滿足條件列表中的任一條件。
path	String	/path	Spring Cloud 應用灰階規則對應的 path。
items	Array of items		條件列表。

Item 參數說明

參數名稱	類型	樣本	描述
name	String	test	參數名。
cond	String	==	比較操作符。可取值：>、<、>=、<=、==以及!=。
type	String	cookie	比較類型。取值說明如下： - param：表示 Parameter。 - cookie：表示 Cookie。 - header：表示 Header。
value	String	test	參數取值，根據 type 和 name 得到的值跟這個值進行比較。
operator	String	rawvalue	運算子。取值說明如下： - rawvalue：表示直接比較。 - list：表示白名單。 - mod：表示對 100 模數。 - deterministic_proportional_steaming_division：表示百分比。

DubboRule 參數說明

參數名稱	類型	樣本	描述
condition	String	OR	灰階規則的條件模式。取值說明如下： - AND：表示與，即同時滿足條件列表中的所有條件。 - OR：表示或，即滿足條件列表中的任一條件。
methodName	String	echo	Dubbo 服務的方法名。
serviceName	String	com.alibaba.edas.boot.EchoService	Dubbo 服務名稱。
version	String	1.0.0	Dubbo 服務版本。
items	Array of items		條件列表。
group	String	DUBBO	灰階規則對應的 Dubbo 服務的分組。

Item 參數說明

參數名稱	類型	樣本	描述
index	Integer	0	參數編號，0 表示第一個參數。
expr	String	.name	參數值擷取運算式。文法遵循 SpEL（link）運算式，取值說明如下： - 留空：表示直接取當前參數的值。 - .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")。
cond	String	==	比較操作符。可取值：>、<、>=、<=、==以及!=。
value	String	test	參數取值，根據 expr 和 index 得到的值跟這個值進行比較。
operator	String	rawvalue	運算子。取值說明如下： - rawvalue：表示直接比較。 - list：表示白名單。 - mod：表示對 100 模數。 - deterministic_proportional_steaming_division：表示百分比。

返回參數

名稱	類型	描述	樣本值
	object	返回資料。
RequestId	string	請求 ID。	9D29CBD0-45D3-410B-9826-52F86F90****
Message	string	附加資訊。取值說明如下：請求正常，返回 success。請求異常，返回具體異常錯誤碼。	success
TraceId	string	調用鏈 ID，用於精確查詢調用資訊。	0a98a02315955564772843261e****
Data	object	灰階規則資訊。
CurrentPage	integer	當前頁碼。	1
PageSize	integer	分頁查詢時設定的每頁數量。目前只能為 1。	1
TotalSize	integer	總個數。目前只能為 1。	1
Result	array<object>	返回結果。
	array<object>	返回資料。
GreyTagRouteId	integer	規則 ID。	1
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>	為配置好 ALB 網關路由的應用建立的灰階規則。
	array<object>	灰階規則詳情。
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
serviceName	string	服務名稱。	s-6366-e3**-99
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	參數值擷取運算式。文法遵循 SpEL（link）運算式，取值說明如下：留空：表示直接取當前參數的值。 .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
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": {
    "CurrentPage": 1,
    "PageSize": 1,
    "TotalSize": 1,
    "Result": [
      {
        "GreyTagRouteId": 1,
        "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": [
          {
            "ingressId": "23",
            "condition": "AND",
            "items": [
              {
                "type": "cookie",
                "name": "example",
                "operator": "rawvalue",
                "value": "test",
                "cond": "==",
                "index": 0,
                "expr": "N/A"
              }
            ],
            "serviceName": "s-6366-e3****-99**"
          }
        ],
        "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
      }
    ]
  },
  "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。

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

變更歷史

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