Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ALB::AclAssociation

Última atualização: Jun 27, 2026

Associa listas de controle de acesso (ACLs) a um listener.

Sintaxe

{
  "Type": "ALIYUN::ALB::AclAssociation",
  "Properties": {
    "AclType": String,
    "AclIds": List,
    "ListenerId": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

AclIds

List

Sim

Sim

IDs das ACLs.

Especifique até três IDs.

AclType

String

Sim

Não

Tipo da ACL.

Valores válidos:

  • White: lista de permissões. O sistema encaminha apenas solicitações originadas dos endereços IP ou blocos CIDR presentes na ACL. Use este tipo para permitir acesso exclusivamente de endereços IP específicos.

    Com uma lista de permissões configurada, o listener encaminha somente requisições provenientes dos endereços IP adicionados a ela. Configurações incorretas podem comprometer a disponibilidade do serviço.

    Se a lista de permissões estiver ativa, mas sem nenhum endereço IP cadastrado, o listener encaminhará todas as solicitações.

  • Black: lista de bloqueios. O sistema não encaminha solicitações vindas dos endereços IP ou blocos CIDR definidos na ACL. Use este tipo para negar acesso de origens específicas.

    Se você ativar uma lista de bloqueios sem adicionar endereços IP à ACL, o listener continuará encaminhando todas as requisições.

ListenerId

String

Sim

Não

ID do listener.

Nenhuma.

Valores de retorno

Fn::GetAtt

ListenerId: ID do listener.

Exemplos

Formato YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  AclIds:
    Description: The IDs of the ACLs. You can specify up to three IDs at a time.
    MaxLength: 3
    MinLength: 1
    Type: Json
  AclType:
    AllowedValues:
    - White
    - Black
    Description: The type of ACL.
    Type: String
  ListenerId:
    Description: The ID of the listener.
    Type: String
Resources:
  AclAssociation:
    Properties:
      AclIds:
        Ref: AclIds
      AclType:
        Ref: AclType
      ListenerId:
        Ref: ListenerId
    Type: ALIYUN::ALB::AclAssociation
Outputs:
  ListenerId:
    Description: The ID of the listener.
    Value:
      Fn::GetAtt:
      - AclAssociation
      - ListenerId

Formato JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "AclType": {
      "Type": "String",
      "Description": "The type of ACL.",
      "AllowedValues": [
        "White",
        "Black"
      ]
    },
    "AclIds": {
      "Type": "Json",
      "Description": "The IDs of the ACLs. You can specify up to three IDs at a time.",
      "MinLength": 1,
      "MaxLength": 3
    },
    "ListenerId": {
      "Type": "String",
      "Description": "The ID of the listener."
    }
  },
  "Resources": {
    "AclAssociation": {
      "Type": "ALIYUN::ALB::AclAssociation",
      "Properties": {
        "AclType": {
          "Ref": "AclType"
        },
        "AclIds": {
          "Ref": "AclIds"
        },
        "ListenerId": {
          "Ref": "ListenerId"
        }
      }
    }
  },
  "Outputs": {
    "ListenerId": {
      "Description": "The ID of the listener.",
      "Value": {
        "Fn::GetAtt": [
          "AclAssociation",
          "ListenerId"
        ]
      }
    }
  }
}