全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::NLB::Listener

更新时间:Feb 07, 2026

Gunakan tipe resource ALIYUN::NLB::Listener untuk membuat listener.

Sintaks

{
  "Type": "ALIYUN::NLB::Listener",
  "Properties": {
    "CaEnabled": Boolean,
    "ListenerPort": Integer,
    "StartPort": Integer,
    "Cps": Integer,
    "ServerGroupId": String,
    "IdleTimeout": Integer,
    "LoadBalancerId": String,
    "Mss": Integer,
    "ListenerProtocol": String,
    "SecurityPolicyId": String,
    "ListenerDescription": String,
    "AlpnPolicy": String,
    "CaCertificateIds": List,
    "EndPort": Integer,
    "ProxyProtocolEnabled": Boolean,
    "CertificateIds": List,
    "SecSensorEnabled": Boolean,
    "Enable": Boolean,
    "AlpnEnabled": Boolean,
    "Tags": List,
    "ServerGroupTuples": List,
    "ProxyProtocolV2Config": Map
  }
}

Properti

Nama properti

Tipe

Wajib

Pembaruan diizinkan

Deskripsi

Batasan

ListenerPort

Integer

Ya

Tidak

Port frontend yang digunakan oleh instans Server Load Balancer (SLB).

Nilai harus berada dalam rentang 1 hingga 65535.

ListenerProtocol

String

Ya

Tidak

Protokol frontend yang digunakan oleh instans SLB.

Nilai yang valid:

  • TCP

  • UDP

  • TCPSSL

LoadBalancerId

String

Ya

Tidak

ID instans SLB.

Tidak ada

AlpnEnabled

Boolean

Tidak

Ya

Menentukan apakah Application-Layer Protocol Negotiation (ALPN) diaktifkan.

Nilai yang valid:

  • true: Diaktifkan

  • false: Dinonaktifkan.

AlpnPolicy

String

Tidak

Ya

Agen Application-Layer Protocol Negotiation (ALPN).

Tidak ada

CaCertificateIds

List

Tidak

Tidak

ID sertifikat Certificate Authority (CA).

Tidak ada

CaEnabled

Boolean

Tidak

Ya

Menentukan apakah otentikasi timbal balik diaktifkan.

Nilai yang valid:

  • true: Fitur diaktifkan.

  • false (default): Dinonaktifkan.

CertificateIds

List

Tidak

Ya

ID sertifikat penandatanganan.

Tidak ada

Cps

Integer

Tidak

Ya

Jumlah koneksi baru per detik.

Nilai harus 3000.

Enable

Boolean

Tidak

Tidak

Menentukan apakah listener diaktifkan.

Nilai yang valid:

  • true: Item diaktifkan.

  • false berarti tidak diaktifkan.

EndPort

Integer

Tidak

Tidak

Port terakhir dalam range port listener.

Nilai harus 65535.

IdleTimeout

Integer

Tidak

Ya

Periode timeout untuk koneksi idle.

Nilai harus berada dalam rentang 1 hingga 60. Satuan: detik.

ListenerDescription

String

Tidak

Ya

Deskripsi listener.

Deskripsi harus terdiri dari 2 hingga 256 karakter. Dapat berisi huruf, angka, tanda hubung (-), garis miring (/), titik (.), dan garis bawah (_).

Mss

Integer

Tidak

Ya

negosiasi otomatis MSS

Tidak ada

ProxyProtocolEnabled

Boolean

Tidak

Ya

Menentukan apakah Proxy Protocol v2 diaktifkan.

Nilai yang valid:

  • true berarti diaktifkan.

  • false: Fitur dinonaktifkan.

ProxyProtocolV2Config

Map

Tidak

Ya

Konfigurasi untuk menggunakan Proxy Protocol guna meneruskan informasi client, seperti VpcId, PrivateLinkEpId, dan PrivateLinkEpsId, ke server backend.

Untuk informasi selengkapnya, lihat properti ProxyProtocolV2Config.

SecSensorEnabled

Boolean

Tidak

Ya

Apakah pemantauan secondary diaktifkan?

Nilai yang valid:

  • true: Mengaktifkan opsi ini.

  • false: Dinonaktifkan.

SecurityPolicyId

String

Tidak

Ya

ID kebijakan keamanan.

Tidak ada

ServerGroupId

String

Tidak

Ya

ID grup server tempat permintaan diteruskan.

Tidak ada

ServerGroupTuples

List

Tidak

Ya

Tupel server target penerusan.

