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

# Elastic Load Balancing - 使用 的第 1 版範例 AWS CLI
<a name="cli_elastic-load-balancing_code_examples"></a>

下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 Elastic Load Balancing - 第 1 版，來執行動作並實作常見案例。

*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。

每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。

**Topics**
+ [動作](#actions)

## 動作
<a name="actions"></a>

### `add-tags`
<a name="elastic-load-balancing_AddTags_cli_topic"></a>

以下程式碼範例顯示如何使用 `add-tags`。

**AWS CLI**  
**將標籤新增至負載平衡器**  
此範例會將標籤新增至指定的負載平衡器。  
命令：  

```
aws elb add-tags --load-balancer-name my-load-balancer --tags "Key=project,Value=lima" "Key=department,Value=digital-media"
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [AddTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/add-tags.html)。

### `apply-security-groups-to-load-balancer`
<a name="elastic-load-balancing_ApplySecurityGroupsToLoadBalancer_cli_topic"></a>

以下程式碼範例顯示如何使用 `apply-security-groups-to-load-balancer`。

**AWS CLI**  
**無法將安全群組與負載平衡器相關聯**  
此範例會為安全群組與 VPC 中指定的負載平衡器建立關聯。  
命令：  

```
aws elb apply-security-groups-to-load-balancer --load-balancer-name my-load-balancer --security-groups sg-fc448899
```
輸出：  

```
{
  "SecurityGroups": [
      "sg-fc448899"
  ]
}
```
+  如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [ApplySecurityGroupsToLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/apply-security-groups-to-load-balancer.html)。

### `attach-load-balancer-to-subnets`
<a name="elastic-load-balancing_AttachLoadBalancerToSubnets_cli_topic"></a>

以下程式碼範例顯示如何使用 `attach-load-balancer-to-subnets`。

**AWS CLI**  
**將子網路連接到負載平衡器**  
此範例會將指定的子網路，新增至指定之負載平衡器的已設定子網路集中。  
命令：  

```
aws elb attach-load-balancer-to-subnets --load-balancer-name my-load-balancer --subnets subnet-0ecac448
```
輸出：  

```
{
   "Subnets": [
       "subnet-15aaab61",
       "subnet-0ecac448"
   ]
}
```
+  如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [AttachLoadBalancerToSubnets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/attach-load-balancer-to-subnets.html)。

### `configure-health-check`
<a name="elastic-load-balancing_ConfigureHealthCheck_cli_topic"></a>

以下程式碼範例顯示如何使用 `configure-health-check`。

**AWS CLI**  
**指定後端 EC2 執行個體的運作狀態檢查設定**  
此範例會指定用於評估後端 EC2 執行個體運作狀態的運作狀態檢查設定。  
命令：  

```
aws elb configure-health-check --load-balancer-name my-load-balancer --health-check Target=HTTP:80/png,Interval=30,UnhealthyThreshold=2,HealthyThreshold=2,Timeout=3
```
輸出：  

```
{
   "HealthCheck": {
       "HealthyThreshold": 2,
       "Interval": 30,
       "Target": "HTTP:80/png",
       "Timeout": 3,
       "UnhealthyThreshold": 2
   }
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ConfigureHealthCheck](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/configure-health-check.html)。

### `create-app-cookie-stickiness-policy`
<a name="elastic-load-balancing_CreateAppCookieStickinessPolicy_cli_topic"></a>

以下程式碼範例顯示如何使用 `create-app-cookie-stickiness-policy`。

**AWS CLI**  
**為您的 HTTPS 負載平衡器產生黏性政策**  
此範例會產生一個黏性政策，該政策遵循應用程式產生的 cookie 的黏性工作階段生命週期。  
命令：  

```
aws elb create-app-cookie-stickiness-policy --load-balancer-name my-load-balancer --policy-name my-app-cookie-policy --cookie-name my-app-cookie
```
+  如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [CreateAppCookieStickinessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/create-app-cookie-stickiness-policy.html)。

### `create-lb-cookie-stickiness-policy`
<a name="elastic-load-balancing_CreateLbCookieStickinessPolicy_cli_topic"></a>

以下程式碼範例顯示如何使用 `create-lb-cookie-stickiness-policy`。

**AWS CLI**  
**為您的 HTTPS 負載平衡器產生以持續時間為基礎的黏性政策**  
此範例會產生一個黏性政策，其中包含由指定之到期期限控制的黏性工作階段生命週期。  
命令：  

```
aws elb create-lb-cookie-stickiness-policy --load-balancer-name my-load-balancer --policy-name my-duration-cookie-policy --cookie-expiration-period 60
```
+  如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [CreateLbCookieStickinessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/create-lb-cookie-stickiness-policy.html)。

### `create-load-balancer-listeners`
<a name="elastic-load-balancing_CreateLoadBalancerListeners_cli_topic"></a>

以下程式碼範例顯示如何使用 `create-load-balancer-listeners`。

**AWS CLI**  
**為負載平衡器建立 HTTP 接聽程式**  
此範例會使用 HTTP 通訊協定，在連接埠 80 為您的負載平衡器建立接聽程式。  
命令：  

```
aws elb create-load-balancer-listeners --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80"
```
**建立負載平衡器的 HTTPS 接聽程式**  
此範例會使用 HTTPS 通訊協定，在連接埠 443 為您的負載平衡器建立接聽程式。  
命令：  

```
aws elb create-load-balancer-listeners --load-balancer-name my-load-balancer --listeners "Protocol=HTTPS,LoadBalancerPort=443,InstanceProtocol=HTTP,InstancePort=80"
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateLoadBalancerListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/create-load-balancer-listeners.html)。

### `create-load-balancer-policy`
<a name="elastic-load-balancing_CreateLoadBalancerPolicy_cli_topic"></a>

以下程式碼範例顯示如何使用 `create-load-balancer-policy`。

**AWS CLI**  
**建立一個在負載平衡器上啟用 Proxy Protocol 的政策**  
此範例會建立一個政策，即為在指定的負載平衡器上啟用 Proxy Protocol。  
命令：  

```
aws elb create-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-ProxyProtocol-policy --policy-type-name ProxyProtocolPolicyType --policy-attributes AttributeName=ProxyProtocol,AttributeValue=true
```
**使用建議的安全政策建立 SSL 溝通政策**  
此範例會使用建議的安全政策，為指定的 HTTPS 負載平衡器建立 SSL 溝通政策。  
命令：  

```
aws elb create-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-SSLNegotiation-policy --policy-type-name SSLNegotiationPolicyType --policy-attributes AttributeName=Reference-Security-Policy,AttributeValue=ELBSecurityPolicy-2015-03
```
**使用自訂安全政策建立 SSL 溝通政策**  
此範例會透過啟用通訊協定和密碼，使用自訂安全政策為您的 HTTPS 負載平衡器建立 SSL 溝通政策。  
命令：  

```
aws elb create-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-SSLNegotiation-policy --policy-type-name SSLNegotiationPolicyType --policy-attributes AttributeName=Protocol-SSLv3,AttributeValue=true AttributeName=Protocol-TLSv1.1,AttributeValue=true AttributeName=DHE-RSA-AES256-SHA256,AttributeValue=true AttributeName=Server-Defined-Cipher-Order,AttributeValue=true
```
**建立公有金鑰政策**  
此範例會建立公有金鑰政策。  
命令：  

```
aws elb create-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-PublicKey-policy --policy-type-name PublicKeyPolicyType --policy-attributes AttributeName=PublicKey,AttributeValue=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwAYUjnfyEyXr1pxjhFWBpMlggUcqoi3kl+dS74kj//c6x7ROtusUaeQCTgIUkayttRDWchuqo1pHC1u+n5xxXnBBe2ejbb2WRsKIQ5rXEeixsjFpFsojpSQKkzhVGI6mJVZBJDVKSHmswnwLBdofLhzvllpovBPTHe+o4haAWvDBALJU0pkSI1FecPHcs2hwxf14zHoXy1e2k36A64nXW43wtfx5qcVSIxtCEOjnYRg7RPvybaGfQ+v6Iaxb/+7J5kEvZhTFQId+bSiJImF1FSUT1W1xwzBZPUbcUkkXDj45vC2s3Z8E+Lk7a3uZhvsQHLZnrfuWjBWGWvZ/MhZYgEXAMPLE
```
**建立後端伺服器驗證政策**  
此範例會建立後端伺服器驗證政策，以使用公有金鑰政策在您的後端執行個體上啟用驗證。  
命令：  

```
aws elb create-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-authentication-policy --policy-type-name BackendServerAuthenticationPolicyType --policy-attributes AttributeName=PublicKeyPolicyName,AttributeValue=my-PublicKey-policy
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateLoadBalancerPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/create-load-balancer-policy.html)。

