Todos os produtos
Search
Central de documentação

:ALIYUN::GWLB::Listener

Última atualização: Jun 27, 2026

O tipo ALIYUN::GWLB::Listener crie um listener.

Sintaxe

{
  "Type": "ALIYUN::GWLB::Listener",
  "Properties": {
    "LoadBalancerId": String,
    "ServerGroupId": String,
    "ListenerDescription": String,
    "Tags": List
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Atualização permitida

Descrição

Restrições

LoadBalancerId

String

Sim

Não

ID da instância do Gateway Load Balancer (GWLB).

Nenhuma

ServerGroupId

String

Sim

Não

ID do grupo de servidores.

Nenhuma

ListenerDescription

String

Não

Sim

Descrição personalizada do listener.

A descrição deve ter de 2 a 256 caracteres e pode conter letras, dígitos, caracteres chineses e os seguintes caracteres especiais: , . ; / @ _ -.

Tags

List

Não

Sim

Tags associadas à instância SLB.

A lista aceita no máximo 20 tags. Para mais informações, consulte Propriedade Tags.

Sintaxe de Tags

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

Propriedade Tags

Propriedade

Tipo

Obrigatória

Atualização permitida

Descrição

Restrições

Key

String

Sim

Não

Chave da tag.

A chave da tag pode ter até 128 caracteres. Não pode ser uma string vazia, começar com aliyun ou acs:, nem conter http:// ou https://.

Value

String

Não

Não

Valor da tag.

O valor da tag pode ter até 256 caracteres e não pode conter http:// ou https://.

Valores de retorno

Fn::GetAtt

  • ListenerDescription: descrição do listener.

  • ServerGroupId: ID do grupo de servidores.

  • LoadBalancerId: ID da instância GWLB.

  • Tags: tags associadas à instância GWLB.

  • ListenerId: ID do listener.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ServerGroupId:
    Type: String
    Description:
      en: The ID of the server group.
    Required: true
  LoadBalancerId:
    Type: String
    Description:
      en: The ID of the gateway load balancer instance.
    Required: true
Resources:
  ExtensionResource:
    Type: ALIYUN::GWLB::Listener
    Properties:
      ServerGroupId:
        Ref: ServerGroupId
      LoadBalancerId:
        Ref: LoadBalancerId
Outputs:
  ListenerDescription:
    Description: The custom listener description.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - ListenerDescription
  ServerGroupId:
    Description: The ID of the server group.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - ServerGroupId
  LoadBalancerId:
    Description: The ID of the gateway load balancer instance.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - LoadBalancerId
  Tags:
    Description: The list of tags.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - Tags
  ListenerId:
    Description: The ID of the listener.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - ListenerId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ServerGroupId": {
      "Type": "String",
      "Description": {
        "en": "The ID of the server group."
      },
      "Required": true
    },
    "LoadBalancerId": {
      "Type": "String",
      "Description": {
        "en": "The ID of the gateway load balancer instance."
      },
      "Required": true
    }
  },
  "Resources": {
    "ExtensionResource": {
      "Type": "ALIYUN::GWLB::Listener",
      "Properties": {
        "ServerGroupId": {
          "Ref": "ServerGroupId"
        },
        "LoadBalancerId": {
          "Ref": "LoadBalancerId"
        }
      }
    }
  },
  "Outputs": {
    "ListenerDescription": {
      "Description": "The custom listener description.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "ListenerDescription"
        ]
      }
    },
    "ServerGroupId": {
      "Description": "The ID of the server group.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "ServerGroupId"
        ]
      }
    },
    "LoadBalancerId": {
      "Description": "The ID of the gateway load balancer instance.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "LoadBalancerId"
        ]
      }
    },
    "Tags": {
      "Description": "The list of tags.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "Tags"
        ]
      }
    },
    "ListenerId": {
      "Description": "The ID of the listener.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "ListenerId"
        ]
      }
    }
  }
}