Todos os produtos
Search
Central de documentação

Resource Orchestration Service:DATASOURCE::SLB::Rules

Última atualização: Jun 27, 2026

Consulta as regras de encaminhamento configuradas para um listener especificado.

Sintaxe

{
  "Type": "DATASOURCE::SLB::Rules",
  "Properties": {
    "ListenerPort": String,
    "LoadBalancerId": String,
    "ListenerProtocol": String,
    "RefreshOptions": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

ListenerPort

String

Sim

Sim

Porta de escuta frontend da instância do Server Load Balancer (SLB).

Valores válidos: 1 a 65535.

LoadBalancerId

String

Sim

Sim

ID da instância SLB.

Nenhuma.

ListenerProtocol

String

Não

Sim

Protocolo frontend da instância SLB.

Especifique esta propriedade quando listeners com protocolos diferentes escutarem na mesma porta.

RefreshOptions

String

Não

Sim

Política de atualização dos recursos de source de dados durante a atualização da pilha.

Valores válidos:

  • Never (padrão): não atualiza os recursos de source de dados ao atualizar a pilha.

  • Always: atualiza os recursos de source de dados ao atualizar a pilha.

Valores de retorno

Fn::GetAtt

  • RuleIds: IDs das regras de encaminhamento.

  • Rules: detalhes das regras de encaminhamento.

Propriedade

Tipo

Descrição

Restrição

RuleIds

List

IDs das regras de encaminhamento.

Nenhuma.

Rules

List

Detalhes das regras de encaminhamento.

Nenhuma.

HealthCheckHttpCode

String

Códigos de status HTTP que indicam verificação de integridade bem-sucedida.

Separe vários códigos de status HTTP com vírgulas (,).

Valores válidos:

  • http_2xx (padrão)

  • http_3xx

  • http_4xx

  • http_5xx

Nota

Esta propriedade só tem efeito quando HealthCheck está definido como on.

HealthCheckUri

String

URI usada para verificações de integridade.

Nota

Esta propriedade só tem efeito quando HealthCheck está definido como on.

CookieTimeout

String

Tempo limite do cookie.

Valores válidos: 1 a 86400.

Unidade: segundos.

Nota

Esta propriedade só tem efeito quando StickySession está definido como on e StickySessionType está definido como insert.

RuleId

String

ID da regra de encaminhamento.

Nenhuma.

Url

String

Caminho de solicitação especificado na regra de encaminhamento.

Nenhuma.

ListenerProtocol

String

Protocolo frontend da instância SLB.

Nenhuma.

HealthCheckTimeout

Integer

Tempo limite de resposta da verificação de integridade.

Se uma instância backend do Elastic Compute Service (ECS) não retornar uma resposta de verificação de integridade dentro do tempo limite especificado, a instância falhará na verificação.

Valores válidos: 1 a 300.

Unidade: segundos.

Nota

Se o valor de HealthCheckTimeout for menor que o valor de HealthCheckInterval, o tempo limite especificado por HealthCheckTimeout torna-se inválido e o valor de HealthCheckInterval é usado como tempo limite.

Esta propriedade só tem efeito quando HealthCheck está definido como on.

HealthCheck

String

Indica se o recurso de verificação de integridade está ativado.

Valores válidos:

  • on

  • off

Nota

Esta propriedade só tem efeito quando ListenerSync está definido como off. Se ListenerSync estiver definido como on, a configuração de verificação de integridade do listener será utilizada.

ListenerSync

String

Indica se a regra de encaminhamento utiliza as configurações de algoritmo de agendamento, persistência de sessão e verificação de integridade do listener.

Valores válidos:

  • on: a regra de encaminhamento utiliza as configurações do listener.

  • off: a regra de encaminhamento não utiliza as configurações do listener. É possível especificar configurações de verificação de integridade e persistência de sessão para a regra de encaminhamento.

UnhealthyThreshold

Integer

Número de falhas consecutivas na verificação de integridade necessárias antes que um servidor backend íntegro seja declarado como não íntegro.

Valores válidos: 2 a 10.

Nota

Esta propriedade só tem efeito quando HealthCheck está definido como on.

HealthyThreshold

Integer

Número de sucessos consecutivos na verificação de integridade necessários antes que um servidor backend não íntegro seja declarado como íntegro.

Valores válidos: 2 a 10.

Nota

Esta propriedade tem efeito quando HealthCheck está definido como on.

HealthCheckInterval

Integer

Intervalo entre duas verificações de integridade consecutivas.

Valores válidos: 1 a 50.

Unidade: segundos.

Nota

Esta propriedade só tem efeito quando HealthCheck está definido como on.

HealthCheckConnectPort

Integer

Porta usada para verificações de integridade nos servidores backend.

Valores válidos: 1 a 65535.

Nota

Esta propriedade só tem efeito quando HealthCheck está definido como on. Se HealthCheckConnectPort estiver vazio e HealthCheck definido como on, a configuração de porta backend do listener será usada por padrão.

Cookie

String

Cookie configurado no servidor backend.

O cookie deve ter de 1 a 200 caracteres e pode conter apenas caracteres ASCII e dígitos. Não pode conter vírgulas (,), ponto e vírgula (;) ou espaços, nem começar com cifrão ($).

Nota

Esta propriedade só tem efeito quando StickySession está definido como on e StickySessionType está definido como server.

VServerGroupId

String

ID do grupo vServer associado à regra de encaminhamento.

Nenhuma.

Scheduler

String

Algoritmo de agendamento.

Valores válidos:

  • wrr (padrão): servidores backend com pesos maiores recebem mais solicitações do que servidores backend com pesos menores.

  • rr: as solicitações são distribuídas aos servidores backend sequencialmente.

Nota

Esta propriedade só tem efeito quando ListenerSync está definido como off. Se ListenerSync estiver definido como on, a configuração de algoritmo de agendamento do listener será utilizada.

RuleName

String

Nome da regra de encaminhamento.

O nome deve ter de 1 a 80 caracteres e pode conter letras, dígitos, hifens (-), barras (/), pontos (.) e sublinhados (_).

Nota

Os nomes das regras de encaminhamento devem ser exclusivos dentro de um listener.

Domain

String

Nome de domínio especificado na regra de encaminhamento.

Nenhuma.

StickySession

String

Indica se a persistência de sessão está ativada.

Valores válidos:

  • on

  • off

Nota
  • Esta propriedade só tem efeito quando ListenerSync está definido como off.

  • Se ListenerSync estiver definido como on, a configuração de persistência de sessão do listener será utilizada.

StickySessionType

String

Método usado para lidar com cookies.

Valores válidos:

  • insert: insere um cookie. O SLB insere o cookie SERVERID no primeiro pacote de resposta HTTP ou HTTPS enviado a um cliente. A próxima solicitação do cliente carrega o cookie e o SLB encaminha essa solicitação para o servidor backend registrado.

  • server: reescreve um cookie. Quando o SLB detecta um cookie definido pelo usuário, substitui o cookie original pelo cookie definido pelo usuário. A próxima solicitação do cliente carrega o cookie definido pelo usuário e o SLB encaminha essa solicitação para o servidor backend registrado.

Nota

Esta propriedade só tem efeito quando StickySession está definido como on.

HealthCheckDomain

String

Nome de domínio usado para verificações de integridade.

Valores válidos:

  • $_ip: endereço IP privado do servidor backend. Se esta propriedade for definida como $_ip ou deixada vazia, o SLB usará o endereço IP privado de cada servidor backend como nome de domínio para as verificações de integridade.

  • domain: nome de domínio. O nome de domínio deve ter de 1 a 80 caracteres e pode conter letras, dígitos, pontos (.) e hifens (-).

Nota

Esta propriedade só tem efeito quando HealthCheck está definido como on.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  LoadBalancerId:
    Type: String
    AssociationProperty: ALIYUN::SLB::Instance::InstanceId
    Description: The ID of the CLB instance.
Resources:
  ExtensionDataSource:
    Type: DATASOURCE::SLB::Rules
    Properties:
      ListenerPort: 3443
      LoadBalancerId:
        Ref: LoadBalancerId
Outputs:
  RuleIds:
    Description: The list of rule IDs.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - RuleIds
  Rules:
    Description: The list of rules.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - Rules
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "LoadBalancerId": {
      "Type": "String",
      "AssociationProperty":"ALIYUN::SLB::Instance::InstanceId",
      "Description": "The ID of the CLB instance."
    }
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::SLB::Rules",
      "Properties": {
        "ListenerPort": 3443,
        "LoadBalancerId": {
          "Ref": "LoadBalancerId"
        }
      }
    }
  },
  "Outputs": {
    "RuleIds": {
      "Description": "The list of rule IDs.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "RuleIds"
        ]
      }
    },
    "Rules": {
      "Description": "The list of rules.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "Rules"
        ]
      }
    }
  }
}