

Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Utilizar `DescribeInstanceHealth` con una CLI
<a name="elastic-load-balancing_example_elastic-load-balancing_DescribeInstanceHealth_section"></a>

Los siguientes ejemplos de código muestran cómo utilizar `DescribeInstanceHealth`.

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

**AWS CLI**  
**Para describir el estado de las instancias de un equilibrador de carga**  
En este ejemplo, se describe el estado de las instancias del equilibrador de carga especificado.  
Comando:  

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

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-207d9717",
          "ReasonCode": "N/A",
          "State": "InService",
          "Description": "N/A"
      },
      {
          "InstanceId": "i-afefb49b",
          "ReasonCode": "N/A",
          "State": "InService",
          "Description": "N/A"
      }
  ]
}
```
**Para describir el estado de una instancia de un equilibrador de carga**  
En este ejemplo, se describe el estado de la instancia especificada del equilibrador de carga especificado.  
Comando:  

```
aws elb describe-instance-health --load-balancer-name {{my-load-balancer}} --instances {{i-7299c809}}
```
A continuación, se muestra un ejemplo de respuesta para una instancia que se está registrando.  
Salida:  

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-7299c809",
          "ReasonCode": "ELB",
          "State": "OutOfService",
          "Description": "Instance registration is still in progress."
    }
  ]
}
```
A continuación, se muestra un ejemplo de respuesta para una instancia en mal estado.  
Salida:  

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-7299c809",
          "ReasonCode": "Instance",
          "State": "OutOfService",
          "Description": "Instance has failed at least the UnhealthyThreshold number of health checks consecutively."
      }
  ]
}
```
+  Para obtener más información sobre la API, consulte [DescribeInstanceHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-instance-health.html)la *Referencia de AWS CLI comandos*. 

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

**Herramientas para la PowerShell versión 4**  
**Ejemplo 1: En este ejemplo se describe el estado de las instancias registradas en el equilibrador de carga especificado.**  

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

```
Description                   InstanceId                    ReasonCode                    State
-----------                   ----------                    ----------                    -----
N/A                           i-87654321                    N/A                           InService
Instance has failed at lea... i-12345678                    Instance                      OutOfService
```
**Ejemplo 2: En este ejemplo se describe el estado de la instancia registrada en el equilibrador de carga especificado.**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Ejemplo 3: En este ejemplo se muestra la descripción completa del estado de la instancia especificada.**  

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

```
Instance has failed at least the UnhealthyThreshold number of health checks consecutively.
```
+  Para obtener más información sobre la API, consulte [DescribeInstanceHealth Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*. 

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: En este ejemplo se describe el estado de las instancias registradas en el equilibrador de carga especificado.**  

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

```
Description                   InstanceId                    ReasonCode                    State
-----------                   ----------                    ----------                    -----
N/A                           i-87654321                    N/A                           InService
Instance has failed at lea... i-12345678                    Instance                      OutOfService
```
**Ejemplo 2: En este ejemplo se describe el estado de la instancia registrada en el equilibrador de carga especificado.**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Ejemplo 3: En este ejemplo se muestra la descripción completa del estado de la instancia especificada.**  

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

```
Instance has failed at least the UnhealthyThreshold number of health checks consecutively.
```
+  Para obtener más información sobre la API, consulte [DescribeInstanceHealth](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). 

------