### `create-load-balancer`
<a name="elastic-load-balancing_CreateLoadBalancer_cli_topic"></a>

以下程式碼範例顯示如何使用 `create-load-balancer`。

**AWS CLI**  
**建立 HTTP 負載平衡器**  
此範例會在 VPC 中建立具有 HTTP 接聽程式的負載平衡器。  
命令：  

```
aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" --subnets subnet-15aaab61 --security-groups sg-a61988c3
```
輸出：  

```
{
    "DNSName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com"
}
```
此範例會在 EC2-Classic 中建立具有 HTTP 接聽程式的負載平衡器。  
命令：  

```
aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" --availability-zones us-west-2a us-west-2b
```
輸出：  

```
{
    "DNSName": "my-load-balancer-123456789.us-west-2.elb.amazonaws.com"
}
```
**建立 HTTPS 負載平衡器**  
此範例會在 VPC 中建立具有 HTTPS 接聽程式的負載平衡器。  
命令：  

```
aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" "Protocol=HTTPS,LoadBalancerPort=443,InstanceProtocol=HTTP,InstancePort=80,SSLCertificateId=arn:aws:iam::123456789012:server-certificate/my-server-cert" --subnets subnet-15aaab61 --security-groups sg-a61988c3
```
輸出：  

```
{
    "DNSName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com"
}
```
此範例會在 EC2-Classic 中建立具有 HTTPS 接聽程式的負載平衡器。  
命令：  

