Créer une listener rule

Vous pouvez créer une listener rule pour gérer la redirection du trafic entrant entre un load balancer et ses machines virtuelles (VM) backend.

Cette action crée une règle associée à un listener spécifié, basée sur un chemin d’accès contenu dans l’URI de la requête. Les listener rules sont traitées par ordre de priorité, de la plus grande à la plus petite.

Une fois la listener rule créée, vous devez enregistrer une ou plusieurs backends cibles avec celle-ci. Pour en savoir plus, voir Enregistrer des VM avec une listener rule.

Pour modifier la règle d’une listener rule existante, voir Modifier une listener rule. Pour afficher la règle et la liste des VM enregistrées avec une listener rule, voir Obtenir des informations sur vos listener rules.

Créer une listener rule avec OSC CLI

À ce jour, cette section est disponible en anglais uniquement.

The CreateListenerRule command creates a rule for traffic redirection for the specified listener. Each rule must have either the HostNamePattern or PathPattern parameter specified. Rules are treated in priority order, from the highest value to the lowest value.
Once the rule is created, you need to register backend VMs with it. For more information, see the RegisterVmsInLoadBalancer method.

For more information, see About Load Balancers.

Request sample: Creating a listener rule based on a host pattern

$ osc-cli api CreateListenerRule --profile "default" \
    --Listener '{
        "LoadBalancerName": "example-lbu",
        "LoadBalancerPort": 80,
      }' \
    --ListenerRule '{
        "Action": "forward",
        "HostNamePattern": "*.example.com",
        "ListenerRuleName": "example-listener-rule",
        "Priority": 10,
      }' \
    --VmIds '["i-12345678"]'

Request sample: Creating a listener rule based on a path pattern

$ osc-cli api CreateListenerRule --profile "default" \
    --Listener '{
        "LoadBalancerName": "example-lbu",
        "LoadBalancerPort": 80,
      }' \
    --ListenerRule '{
        "Action": "forward",
        "PathPattern": "/docs/*",
        "ListenerRuleName": "example-listener-rule",
        "Priority": 100,
      }' \
    --VmIds '["i-12345678"]'

This command contains the following attributes that you need to specify:

DryRun: (optional) If true, checks whether you have the required permissions to perform the action.
Listener: Information about the load balancer.
ListenerRule: Information about the listener rule.
VmIds: The IDs of the backend VMs.

The CreateListenerRule command returns the following elements:

ListenerRule: Information about the listener rule.
ResponseContext: Information about the context of the response.

Result sample: Creating a listener rule based on a host pattern

{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "ListenerRule": {
    "Priority": 10,
    "VmIds": [
      "i-12345678"
    ],
    "ListenerRuleName": "example-listener-rule",
    "Action": "forward",
    "ListenerId": 123456,
    "HostNamePattern": "*.example.com",
    "ListenerRuleId": 1234
  }
}

Result sample: Creating a listener rule based on a path pattern

{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "ListenerRule": {
    "Priority": 100,
    "VmIds": [
      "i-12345678"
    ],
    "ListenerRuleName": "example-listener-rule",
    "Action": "forward",
    "ListenerId": 123456,
    "PathPattern": "/docs/*",
    "ListenerRuleId": 1234
  }
}

Pages connexes

Méthodes API correspondantes