

Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CLI で `DescribeInstanceHealth` を使用する
<a name="elastic-load-balancing_example_elastic-load-balancing_DescribeInstanceHealth_section"></a>

次のサンプルコードは、`DescribeInstanceHealth` を使用する方法を説明しています。

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

**AWS CLI**  
**ロードバランサーのインスタンスのヘルスを記述するには**  
この例では、指定されたロードバランサーのインスタンスのヘルスを記述します。  
コマンド:  

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

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-207d9717",
          "ReasonCode": "N/A",
          "State": "InService",
          "Description": "N/A"
      },
      {
          "InstanceId": "i-afefb49b",
          "ReasonCode": "N/A",
          "State": "InService",
          "Description": "N/A"
      }
  ]
}
```
**ロードバランサーのインスタンスのヘルスを記述するには**  
この例では、指定されたロードバランサーの指定されたインスタンスのヘルスを記述します。  
コマンド:  

```
aws elb describe-instance-health --load-balancer-name {{my-load-balancer}} --instances {{i-7299c809}}
```
次は、登録しているインスタンスのレスポンスの例を次に示します。  
出力:  

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-7299c809",
          "ReasonCode": "ELB",
          "State": "OutOfService",
          "Description": "Instance registration is still in progress."
    }
  ]
}
```
次は、異常なインスタンスのレスポンスの例です。  
出力:  

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-7299c809",
          "ReasonCode": "Instance",
          "State": "OutOfService",
          "Description": "Instance has failed at least the UnhealthyThreshold number of health checks consecutively."
      }
  ]
}
```
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeInstanceHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-instance-health.html)」を参照してください。

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

**Tools for PowerShell V4**  
**例 1: この例では、指定されたロードバランサーに登録されているインスタンスの状態を記述します。**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer
```
**出力:**  

```
Description                   InstanceId                    ReasonCode                    State
-----------                   ----------                    ----------                    -----
N/A                           i-87654321                    N/A                           InService
Instance has failed at lea... i-12345678                    Instance                      OutOfService
```
**例 2: この例では、指定されたロードバランサーに登録されている指定されたインスタンスの状態を記述します。**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678
```
**例 3: この例では、指定されたインスタンスの状態の完全な説明を表示します。**  

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

```
Instance has failed at least the UnhealthyThreshold number of health checks consecutively.
```
+  API の詳細については、「*AWS Tools for PowerShell コマンドレットリファレンス (V4)*」の「[DescribeInstanceHealth](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。

**Tools for PowerShell V5**  
**例 1: この例では、指定されたロードバランサーに登録されているインスタンスの状態を記述します。**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer
```
**出力:**  

```
Description                   InstanceId                    ReasonCode                    State
-----------                   ----------                    ----------                    -----
N/A                           i-87654321                    N/A                           InService
Instance has failed at lea... i-12345678                    Instance                      OutOfService
```
**例 2: この例では、指定されたロードバランサーに登録されている指定されたインスタンスの状態を記述します。**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678
```
**例 3: この例では、指定されたインスタンスの状態の完全な説明を表示します。**  

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

```
Instance has failed at least the UnhealthyThreshold number of health checks consecutively.
```
+  API の詳細については、「*AWS Tools for PowerShell コマンドレットリファレンス (V5)*」の「[DescribeInstanceHealth](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。

------