```
aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" "Protocol=HTTPS,LoadBalancerPort=443,InstanceProtocol=HTTP,InstancePort=80,SSLCertificateId=arn:aws:iam::123456789012:server-certificate/my-server-cert" --availability-zones us-west-2a us-west-2b
```
輸出：  

```
{
    "DNSName": "my-load-balancer-123456789.us-west-2.elb.amazonaws.com"
}
```
**建立內部負載平衡器**  
此範例會在 VPC 中建立具有 HTTP 接聽程式的內部負載平衡器。  
命令：  

```
aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" --scheme internal --subnets subnet-a85db0df --security-groups sg-a61988c3
```
輸出：  

```
{
    "DNSName": "internal-my-load-balancer-123456789.us-west-2.elb.amazonaws.com"
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/create-load-balancer.html)。

### `delete-load-balancer-listeners`
<a name="elastic-load-balancing_DeleteLoadBalancerListeners_cli_topic"></a>

以下程式碼範例顯示如何使用 `delete-load-balancer-listeners`。

**AWS CLI**  
**刪除負載平衡器的接聽程式**  
此範例會從指定的負載平衡器刪除指定連接埠的接聽程式。  
命令：  

```
aws elb delete-load-balancer-listeners --load-balancer-name my-load-balancer --load-balancer-ports 80
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteLoadBalancerListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/delete-load-balancer-listeners.html)。

### `delete-load-balancer-policy`
<a name="elastic-load-balancing_DeleteLoadBalancerPolicy_cli_topic"></a>

以下程式碼範例顯示如何使用 `delete-load-balancer-policy`。

**AWS CLI**  
**從負載平衡器刪除政策**  
此範例會從指定的負載平衡器刪除指定的政策。不得在任何接聽程式上啟用此政策。  
命令：  

