

D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation de `DescribeInstanceHealth` avec une CLI
<a name="elastic-load-balancing_example_elastic-load-balancing_DescribeInstanceHealth_section"></a>

Les exemples de code suivants illustrent comment utiliser `DescribeInstanceHealth`.

------
#### [ CLI ]

**AWS CLI**  
**Pour décrire l’état des instances d’un équilibreur de charge**  
Cet exemple décrit l’état des instances de l’équilibreur de charge spécifié.  
Commande :  

```
aws elb describe-instance-health --load-balancer-name {{my-load-balancer}}
```
Sortie :  

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-207d9717",
          "ReasonCode": "N/A",
          "State": "InService",
          "Description": "N/A"
      },
      {
          "InstanceId": "i-afefb49b",
          "ReasonCode": "N/A",
          "State": "InService",
          "Description": "N/A"
      }
  ]
}
```
**Pour décrire l’état d’une instance d’un équilibreur de charge**  
Cet exemple décrit l’état de santé de l’instance spécifiée pour l’équilibreur de charge spécifié.  
Commande :  

```
aws elb describe-instance-health --load-balancer-name {{my-load-balancer}} --instances {{i-7299c809}}
```
Voici un exemple de réponse pour une instance en cours d’enregistrement.  
Sortie :  

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-7299c809",
          "ReasonCode": "ELB",
          "State": "OutOfService",
          "Description": "Instance registration is still in progress."
    }
  ]
}
```
Voici un exemple de réponse pour une instance défectueuse.  
Sortie :  

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-7299c809",
          "ReasonCode": "Instance",
          "State": "OutOfService",
          "Description": "Instance has failed at least the UnhealthyThreshold number of health checks consecutively."
      }
  ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeInstanceHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-instance-health.html)à la section *Référence des AWS CLI commandes*. 

------
#### [ PowerShell ]

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple décrit l’état des instances enregistrées auprès de l’équilibreur de charge spécifié.**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer
```
**Sortie** :  

```
Description                   InstanceId                    ReasonCode                    State
-----------                   ----------                    ----------                    -----
N/A                           i-87654321                    N/A                           InService
Instance has failed at lea... i-12345678                    Instance                      OutOfService
```
**Exemple 2 : cet exemple décrit l’état de l’instances spécifiée enregistrée auprès de l’équilibreur de charge spécifié.**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Exemple 3 : cet exemple affiche la description complète de l’état de l’instance spécifiée.**  

```
(Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678).Description
```
**Sortie** :  

```
Instance has failed at least the UnhealthyThreshold number of health checks consecutively.
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeInstanceHealth](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

**Outils pour PowerShell V5**  
**Exemple 1 : cet exemple décrit l’état des instances enregistrées auprès de l’équilibreur de charge spécifié.**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer
```
**Sortie** :  

```
Description                   InstanceId                    ReasonCode                    State
-----------                   ----------                    ----------                    -----
N/A                           i-87654321                    N/A                           InService
Instance has failed at lea... i-12345678                    Instance                      OutOfService
```
**Exemple 2 : cet exemple décrit l’état de l’instances spécifiée enregistrée auprès de l’équilibreur de charge spécifié.**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Exemple 3 : cet exemple affiche la description complète de l’état de l’instance spécifiée.**  

```
(Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678).Description
```
**Sortie** :  

```
Instance has failed at least the UnhealthyThreshold number of health checks consecutively.
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeInstanceHealth](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. 

------