DescribeGreyTagRoute - Serverless App Engine: Central de Documentação do Alibaba Cloud

Obtém uma regra de lançamento canário pelo ID da regra.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

sae:DescribeGreyTagRoute

get

*All Resource

*

Nenhuma

Sintaxe da solicitação

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
GreyTagRouteId	integer	Sim	O ID da regra.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
RequestId	string	O ID da solicitação.	9D29CBD0-45D3-410B-9826-52F86F90****
Message	string	A mensagem que indica o resultado da chamada.	success
TraceId	string	O ID de rastreamento para consultar os detalhes de uma chamada.	0a98a02315955564772843261e****
Data	object	Os detalhes da regra canário.
GreyTagRouteId	integer	O ID globalmente único da regra canário.	16
Name	string	O nome da regra canário.	rule-name
Description	string	A descrição da regra canário.	test
ScRules	array<object>	As regras canário para a aplicação Spring Cloud.
	array<object>	Um objeto que define uma regra canário.
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>	As regras canário para a instância do Application Load Balancer (ALB).
	array<object>	Um objeto que define uma regra canário para uma instância 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>	As regras canário para o serviço Dubbo.
	array<object>	Um objeto que define uma regra canário.
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	O timestamp de criação da regra, em milissegundos.	1619007592013
UpdateTime	integer	O timestamp da última atualização da regra, em milissegundos.	1609434061000
AppId	string	O ID da aplicação.	3faaf993-7aed-4bcd-b189-625e6a5a****
ErrorCode	string	O código de erro. Valores válidos: Este parâmetro não é retornado se a solicitação for bem-sucedida. Se a solicitação falhar, o parâmetro ErrorCode será retornado. Para mais informações, consulte a seção Códigos de erro neste tópico.
Code	string	O código de status da chamada de API ou um código de erro POP. Valores válidos: 2xx: A solicitação foi bem-sucedida. 3xx: A solicitação foi redirecionada. 4xx: Ocorreu um erro no lado do cliente. 5xx: Ocorreu um erro no lado do servidor.	200
Success	boolean	Indica se a solicitação foi bem-sucedida. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou.	true

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
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

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.