```
aws elb delete-load-balancer-policy --load-balancer-name my-load-balancer --policy-name my-duration-cookie-policy
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteLoadBalancerPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/delete-load-balancer-policy.html)。

### `delete-load-balancer`
<a name="elastic-load-balancing_DeleteLoadBalancer_cli_topic"></a>

以下程式碼範例顯示如何使用 `delete-load-balancer`。

**AWS CLI**  
**刪除負載平衡器**  
此範例會刪除指定的負載平衡器。  
命令：  

```
aws elb delete-load-balancer --load-balancer-name my-load-balancer
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/delete-load-balancer.html)。

### `deregister-instances-from-load-balancer`
<a name="elastic-load-balancing_DeregisterInstancesFromLoadBalancer_cli_topic"></a>

以下程式碼範例顯示如何使用 `deregister-instances-from-load-balancer`。

**AWS CLI**  
**從負載平衡器撤銷執行個體**  
從指定的負載平衡器撤銷指定的執行個體。  
命令：  

```
aws elb deregister-instances-from-load-balancer --load-balancer-name my-load-balancer --instances i-d6f6fae3
```
輸出：  

```
{
    "Instances": [
        {
            "InstanceId": "i-207d9717"
        },
        {
            "InstanceId": "i-afefb49b"
        }
    ]
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeregisterInstancesFromLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/deregister-instances-from-load-balancer.html)。

### `describe-account-limits`
<a name="elastic-load-balancing_DescribeAccountLimits_cli_topic"></a>

以下程式碼範例顯示如何使用 `describe-account-limits`。

**AWS CLI**  
**描述 Classic Load Balancer 限制**  
下列`describe-account-limits`範例顯示您 AWS 帳戶 Classic Load Balancer 限制的詳細資訊。  

```
aws elb describe-account-limits
```
輸出：  

```
{
    "Limits": [
        {
            "Name": "classic-load-balancers",
            "Max": "20"
        },
        {
            "Name": "classic-listeners",
            "Max": "100"
        },
        {
            "Name": "classic-registered-instances",
            "Max": "1000"
        }
    ]
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeAccountLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-account-limits.html)。

### `describe-instance-health`
<a name="elastic-load-balancing_DescribeInstanceHealth_cli_topic"></a>

以下程式碼範例顯示如何使用 `describe-instance-health`。

**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)。

### `describe-load-balancer-attributes`
<a name="elastic-load-balancing_DescribeLoadBalancerAttributes_cli_topic"></a>

以下程式碼範例顯示如何使用 `describe-load-balancer-attributes`。

**AWS CLI**  
**描述負載平衡器的屬性**  
此範例描述指定之負載平衡器的屬性。  
命令：  

```
aws elb describe-load-balancer-attributes --load-balancer-name my-load-balancer
```
輸出：  

```
{
  "LoadBalancerAttributes": {
      "ConnectionDraining": {
          "Enabled": false,
          "Timeout": 300
      },
      "CrossZoneLoadBalancing": {
          "Enabled": true
      },
      "ConnectionSettings": {
          "IdleTimeout": 30
      },
      "AccessLog": {
          "Enabled": false
    }
  }
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeLoadBalancerAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-load-balancer-attributes.html)。

### `describe-load-balancer-policies`
<a name="elastic-load-balancing_DescribeLoadBalancerPolicies_cli_topic"></a>

以下程式碼範例顯示如何使用 `describe-load-balancer-policies`。

**AWS CLI**  
**描述與負載平衡器相關聯的所有政策**  
此範例描述與指定之負載平衡器相關聯的所有政策。  
命令：  

```
aws elb describe-load-balancer-policies --load-balancer-name my-load-balancer
```
輸出：  

```
{
  "PolicyDescriptions": [
    {
      "PolicyAttributeDescriptions": [
        {
          "AttributeName": "ProxyProtocol",
          "AttributeValue": "true"
        }
      ],
      "PolicyName": "my-ProxyProtocol-policy",
      "PolicyTypeName": "ProxyProtocolPolicyType"
    },
    {
        "PolicyAttributeDescriptions": [
            {
                "AttributeName": "CookieName",
                "AttributeValue": "my-app-cookie"
            }
        ],
        "PolicyName": "my-app-cookie-policy",
        "PolicyTypeName": "AppCookieStickinessPolicyType"
    },
    {
      "PolicyAttributeDescriptions": [
        {
          "AttributeName": "CookieExpirationPeriod",
          "AttributeValue": "60"
        }
      ],
      "PolicyName": "my-duration-cookie-policy",
      "PolicyTypeName": "LBCookieStickinessPolicyType"
    },
    .
    .
    .
  ]
}
```
**描述與負載平衡器相關聯的特定政策**  
此範例描述與指定負載平衡器相關聯的指定政策。  
命令：  

```
aws elb describe-load-balancer-policies --load-balancer-name my-load-balancer --policy-name my-authentication-policy
```
輸出：  

```
{
  "PolicyDescriptions": [
      {
          "PolicyAttributeDescriptions": [
              {
                  "AttributeName": "PublicKeyPolicyName",
                  "AttributeValue": "my-PublicKey-policy"
              }
          ],
          "PolicyName": "my-authentication-policy",
          "PolicyTypeName": "BackendServerAuthenticationPolicyType"
      }
  ]
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeLoadBalancerPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-load-balancer-policies.html)。

