# Utilisation de l'endpoint API CreateLoadBalancer

## Description
Cette méthode permet de creating an internet-facing load balancer in the public cloud.

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

## 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 :
- `LoadBalancerName` : L'identifiant LoadBalancerName (ex: "public-lb-example") (optionnel)
- `SubregionNames` : Liste de SubregionNames (ex: ["eu-west-2a"]) (optionnel)
- `Listeners` : Liste de Listeners (ex: [{"BackendPort": 8080, "BackendProtocol": "HTTP", "LoadBalancerPort": 8080, "LoadBalancerProtocol": "HTTP"}]) (optionnel)

### Exemple de structure JSON :
{
  "LoadBalancerName": "public-lb-example",
  "SubregionNames": [
    "eu-west-2a"
  ],
  "Listeners": [
    {
      "BackendPort": 8080,
      "BackendProtocol": "HTTP",
      "LoadBalancerPort": 8080,
      "LoadBalancerProtocol": "HTTP"
    }
  ]
}

## Exemple de requête cURL
```bash
curl -X POST https://api.$OSC_REGION.outscale.com/api/v1/CreateLoadBalancer \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'osc' \
  --header 'Content-Type: application/json' \
  --data '{"LoadBalancerName": "public-lb-example", "SubregionNames": ["eu-west-2a"], "Listeners": [{"BackendPort": 8080, "BackendProtocol": "HTTP", "LoadBalancerPort": 8080, "LoadBalancerProtocol": "HTTP"}]}'
```

## 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 an internet-facing load balancer in the public cloud avec les paramètres requis
2. Configure les options pour creating an internet-facing load balancer in the public cloud
3. Applique cette configuration pour creating an internet-facing load balancer in the public cloud
4. Utilise l'API pour creating an internet-facing load balancer in the public cloud
curl -X POST https://api.$OSC_REGION.outscale.com/api/v1/CreateLoadBalancer \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'osc' \
  --header 'Content-Type: application/json' \
  --data '{"LoadBalancerName": "public-lb-example", "SubregionNames": ["eu-west-2a"], "Listeners": [{"BackendPort": 8080, "BackendProtocol": "HTTP", "LoadBalancerPort": 8080, "LoadBalancerProtocol": "HTTP"}]}'
curl -X POST https://api.$OSC_REGION.outscale.com/api/v1/CreateLoadBalancer \
  --user wrong_access_key:wrong_secret_key \
  --aws-sigv4 'osc' \
  --header 'Content-Type: text/plain' \
  --data '{"LoadBalancerName": "public-lb-example", "SubregionNames": ["eu-west-2a"], "Listeners": [{"BackendPort": 8080, "BackendProtocol": "HTTP", "LoadBalancerPort": 8080, "LoadBalancerProtocol": "HTTP"}]}'