Obtenir des informations sur vos load balancers

Vous pouvez obtenir des informations sur vos load balancers en utilisant AWS CLI.

Obtenir des informations sur vos load balancers avec Cockpit v2

Voir le dashboard Load Balancers.

Obtenir des informations sur vos load balancers avec OSC CLI

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

The ReadLoadBalancers command lists one or more load balancers and their attributes.

Request sample

$ osc-cli api ReadLoadBalancers --profile "default" \
    --Filters '{
        "LoadBalancerNames": ["private*"],
      }'

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.
Filters: (optional) One or more filters.

The ReadLoadBalancers command returns the following elements:

LoadBalancers: Information about one or more load balancers.
ResponseContext: Information about the context of the response.

Result sample

{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "LoadBalancers": [
    {
      "Tags": [],
      "SourceSecurityGroup": {
        "SecurityGroupName": "security-group-example",
        "SecurityGroupAccountId": "123456789012"
      },
      "SecuredCookies": false,
      "PublicIp": "192.0.2.0",
      "Subnets": [
        "subnet-12345678"
      ],
      "NetId": "vpc-12345678",
      "BackendVmIds": [],
      "ApplicationStickyCookiePolicies": [],
      "SecurityGroups": [
        "sg-12345678"
      ],
      "LoadBalancerType": "internet-facing",
      "AccessLog": {
        "PublicationInterval": 60,
        "IsEnabled": false
      },
      "DnsName": "private-lb-example.123456789.eu-west-2.lbu.outscale.com",
      "HealthCheck": {
        "UnhealthyThreshold": 2,
        "Timeout": 5,
        "CheckInterval": 30,
        "Protocol": "TCP",
        "HealthyThreshold": 10,
        "Port": 80
      },
      "LoadBalancerStickyCookiePolicies": [],
      "SubregionNames": [
        "eu-west-2a"
      ],
      "Listeners": [
        {
          "ServerCertificateId": "orn:ows:idauth::012345678910:server-certificate/Certificate",
          "BackendPort": 80,
          "BackendProtocol": "HTTP",
          "LoadBalancerPort": 443,
          "LoadBalancerProtocol": "HTTPS"
        }
      ],
      "LoadBalancerName": "private-lb-example"
    }
  ]
}

Obtenir des informations sur vos load balancers avec AWS CLI

Obtenir des informations générales sur vos load balancers

Pour obtenir des informations sur un ou plusieurs load balancers, utilisez la commande describe-load-balancer suivant cette syntaxe :

Exemple de requête

$ aws elb describe-load-balancers \
    --profile YOUR_PROFILE \
    --load-balancer-names my-load-balancer \
    --endpoint https://lbu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

(optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.
(optionnel) load-balancer-names : Le nom d’un ou plusieurs load balancers.

Si vous ne spécifiez aucun nom de load balancer, la requête renvoie une description de l’ensemble de vos load balancers.
endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande describe-load-balancers renvoie les éléments suivants :

LoadBalancerDescriptions : Informations à propos d’un ou plusieurs load balancers. Cet élément contient les informations suivantes pour chaque load balancer :
- Subnets : L’ID du subnet dans lequel le load balancer a été créé, si celui-ci est dans un VPC.
- ListenerDescriptions : Informations à propos d’un ou plusieurs listeners ajoutés au load balancer. Cet élément contient les informations suivantes pour chaque listener :
  - Listener : Informations à propos d’un listener :
    
    InstancePort : Le port sur lequel les instances backend écoutent.
    
    LoadBalancerPort : Le port sur lequel le load balancer écoute.
    
    Protocol : Le protocole de routage du load balancer ( HTTP, HTTPS, TCP ou SSL ).
    
    InstanceProtocol : Le protocole utilisé pour router le trafic vers les instances backend ( HTTP ou TCP ).
  - PolicyNames : Le nom des politiques mises en places pour le load balancer, s’il y en a.
- HealthCheck : Informations à propos de la configuration du health check pour le load balancer. Cet élément contient les informations suivantes :
  - HealthyThreshold : Le nombre de requêtes réussies consécutives nécessaires pour considérer l’instance comme saine.
  - Interval : Le nombre de secondes entre deux requêtes.
  - Target : Le port et le protocole pour les instances backend ciblées par les health checks (et le chemin à vérifier pour le protocole HTTP).
  - Timeout : Le temps d’attente maximum d’une réponse avant de considérer la requête comme non réussie, en secondes.
  - UnhealthyThreshold : Le nombre de requêtes non réussies consécutives pour considérer l’instance comme non saine.
- VPCId : L’ID du VPC pour le load balancer, s’il y en a un.
- BackendServerDescriptions : Informations à propos des instances backend. Cet élément contient les informations suivantes pour chaque instance backend :
  - InstancePort : Le port sur lequel les instances backend écoutent.
  - PolicyNames : Le nom des politiques activées pour les instances backend, s’il y en a.
- Instances : Informations à propos d’une ou plusieurs instances backend. Cet élément contient l’information suivante pour chaque instance backend :
  - InstanceId : L’ID de l’instance backend.
- DNSName : Le nom DNS du load balancer.
- SecurityGroups : Les security groups pour le load balancer, si celui-ci est dans un VPC.
- Policies : Informations à propos des politiques pour le load balancer, s’il y en a :
  - LBCookieStickinessPolicies : Le nom de la politique utilisée pour les permanences de sessions basées sur la durée.
  - AppCookieStickinessPolicies : Le nom de la politique pour les permanences de sessions contrôlées par application.
  - OtherPolicies : Le nom de politiques autres que les politiques de permanences de sessions.
- LoadBalancerName : Le nom du load balancer.
- CreatedTime : La date et l’heure de création du load balancer.
- AvailabilityZones : L’ID de l’Availability Zone (AZ) dans laquelle le load balancer a été créé. Dans le Cloud public, c’est l’AZ spécifiée lors de la création du load balancer. Dans un VPC, c’est l’AZ qui correspond au subnet spécifié lors de la création du load balancer.
- Scheme : Le type de load balancer. Pour en savoir plus, voir À propos des load balancers > Types de load balancers.

Exemple de résultat

{
  "LoadBalancerDescriptions": [
    {
      "Subnets": [
          "subnet-12345678"
      ],
      "ListenerDescriptions": [
          {
              "Listener": {
                  "InstancePort": 80,
                  "LoadBalancerPort": 80,
                  "Protocol": "HTTP",
                  "InstanceProtocol": "HTTP"
              },
              "PolicyNames": []
          },
      ],
      "HealthCheck": {
          "HealthyThreshold": 3,
          "Interval": 15,
          "Target": "HTTP:80/index.html",
          "Timeout": 3,
          "UnhealthyThreshold": 3
      },
      "VPCId": "vpc-87654321",
      "BackendServerDescriptions": [
          {
              "InstancePort": 80,
              "PolicyNames": []
          }
      ],
      "Instances": [
          {
              "InstanceId": "i-56781234"
          },
          {
              "InstanceId": "i-43218765"
          }
      ],
      "DNSName": "my-load-balancer-1234567890.lbu.eu-west-2.outscale.com",
      "SecurityGroups": [
          "sg-18273465"
      ],
      "Policies": {
          "LBCookieStickinessPolicies": [],
          "AppCookieStickinessPolicies": [],
          "OtherPolicies": []
      },
      "LoadBalancerName": "my-load-balancer",
      "CreatedTime": "2016-05-12T05:22:08.364Z",
      "AvailabilityZones": [
          "eu-west-2a"
      ],
      "Scheme": "internet-facing",
      "SourceSecurityGroup": {
          "OwnerAlias": "123456789012",
          "GroupName": "my-lb-sg"
      }
    }
  ]
}

Obtenir des informations sur les attributs de vos load balancers

Pour obtenir des informations sur les attributs d’un load balancer, utilisez la commande describe-load-balancer-attributes suivant cette syntaxe :

Exemple de requête

$ aws elb describe-load-balancer-attributes \
    --profile YOUR_PROFILE \
    --load-balancer-name LOAD_BALANCER_NAME \
    --endpoint https://lbu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

(optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.
load-balancer-name : Le nom du load balancer dont vous voulez obtenir les attributs.
endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande describe-load-balancer-attributes renvoie les éléments suivants :

LoadBalancerAttributes : Informations sur les attributs du load balancer. Cet élément contient les informations suivantes :
- AccessLog : Informations sur la publication des access logs. Cet élément contient les informations suivantes :
  - Enabled : Si true, les access logs sont activés pour le load balancer spécifié. Si false, ils ne le sont pas.
  - S3BucketName : Le nom du bucket OOS dans lequel les access logs sont publiés. Pour en savoir plus, voir À propos d’OOS.
  - EmitInterval : L’intervalle de temps pour la publication des access logs dans le bucket OOS, en minutes. Cette valeur peut être 5 ou 60 (par défaut, 60).
  - S3BucketPrefix : Le chemin d’accès au répertoire dans votre bucket OOS dans lequel les access logs sont publiés (par défaut, le niveau root du bucket).
- ConnectionDraining : Informations sur le drainage des connexions. Cet élément contient les informations suivantes :
  - Enabled : Si true, le drainage de connexion est activé pour votre load balancer. Si false, il ne l’est pas.
  - Timeout : La durée maximum en secondes durant laquelle le load balancer laisse les connexions ouvertes avant de désenregistrer les instances.
- ConnectionSettings : Informations sur le délai d’inactivité des connexions. Cet élément contient les informations suivantes :
  - IdleTimeout : La durée d’inactivité de la connexion en secondes avant sa fermeture par le load balancer.
- AdditionalAttributes : Informations sur les attributs additionnels des load balancers. Cet élément contient les informations suivantes :
  - Key : Le nom de l’attribut, par exemple SecuredCookies.
  - Value : La valeur de l’attribut. Si le nom de l’attribut est SecuredCookies et sa valeur est true, les cookies sécurisés sont activés. Si false, ils sont désactivés.

Exemple de résultat

{
    "LoadBalancerAttributes": {
        "AccessLog": {
            "Enabled": true,
            "S3BucketName": "BUCKET_NAME",
            "EmitInterval": 60,
            "S3BucketPrefix": "BUCKET_PREFIX"
        },
        "ConnectionDraining": {
            "Enabled": true,
            "Timeout": 1
        },
        "ConnectionSettings": {
            "IdleTimeout": 1
        },
        "AdditionalAttributes": [
            {
                "Key": "SecuredCookies",
                "Value": "true"
            }
        ]
    }
}

Pages connexes

Méthodes API correspondantes

AWS™ et Amazon Web Services™ sont des marques de commerce d’Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.