### `describe-load-balancer-policy-types`
<a name="elastic-load-balancing_DescribeLoadBalancerPolicyTypes_cli_topic"></a>

以下程式碼範例顯示如何使用 `describe-load-balancer-policy-types`。

**AWS CLI**  
**描述 Elastic Load Balancing 定義的負載平衡器政策類型**  
此範例描述可用來為負載平衡器建立政策組態的負載平衡器政策類型。  
命令：  

```
aws elb describe-load-balancer-policy-types
```
輸出：  

```
{
  "PolicyTypeDescriptions": [
      {
          "PolicyAttributeTypeDescriptions": [
              {
                  "Cardinality": "ONE",
                  "AttributeName": "ProxyProtocol",
                  "AttributeType": "Boolean"
              }
          ],
          "PolicyTypeName": "ProxyProtocolPolicyType",
          "Description": "Policy that controls whether to include the IP address and port of the originating request for TCP messages. This policy operates on TCP/SSL listeners only"
      },
      {
          "PolicyAttributeTypeDescriptions": [
              {
                  "Cardinality": "ONE",
                  "AttributeName": "PublicKey",
                  "AttributeType": "String"
              }
          ],
          "PolicyTypeName": "PublicKeyPolicyType",
          "Description": "Policy containing a list of public keys to accept when authenticating the back-end server(s). This policy cannot be applied directly to back-end servers or listeners but must be part of a BackendServerAuthenticationPolicyType."
      },
      {
          "PolicyAttributeTypeDescriptions": [
              {
                  "Cardinality": "ONE",
                  "AttributeName": "CookieName",
                  "AttributeType": "String"
              }
          ],
          "PolicyTypeName": "AppCookieStickinessPolicyType",
          "Description": "Stickiness policy with session lifetimes controlled by the lifetime of the application-generated cookie. This policy can be associated only with HTTP/HTTPS listeners."
      },
      {
          "PolicyAttributeTypeDescriptions": [
              {
                  "Cardinality": "ZERO_OR_ONE",
                  "AttributeName": "CookieExpirationPeriod",
                  "AttributeType": "Long"
              }
          ],
          "PolicyTypeName": "LBCookieStickinessPolicyType",
          "Description": "Stickiness policy with session lifetimes controlled by the browser (user-agent) or a specified expiration period. This policy can be associated only with HTTP/HTTPS listeners."
      },
      {
          "PolicyAttributeTypeDescriptions": [
              .
              .
              .
          ],
          "PolicyTypeName": "SSLNegotiationPolicyType",
          "Description": "Listener policy that defines the ciphers and protocols that will be accepted by the load balancer. This policy can be associated only with HTTPS/SSL listeners."
      },
      {
          "PolicyAttributeTypeDescriptions": [
              {
                  "Cardinality": "ONE_OR_MORE",
                  "AttributeName": "PublicKeyPolicyName",
                  "AttributeType": "PolicyName"
              }
          ],
          "PolicyTypeName": "BackendServerAuthenticationPolicyType",
          "Description": "Policy that controls authentication to back-end server(s) and contains one or more policies, such as an instance of a PublicKeyPolicyType. This policy can be associated only with back-end servers that are using HTTPS/SSL."
      }
  ]
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeLoadBalancerPolicyTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-load-balancer-policy-types.html)。

### `describe-load-balancers`
<a name="elastic-load-balancing_DescribeLoadBalancers_cli_topic"></a>

以下程式碼範例顯示如何使用 `describe-load-balancers`。

**AWS CLI**  
**描述您的負載平衡器**  
此範例描述所有的負載平衡器。  
命令：  

```
aws elb describe-load-balancers
```
**描述其中一個負載平衡器**  
此範例描述指定的負載平衡器。  
命令：  

```
aws elb describe-load-balancers --load-balancer-name my-load-balancer
```
以下為 VPC 中的 HTTPS 負載平衡器的範例回應。  
輸出：  

```
{
  "LoadBalancerDescriptions": [
    {
      "Subnets": [
          "subnet-15aaab61"
      ],
      "CanonicalHostedZoneNameID": "Z3DZXE0EXAMPLE",
      "CanonicalHostedZoneName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com",
      "ListenerDescriptions": [
          {
              "Listener": {
                  "InstancePort": 80,
                  "LoadBalancerPort": 80,
                  "Protocol": "HTTP",
                  "InstanceProtocol": "HTTP"
              },
              "PolicyNames": []
          },
          {
              "Listener": {
                  "InstancePort": 443,
                  "SSLCertificateId": "arn:aws:iam::123456789012:server-certificate/my-server-cert",
                  "LoadBalancerPort": 443,
                  "Protocol": "HTTPS",
                  "InstanceProtocol": "HTTPS"
              },
              "PolicyNames": [
                  "ELBSecurityPolicy-2015-03"
              ]
          }
      ],
      "HealthCheck": {
          "HealthyThreshold": 2,
          "Interval": 30,
          "Target": "HTTP:80/png",
          "Timeout": 3,
          "UnhealthyThreshold": 2
      },
      "VPCId": "vpc-a01106c2",
      "BackendServerDescriptions": [
          {
              "InstancePort": 80,
              "PolicyNames": [
                  "my-ProxyProtocol-policy"
              ]
          }
      ],
      "Instances": [
          {
              "InstanceId": "i-207d9717"
          },
          {
              "InstanceId": "i-afefb49b"
          }
      ],
      "DNSName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com",
      "SecurityGroups": [
          "sg-a61988c3"
      ],
      "Policies": {
          "LBCookieStickinessPolicies": [
              {
                  "PolicyName": "my-duration-cookie-policy",
                  "CookieExpirationPeriod": 60
              }
          ],
          "AppCookieStickinessPolicies": [],
          "OtherPolicies": [
              "my-PublicKey-policy",
              "my-authentication-policy",
              "my-SSLNegotiation-policy",
              "my-ProxyProtocol-policy",
              "ELBSecurityPolicy-2015-03"
          ]
      },
      "LoadBalancerName": "my-load-balancer",
      "CreatedTime": "2015-03-19T03:24:02.650Z",
      "AvailabilityZones": [
          "us-west-2a"
      ],
      "Scheme": "internet-facing",
      "SourceSecurityGroup": {
          "OwnerAlias": "123456789012",
          "GroupName": "my-elb-sg"
      }
    }
  ]
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeLoadBalancers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-load-balancers.html)。

