Tous les produits
Search
Centre de documentation

Resource Orchestration Service:ALIYUN::NLB::Listener

Dernière mise à jour :Aug 10, 2026

Le type de ressource ALIYUN::NLB::Listener permet de créer un écouteur pour une instance Network Load Balancer (NLB).

Syntaxe

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

Propriétés

Nom de la propriété

Type

Obligatoire

Mise à jour autorisée

Description

Contraintes

ListenerPort

Integer

Oui

Non

Port frontal utilisé par l'instance Server Load Balancer (SLB).

La valeur doit être comprise entre 1 et 65535.

ListenerProtocol

String

Oui

Non

Protocole frontal utilisé par l'instance SLB.

Valeurs valides :

  • TCP

  • UDP

  • TCPSSL

LoadBalancerId

String

Oui

Non

ID de l'instance SLB.

Aucun

AlpnEnabled

Boolean

Non

Oui

Active ou non la négociation de protocole au niveau de la couche application (ALPN).

Valeurs valides :

  • true : activé.

  • false : désactivé.

AlpnPolicy

String

Non

Oui

Stratégie de négociation de protocole au niveau de la couche application (ALPN).

Aucun

CaCertificateIds

List

Non

Non

ID du certificat d'autorité de certification (CA).

Aucun

CaEnabled

Boolean

Non

Oui

Active ou non l'authentification mutuelle.

Valeurs valides :

  • true : activé.

  • false (par défaut) : désactivé.

CertificateIds

List

Non

Oui

ID du certificat de signature.

Aucun

Cps

Integer

Non

Oui

Nombre de nouvelles connexions par seconde.

La valeur doit être 3000.

Enable

Boolean

Non

Non

Active ou non l'écouteur.

Valeurs valides :

  • true : activé.

  • false : désactivé.

EndPort

Integer

Non

Non

Dernier port de la plage de ports de l'écouteur.

La valeur doit être 65535.

IdleTimeout

Integer

Non

Oui

Délai d'expiration des connexions inactives.

La valeur doit être comprise entre 1 et 60. Unité : secondes.

ListenerDescription

String

Non

Oui

Description de l'écouteur.

La description doit comporter entre 2 et 256 caractères. Elle peut contenir des lettres, des chiffres, des traits d'union (-), des barres obliques (/), des points (.) et des traits de soulignement (_).

Mss

Integer

Non

Oui

Négociation automatique MSS

Aucun

ProxyProtocolEnabled

Boolean

Non

Oui

Active ou non Proxy Protocol v2.

Valeurs valides :

  • true : activé.

  • false : désactivé.

ProxyProtocolV2Config

Map

Non

Oui

Configuration permettant d'utiliser le Proxy Protocol pour transmettre aux serveurs principaux des informations client, telles que VpcId, PrivateLinkEpId et PrivateLinkEpsId.

Pour plus d'informations, consultez Propriétés ProxyProtocolV2Config.

SecSensorEnabled

Boolean

Non

Oui

Active ou non la surveillance secondaire.

Valeurs valides :

  • true : activé.

  • false : désactivé.

SecurityPolicyId

String

Non

Oui

ID de la politique de sécurité.

Aucun

ServerGroupId

String

Non

Oui

ID du groupe de serveurs vers lequel les requêtes sont transférées.

Aucun

ServerGroupTuples

List

Non

Oui

Liste des groupes de serveurs de destination vers lesquels les requêtes sont transférées.

Liste des ID de groupes de serveurs de destination et de leurs pondérations. Pour plus d'informations, consultez Propriétés ServerGroupTuples.

StartPort

Integer

Non

Non

Premier port de la plage de ports de l'écouteur.

La valeur doit être 1.

Tags

List

Non

Oui

Liste des tags.

Pour plus d'informations, consultez Propriétés Tags.

Syntaxe ServerGroupTuples

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

Propriétés ServerGroupTuples

Nom de la propriété

Type

Obligatoire

Mise à jour autorisée

Description

Contraintes

ServerGroupId

String

Non

Oui

ID du groupe de serveurs de destination vers lequel les requêtes sont transférées.

Aucun

Weight

Integer

Non

Oui

Pondération.

Une valeur plus élevée indique une pondération plus importante. Un groupe de serveurs avec une pondération plus élevée reçoit plus de requêtes. La valeur doit être comprise entre 0 et 100.

Syntaxe ProxyProtocolV2Config

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

Propriétés ProxyProtocolV2Config

Nom de la propriété

Type

Obligatoire

Mise à jour autorisée

Description

Contraintes

Ppv2PrivateLinkEpIdEnabled

Boolean

Non

Oui

Utilise ou non le Proxy Protocol pour transmettre le PrivateLinkEpId aux serveurs principaux.

Valeurs valides :

  • true : activé.

  • false : désactivé.

Ppv2PrivateLinkEpsIdEnabled

Boolean

Non

Oui

Utilise ou non le Proxy Protocol pour transmettre le PrivateLinkEpsId aux serveurs principaux.

Valeurs valides :

  • true : activé.

  • false : désactivé.

Ppv2VpcIdEnabled

Boolean

Non

Oui

Utilise ou non le Proxy Protocol pour transmettre le VpcId aux serveurs principaux.

Valeurs valides :

  • true : activé.

  • false : désactivé.

Syntaxe Tags

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

Propriétés Tags

Nom de la propriété

Type

Obligatoire

Mise à jour autorisée

Description

Contraintes

Key

String

Oui

Non

Clé du tag.

Aucun

Value

String

Non

Non

Valeur du tag.

Aucun

Valeur de retour

Fn::GetAtt

  • ListenerPort : port frontal utilisé par l'instance SLB.

  • ListenerId : ID de l'écouteur.

Exemples

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