

文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 [AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 搭配使用 `DescribeInstanceHealth` 與 CLI
<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 Cmdlet 參考 (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 Cmdlet 參考 (V5)》**中的 [DescribeInstanceHealth](https://docs.aws.amazon.com/powershell/v5/reference)。

------