### `describe-tags`
<a name="elastic-load-balancing_DescribeTags_cli_topic"></a>

以下程式碼範例顯示如何使用 `describe-tags`。

**AWS CLI**  
**描述指派給負載平衡器的標籤**  
此範例描述指派給指定之負載平衡器的標籤。  
命令：  

```
aws elb describe-tags --load-balancer-name my-load-balancer
```
輸出：  

```
{
  "TagDescriptions": [
      {
          "Tags": [
              {
                  "Value": "lima",
                  "Key": "project"
              },
              {
                  "Value": "digital-media",
                  "Key": "department"
              }
          ],
          "LoadBalancerName": "my-load-balancer"
      }
  ]
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-tags.html)。

### `detach-load-balancer-from-subnets`
<a name="elastic-load-balancing_DetachLoadBalancerFromSubnets_cli_topic"></a>

以下程式碼範例顯示如何使用 `detach-load-balancer-from-subnets`。

**AWS CLI**  
**將負載平衡器與子網路分開**  
此範例會將指定的負載平衡器與指定的子網路分開。  
命令：  

```
aws elb detach-load-balancer-from-subnets --load-balancer-name my-load-balancer --subnets subnet-0ecac448
```
輸出：  

```
{
   "Subnets": [
       "subnet-15aaab61"
   ]
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DetachLoadBalancerFromSubnets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/detach-load-balancer-from-subnets.html)。