Kombinasi beberapa ID grup server tujuan tempat permintaan diteruskan. Untuk informasi selengkapnya, lihat properti ServerGroupTuples.

StartPort

Integer

Tidak

Tidak

Port pertama dalam range port listener.

Nilai harus 1.

Tags

List

Tidak

Ya

Daftar tag.

Untuk informasi selengkapnya, lihat properti Tags.

Sintaks ServerGroupTuples

"ServerGroupTuples": [{
    "ServerGroupId": String,
    "Weight": Integer
}]

Properti ServerGroupTuples

Nama properti

Tipe

Wajib

Pembaruan diizinkan

Deskripsi

Batasan

ServerGroupId

String

Tidak

Ya

ID grup server tujuan tempat permintaan diteruskan.

Tidak ada

Weight

Integer

Tidak

Ya

Bobot.

Nilai yang lebih besar menunjukkan bobot yang lebih tinggi. Grup server dengan bobot lebih tinggi menerima lebih banyak permintaan. Nilai harus berada dalam rentang 0 hingga 100.

Sintaks ProxyProtocolV2Config

"ProxyProtocolV2Config": {
    "Ppv2PrivateLinkEpIdEnabled": Boolean,
    "Ppv2PrivateLinkEpsIdEnabled": Boolean,
    "Ppv2VpcIdEnabled": Boolean
  }

Properti ProxyProtocolV2Config

Nama properti

Tipe

Wajib

Pembaruan diizinkan

Deskripsi

Batasan

Ppv2PrivateLinkEpIdEnabled

Boolean

Tidak

Ya

Menentukan apakah Proxy Protocol digunakan untuk meneruskan PrivateLinkEpId ke server backend.

Nilai yang valid:

  • true: Diaktifkan.

  • false berarti dimatikan.

Ppv2PrivateLinkEpsIdEnabled

Boolean

Tidak

Ya

Menentukan apakah Proxy Protocol digunakan untuk meneruskan PrivateLinkEpsId ke server backend.

Nilai yang valid:

  • true: Diaktifkan.

  • false: Dimatikan.

Ppv2VpcIdEnabled

Boolean

Tidak

Ya

Menentukan apakah Proxy Protocol digunakan untuk meneruskan VpcId ke server backend.

Nilai yang valid:

  • true: Diaktifkan.

  • false berarti dimatikan.

Sintaks Tags

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

Properti Tags

Nama properti

Tipe

Wajib

Pembaruan diizinkan

Deskripsi

Batasan

Key

String

Ya

Tidak

kunci tag.

Tidak ada

Value

String

Tidak

Tidak

nilai tag.

Tidak ada

Nilai kembalian

Fn::GetAtt

  • ListenerPort: Port frontend yang digunakan oleh instans SLB.

  • ListenerId: ID listener.

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ServerGroupId:
    Type: String
    Description: ID of the ServerGroup
  LoadBalancerId:
    Type: String
    Description: ID of the LoadBalancer
  ListenerProtocol:
    Type: String
    AllowedValues:
      - TCP
      - UDP
      - TCPSSL
Resources:
  ExtensionResource:
    Type: ALIYUN::NLB::Listener
    Properties:
      ServerGroupId:
        Ref: ServerGroupId
      LoadBalancerId:
        Ref: LoadBalancerId
      ListenerProtocol:
        Ref: ListenerProtocol
Outputs:
  ListenerPort:
    Description: ListenerPort of created Listener
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - ListenerPort
  ListenerId:
    Description: Id of created Listener
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - ListenerId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ServerGroupId": {
      "Type": "String",
      "Description": "ID of the ServerGroup"
    },
    "LoadBalancerId": {
      "Type": "String",
      "Description": "ID of the LoadBalancer"
    },
    "ListenerProtocol": {
      "Type": "String",
      "AllowedValues": [
        "TCP",
        "UDP",
        "TCPSSL"
      ]
    }
  },
  "Resources": {
    "ExtensionResource": {
      "Type": "ALIYUN::NLB::Listener",
      "Properties": {
        "ServerGroupId": {
          "Ref": "ServerGroupId"
        },
        "LoadBalancerId": {
          "Ref": "LoadBalancerId"
        },
        "ListenerProtocol": {
          "Ref": "ListenerProtocol"
        }
      }
    }
  },
  "Outputs": {
    "ListenerPort": {
      "Description": "ListenerPort of created Listener",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "ListenerPort"
        ]
      }
    },
    "ListenerId": {
      "Description": "Id of created Listener",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "ListenerId"
        ]
      }
    }
  }
}