# Exemplos do Elastic Load Balancing Versão 2 usando o AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Elastic Load Balancing Versão 2.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `add-listener-certificates`
O código de exemplo a seguir mostra como usar `add-listener-certificates`.
**AWS CLI**
**Adicionar um certificado a um receptor seguro**
Esse exemplo adiciona o certificado especificado ao receptor seguro especificado.
Comando:
```
aws elbv2 add-listener-certificates --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 --certificates CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/5cc54884-f4a3-4072-80be-05b9ba72f705
```
Resultado:
```
{
"Certificates": [
{
"CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/5cc54884-f4a3-4072-80be-05b9ba72f705",
"IsDefault": false
}
]
}
```
+ Para ver detalhes da API, consulte [AddListenerCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/add-listener-certificates.html) na *Referência de comandos da AWS CLI*.
### `add-tags`
O código de exemplo a seguir mostra como usar `add-tags`.
**AWS CLI**
**Adicionar tags ao balanceador de carga**
O exemplo `add-tags` a seguir adiciona as tags `project` e `department` ao balanceador de carga especificado.
```
aws elbv2 add-tags \
--resource-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \
--tags "Key=project,Value=lima" "Key=department,Value=digital-media"
```
+ Para ver detalhes da API, consulte [AddTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/add-tags.html) na *Referência de comandos da AWS CLI*.
### `create-listener`
O código de exemplo a seguir mostra como usar `create-listener`.
**AWS CLI**
**Exemplo 1: como criar um receptor HTTP**
O exemplo de `create-listener` a seguir cria um receptor HTTP para o Application Load Balancer especificado. Esse receptor encaminha as solicitações para o grupo de destino especificado.
```
aws elbv2 create-listener \
--load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \
--protocol HTTP \
--port 80 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
```
Para obter mais informações, consulte [Tutorial: criar um Application Load Balancer usando a AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/tutorial-application-load-balancer-cli.html#create-load-balancer-aws-cli) no *Guia do usuário dos Application Load Balancers*.
**Exemplo 2: como criar um receptor HTTPS**
O exemplo de `create-listener` a seguir cria um receptor HTTPS para o Application Load Balancer especificado. Esse receptor encaminha as solicitações para o grupo de destino especificado. É necessário especificar um certificado SSL para um receptor HTTPS. Você pode criar e gerenciar certificados usando AWS Certificate Manager (ACM). Como alternativa, você pode criar um certificado usando ferramentas SSL/TLS, obter a assinatura de uma autoridade de certificação (CA) e fazer upload do certificado no AWS Identity and Access Management (IAM).
```
aws elbv2 create-listener \
--load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \
--protocol HTTPS \
--port 443 \
--certificates CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/3dcb0a41-bd72-4774-9ad9-756919c40557 \
--ssl-policy ELBSecurityPolicy-2016-08 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
```
Para obter mais informações, consulte [Adicionar um receptor HTTPS](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/tutorial-application-load-balancer-cli.html#https-listener-aws-cli) no *Guia do usuário de Application Load Balancers*.
**Exemplo 3: como criar um receptor TCP**
O exemplo de `create-listener` a seguir cria um receptor TCP para o Network Load Balancer especificado. Esse receptor encaminha as solicitações para o grupo de destino especificado.
```
aws elbv2 create-listener \
--load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/net/my-network-load-balancer/5d1b75f4f1cee11e \
--protocol TCP \
--port 80 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-tcp-targets/b6bba954d1361c78
```
Para obter mais informações, consulte [Tutorial: criar um Network Load Balancer usando a AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancer-cli.html#create-load-balancer-aws-cli) no *Guia do usuário dos Network Load Balancers*.
**Exemplo 4: como criar um receptor TLS**
O exemplo de `create-listener` a seguir cria um receptor TLS para o Network Load Balancer especificado. Esse receptor encaminha as solicitações para o grupo de destino especificado. É necessário especificar um certificado SSL para um listener TLS.
```
aws elbv2 create-listener \
--load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \
--protocol TLS \
--port 443 \
--certificates CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/3dcb0a41-bd72-4774-9ad9-756919c40557 \
--ssl-policy ELBSecurityPolicy-2016-08 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
```
Para obter mais informações, consulte [Listeners TLS para o Network Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-tls-listener.html) no *Guia do usuário dos Network Load Balancers*.
**Exemplo 5: como criar um receptor UDP**
O exemplo de `create-listener` a seguir cria um receptor UDP para o Network Load Balancer especificado. Esse receptor encaminha as solicitações para o grupo de destino especificado.
```
aws elbv2 create-listener \
--load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/net/my-network-load-balancer/5d1b75f4f1cee11e \
--protocol UDP \
--port 53 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-tcp-targets/b6bba954d1361c78
```
Para obter mais informações, consulte [Tutorial: criar um Network Load Balancer usando a AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancer-cli.html#create-load-balancer-aws-cli) no *Guia do usuário dos Network Load Balancers*.
**Exemplo 6: como criar um receptor para o gateway e encaminhamento especificados**
O exemplo de `create-listener` a seguir cria um receptor para o Gateway Load Balancer especificado. Esse receptor encaminha as solicitações para o grupo de destino especificado.
```
aws elbv2 create-listener \
--load-balancer-arn arn:aws:elasticloadbalancing:us-east-1:850631746142:loadbalancer/gwy/my-gateway-load-balancer/e0f9b3d5c7f7d3d6 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-east-1:850631746142:targetgroup/my-glb-targets/007ca469fae3bb1615
```
Resultado:
```
{
"Listeners": [
{
"ListenerArn": "arn:aws:elasticloadbalancing:us-east-1:850631746142:listener/gwy/my-agw-lb-example2/e0f9b3d5c7f7d3d6/afc127db15f925de",
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-east-1:850631746142:loadbalancer/gwy/my-agw-lb-example2/e0f9b3d5c7f7d3d6",
"DefaultActions": [
{
"Type": "forward",
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-east-1:850631746142:targetgroup/test-tg-agw-2/007ca469fae3bb1615",
"ForwardConfig": {
"TargetGroups": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-east-1:850631746142:targetgroup/test-tg-agw-2/007ca469fae3bb1615"
}
]
}
}
]
}
]
}
```
Para mais informações, consulte [Saiba como começar a usar Gateway Load Balancers com a AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/getting-started-cli.html) no *Guia do usuário para Gateway Load Balancers*.
+ Consulte detalhes da API em [CreateListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/create-listener.html) na *Referência de comandos da AWS CLI*.
### `create-load-balancer`
O código de exemplo a seguir mostra como usar `create-load-balancer`.
**AWS CLI**
**Exemplo 1: como criar um balanceador de carga voltado para a internet**
O exemplo de `create-load-balancer` a seguir cria um Application Load Balancer voltado para a internet e habilita as zonas de disponibilidade para as sub-redes especificadas.
```
aws elbv2 create-load-balancer \
--name my-load-balancer \
--subnets subnet-b7d581c0 subnet-8360a9e7
```
Resultado:
```
{
"LoadBalancers": [
{
"Type": "application",
"Scheme": "internet-facing",
"IpAddressType": "ipv4",
"VpcId": "vpc-3ac0fb5f",
"AvailabilityZones": [
{
"ZoneName": "us-west-2a",
"SubnetId": "subnet-8360a9e7"
},
{
"ZoneName": "us-west-2b",
"SubnetId": "subnet-b7d581c0"
}
],
"CreatedTime": "2017-08-25T21:26:12.920Z",
"CanonicalHostedZoneId": "Z2P70J7EXAMPLE",
"DNSName": "my-load-balancer-424835706.us-west-2.elb.amazonaws.com",
"SecurityGroups": [
"sg-5943793c"
],
"LoadBalancerName": "my-load-balancer",
"State": {
"Code": "provisioning"
},
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
}
]
}
```
Para obter mais informações, consulte [Tutorial: criar um Application Load Balancer usando a AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/tutorial-application-load-balancer-cli.html) no *Guia do usuário dos Application Load Balancers*.
**Exemplo 2: como criar um balanceador de carga interno**
O exemplo de `create-load-balancer` a seguir cria um Application Load Balancer interno e habilita as zonas de disponibilidade para as sub-redes especificadas.
```
aws elbv2 create-load-balancer \
--name my-internal-load-balancer \
--scheme internal \
--subnets subnet-b7d581c0 subnet-8360a9e7
```
Resultado:
```
{
"LoadBalancers": [
{
"Type": "application",
"Scheme": "internal",
"IpAddressType": "ipv4",
"VpcId": "vpc-3ac0fb5f",
"AvailabilityZones": [
{
"ZoneName": "us-west-2a",
"SubnetId": "subnet-8360a9e7"
},
{
"ZoneName": "us-west-2b",
"SubnetId": "subnet-b7d581c0"
}
],
"CreatedTime": "2016-03-25T21:29:48.850Z",
"CanonicalHostedZoneId": "Z2P70J7EXAMPLE",
"DNSName": "internal-my-internal-load-balancer-1529930873.us-west-2.elb.amazonaws.com",
"SecurityGroups": [
"sg-5943793c"
],
"LoadBalancerName": "my-internal-load-balancer",
"State": {
"Code": "provisioning"
},
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-internal-load-balancer/5b49b8d4303115c2"
}
]
}
```
Para obter mais informações, consulte [Tutorial: criar um Application Load Balancer usando a AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/tutorial-application-load-balancer-cli.html) no *Guia do usuário dos Application Load Balancers*.
**Exemplo 3: como criar um Network Load Balancer**
O exemplo de `create-load-balancer` a seguir cria um Network Load Balancer voltado para a internet e habilita a zona de disponibilidade para as sub-redes especificadas. Ele usa o mapeamento de sub-redes para associar o endereço IP do Elastic específico à interface de rede usada pelos nós do balanceador de carga da zona de disponibilidade.
```
aws elbv2 create-load-balancer \
--name my-network-load-balancer \
--type network \
--subnet-mappings SubnetId=subnet-b7d581c0,AllocationId=eipalloc-64d5890a
```
Resultado:
```
{
"LoadBalancers": [
{
"Type": "network",
"Scheme": "internet-facing",
"IpAddressType": "ipv4",
"VpcId": "vpc-3ac0fb5f",
"AvailabilityZones": [
{
"LoadBalancerAddresses": [
{
"IpAddress": "35.161.207.171",
"AllocationId": "eipalloc-64d5890a"
}
],
"ZoneName": "us-west-2b",
"SubnetId": "subnet-5264e837"
}
],
"CreatedTime": "2017-10-15T22:41:25.657Z",
"CanonicalHostedZoneId": "Z2P70J7EXAMPLE",
"DNSName": "my-network-load-balancer-5d1b75f4f1cee11e.elb.us-west-2.amazonaws.com",
"LoadBalancerName": "my-network-load-balancer",
"State": {
"Code": "provisioning"
},
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/net/my-network-load-balancer/5d1b75f4f1cee11e"
}
]
}
```
Para obter mais informações, consulte [Tutorial: criar um Network Load Balancer usando a AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancer-cli.html) no *Guia do usuário dos Network Load Balancers*.
**Exemplo 4: como criar um Gateway Load Balancer**
O exemplo de `create-load-balancer` a seguir cria um Gateway Load Balancer e habilita as zonas de disponibilidade para as sub-redes especificadas.
```
aws elbv2 create-load-balancer \
--name my-gateway-load-balancer \
--type gateway \
--subnets subnet-dc83f691 subnet-a62583f9
```
Resultado:
```
{
"LoadBalancers": [
{
"Type": "gateway",
"VpcId": "vpc-838475fe",
"AvailabilityZones": [
{
"ZoneName": "us-east-1b",
"SubnetId": "subnet-a62583f9"
},
{
"ZoneName": "us-east-1a",
"SubnetId": "subnet-dc83f691"
}
],
"CreatedTime": "2021-07-14T19:33:43.324000+00:00",
"LoadBalancerName": "my-gateway-load-balancer",
"State": {
"Code": "provisioning"
},
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-east-1:850631746142:loadbalancer/gwy/my-gateway-load-balancer/dfbb5a7d32cdee79"
}
]
}
```
Para mais informações, consulte [Saiba como começar a usar Gateway Load Balancers com a AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/gateway/getting-started-cli.html) no *Guia do usuário para Gateway Load Balancers*.
+ Consulte detalhes da API em [CreateLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/create-load-balancer.html) na *Referência de comandos da AWS CLI*.
### `create-rule`
O código de exemplo a seguir mostra como usar `create-rule`.
**AWS CLI**
**Exemplo 1: criar uma regra usando uma condição de caminho e uma ação de avanço**
O exemplo `create-rule` a seguir cria uma regra que encaminha solicitações para o grupo de destino especificado, se o URL contiver o padrão especificado.
```
aws elbv2 create-rule \
--listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \
--priority 5 \
--conditions file://conditions-pattern.json
--actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
```
Conteúdo de `conditions-pattern.json`:
```
[
{
"Field": "path-pattern",
"PathPatternConfig": {
"Values": ["/images/*"]
}
}
]
```
**Exemplo 2: criar uma regra usando uma condição de host e uma resposta fixa**
O exemplo `create-rule` a seguir cria uma regra que fornece uma resposta fixa se o nome do host no cabeçalho do host corresponder ao nome do host especificado.
```
aws elbv2 create-rule \
--listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \
--priority 10 \
--conditions file://conditions-host.json \
--actions file://actions-fixed-response.json
```
Conteúdo de `conditions-host.json`
```
[
{
"Field": "host-header",
"HostHeaderConfig": {
"Values": ["*.example.com"]
}
}
]
```
Conteúdo de `actions-fixed-response.json`
```
[
{
"Type": "fixed-response",
"FixedResponseConfig": {
"MessageBody": "Hello world",
"StatusCode": "200",
"ContentType": "text/plain"
}
}
]
```
**Exemplo 3: criar uma regra usando uma condição de endereço IP de origem, uma ação de autenticação e uma ação de encaminhamento**
O exemplo `create-rule` a seguir cria uma regra que autentica o usuário se o endereço IP de origem corresponder ao endereço IP especificado e encaminha a solicitação para o grupo de destino especificado se a autenticação for bem-sucedida.
```
aws elbv2 create-rule \
--listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \
--priority 20 \
--conditions file://conditions-source-ip.json \
--actions file://actions-authenticate.json
```
Conteúdo de `conditions-source-ip.json`
```
[
{
"Field": "source-ip",
"SourceIpConfig": {
"Values": ["192.0.2.0/24", "198.51.100.10/32"]
}
}
]
```
Conteúdo de `actions-authenticate.json`
```
[
{
"Type": "authenticate-oidc",
"AuthenticateOidcConfig": {
"Issuer": "https://idp-issuer.com",
"AuthorizationEndpoint": "https://authorization-endpoint.com",
"TokenEndpoint": "https://token-endpoint.com",
"UserInfoEndpoint": "https://user-info-endpoint.com",
"ClientId": "abcdefghijklmnopqrstuvwxyz123456789",
"ClientSecret": "123456789012345678901234567890",
"SessionCookieName": "my-cookie",
"SessionTimeout": 3600,
"Scope": "email",
"AuthenticationRequestExtraParams": {
"display": "page",
"prompt": "login"
},
"OnUnauthenticatedRequest": "deny"
},
"Order": 1
},
{
"Type": "forward",
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-east-1:880185128111:targetgroup/cli-test/642a97ecb0e0f26b",
"Order": 2
}
]
```
+ Para ver detalhes da API, consulte [CreateRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/create-rule.html) na *Referência de comandos da AWS CLI*.
### `create-target-group`
O código de exemplo a seguir mostra como usar `create-target-group`.
**AWS CLI**
**Exemplo 1: criar um grupo de destino para o Application Load Balancer**
O exemplo de `create-target-group` a seguir cria um grupo de destino para um Application Load Balancer no qual você registra destinos por ID de instância (o tipo do destino é `instance`). Esse grupo de destino usa o protocolo HTTP, a porta 80 e as configurações padrão de verificação de integridade de um grupo de destino HTTP.
```
aws elbv2 create-target-group \
--name my-targets \
--protocol HTTP \
--port 80 \
--target-type instance \
--vpc-id vpc-3ac0fb5f
```
Resultado:
```
{
"TargetGroups": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
"TargetGroupName": "my-targets",
"Protocol": "HTTP",
"Port": 80,
"VpcId": "vpc-3ac0fb5f",
"HealthCheckProtocol": "HTTP",
"HealthCheckPort": "traffic-port",
"HealthCheckEnabled": true,
"HealthCheckIntervalSeconds": 30,
"HealthCheckTimeoutSeconds": 5,
"HealthyThresholdCount": 5,
"UnhealthyThresholdCount": 2,
"HealthCheckPath": "/",
"Matcher": {
"HttpCode": "200"
},
"TargetType": "instance",
"ProtocolVersion": "HTTP1",
"IpAddressType": "ipv4"
}
]
}
```
Para obter mais informações, consulte [Criar um grupo de destino](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-target-group.html) no *Guia do usuário dos Application Load Balancers*.
**Exemplo 2: criar um grupo de destino para rotear o tráfego de um Application Load Balancer para uma função do Lambda**
O exemplo de `create-target-group` a seguir cria um grupo de destino para um Application Load Balancer, no qual o destino é uma função do Lambda (o tipo do destino é `lambda`). Por padrão, as verificações de integridade estão desabilitadas para esse grupo de destino.
```
aws elbv2 create-target-group \
--name my-lambda-target \
--target-type lambda
```
Resultado:
```
{
"TargetGroups": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-lambda-target/a3003e085dbb8ddc",
"TargetGroupName": "my-lambda-target",
"HealthCheckEnabled": false,
"HealthCheckIntervalSeconds": 35,
"HealthCheckTimeoutSeconds": 30,
"HealthyThresholdCount": 5,
"UnhealthyThresholdCount": 2,
"HealthCheckPath": "/",
"Matcher": {
"HttpCode": "200"
},
"TargetType": "lambda",
"IpAddressType": "ipv4"
}
]
}
```
Para obter mais informações, consulte [Lambda functions as targets](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/lambda-functions.html) no *Guia do usuário de Application Load Balancers*.
**Exemplo 3: criar um grupo de destino para o Network Load Balancer**
O exemplo de `create-target-group` a seguir cria um grupo de destino para um Network Load Balancer no qual você registra destinos por endereço IP (o tipo do destino é `ip`). Esse grupo de destino usa o protocolo TCP, a porta 80 e as configurações padrão de verificação de integridade de um grupo de destino TCP.
```
aws elbv2 create-target-group \
--name my-ip-targets \
--protocol TCP \
--port 80 \
--target-type ip \
--vpc-id vpc-3ac0fb5f
```
Resultado:
```
{
"TargetGroups": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-ip-targets/b6bba954d1361c78",
"TargetGroupName": "my-ip-targets",
"Protocol": "TCP",
"Port": 80,
"VpcId": "vpc-3ac0fb5f",
"HealthCheckEnabled": true,
"HealthCheckProtocol": "TCP",
"HealthCheckPort": "traffic-port",
"HealthCheckIntervalSeconds": 30,
"HealthCheckTimeoutSeconds": 10,
"HealthyThresholdCount": 5,
"UnhealthyThresholdCount": 2,
"TargetType": "ip",
"IpAddressType": "ipv4"
}
]
}
```
Para obter mais informações, consulte [Criar um grupo de destino](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-target-group.html) no *Guia do usuário do Network Load Balancer*.
**Exemplo 4: criar um grupo de destino para rotear o tráfego de um Network Load Balancer para um Application Load Balancer**
O exemplo `create-target-group` a seguir cria um grupo de destino para um Network Load Balancer no qual você registra um Application Load Balancer como destino (o tipo do destino é `alb`).
aws elbv2 create-target-group --name my-alb-target --protocol TCP --port 80 --target-type alb --vpc-id vpc-3ac0fb5f
Resultado:
```
{
"TargetGroups": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-alb-target/a3003e085dbb8ddc",
"TargetGroupName": "my-alb-target",
"Protocol": "TCP",
"Port": 80,
"VpcId": "vpc-838475fe",
"HealthCheckProtocol": "HTTP",
"HealthCheckPort": "traffic-port",
"HealthCheckEnabled": true,
"HealthCheckIntervalSeconds": 30,
"HealthCheckTimeoutSeconds": 6,
"HealthyThresholdCount": 5,
"UnhealthyThresholdCount": 2,
"HealthCheckPath": "/",
"Matcher": {
"HttpCode": "200-399"
},
"TargetType": "alb",
"IpAddressType": "ipv4"
}
]
}
```
Para obter mais informações, consulte [Criar um grupo de destino com um Application Load Balancer como destino](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/application-load-balancer-target.html) no *Guia do usuário do Network Load Balancer*.
**Exemplo 5: criar um grupo de destino para o Balanceador de Carga de Gateway**
O exemplo `create-target-group` a seguir cria um grupo destino para um Balanceador de Carga de Gateway, no qual o destino é uma instância e o protocolo do grupo de destino é `GENEVE`.
```
aws elbv2 create-target-group \
--name my-glb-targetgroup \
--protocol GENEVE \
--port 6081 \
--target-type instance \
--vpc-id vpc-838475fe
```
Resultado:
```
{
"TargetGroups": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-glb-targetgroup/00c3d57eacd6f40b6f",
"TargetGroupName": "my-glb-targetgroup",
"Protocol": "GENEVE",
"Port": 6081,
"VpcId": "vpc-838475fe",
"HealthCheckProtocol": "TCP",
"HealthCheckPort": "80",
"HealthCheckEnabled": true,
"HealthCheckIntervalSeconds": 10,
"HealthCheckTimeoutSeconds": 5,
"HealthyThresholdCount": 5,
"UnhealthyThresholdCount": 2,
"TargetType": "instance"
}
]
}
```
Para obter mais informações, consulte Criar um grupo de destino `\$1\$1 no *Guia do usuário do Balanceador de Carga do Gateway*.
+ Consulte detalhes da API em [CreateTargetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/create-target-group.html) na *Referência de comandos da AWS CLI*.
### `delete-listener`
O código de exemplo a seguir mostra como usar `delete-listener`.
**AWS CLI**
**Excluir um receptor**
O exemplo `delete-listener` a seguir exclui o receptor especificado.
```
aws elbv2 delete-listener \
--listener-arn arn:aws:elasticloadbalancing:ua-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
```
+ Para ver detalhes da API, consulte [DeleteListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/delete-listener.html) na *Referência de comandos da AWS CLI*.
### `delete-load-balancer`
O código de exemplo a seguir mostra como usar `delete-load-balancer`.
**AWS CLI**
**Como excluir um balanceador de carga**
O exemplo `delete-load-balancer` a seguir exclui o balanceador de carga especificado.
```
aws elbv2 delete-load-balancer \
--load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
```
+ Consulte detalhes da API em [DeleteLoadBalancer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/delete-load-balancer.html) na *Referência de comandos da AWS CLI*.
### `delete-rule`
O código de exemplo a seguir mostra como usar `delete-rule`.
**AWS CLI**
**Para excluir uma regra**
O exemplo de `delete-rule` a seguir exclui a regra especificada.
```
aws elbv2 delete-rule \
--rule-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3
```
+ Consulte detalhes da API em [DeleteRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/delete-rule.html) na *Referência de comandos da AWS CLI*.
### `delete-target-group`
O código de exemplo a seguir mostra como usar `delete-target-group`.
**AWS CLI**
**Como excluir um grupo de destino**
O exemplo de `delete-target-group` a seguir exclui o grupo de destino especificado.
```
aws elbv2 delete-target-group \
--target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
```
Este comando não produz saída.
Para obter mais informações, consulte [Excluir o balanceador de carga](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-delete.html) no *Guia do Application Load Balancer Guide*.
+ Consulte detalhes da API em [DeleteTargetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/delete-target-group.html) na *Referência de comandos da AWS CLI*.
### `deregister-targets`
O código de exemplo a seguir mostra como usar `deregister-targets`.
**AWS CLI**
**Exemplo 1: cancelar o registro de um destino de um grupo de destino**
O exemplo `deregister-targets` a seguir remove a instância especificada do grupo de destino especificado.
```
aws elbv2 deregister-targets \
--target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 \
--targets Id=i-1234567890abcdef0
```
**Exemplo 2: cancelar o registro de um destino registrado usando substituições de porta**
O exemplo `deregister-targets` a seguir remove uma instância de um grupo de destino que foi registrado usando substituições de porta.
```
aws elbv2 deregister-targets \
--target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-internal-targets/3bb63f11dfb0faf9 \
--targets Id=i-1234567890abcdef0,Port=80 Id=i-1234567890abcdef0,Port=766
```
+ Para ver detalhes da API, consulte [DeregisterTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/deregister-targets.html) na *Referência de comandos da AWS CLI*.
### `describe-account-limits`
O código de exemplo a seguir mostra como usar `describe-account-limits`.
**AWS CLI**
**Descrever os limites do Balanceamento de Carga Elastic**
O exemplo `describe-account-limits` a seguir mostra os limites do Balanceamento de Carga Elastic para sua conta AWS na Região atual.
```
aws elbv2 describe-account-limits
```
Resultado:
```
{
"Limits": [
{
"Name": "target-groups",
"Max": "3000"
},
{
"Name": "targets-per-application-load-balancer",
"Max": "1000"
},
{
"Name": "listeners-per-application-load-balancer",
"Max": "50"
},
{
"Name": "rules-per-application-load-balancer",
"Max": "100"
},
{
"Name": "network-load-balancers",
"Max": "50"
},
{
"Name": "targets-per-network-load-balancer",
"Max": "3000"
},
{
"Name": "targets-per-availability-zone-per-network-load-balancer",
"Max": "500"
},
{
"Name": "listeners-per-network-load-balancer",
"Max": "50"
},
{
"Name": "condition-values-per-alb-rule",
"Max": "5"
},
{
"Name": "condition-wildcards-per-alb-rule",
"Max": "5"
},
{
"Name": "target-groups-per-application-load-balancer",
"Max": "100"
},
{
"Name": "target-groups-per-action-on-application-load-balancer",
"Max": "5"
},
{
"Name": "target-groups-per-action-on-network-load-balancer",
"Max": "1"
},
{
"Name": "certificates-per-application-load-balancer",
"Max": "25"
},
{
"Name": "certificates-per-network-load-balancer",
"Max": "25"
},
{
"Name": "targets-per-target-group",
"Max": "1000"
},
{
"Name": "target-id-registrations-per-application-load-balancer",
"Max": "1000"
},
{
"Name": "network-load-balancer-enis-per-vpc",
"Max": "1200"
},
{
"Name": "application-load-balancers",
"Max": "50"
},
{
"Name": "gateway-load-balancers",
"Max": "100"
},
{
"Name": "gateway-load-balancers-per-vpc",
"Max": "100"
},
{
"Name": "geneve-target-groups",
"Max": "100"
},
{
"Name": "targets-per-availability-zone-per-gateway-load-balancer",
"Max": "300"
}
]
}
```
Para obter mais informações, consulte [Quotas](https://docs.aws.amazon.com/general/latest/gr/elb.html#limits_elastic_load_balancer) na *Referência geral da AWS*.
+ Para ver detalhes da API, consulte [DescribeAccountLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-account-limits.html) na *Referência de comandos da AWS CLI*.
### `describe-listener-certificates`
O código de exemplo a seguir mostra como usar `describe-listener-certificates`.
**AWS CLI**
**Descrever os certificados para um receptor seguro**
Esse exemplo descreve os certificados do receptor seguro especificado.
Comando:
```
aws elbv2 describe-listener-certificates --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
```
Resultado:
```
{
"Certificates": [
{
"CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/5cc54884-f4a3-4072-80be-05b9ba72f705",
"IsDefault": false
},
{
"CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/3dcb0a41-bd72-4774-9ad9-756919c40557",
"IsDefault": false
},
{
"CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/fe59da96-6f58-4a22-8eed-6d0d50477e1d",
"IsDefault": true
}
]
}
```
+ Para ver detalhes da API, consulte [DescribeListenerCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-listener-certificates.html) na *Referência de comandos da AWS CLI*.
### `describe-listeners`
O código de exemplo a seguir mostra como usar `describe-listeners`.
**AWS CLI**
**Descrever um receptor**
Este exemplo descreve o receptor especificado.
Comando:
```
aws elbv2 describe-listeners --listener-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
```
Resultado:
```
{
"Listeners": [
{
"Port": 80,
"Protocol": "HTTP",
"DefaultActions": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
"Type": "forward"
}
],
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
"ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2"
}
]
}
```
**Descrever os receptores de um balanceador de carga**
Este exemplo descreve os receptores do balanceador de carga especificado.
Comando:
```
aws elbv2 describe-listeners --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
```
Resultado:
```
{
"Listeners": [
{
"Port": 443,
"Protocol": "HTTPS",
"DefaultActions": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
"Type": "forward"
}
],
"SslPolicy": "ELBSecurityPolicy-2015-05",
"Certificates": [
{
"CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-server-cert"
}
],
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
"ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65"
},
{
"Port": 80,
"Protocol": "HTTP",
"DefaultActions": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
"Type": "forward"
}
],
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
"ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2"
}
]
}
```
+ Para ver detalhes da API, consulte [DescribeListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-listeners.html) na *Referência de comandos da AWS CLI*.
### `describe-load-balancer-attributes`
O código de exemplo a seguir mostra como usar `describe-load-balancer-attributes`.
**AWS CLI**
**Descrever os atributos do balanceador de carga**
O exemplo `describe-load-balancer-attributes` a seguir exibe os atributos do balanceador de carga especificado.
```
aws elbv2 describe-load-balancer-attributes \
--load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
```
O exemplo de saída a seguir mostra os atributos de um Application Load Balancer.
```
{
"Attributes": [
{
"Value": "false",
"Key": "access_logs.s3.enabled"
},
{
"Value": "",
"Key": "access_logs.s3.bucket"
},
{
"Value": "",
"Key": "access_logs.s3.prefix"
},
{
"Value": "60",
"Key": "idle_timeout.timeout_seconds"
},
{
"Value": "false",
"Key": "deletion_protection.enabled"
},
{
"Value": "true",
"Key": "routing.http2.enabled"
}
]
}
```
O exemplo de saída a seguir inclui os atributos de um Network Load Balancer.
```
{
"Attributes": [
{
"Value": "false",
"Key": "access_logs.s3.enabled"
},
{
"Value": "",
"Key": "access_logs.s3.bucket"
},
{
"Value": "",
"Key": "access_logs.s3.prefix"
},
{
"Value": "false",
"Key": "deletion_protection.enabled"
},
{
"Value": "false",
"Key": "load_balancing.cross_zone.enabled"
}
]
}
```
+ Para ver detalhes da API, consulte [DescribeLoadBalancerAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-load-balancer-attributes.html) na *Referência de comandos da AWS CLI*.
### `describe-load-balancers`
O código de exemplo a seguir mostra como usar `describe-load-balancers`.
**AWS CLI**
**Como descrever um balanceador de carga**
Este exemplo descreve o balanceador de carga especificado.
Comando:
```
aws elbv2 describe-load-balancers --load-balancer-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
```
Resultado:
```
{
"LoadBalancers": [
{
"Type": "application",
"Scheme": "internet-facing",
"IpAddressType": "ipv4",
"VpcId": "vpc-3ac0fb5f",
"AvailabilityZones": [
{
"ZoneName": "us-west-2a",
"SubnetId": "subnet-8360a9e7"
},
{
"ZoneName": "us-west-2b",
"SubnetId": "subnet-b7d581c0"
}
],
"CreatedTime": "2016-03-25T21:26:12.920Z",
"CanonicalHostedZoneId": "Z2P70J7EXAMPLE",
"DNSName": "my-load-balancer-424835706.us-west-2.elb.amazonaws.com",
"SecurityGroups": [
"sg-5943793c"
],
"LoadBalancerName": "my-load-balancer",
"State": {
"Code": "active"
},
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
}
]
}
```
**Como descrever todos os balanceadores de carga**
Este exemplo descreve todos os balanceadores de carga.
Comando:
```
aws elbv2 describe-load-balancers
```
+ Consulte detalhes da API em [DescribeLoadBalancers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-load-balancers.html) na *Referência de comandos da AWS CLI*.
### `describe-rules`
O código de exemplo a seguir mostra como usar `describe-rules`.
**AWS CLI**
**Exemplo 1: descrever uma regra**
O exemplo `describe-rules` a seguir exibe os detalhes da regra especificada.
```
aws elbv2 describe-rules \
--rule-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee
```
**Exemplo 2: descrever as regras para um receptor**
O exemplo `describe-rules` a seguir exibe os detalhes da regra para o receptor especificado. A saída inclui a regra padrão e quaisquer outras regras que você tenha adicionado.
```
aws elbv2 describe-rules \
--listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2
```
+ Para ver detalhes da API, consulte [DescribeRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-rules.html) na *Referência de comandos da AWS CLI*.
### `describe-ssl-policies`
O código de exemplo a seguir mostra como usar `describe-ssl-policies`.
**AWS CLI**
**Exemplo 1: listar as políticas usadas para negociação de SSL por tipo de balanceador de carga**
O exemplo `describe-ssl-policies` a seguir exibe os nomes das políticas que você pode usar para negociação de SSL com um Application Load Balancer. O exemplo usa o parâmetro `--query` para exibir somente os nomes das políticas.
```
aws elbv2 describe-ssl-policies \
--load-balancer-type application \
--query SslPolicies[*].Name
```
Resultado:
```
[
"ELBSecurityPolicy-2016-08",
"ELBSecurityPolicy-TLS13-1-2-2021-06",
"ELBSecurityPolicy-TLS13-1-2-Res-2021-06",
"ELBSecurityPolicy-TLS13-1-2-Ext1-2021-06",
"ELBSecurityPolicy-TLS13-1-2-Ext2-2021-06",
"ELBSecurityPolicy-TLS13-1-1-2021-06",
"ELBSecurityPolicy-TLS13-1-0-2021-06",
"ELBSecurityPolicy-TLS13-1-3-2021-06",
"ELBSecurityPolicy-TLS-1-2-2017-01",
"ELBSecurityPolicy-TLS-1-1-2017-01",
"ELBSecurityPolicy-TLS-1-2-Ext-2018-06",
"ELBSecurityPolicy-FS-2018-06",
"ELBSecurityPolicy-2015-05",
"ELBSecurityPolicy-TLS-1-0-2015-04",
"ELBSecurityPolicy-FS-1-2-Res-2019-08",
"ELBSecurityPolicy-FS-1-1-2019-08",
"ELBSecurityPolicy-FS-1-2-2019-08",
"ELBSecurityPolicy-FS-1-2-Res-2020-10"
]
```
**Exemplo 2: listar as políticas que oferecem suporte a um protocolo específico**
O exemplo `describe-ssl-policies` a seguir exibe os nomes das políticas que oferecem suporte ao protocolo TLS 1.3. O exemplo usa o parâmetro `--query` para exibir somente os nomes das políticas.
```
aws elbv2 describe-ssl-policies \
--load-balancer-type application \
--query SslPolicies[?contains(SslProtocols,'TLSv1.3')].Name
```
Resultado:
```
[
"ELBSecurityPolicy-TLS13-1-2-2021-06",
"ELBSecurityPolicy-TLS13-1-2-Res-2021-06",
"ELBSecurityPolicy-TLS13-1-2-Ext1-2021-06",
"ELBSecurityPolicy-TLS13-1-2-Ext2-2021-06",
"ELBSecurityPolicy-TLS13-1-1-2021-06",
"ELBSecurityPolicy-TLS13-1-0-2021-06",
"ELBSecurityPolicy-TLS13-1-3-2021-06"
]
```
**Exemplo 3: exibir as cifras de uma política**
O exemplo `describe-ssl-policies` a seguir exibe os nomes das cifras da política especificada. O exemplo usa o parâmetro `--query` para exibir somente os nomes das cifras. A primeira cifra da lista tem prioridade 1 e as cifras restantes estão em ordem de prioridade.
```
aws elbv2 describe-ssl-policies \
--names ELBSecurityPolicy-TLS13-1-2-2021-06 \
--query SslPolicies[*].Ciphers[*].Name
```
Resultado:
```
[
"TLS_AES_128_GCM_SHA256",
"TLS_AES_256_GCM_SHA384",
"TLS_CHACHA20_POLY1305_SHA256",
"ECDHE-ECDSA-AES128-GCM-SHA256",
"ECDHE-RSA-AES128-GCM-SHA256",
"ECDHE-ECDSA-AES128-SHA256",
"ECDHE-RSA-AES128-SHA256",
"ECDHE-ECDSA-AES256-GCM-SHA384",
"ECDHE-RSA-AES256-GCM-SHA384",
"ECDHE-ECDSA-AES256-SHA384",
"ECDHE-RSA-AES256-SHA384"
]
```
Para obter mais informações, consulte [Políticas de segurança](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html#describe-ssl-policies) no *Guia do usuário dos Application Load Balancers*.
+ Para ver detalhes da API, consulte [DescribeSslPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-ssl-policies.html) na *Referência de comandos da AWS CLI*.
### `describe-tags`
O código de exemplo a seguir mostra como usar `describe-tags`.
**AWS CLI**
**Descrever as tags atribuídas a um balanceador de carga**
Este exemplo descreve as tags atribuídas ao balanceador de carga especificado.
Comando:
```
aws elbv2 describe-tags --resource-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
```
Resultado:
```
{
"TagDescriptions": [
{
"ResourceArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
"Tags": [
{
"Value": "lima",
"Key": "project"
},
{
"Value": "digital-media",
"Key": "department"
}
]
}
]
}
```
+ Para ver detalhes da API, consulte [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-tags.html) na *Referência de comandos da AWS CLI*.
### `describe-target-group-attributes`
O código de exemplo a seguir mostra como usar `describe-target-group-attributes`.
**AWS CLI**
**Descrever os atributos do grupo de destino**
O exemplo `describe-target-group-attributes` a seguir exibe os atributos do grupo de destino especificado.
```
aws elbv2 describe-target-group-attributes \
--target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
```
A saída inclui os atributos se o protocolo for HTTP ou HTTPS e o tipo de destino for `instance` ou `ip`.
```
{
"Attributes": [
{
"Value": "false",
"Key": "stickiness.enabled"
},
{
"Value": "300",
"Key": "deregistration_delay.timeout_seconds"
},
{
"Value": "lb_cookie",
"Key": "stickiness.type"
},
{
"Value": "86400",
"Key": "stickiness.lb_cookie.duration_seconds"
},
{
"Value": "0",
"Key": "slow_start.duration_seconds"
}
]
}
```
A saída a seguir inclui os atributos se o protocolo for HTTP ou HTTPS e o tipo de destino for `lambda`.
```
{
"Attributes": [
{
"Value": "false",
"Key": "lambda.multi_value_headers.enabled"
}
]
}
```
A saída a seguir inclui os atributos se o protocolo for TCP, TLS, UDP ou TCP\$1UDP.
```
{
"Attributes": [
{
"Value": "false",
"Key": "proxy_protocol_v2.enabled"
},
{
"Value": "300",
"Key": "deregistration_delay.timeout_seconds"
}
]
}
```
+ Para ver detalhes da API, consulte [DescribeTargetGroupAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-target-group-attributes.html) na *Referência de comandos da AWS CLI*.
### `describe-target-groups`
O código de exemplo a seguir mostra como usar `describe-target-groups`.
**AWS CLI**
**Exemplo 1: como descrever um grupo de destino**
O exemplo de `describe-target-groups` a seguir exibe os detalhes do grupo de destino especificado.
```
aws elbv2 describe-target-groups \
--target-group-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
```
Resultado:
```
{
"TargetGroups": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
"TargetGroupName": "my-targets",
"Protocol": "HTTP",
"Port": 80,
"VpcId": "vpc-3ac0fb5f",
"HealthCheckProtocol": "HTTP",
"HealthCheckPort": "traffic-port",
"HealthCheckEnabled": true,
"HealthCheckIntervalSeconds": 30,
"HealthCheckTimeoutSeconds": 5,
"HealthyThresholdCount": 5,
"UnhealthyThresholdCount": 2,
"HealthCheckPath": "/",
"Matcher": {
"HttpCode": "200"
},
"LoadBalancerArns": [
"arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
],
"TargetType": "instance",
"ProtocolVersion": "HTTP1",
"IpAddressType": "ipv4"
}
]
}
```
**Exemplo 2: como descrever todos os grupos de destino de um balanceador de carga**
O exemplo de `describe-target-groups` a seguir exibe os detalhes de todos os grupos de destino do balanceador de carga especificado. O exemplo usa o parâmetro `--query` para exibir somente os nomes dos grupo de destino.
```
aws elbv2 describe-target-groups \
--load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \
--query TargetGroups[*].TargetGroupName
```
Resultado:
```
[
"my-instance-targets",
"my-ip-targets",
"my-lambda-target"
]
```
Para ter mais informações, consulte [Grupos de destino](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html) no *Guia do Application Load Balancer*.
+ Consulte detalhes da API em [DescribeTargetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-target-groups.html) na *Referência de comandos da AWS CLI*.
### `describe-target-health`
O código de exemplo a seguir mostra como usar `describe-target-health`.
**AWS CLI**
**Exemplo 1: como descrever a integridade dos destinos de um grupo de destino**
O exemplo de `describe-target-health` a seguir exibe os detalhes de integridade dos destinos do grupo de destino especificado. Os destinos estão íntegros.
```
aws elbv2 describe-target-health \
--target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
```
Resultado:
```
{
"TargetHealthDescriptions": [
{
"HealthCheckPort": "80",
"Target": {
"Id": "i-ceddcd4d",
"Port": 80
},
"TargetHealth": {
"State": "healthy"
}
},
{
"HealthCheckPort": "80",
"Target": {
"Id": "i-0f76fade",
"Port": 80
},
"TargetHealth": {
"State": "healthy"
}
}
]
}
```
**Exemplo 2: como descrever a integridade de um destino**
O exemplo de `describe-target-health` a seguir exibe os detalhes de integridade do destino especificado. Este destino é íntegro.
```
aws elbv2 describe-target-health \
--targets Id=i-0f76fade,Port=80 \
--target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067
```
Resultado:
```
{
"TargetHealthDescriptions": [
{
"HealthCheckPort": "80",
"Target": {
"Id": "i-0f76fade",
"Port": 80
},
"TargetHealth": {
"State": "healthy"
}
}
]
}
```
O exemplo de saída a seguir é de um destino cujo grupo de destino não está especificado em uma ação de um receptor. Esse destino não pode receber tráfego do balanceador de carga.
```
{
"TargetHealthDescriptions": [
{
"HealthCheckPort": "80",
"Target": {
"Id": "i-0f76fade",
"Port": 80
},
"TargetHealth": {
"State": "unused",
"Reason": "Target.NotInUse",
"Description": "Target group is not configured to receive traffic from the load balancer"
}
}
]
}
```
O exemplo de saída a seguir é de um destino cujo grupo de destino foi especificado em uma ação de um receptor. O destino ainda está sendo registrado.
```
{
"TargetHealthDescriptions": [
{
"HealthCheckPort": "80",
"Target": {
"Id": "i-0f76fade",
"Port": 80
},
"TargetHealth": {
"State": "initial",
"Reason": "Elb.RegistrationInProgress",
"Description": "Target registration is in progress"
}
}
]
}
```
O exemplo de saída a seguir é de um destino não íntegro.
```
{
"TargetHealthDescriptions": [
{
"HealthCheckPort": "80",
"Target": {
"Id": "i-0f76fade",
"Port": 80
},
"TargetHealth": {
"State": "unhealthy",
"Reason": "Target.Timeout",
"Description": "Connection to target timed out"
}
}
]
}
```
O exemplo de saída a seguir é de um destino que é uma função do Lambda e com verificações de integridade desabilitadas.
```
{
"TargetHealthDescriptions": [
{
"Target": {
"Id": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
"AvailabilityZone": "all",
},
"TargetHealth": {
"State": "unavailable",
"Reason": "Target.HealthCheckDisabled",
"Description": "Health checks are not enabled for this target"
}
}
]
}
```
+ Consulte detalhes da API em [DescribeTargetHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/describe-target-health.html) na *Referência de comandos da AWS CLI*.
### `modify-listener`
O código de exemplo a seguir mostra como usar `modify-listener`.
**AWS CLI**
**Exemplo 1: alterar a ação padrão para uma ação de encaminhamento**
O exemplo `modify-listener` a seguir altera a ação padrão para uma ação de `forward` para o receptor especificado.
```
aws elbv2 modify-listener \
--listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f
```
Resultado:
```
{
"Listeners": [
{
"ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2",
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
"Protocol": "HTTP",
"Port": 80,
"DefaultActions": [
{
"Type": "forward",
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f"
}
]
}
]
}
```
**Exemplo 2: alterar a ação padrão para uma ação de redirecionamento**
O exemplo `modify-listener` a seguir altera a ação padrão para uma ação de `redirect` para o receptor especificado.
```
aws elbv2 modify-listener \
--listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 \
--default-actions Type=redirect, RedirectConfig='{Protocol=HTTPS,StatusCode=HTTP_302}'
```
Resultado:
```
{
"Listeners": [
{
"ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2",
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
"Protocol": "HTTP",
"Port": 80,
"DefaultActions": [
{
"Type": "redirect",
"RedirectConfig": {
"Protocol": "HTTPS",
"Port": "#{port}",
"Host": "#{host}",
"Path": "/#{path}",
"Query": "#{query}",
"StatusCode": "HTTP_302",
}
}
]
}
]
}
```
**Exemplo 3: alterar o certificado do servidor**
O exemplo `modify-listener` a seguir altera o certificado do servidor para o receptor HTTPS especificado.
```
aws elbv2 modify-listener \
--listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65 \
--certificates CertificateArn=arn:aws:iam::123456789012:server-certificate/my-new-server-cert
```
Resultado:
```
{
"Listeners": [
{
"ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65",
"LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
"Protocol": "HTTPS",
"Port": 443,
"DefaultActions": [
{
"Type": "forward",
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"
}
],
"SslPolicy": "ELBSecurityPolicy-2015-05",
"Certificates": [
{
"CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-new-server-cert"
}
],
}
]
}
```
Para ter mais informações, consulte [Listener rules](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html#listener-rules) no *Guia do usuário de Application Load Balancers*.
+ Para ver detalhes da API, consulte [ModifyListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/modify-listener.html) na *Referência de comandos da AWS CLI*.
### `modify-load-balancer-attributes`
O código de exemplo a seguir mostra como usar `modify-load-balancer-attributes`.
**AWS CLI**
**Ativar a proteção contra exclusão**
Este exemplo habilita a proteção contra exclusão do balanceador de carga especificado.
Comando:
```
aws elbv2 modify-load-balancer-attributes --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --attributes Key=deletion_protection.enabled,Value=true
```
Resultado:
```
{
"Attributes": [
{
"Value": "true",
"Key": "deletion_protection.enabled"
},
{
"Value": "false",
"Key": "access_logs.s3.enabled"
},
{
"Value": "60",
"Key": "idle_timeout.timeout_seconds"
},
{
"Value": "",
"Key": "access_logs.s3.prefix"
},
{
"Value": "",
"Key": "access_logs.s3.bucket"
}
]
}
```
**Alterar o tempo limite de inatividade**
Este exemplo altera o valor do tempo limite de inatividade do balanceador de carga especificado.
Comando:
```
aws elbv2 modify-load-balancer-attributes --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --attributes Key=idle_timeout.timeout_seconds,Value=30
```
Resultado:
```
{
"Attributes": [
{
"Value": "30",
"Key": "idle_timeout.timeout_seconds"
},
{
"Value": "false",
"Key": "access_logs.s3.enabled"
},
{
"Value": "",
"Key": "access_logs.s3.prefix"
},
{
"Value": "true",
"Key": "deletion_protection.enabled"
},
{
"Value": "",
"Key": "access_logs.s3.bucket"
}
]
}
```
**Habilitar logs de acesso**
Este exemplo habilita os logs de acesso para o balanceador de carga especificado. Observe que o bucket do S3 deve existir na mesma região que o balanceador de carga e deve conter uma política anexada que conceda acesso ao serviço Elastic Load Balancing.
Comando:
```
aws elbv2 modify-load-balancer-attributes --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --attributes Key=access_logs.s3.enabled,Value=true Key=access_logs.s3.bucket,Value=my-loadbalancer-logs Key=access_logs.s3.prefix,Value=myapp
```
Resultado:
```
{
"Attributes": [
{
"Value": "true",
"Key": "access_logs.s3.enabled"
},
{
"Value": "my-load-balancer-logs",
"Key": "access_logs.s3.bucket"
},
{
"Value": "myapp",
"Key": "access_logs.s3.prefix"
},
{
"Value": "60",
"Key": "idle_timeout.timeout_seconds"
},
{
"Value": "false",
"Key": "deletion_protection.enabled"
}
]
}
```
+ Para ver detalhes da API, consulte [ModifyLoadBalancerAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/modify-load-balancer-attributes.html) na *Referência de comandos da AWS CLI*.
### `modify-rule`
O código de exemplo a seguir mostra como usar `modify-rule`.
**AWS CLI**
**Modificar uma regra**
O exemplo `modify-rule` a seguir atualiza as ações e condições da regra especificada.
```
aws elbv2 modify-rule \
--actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 \
--conditions Field=path-pattern,Values='/images/*'
--rule-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee
```
Resultado:
```
{
"Rules": [
{
"Priority": "10",
"Conditions": [
{
"Field": "path-pattern",
"Values": [
"/images/*"
]
}
],
"RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee",
"IsDefault": false,
"Actions": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
"Type": "forward"
}
]
}
]
}
```
+ Para ver detalhes da API, consulte [ModifyRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/modify-rule.html) na *Referência de comandos da AWS CLI*.
### `modify-target-group-attributes`
O código de exemplo a seguir mostra como usar `modify-target-group-attributes`.
**AWS CLI**
**Modificar o tempo limite de atraso do cancelamento de registro**
Este exemplo define o tempo limite do atraso de cancelamento de registro para o valor especificado para o grupo de destino especificado.
Comando:
```
aws elbv2 modify-target-group-attributes --target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 --attributes Key=deregistration_delay.timeout_seconds,Value=600
```
Resultado:
```
{
"Attributes": [
{
"Value": "false",
"Key": "stickiness.enabled"
},
{
"Value": "600",
"Key": "deregistration_delay.timeout_seconds"
},
{
"Value": "lb_cookie",
"Key": "stickiness.type"
},
{
"Value": "86400",
"Key": "stickiness.lb_cookie.duration_seconds"
}
]
}
```
+ Para ver detalhes da API, consulte [ModifyTargetGroupAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/modify-target-group-attributes.html) na *Referência de comandos da AWS CLI*.
### `modify-target-group`
O código de exemplo a seguir mostra como usar `modify-target-group`.
**AWS CLI**
**Modificar as configurações de verificação de integridade de um grupo de destino**
O exemplo `modify-target-group` a seguir altera a configuração das verificações de integridade usadas para avaliar a integridade dos destinos para o grupo de destino especificado. Observe que, devido à forma como a CLI analisa as vírgulas, você deve delimitar o intervalo da opção `--matcher` com aspas simples em vez de aspas duplas.
```
aws elbv2 modify-target-group \
--target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-https-targets/2453ed029918f21f \
--health-check-protocol HTTPS \
--health-check-port 443 \
--matcher HttpCode='200,299'
```
Resultado:
```
{
"TargetGroups": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-https-targets/2453ed029918f21f",
"TargetGroupName": "my-https-targets",
"Protocol": "HTTPS",
"Port": 443,
"VpcId": "vpc-3ac0fb5f",
"HealthCheckProtocol": "HTTPS",
"HealthCheckPort": "443",
"HealthCheckEnabled": true,
"HealthCheckIntervalSeconds": 30,
"HealthCheckTimeoutSeconds": 5,
"HealthyThresholdCount": 5,
"UnhealthyThresholdCount": 2,
"Matcher": {
"HttpCode": "200,299"
},
"LoadBalancerArns": [
"arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
],
"TargetType": "instance",
"ProtocolVersion": "HTTP1",
"IpAddressType": "ipv4"
}
]
}
```
Para ter mais informações, consulte [Grupos de destino](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html) no *Guia do Application Load Balancer*.
+ Para ver detalhes da API, consulte [ModifyTargetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/modify-target-group.html) na *Referência de comandos da AWS CLI*.
### `register-targets`
O código de exemplo a seguir mostra como usar `register-targets`.
**AWS CLI**
**Exemplo 1: registrar destinos com um grupo de destino por ID de instância**
O exemplo `register-targets` a seguir registra as instâncias especificadas com um grupo de destino. O grupo de destino deve ter um tipo de destino de `instance`.
```
aws elbv2 register-targets \
--target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067 \
--targets Id=i-1234567890abcdef0 Id=i-0abcdef1234567890
```
**Exemplo 2: registrar destinos em um grupo de destino usando substituições de porta**
O exemplo `register-targets` a seguir registra a instância especificada com um grupo de destino usando várias portas. Isso permite que você registre contêineres na mesma instância que os destinos no grupo de destino.
```
aws elbv2 register-targets \
--target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-internal-targets/3bb63f11dfb0faf9 \
--targets Id=i-0598c7d356eba48d7,Port=80 Id=i-0598c7d356eba48d7,Port=766
```
**Exemplo 3: registrar destinos com um grupo de destino por endereço IP**
O exemplo `register-targets` a seguir registra os endereços IP especificados com um grupo de destino. O grupo de destino deve ter um tipo de destino de `ip`.
```
aws elbv2 register-targets \
--target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-tcp-ip-targets/8518e899d173178f \
--targets Id=10.0.1.15 Id=10.0.1.23
```
**Exemplo 4: registrar uma função do Lambda como um destino**
O exemplo `register-targets` a seguir registra os endereços IP especificados com um grupo de destino. O grupo de destino deve ter um tipo de destino de `lambda`. O Elastic Load Balancing precisa ter permissão para invocar cada função do Lambda.
```
aws elbv2 register-targets \
--target-group-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-tcp-ip-targets/8518e899d173178f \
--targets Id=arn:aws:lambda:us-west-2:123456789012:function:my-function
```
+ Para ver detalhes da API, consulte [RegisterTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/register-targets.html) na *Referência de comandos da AWS CLI*.
### `remove-listener-certificates`
O código de exemplo a seguir mostra como usar `remove-listener-certificates`.
**AWS CLI**
**Remover um certificado de um receptor seguro**
Este exemplo remove os certificados especificados do receptor seguro especificado.
Comando:
```
aws elbv2 remove-listener-certificates --listener-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2 --certificates CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/5cc54884-f4a3-4072-80be-05b9ba72f705
```
+ Para ver detalhes da API, consulte [RemoveListenerCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/remove-listener-certificates.html) na *Referência de comandos da AWS CLI*.
### `remove-tags`
O código de exemplo a seguir mostra como usar `remove-tags`.
**AWS CLI**
**Remover tags de um balanceador de carga**
O exemplo `remove-tags` a seguir remove as tags `project` e `department` do balanceador de carga especificado.
```
aws elbv2 remove-tags \
--resource-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 \
--tag-keys project department
```
+ Para ver detalhes da API, consulte [RemoveTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/remove-tags.html) na *Referência de comandos da AWS CLI*.
### `set-ip-address-type`
O código de exemplo a seguir mostra como usar `set-ip-address-type`.
**AWS CLI**
**Definir o tipo de endereço de um balanceador de carga**
Este exemplo define o tipo de endereço do balanceador de carga especificado como `dualstack`. As sub-redes do balanceador de carga devem conter blocos CIDR IPv6 associados.
Comando:
```
aws elbv2 set-ip-address-type --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --ip-address-type dualstack
```
Resultado:
```
{
"IpAddressType": "dualstack"
}
```
+ Para encontrar detalhes da API, consulte [SetIpAddressType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/set-ip-address-type.html) na *Referência de comandos da AWS CLI*.
### `set-rule-priorities`
O código de exemplo a seguir mostra como usar `set-rule-priorities`.
**AWS CLI**
**Definir a prioridade da regra**
Este exemplo define a prioridade da regra especificada.
Comando:
```
aws elbv2 set-rule-priorities --rule-priorities RuleArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3,Priority=5
```
Resultado:
```
{
"Rules": [
{
"Priority": "5",
"Conditions": [
{
"Field": "path-pattern",
"Values": [
"/img/*"
]
}
],
"RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3",
"IsDefault": false,
"Actions": [
{
"TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
"Type": "forward"
}
]
}
]
}
```
+ Para ver detalhes da API, consulte [SetRulePriorities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/set-rule-priorities.html) na *Referência de comandos da AWS CLI*.
### `set-security-groups`
O código de exemplo a seguir mostra como usar `set-security-groups`.
**AWS CLI**
**Associar um grupo de segurança a um balanceador de carga**
Este exemplo associa o grupo de segurança especificado ao balanceador de carga especificado.
Comando:
```
aws elbv2 set-security-groups --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --security-groups sg-5943793c
```
Resultado:
```
{
"SecurityGroupIds": [
"sg-5943793c"
]
}
```
+ Para ver detalhes da API, consulte [SetSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/set-security-groups.html) na *Referência de comandos da AWS CLI*.
### `set-subnets`
O código de exemplo a seguir mostra como usar `set-subnets`.
**AWS CLI**
**Habilitar Zonas de Disponibilidade para um balanceador de carga**
Este exemplo habilita a Zona de Disponibilidade da sub-rede especificada para o balanceador de carga especificado.
Comando:
```
aws elbv2 set-subnets --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --subnets subnet-8360a9e7 subnet-b7d581c0
```
Resultado:
```
{
"AvailabilityZones": [
{
"SubnetId": "subnet-8360a9e7",
"ZoneName": "us-west-2a"
},
{
"SubnetId": "subnet-b7d581c0",
"ZoneName": "us-west-2b"
}
]
}
```
+ Para ver detalhes da API, consulte [SetSubnets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elbv2/set-subnets.html) na *Referência de comandos da AWS CLI*.