### `disable-availability-zones-for-load-balancer`
<a name="elastic-load-balancing_DisableAvailabilityZonesForLoadBalancer_cli_topic"></a>

以下程式碼範例顯示如何使用 `disable-availability-zones-for-load-balancer`。

**AWS CLI**  
**停用負載平衡器的可用區域**  
此範例會從指定之負載平衡器的一組可用區域，移除指定的可用區域。  
命令：  

```
aws elb disable-availability-zones-for-load-balancer --load-balancer-name my-load-balancer --availability-zones us-west-2a
```
輸出：  

```
{
    "AvailabilityZones": [
        "us-west-2b"
    ]
}
```
+  如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [DisableAvailabilityZonesForLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/disable-availability-zones-for-load-balancer.html)。

### `enable-availability-zones-for-load-balancer`
<a name="elastic-load-balancing_EnableAvailabilityZonesForLoadBalancer_cli_topic"></a>

以下程式碼範例顯示如何使用 `enable-availability-zones-for-load-balancer`。

**AWS CLI**  
**啟用負載平衡器的可用區域**  
此範例會將指定的可用區域，新增至指定的負載平衡器。  
命令：  

```
aws elb enable-availability-zones-for-load-balancer --load-balancer-name my-load-balancer --availability-zones us-west-2b
```
輸出：  

```
{
    "AvailabilityZones": [
        "us-west-2a",
        "us-west-2b"
    ]
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [EnableAvailabilityZonesForLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/enable-availability-zones-for-load-balancer.html)。

### `modify-load-balancer-attributes`
<a name="elastic-load-balancing_ModifyLoadBalancerAttributes_cli_topic"></a>

以下程式碼範例顯示如何使用 `modify-load-balancer-attributes`。

**AWS CLI**  
**修改負載平衡器的屬性**  
此範例會修改指定之負載平衡器的 `CrossZoneLoadBalancing` 屬性。  
命令：  

```
aws elb modify-load-balancer-attributes --load-balancer-name my-load-balancer --load-balancer-attributes "{\"CrossZoneLoadBalancing\":{\"Enabled\":true}}"
```
輸出：  

```
{
    "LoadBalancerAttributes": {
        "CrossZoneLoadBalancing": {
            "Enabled": true
        }
    },
    "LoadBalancerName": "my-load-balancer"
}
```
此範例會修改指定之負載平衡器的 `ConnectionDraining` 屬性。  
命令：  

```
aws elb modify-load-balancer-attributes --load-balancer-name my-load-balancer --load-balancer-attributes "{\"ConnectionDraining\":{\"Enabled\":true,\"Timeout\":300}}"
```
輸出：  

```
{
    "LoadBalancerAttributes": {
        "ConnectionDraining": {
            "Enabled": true,
            "Timeout": 300
        }
    },
    "LoadBalancerName": "my-load-balancer"
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ModifyLoadBalancerAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/modify-load-balancer-attributes.html)。

### `register-instances-with-load-balancer`
<a name="elastic-load-balancing_RegisterInstancesWithLoadBalancer_cli_topic"></a>

