Todos os produtos
Search

Este produto

    Serverless App Engine:ListGreyTagRoute

    Central de documentação

    Serverless App Engine:ListGreyTagRoute

    Última atualização: Jun 28, 2026

    Consulta os detalhes de uma regra de escala de cinza com base no ID da aplicação.

    Descrição da operação

    Nota

    Você pode configurar apenas uma regra de escala de cinza para cada aplicação.

    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:ListGreyTagRoute

    get

    *All Resource

    *

    		 Nenhuma Nenhuma

    Sintaxe da solicitação

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

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    AppId

    string

    Sim

    O ID da aplicação.

    7171a6ca-d1cd-4928-8642-7d5cfe69****

    • Parâmetro ScRule

    ParâmetroTipoExemploDescrição
    conditionStringORO padrão condicional da regra de escala de cinza. Valores válidos:
    - AND: Todas as condições na lista devem ser atendidas.
    - OR: Qualquer condição na lista pode ser atendida.
    pathString/pathO caminho que corresponde à regra de escala de cinza para uma aplicação Spring Cloud.
    itemsArray of itemsA lista de condições.

    Parâmetro Item

    ParâmetroTipoExemploDescrição
    nameStringtestO nome do parâmetro.
    condString==O operador de comparação. Valores válidos: >, <, >=, <=, == e !=
    typeStringcookieO tipo de comparação. Valores válidos:
    - param: Parâmetro.
    - cookie: Cookie.
    - header: Cabeçalho.
    valueStringtestO valor do parâmetro. O valor obtido com base em type e name é comparado com este valor.
    operatorStringrawvalueO operador. Valores válidos:
    - rawvalue: Comparação direta.
    - list: Lista de permissões.
    - mod: Operação de módulo 100.
    - deterministic_proportional_steaming_division: Porcentagem.

    • Parâmetro DubboRule

    ParâmetroTipoExemploDescrição
    conditionStringORO padrão condicional da regra de escala de cinza. Valores válidos:
    - AND: Todas as condições na lista devem ser atendidas.
    - OR: Qualquer condição na lista pode ser atendida.
    methodNameStringechoO nome do método do serviço Dubbo.
    serviceNameStringcom.alibaba.edas.boot.EchoServiceO nome do serviço Dubbo.
    versionString1.0.0A versão do serviço Dubbo.
    itemsArray of itemsA lista de condições.
    groupStringDUBBOO grupo do serviço Dubbo que corresponde à regra de escala de cinza.

    Parâmetro Item

    ParâmetroTipoExemploDescrição
    indexInteger0O número do parâmetro. 0 indica o primeiro parâmetro.
    exprString.nameA expressão usada para obter o valor do parâmetro. A sintaxe segue a Spring Expression Language (SpEL). Valores válidos:
    - Deixe em branco: Obtém o valor do parâmetro atual.
    - .name: Obtém a propriedade name do parâmetro. Isso é equivalente a args0.getName().
    - .isEnabled(): Obtém a propriedade enabled do parâmetro. Isso é equivalente a args0.isEnabled().
    - [0]: Obtém o primeiro valor do array. Isso é equivalente a args0[0]. Observe que a expressão não começa com um ponto (.).
    - **.get(0) **: Obtém o primeiro valor da lista. Isso é equivalente a args0.get(0).
    - .get("key"): Obtém o valor que corresponde à chave especificada do mapa. Isso é equivalente a args0.get("key").
    condString==O operador de comparação. Valores válidos: >, <, >=, <=, == e !=
    valueStringtestO valor do parâmetro. O valor obtido com base em expr e index é comparado com este valor.
    operatorStringrawvalueO operador. Valores válidos:
    - rawvalue: Comparação direta.
    - list: Lista de permissões.
    - mod: Operação de módulo 100.
    - deterministic_proportional_steaming_division: Porcentagem.

    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

    Informações adicionais. Valores válidos:

    • Se a solicitação for bem-sucedida, success será retornado.

    • Se a solicitação falhar, um código de erro específico será retornado.

    success
    TraceId

    string

    O ID de rastreamento, usado para consultar os detalhes de uma chamada.

    0a98a02315955564772843261e****
    Data

    object

    As informações sobre a regra de escala de cinza.

    CurrentPage

    integer

    O número da página atual.

    1
    PageSize

    integer

    O número de entradas por página em uma consulta paginada. O valor pode ser apenas 1.

    1
    TotalSize

    integer

    O número total de entradas. O valor pode ser apenas 1.

    1
    Result

    array<object>

    O resultado retornado.

    array<object>

    Os dados retornados.

    GreyTagRouteId

    integer

    The rule ID.

    1
    Name

    string

    The rule name.

    rule-name
    Description

    string

    The description of the rule.

    test
    ScRules

    array<object>

    The grayscale rules for Spring Cloud.

    array<object>

    The details of the rules.

    path

    string

    The path that corresponds to the grayscale rule for the Spring Cloud application.

    /path
    condition

    string

    The conditional pattern of the grayscale rule. Valid values:

    • AND: All conditions in the list must be met.

    • OR: Any condition in the list can be met.

    OR
    items

    array<object>

    The list of conditions.

    object

    The data in the list of conditions.

    type

    string

    The comparison type. Valid values:

    • param: Parameter.

    • cookie: Cookie.

    • header: Header.

    cookie
    name

    string

    The parameter name.

    test
    operator

    string

    The operator. Valid values:

    • rawvalue: Direct comparison.

    • list: Whitelist.

    • mod: Modulo 100 operation.

    • deterministic_proportional_steaming_division: Percentage.

    rawvalue
    value

    string

    The parameter value. The value obtained based on type and name is compared with this value.

    test
    cond

    string

    The comparison operator. Valid values: >, <, >=, <=, ==, and !=.

    ==
    index

    integer

    This parameter is not applicable to Spring Cloud applications.

    N/A
    expr

    string

    This parameter is not applicable to Spring Cloud applications.

    N/A
    AlbRules

    array<object>

    The grayscale rules created for an application for which an Application Load Balancer (ALB) Ingress is configured.

    array<object>

    The details of the grayscale rules.

    ingressId

    string

    The Ingress ID.

    23
    condition

    string

    The conditional pattern of the grayscale rule. Only AND is supported, which indicates that all conditions in the list must be met.

    AND
    items

    array<object>

    The list of conditions.

    object

    The details of the list of conditions.

    type

    string

    The comparison type. Valid values:

    • sourceIp: SourceIp.

    • cookie: Cookie.

    • header: Header.

    cookie
    name

    string

    The parameter name.

    example
    operator

    string

    The operator. Valid values: Only rawvalue is supported, which indicates a direct comparison.

    rawvalue
    value

    string

    The parameter value. The value obtained based on type and name is compared with this value.

    test
    cond

    string

    Only == is supported.

    ==
    index

    integer

    This parameter is not applicable to ALB applications.

    N/A
    expr

    string

    This parameter is not applicable to ALB applications.

    N/A
    serviceName

    string

    The service name.

    s-6366-e3****-99**
    DubboRules

    array<object>

    The grayscale rules for Dubbo services.

    array<object>

    The information about the grayscale rules.

    serviceName

    string

    The name of the Dubbo service.

    com.alibaba.edas.boot.EchoService
    group

    string

    The group of the Dubbo service that corresponds to the grayscale rule.

    DUBBO
    version

    string

    The version of the Dubbo service.

    1.0.0
    methodName

    string

    The method name of the Dubbo service.

    echo
    condition

    string

    The conditional pattern of the grayscale rule. Valid values:

    • AND: All conditions in the list must be met.

    • OR: Any condition in the list can be met.

    OR
    items

    array<object>

    The list of conditions.

    object

    The details of the conditions.

    index

    integer

    The parameter number. 0 indicates the first parameter.

    0
    expr

    string

    The expression that is used to obtain the parameter value. The syntax follows the Spring Expression Language (SpEL). Valid values:

    • Leave it empty: Obtains the value of the current parameter.

    • .name: Obtains the name property of the parameter. This is equivalent to args0.getName().

    • .isEnabled(): Obtains the enabled property of the parameter. This is equivalent to args0.isEnabled().

    • [0]: Obtains the first value of the array. This is equivalent to args0[0]. Note that the expression does not start with a period (.).

    • .get(0): Obtains the first value of the list. This is equivalent to args0.get(0).

    • .get("key"): Obtains the value that corresponds to the specified key from the map. This is equivalent to args0.get("key").

    .name
    operator

    string

    The operator. Valid values:

    • rawvalue: Direct comparison.

    • list: Whitelist.

    • mod: Modulo 100 operation.

    • deterministic_proportional_steaming_division: Percentage.

    rawvalue
    value

    string

    The parameter value. The value obtained based on expr and index is compared with this value.

    test
    cond

    string

    The comparison operator. Valid values: >, <, >=, <=, ==, and !=.

    ==
    type

    string

    This parameter is not applicable to Dubbo services.

    N/A
    name

    string

    This parameter is not applicable to Dubbo services.

    N/A
    CreateTime

    integer

    The timestamp when the rule was created. Unit: milliseconds.

    1619007592013
    UpdateTime

    integer

    The timestamp when the rule was updated. Unit: milliseconds.

    1609434061000
    ErrorCode

    string

    O código de erro. Valores válidos:

    • Este parâmetro não é retornado se a solicitação for bem-sucedida.

    • Este parâmetro é retornado se a solicitação falhar. Para obter mais informações, consulte a seção Códigos de erro neste tópico.

    Code

    string

    O status da interface ou o código de erro POP. Valores válidos:

    • 2xx: A solicitação é bem-sucedida.

    • 3xx: A solicitação é redirecionada.

    • 4xx: Ocorre um erro de solicitação.

    • 5xx: Ocorre um erro de servidor.

    200
    Success

    boolean

    Indica se a consulta foi bem-sucedida.

    • true: A consulta foi bem-sucedida.

    • false: A consulta falhou.

    true

    Exemplos

    Resposta de sucesso

    JSON formato

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

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    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.