DescribeGreyTagRoute - - Centre de documentation Alibaba Cloud

Obtient une règle de déploiement canari par identifiant de règle.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

sae:DescribeGreyTagRoute

get

*All Resource

*

Aucune

Syntaxe de la requête

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

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
GreyTagRouteId	integer	Oui	L'identifiant de la règle.	1

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les données renvoyées.
RequestId	string	L'identifiant de la requête.	9D29CBD0-45D3-410B-9826-52F86F90****
Message	string	Le message qui indique le résultat de l'appel.	success
TraceId	string	L'identifiant de trace pour interroger les détails d'un appel.	0a98a02315955564772843261e****
Data	object	Les détails de la règle canari.
GreyTagRouteId	integer	L'identifiant unique global de la règle canari.	16
Name	string	Le nom de la règle canari.	rule-name
Description	string	La description de la règle canari.	test
ScRules	array<object>	Les règles canari pour l'application Spring Cloud.
	array<object>	Un objet qui définit une règle canari.
path	string	The path to which the rule applies.	/path
condition	string	The relationship between the conditions in the rule. Valid values: AND: All conditions must be met. OR: At least one condition must be met.	OR
items	array<object>	The list of conditions.
	object	An object that defines a single condition.
type	string	The type of request element to match against. Valid values: param: A request parameter. cookie: A cookie. header: A request header.	cookie
name	string	The name of the element to match, as specified by the type parameter. For example, a header name or cookie name.	test
operator	string	The matching operator. Valid values: rawvalue: Performs a direct comparison. list: Matches against an allowlist of values. mod: Calculates the remainder of a division by 100. deterministic_proportional_steaming_division: Performs a percentage-based match.	rawvalue
value	string	The value to match. This value is compared with the actual value of the element specified by type and name.	test
cond	string	The comparison operator. Valid values are >, <, >=, <=, ==, and !=.	==
index	integer	Not used in Spring Cloud applications.	N/A
expr	string	Not used in Spring Cloud applications.	N/A
AlbRules	array<object>	Les règles canari pour l'instance Application Load Balancer (ALB).
	array<object>	Un objet qui définit une règle canari pour une instance ALB.
serviceId	string	The routing service ID.	22
ingressId	string	The ID of the Ingress.	23
condition	string	The relationship between the conditions in the canary rule. Only AND is supported, which indicates that all conditions must be met.	AND
items	array<object>	The list of conditions.
	object	An object that defines a single condition.
type	string	The type of request element to match against. Valid values: sourceIp: The source IP address. cookie: A cookie. header: A request header.	cookie
name	string	The name of the element to match, such as a header or cookie name. This parameter is not used if type is set to sourceIp.	example
operator	string	The matching operator. Only rawvalue is supported, which indicates a direct comparison.	rawvalue
value	string	The value to match. This value is compared with the actual value of the element specified by type and name.	test
cond	string	Currently supports ==.	==
index	integer	Not required for ALB applications.	N/A
expr	string	Not required for ALB applications.	N/A
DubboRules	array<object>	Les règles canari pour le service Dubbo.
	array<object>	Un objet qui définit une règle canari.
serviceName	string	The Dubbo service name.	com.alibaba.edas.boot.EchoService
group	string	The service group to which the canary rule applies.	DUBBO
version	string	The Dubbo service version.	1.0.0
methodName	string	The method name of the Dubbo service.	echo
condition	string	The relationship between the conditions in the rule. Valid values: AND: All conditions must be met. OR: At least one condition must be met.	OR
items	array<object>	The list of conditions.
	object	An object that defines a single condition.
index	integer	The parameter index. `0` indicates the first parameter.	0
expr	string	The expression that is used to obtain the parameter value. Valid values: Leave empty: If left empty, the value of the parameter itself is used. .name: Obtains the value of the `name` attribute of the parameter. This is equivalent to `args0.getName()`. .isEnabled(): Obtains the value of the `enabled` attribute of the parameter. This is equivalent to `args0.isEnabled()`. [0]: The parameter must be an array. This expression obtains the first value of the array, which is equivalent to `args0[0]`. Note that the expression does not start with a period (.). .get(0): The parameter must be a list. This expression obtains the first value of the list, which is equivalent to `args0.get(0)`. .get("key"): The parameter must be a map. This expression obtains the value that corresponds to a key. This is equivalent to `args0.get("key")`.	.name
operator	string	The matching operator. Valid values: rawvalue: Performs a direct comparison. list: Matches against an allowlist of values. mod: Calculates the remainder of a division by 100. deterministic_proportional_steaming_division: Performs a percentage-based match.	rawvalue
value	string	The value to match. This value is compared with the actual value retrieved by using the specified expr and index.	test
cond	string	The comparison operator. Valid values are >, <, >=, <=, ==, and !=.	==
type	string	Not used in Dubbo services.	N/A
name	string	Not used in Dubbo services.	N/A
CreateTime	integer	L'horodatage de création de la règle, en millisecondes.	1619007592013
UpdateTime	integer	L'horodatage de la dernière mise à jour de la règle, en millisecondes.	1609434061000
AppId	string	L'identifiant de l'application.	3faaf993-7aed-4bcd-b189-625e6a5a****
ErrorCode	string	Le code d'erreur. Valeurs valides :
Code	string	Le code d'état de l'appel d'API ou un code d'erreur POP. Valeurs valides :	200
Success	boolean	Indique si la requête a abouti. Valeurs valides :	true

Exemples

JSON format

{
  "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
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
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

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.