以下程式碼範例顯示如何使用 `register-instances-with-load-balancer`。

**AWS CLI**  
**將負載平衡器註冊到執行個體**  
此範例會將指定的負載平衡器註冊到指定的執行個體。  
命令：  

```
aws elb register-instances-with-load-balancer --load-balancer-name my-load-balancer --instances i-d6f6fae3
```
輸出：  

```
{
   "Instances": [
       {
           "InstanceId": "i-d6f6fae3"
       },
       {
           "InstanceId": "i-207d9717"
       },
       {
           "InstanceId": "i-afefb49b"
       }
   ]
}
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [RegisterInstancesWithLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/register-instances-with-load-balancer.html)。

### `remove-tags`
<a name="elastic-load-balancing_RemoveTags_cli_topic"></a>

以下程式碼範例顯示如何使用 `remove-tags`。

**AWS CLI**  
**從負載平衡器移除標籤**  
此範例會從指定的負載平衡器移除標籤。  
命令：  

```
aws elb remove-tags --load-balancer-name my-load-balancer --tags project
```
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [RemoveTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/remove-tags.html)。

### `set-load-balancer-listener-ssl-certificate`
<a name="elastic-load-balancing_SetLoadBalancerListenerSslCertificate_cli_topic"></a>

以下程式碼範例顯示如何使用 `set-load-balancer-listener-ssl-certificate`。

**AWS CLI**  
**為 HTTPS 負載平衡器更新 SSL 憑證**  
此範例會取代指定之 HTTPS 負載平衡器的現有 SSL 憑證。  
命令：  

```
aws elb set-load-balancer-listener-ssl-certificate --load-balancer-name my-load-balancer --load-balancer-port 443 --ssl-certificate-id arn:aws:iam::123456789012:server-certificate/new-server-cert
```
+  如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [SetLoadBalancerListenerSslCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/set-load-balancer-listener-ssl-certificate.html)。

### `set-load-balancer-policies-for-backend-server`
<a name="elastic-load-balancing_SetLoadBalancerPoliciesForBackendServer_cli_topic"></a>

以下程式碼範例顯示如何使用 `set-load-balancer-policies-for-backend-server`。

**AWS CLI**  
**取代與後端執行個體的連接埠相關聯的政策**  
此範例會取代目前與指定之連接埠相關聯的政策。  
命令：  

```
aws elb set-load-balancer-policies-for-backend-server --load-balancer-name my-load-balancer --instance-port 80 --policy-names my-ProxyProtocol-policy
```
**移除目前與後端執行個體上的連接埠相關聯的所有政策**  
此範例會移除與指定之連接埠相關聯的所有政策。  
命令：  

```
aws elb set-load-balancer-policies-for-backend-server --load-balancer-name my-load-balancer --instance-port 80 --policy-names []
```
要確認政策已移除，請使用 `describe-load-balancer-policies` 命令。  
+  如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [SetLoadBalancerPoliciesForBackendServer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/set-load-balancer-policies-for-backend-server.html)。

### `set-load-balancer-policies-of-listener`
<a name="elastic-load-balancing_SetLoadBalancerPoliciesOfListener_cli_topic"></a>

以下程式碼範例顯示如何使用 `set-load-balancer-policies-of-listener`。

**AWS CLI**  
**取代與接聽程式相關聯的政策**  
此範例會取代目前與指定之接聽程式相關聯的政策。  
命令：  

```
aws elb set-load-balancer-policies-of-listener --load-balancer-name my-load-balancer --load-balancer-port 443 --policy-names my-SSLNegotiation-policy
```
**移除與接聽程式相關聯的所有政策**  
此範例會移除目前與指定之接聽程式相關聯的所有政策。  
命令：  

```
aws elb set-load-balancer-policies-of-listener --load-balancer-name my-load-balancer --load-balancer-port 443 --policy-names []
```
要確認已從負載平衡器移除政策，請使用 `describe-load-balancer-policies` 命令。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [SetLoadBalancerPoliciesOfListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/set-load-balancer-policies-of-listener.html)。