# Utilisation de l'endpoint API CreateListenerRule

## Description
Cette méthode permet de creating a listener rule based on a host pattern.

## Endpoint API
L'endpoint API à utiliser est `/CreateListenerRule`.

## Méthode HTTP
La méthode HTTP à utiliser est `post`.

## En-têtes et authentification
Assurez-vous d'inclure les en-têtes suivants dans votre requête :
- `Content-Type: application/json` : Indique le type de contenu de la requête
- `Authorization` : Utilisez l'authentification AWS Signature Version 4 (AWS-SigV4)

## Paramètres de requête
### Paramètres requis :
Aucun paramètre requis

### Paramètres optionnels :
- `Listener` : Valeur de type dict (optionnel)
- `ListenerRule` : Valeur de type dict (optionnel)
- `VmIds` : Liste de VmIds (ex: ["i-12345678"]) (optionnel)

### Exemple de structure JSON :
{
  "Listener": {
    "LoadBalancerName": "example-lbu",
    "LoadBalancerPort": 80
  },
  "ListenerRule": {
    "Action": "forward",
    "HostNamePattern": "*.example.com",
    "ListenerRuleName": "example-listener-rule",
    "Priority": 10
  },
  "VmIds": [
    "i-12345678"
  ]
}

## Exemple de requête cURL
```bash
curl -X POST https://api.$OSC_REGION.outscale.com/api/v1/CreateListenerRule \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'osc' \
  --header 'Content-Type: application/json' \
  --data '{"Listener": {"LoadBalancerName": "example-lbu", "LoadBalancerPort": 80}, "ListenerRule": {"Action": "forward", "HostNamePattern": "*.example.com", "ListenerRuleName": "example-listener-rule", "Priority": 10}, "VmIds": ["i-12345678"]}'
```

## Notes importantes
- Assurez-vous d'avoir les autorisations nécessaires
- Remplacez $OSC_REGION, $OSC_ACCESS_KEY et $OSC_SECRET_KEY par vos valeurs
- Vérifiez que tous les paramètres requis sont fournis
- Les paramètres optionnels peuvent être omis selon vos besoins
Ordres utilisateur possibles :
1. Exécute creating a listener rule based on a host pattern avec les paramètres requis
2. Configure les options pour creating a listener rule based on a host pattern
3. Applique cette configuration pour creating a listener rule based on a host pattern
4. Utilise l'API pour creating a listener rule based on a host pattern
curl -X POST https://api.$OSC_REGION.outscale.com/api/v1/CreateListenerRule \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'osc' \
  --header 'Content-Type: application/json' \
  --data '{"Listener": {"LoadBalancerName": "example-lbu", "LoadBalancerPort": 80}, "ListenerRule": {"Action": "forward", "HostNamePattern": "*.example.com", "ListenerRuleName": "example-listener-rule", "Priority": 10}, "VmIds": ["i-12345678"]}'
curl -X GET https://api.$OSC_REGION.outscale.com/api/v1/CreateListenerRule \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'osc' \
  --header 'Content-Type: application/json' \
  --data '{"Listener": {"LoadBalancerName": "example-lbu", "LoadBalancerPort": 80}, "ListenerRule": {"Action": "forward", "HostNamePattern": "*.example.com", "ListenerRuleName": "example-listener-rule", "Priority": 10}, "VmIds": ["i-12345678"]}'