As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Trabalhe com de Amazon EC2
Esta seção apresenta exemplos de como programar o [Amazon EC2](https://docs.aws.amazon.com/ec2/) usando o AWS SDK para Java 2.x.
**Topics**
+ [Gerenciar Amazon EC2 instâncias](examples-ec2-instances.md)
+ [Zonas Regiões da AWS de uso e disponibilidade](examples-ec2-regions-zones.md)
+ [Trabalho com grupos de segurança no Amazon EC2](examples-ec2-security-groups.md)
+ [Trabalhar com metadados da instância do Amazon EC2](examples-ec2-IMDS.md)
# Gerenciar Amazon EC2 instâncias
## Criar uma instância do
Crie uma nova Amazon EC2 instância chamando o [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#runInstances(software.amazon.awssdk.services.ec2.model.RunInstancesRequest)](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#runInstances(software.amazon.awssdk.services.ec2.model.RunInstancesRequest))método do [Ec2Client](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html), fornecendo a ela uma [imagem de [RunInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/RunInstancesRequest.html)máquina da Amazon (AMI)](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/AMIs.html) a ser usada e um tipo de [instância](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instance-types.html).
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.InstanceType;
import software.amazon.awssdk.services.ec2.model.RunInstancesRequest;
import software.amazon.awssdk.services.ec2.model.RunInstancesResponse;
import software.amazon.awssdk.services.ec2.model.Tag;
import software.amazon.awssdk.services.ec2.model.CreateTagsRequest;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;
```
**Código**
```
public static String createEC2Instance(Ec2Client ec2,String name, String amiId ) {
RunInstancesRequest runRequest = RunInstancesRequest.builder()
.imageId(amiId)
.instanceType(InstanceType.T1_MICRO)
.maxCount(1)
.minCount(1)
.build();
RunInstancesResponse response = ec2.runInstances(runRequest);
String instanceId = response.instances().get(0).instanceId();
Tag tag = Tag.builder()
.key("Name")
.value(name)
.build();
CreateTagsRequest tagRequest = CreateTagsRequest.builder()
.resources(instanceId)
.tags(tag)
.build();
try {
ec2.createTags(tagRequest);
System.out.printf(
"Successfully started EC2 Instance %s based on AMI %s",
instanceId, amiId);
return instanceId;
} catch (Ec2Exception e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return "";
}
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/CreateInstance.java) em GitHub.
## Iniciar uma instância
Para iniciar uma Amazon EC2 instância, chame o [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#startInstances(software.amazon.awssdk.services.ec2.model.StartInstancesRequest)](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#startInstances(software.amazon.awssdk.services.ec2.model.StartInstancesRequest))método do Ec2Client, fornecendo a ele um [StartInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/StartInstancesRequest.html)contendo o ID da instância a ser iniciada.
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.StartInstancesRequest;
import software.amazon.awssdk.services.ec2.model.StopInstancesRequest;
```
**Código**
```
public static void startInstance(Ec2Client ec2, String instanceId) {
StartInstancesRequest request = StartInstancesRequest.builder()
.instanceIds(instanceId)
.build();
ec2.startInstances(request);
System.out.printf("Successfully started instance %s", instanceId);
}
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/StartStopInstance.java) em GitHub.
## Interromper uma instância
Para interromper uma Amazon EC2 instância, chame o [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#stopInstances(software.amazon.awssdk.services.ec2.model.StopInstancesRequest)](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#stopInstances(software.amazon.awssdk.services.ec2.model.StopInstancesRequest))método do Ec2Client, fornecendo a ele um [StopInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/StopInstancesRequest.html)contendo o ID da instância a ser interrompida.
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.StartInstancesRequest;
import software.amazon.awssdk.services.ec2.model.StopInstancesRequest;
```
**Código**
```
public static void stopInstance(Ec2Client ec2, String instanceId) {
StopInstancesRequest request = StopInstancesRequest.builder()
.instanceIds(instanceId)
.build();
ec2.stopInstances(request);
System.out.printf("Successfully stopped instance %s", instanceId);
}
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/StartStopInstance.java) em GitHub.
## Reinicializar uma instância
Para reinicializar uma Amazon EC2 instância, chame o [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#rebootInstances(software.amazon.awssdk.services.ec2.model.RebootInstancesRequest)](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#rebootInstances(software.amazon.awssdk.services.ec2.model.RebootInstancesRequest))método do Ec2Client, fornecendo a ele um [RebootInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/RebootInstancesRequest.html)contendo o ID da instância a ser reinicializada.
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;
import software.amazon.awssdk.services.ec2.model.RebootInstancesRequest;
```
**Código**
```
public static void rebootEC2Instance(Ec2Client ec2, String instanceId) {
try {
RebootInstancesRequest request = RebootInstancesRequest.builder()
.instanceIds(instanceId)
.build();
ec2.rebootInstances(request);
System.out.printf(
"Successfully rebooted instance %s", instanceId);
} catch (Ec2Exception e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/RebootInstance.java) em GitHub.
## Descrever instâncias
Para listar suas instâncias, crie um [DescribeInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeInstancesRequest.html)e chame o método do Ec2Client. [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#describeInstances(software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest)](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#describeInstances(software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest)) Ele retornará um [DescribeInstancesResponse](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeInstancesResponse.html)objeto que você pode usar para listar as Amazon EC2 instâncias da sua conta e região.
As instâncias são agrupadas por *reserva*. Cada reserva corresponde à chamada a `startInstances` que iniciou a instância. Para listar as instâncias, você deve primeiro chamar o método `reservations` da classe `DescribeInstancesResponse` e chamar `instances` em cada objeto [Reservation](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/Reservation.html) retornado.
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.DescribeInstancesRequest;
import software.amazon.awssdk.services.ec2.model.DescribeInstancesResponse;
import software.amazon.awssdk.services.ec2.model.Instance;
import software.amazon.awssdk.services.ec2.model.Reservation;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;
```
**Código**
```
public static void describeEC2Instances( Ec2Client ec2){
String nextToken = null;
try {
do {
DescribeInstancesRequest request = DescribeInstancesRequest.builder().maxResults(6).nextToken(nextToken).build();
DescribeInstancesResponse response = ec2.describeInstances(request);
for (Reservation reservation : response.reservations()) {
for (Instance instance : reservation.instances()) {
System.out.println("Instance Id is " + instance.instanceId());
System.out.println("Image id is "+ instance.imageId());
System.out.println("Instance type is "+ instance.instanceType());
System.out.println("Instance state name is "+ instance.state().name());
System.out.println("monitoring information is "+ instance.monitoring().state());
}
}
nextToken = response.nextToken();
} while (nextToken != null);
} catch (Ec2Exception e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
Os resultados são paginados; você pode obter mais resultados passando o valor retornado do método `nextToken` do objeto de resultado para o método `nextToken` do objeto de uma solicitação nova e usando o objeto da nova solicitação na próxima chamada para `describeInstances`.
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/DescribeInstances.java) em GitHub.
## Monitorar uma instância
Você pode monitorar vários aspectos de suas Amazon EC2 instâncias, como utilização da CPU e da rede, memória disponível e espaço em disco restante. Para saber mais sobre o monitoramento de instâncias, consulte [Monitoramento Amazon EC2](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/monitoring_ec2.html) no Guia Amazon EC2 do usuário para instâncias Linux.
Para começar a monitorar uma instância, você deve criar uma [MonitorInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/MonitorInstancesRequest.html)com o ID da instância a ser monitorada e passá-la para o método do Ec2Client. [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#monitorInstances(software.amazon.awssdk.services.ec2.model.MonitorInstancesRequest)](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#monitorInstances(software.amazon.awssdk.services.ec2.model.MonitorInstancesRequest))
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.MonitorInstancesRequest;
import software.amazon.awssdk.services.ec2.model.UnmonitorInstancesRequest;
```
**Código**
```
public static void monitorInstance( Ec2Client ec2, String instanceId) {
MonitorInstancesRequest request = MonitorInstancesRequest.builder()
.instanceIds(instanceId).build();
ec2.monitorInstances(request);
System.out.printf(
"Successfully enabled monitoring for instance %s",
instanceId);
}
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/MonitorInstance.java) em GitHub.
## Interromper o monitoramento de instâncias
Para parar de monitorar uma instância, crie um [UnmonitorInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/UnmonitorInstancesRequest.html)com o ID da instância para interromper o monitoramento e passe-o para o método do Ec2Client. [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#unmonitorInstances(software.amazon.awssdk.services.ec2.model.UnmonitorInstancesRequest)](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html#unmonitorInstances(software.amazon.awssdk.services.ec2.model.UnmonitorInstancesRequest))
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.MonitorInstancesRequest;
import software.amazon.awssdk.services.ec2.model.UnmonitorInstancesRequest;
```
**Código**
```
public static void unmonitorInstance(Ec2Client ec2, String instanceId) {
UnmonitorInstancesRequest request = UnmonitorInstancesRequest.builder()
.instanceIds(instanceId).build();
ec2.unmonitorInstances(request);
System.out.printf(
"Successfully disabled monitoring for instance %s",
instanceId);
}
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/MonitorInstance.java) em GitHub.
## Mais informações
+ [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html)na Referência da Amazon EC2 API
+ [DescribeInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html)na Referência da Amazon EC2 API
+ [StartInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StartInstances.html)na Referência da Amazon EC2 API
+ [StopInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StopInstances.html)na Referência da Amazon EC2 API
+ [RebootInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RebootInstances.html)na Referência da Amazon EC2 API
+ [MonitorInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_MonitorInstances.html)na Referência da Amazon EC2 API
+ [UnmonitorInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_UnmonitorInstances.html)na Referência da Amazon EC2 API
# Zonas Regiões da AWS de uso e disponibilidade
## Descrever regiões
Para listar as regiões disponíveis para a conta, chame o método `describeRegions` do Ec2Client. Ele retorna um [DescribeRegionsResponse](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeRegionsResponse.html). Chame o método `regions` do objeto retornado para obter uma lista de objetos [Region](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/Region.html) que representam cada região.
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2AsyncClient;
import software.amazon.awssdk.services.ec2.model.DescribeRegionsResponse;
import software.amazon.awssdk.services.ec2.model.DescribeAvailabilityZonesResponse;
import java.util.concurrent.CompletableFuture;
```
**Código**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2AsyncClient;
import software.amazon.awssdk.services.ec2.model.DescribeRegionsResponse;
import software.amazon.awssdk.services.ec2.model.DescribeAvailabilityZonesResponse;
import java.util.concurrent.CompletableFuture;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class DescribeRegionsAndZones {
public static void main(String[] args) {
Ec2AsyncClient ec2AsyncClient = Ec2AsyncClient.builder()
.region(Region.US_EAST_1)
.build();
try {
CompletableFuture future = describeEC2RegionsAndZonesAsync(ec2AsyncClient);
future.join(); // Wait for both async operations to complete.
} catch (RuntimeException rte) {
System.err.println("An exception occurred: " + (rte.getCause() != null ? rte.getCause().getMessage() : rte.getMessage()));
}
}
/**
* Asynchronously describes the EC2 regions and availability zones.
*
* @param ec2AsyncClient the EC2 async client used to make the API calls
* @return a {@link CompletableFuture} that completes when both the region and availability zone descriptions are complete
*/
public static CompletableFuture describeEC2RegionsAndZonesAsync(Ec2AsyncClient ec2AsyncClient) {
// Initiate the asynchronous request to describe regions
CompletableFuture regionsResponse = ec2AsyncClient.describeRegions();
// Handle the response or exception for regions
CompletableFuture regionsFuture = regionsResponse.whenComplete((regionsResp, ex) -> {
if (ex != null) {
// Handle the exception by throwing a RuntimeException
throw new RuntimeException("Failed to describe EC2 regions.", ex);
} else if (regionsResp == null || regionsResp.regions().isEmpty()) {
// Throw an exception if the response is null or the result is empty
throw new RuntimeException("No EC2 regions found.");
} else {
// Process the response if no exception occurred and the result is not empty
regionsResp.regions().forEach(region -> {
System.out.printf(
"Found Region %s with endpoint %s%n",
region.regionName(),
region.endpoint());
});
}
});
CompletableFuture zonesResponse = ec2AsyncClient.describeAvailabilityZones();
CompletableFuture zonesFuture = zonesResponse.whenComplete((zonesResp, ex) -> {
if (ex != null) {
throw new RuntimeException("Failed to describe EC2 availability zones.", ex);
} else if (zonesResp == null || zonesResp.availabilityZones().isEmpty()) {
throw new RuntimeException("No EC2 availability zones found.");
} else {
zonesResp.availabilityZones().forEach(zone -> {
System.out.printf(
"Found Availability Zone %s with status %s in region %s%n",
zone.zoneName(),
zone.state(),
zone.regionName()
);
});
}
});
return CompletableFuture.allOf(regionsFuture, zonesFuture);
}
}
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/7486a1a092aa8e16a21698ef26f9d524fef62e55/javav2/example_code/ec2/src/main/java/com/example/ec2/DescribeRegionsAndZones.java) em GitHub.
## Descrever zonas de disponibilidade
Para listar cada zona de disponibilidade disponível para a conta, chame o método `describeAvailabilityZones` do Ec2Client. Ele retorna um [DescribeAvailabilityZonesResponse](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeAvailabilityZonesResponse.html). Chame seu `availabilityZones` método para obter uma lista de [AvailabilityZone](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/AvailabilityZone.html)objetos que representam cada zona de disponibilidade.
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2AsyncClient;
import software.amazon.awssdk.services.ec2.model.DescribeRegionsResponse;
import software.amazon.awssdk.services.ec2.model.DescribeAvailabilityZonesResponse;
import java.util.concurrent.CompletableFuture;
```
**Código**
Criar o Ec2Client.
```
Ec2AsyncClient ec2AsyncClient = Ec2AsyncClient.builder()
.region(Region.US_EAST_1)
.build();
```
Em seguida, chame describeAvailabilityZones () e recupere os resultados.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2AsyncClient;
import software.amazon.awssdk.services.ec2.model.DescribeRegionsResponse;
import software.amazon.awssdk.services.ec2.model.DescribeAvailabilityZonesResponse;
import java.util.concurrent.CompletableFuture;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class DescribeRegionsAndZones {
public static void main(String[] args) {
Ec2AsyncClient ec2AsyncClient = Ec2AsyncClient.builder()
.region(Region.US_EAST_1)
.build();
try {
CompletableFuture future = describeEC2RegionsAndZonesAsync(ec2AsyncClient);
future.join(); // Wait for both async operations to complete.
} catch (RuntimeException rte) {
System.err.println("An exception occurred: " + (rte.getCause() != null ? rte.getCause().getMessage() : rte.getMessage()));
}
}
/**
* Asynchronously describes the EC2 regions and availability zones.
*
* @param ec2AsyncClient the EC2 async client used to make the API calls
* @return a {@link CompletableFuture} that completes when both the region and availability zone descriptions are complete
*/
public static CompletableFuture describeEC2RegionsAndZonesAsync(Ec2AsyncClient ec2AsyncClient) {
// Initiate the asynchronous request to describe regions
CompletableFuture regionsResponse = ec2AsyncClient.describeRegions();
// Handle the response or exception for regions
CompletableFuture regionsFuture = regionsResponse.whenComplete((regionsResp, ex) -> {
if (ex != null) {
// Handle the exception by throwing a RuntimeException
throw new RuntimeException("Failed to describe EC2 regions.", ex);
} else if (regionsResp == null || regionsResp.regions().isEmpty()) {
// Throw an exception if the response is null or the result is empty
throw new RuntimeException("No EC2 regions found.");
} else {
// Process the response if no exception occurred and the result is not empty
regionsResp.regions().forEach(region -> {
System.out.printf(
"Found Region %s with endpoint %s%n",
region.regionName(),
region.endpoint());
});
}
});
CompletableFuture zonesResponse = ec2AsyncClient.describeAvailabilityZones();
CompletableFuture zonesFuture = zonesResponse.whenComplete((zonesResp, ex) -> {
if (ex != null) {
throw new RuntimeException("Failed to describe EC2 availability zones.", ex);
} else if (zonesResp == null || zonesResp.availabilityZones().isEmpty()) {
throw new RuntimeException("No EC2 availability zones found.");
} else {
zonesResp.availabilityZones().forEach(zone -> {
System.out.printf(
"Found Availability Zone %s with status %s in region %s%n",
zone.zoneName(),
zone.state(),
zone.regionName()
);
});
}
});
return CompletableFuture.allOf(regionsFuture, zonesFuture);
}
}
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/7486a1a092aa8e16a21698ef26f9d524fef62e55/javav2/example_code/ec2/src/main/java/com/example/ec2/DescribeRegionsAndZones.java) em GitHub.
## Descrever contas
Para listar informações EC2 relacionadas à sua conta, chame o método do Ec2Client. `describeAccountAttributes` Esse método retorna um objeto [DescribeAccountAttributesResponse](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeAccountAttributesResponse.html). Invoque esse `accountAttributes` método de objetos para obter uma lista de [AccountAttribute](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/AccountAttribute.html)objetos. É possível iterar a lista para recuperar um objeto `AccountAttribute`.
Você pode obter os valores dos atributos da sua conta invocando o método `attributeValues` do objeto `AccountAttribute`. Esse método retorna uma lista de [AccountAttributeValue](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/AccountAttributeValue.html)objetos. É possível percorrer essa segunda lista para exibir o valor dos atributos (veja o exemplo de código a seguir).
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2AsyncClient;
import software.amazon.awssdk.services.ec2.model.DescribeAccountAttributesResponse;
import java.util.concurrent.CompletableFuture;
```
**Código**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2AsyncClient;
import software.amazon.awssdk.services.ec2.model.DescribeAccountAttributesResponse;
import java.util.concurrent.CompletableFuture;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class DescribeAccount {
public static void main(String[] args) {
Ec2AsyncClient ec2AsyncClient = Ec2AsyncClient.builder()
.region(Region.US_EAST_1)
.build();
try {
CompletableFuture future = describeEC2AccountAsync(ec2AsyncClient);
future.join();
System.out.println("EC2 Account attributes described successfully.");
} catch (RuntimeException rte) {
System.err.println("An exception occurred: " + (rte.getCause() != null ? rte.getCause().getMessage() : rte.getMessage()));
}
}
/**
* Describes the EC2 account attributes asynchronously.
*
* @param ec2AsyncClient the EC2 asynchronous client to use for the operation
* @return a {@link CompletableFuture} containing the {@link DescribeAccountAttributesResponse} with the account attributes
*/
public static CompletableFuture describeEC2AccountAsync(Ec2AsyncClient ec2AsyncClient) {
CompletableFuture response = ec2AsyncClient.describeAccountAttributes();
return response.whenComplete((accountResults, ex) -> {
if (ex != null) {
// Handle the exception by throwing a RuntimeException.
throw new RuntimeException("Failed to describe EC2 account attributes.", ex);
} else if (accountResults == null || accountResults.accountAttributes().isEmpty()) {
// Throw an exception if the response is null or no account attributes are found.
throw new RuntimeException("No account attributes found.");
} else {
// Process the response if no exception occurred.
accountResults.accountAttributes().forEach(attribute -> {
System.out.println("\nThe name of the attribute is " + attribute.attributeName());
attribute.attributeValues().forEach(
myValue -> System.out.println("The value of the attribute is " + myValue.attributeValue()));
});
}
});
}
}
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/7486a1a092aa8e16a21698ef26f9d524fef62e55/javav2/example_code/ec2/src/main/java/com/example/ec2/DescribeAccount.java) em GitHub.
## Mais informações
+ [Regiões e zonas de disponibilidade](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/using-regions-availability-zones.html) no Guia Amazon EC2 do usuário para instâncias Linux
+ [DescribeRegions](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeRegions.html)na Referência da Amazon EC2 API
+ [DescribeAvailabilityZones](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeAvailabilityZones.html)na Referência da Amazon EC2 API
# Trabalho com grupos de segurança no Amazon EC2
## Criar um grupo de segurança
Para criar um grupo de segurança, chame o método `createSecurityGroup` do Ec2Client com um [CreateSecurityGroupRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/CreateSecurityGroupRequest.html) que contenha o nome da chave.
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.CreateSecurityGroupRequest;
import software.amazon.awssdk.services.ec2.model.AuthorizeSecurityGroupIngressRequest;
import software.amazon.awssdk.services.ec2.model.AuthorizeSecurityGroupIngressResponse;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;
import software.amazon.awssdk.services.ec2.model.IpPermission;
import software.amazon.awssdk.services.ec2.model.CreateSecurityGroupResponse;
import software.amazon.awssdk.services.ec2.model.IpRange;
```
**Código da**
```
CreateSecurityGroupRequest createRequest = CreateSecurityGroupRequest.builder()
.groupName(groupName)
.description(groupDesc)
.vpcId(vpcId)
.build();
CreateSecurityGroupResponse resp= ec2.createSecurityGroup(createRequest);
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/0b1785e42949ebf959eaa0f0da4dc2a48f92ea25/javav2/example_code/ec2/src/main/java/com/example/ec2/CreateSecurityGroup.java) no GitHub.
## Configurar um grupo de segurança
Um grupo de segurança pode controlar os tráfegos de entrada e saída para as instâncias do Amazon EC2.
Para adicionar regras de entrada ao grupo de segurança, use o método `authorizeSecurityGroupIngress` do Ec2Client, fornecendo o nome do grupo de segurança e as regras de acesso ([IpPermission](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/IpPermission.html)) que você deseja atribuir a ele dentro de um objeto [AuthorizeSecurityGroupIngressRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/AuthorizeSecurityGroupIngressRequest.html). O exemplo a seguir mostra como adicionar permissões de IP a um grupo de segurança.
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.CreateSecurityGroupRequest;
import software.amazon.awssdk.services.ec2.model.AuthorizeSecurityGroupIngressRequest;
import software.amazon.awssdk.services.ec2.model.AuthorizeSecurityGroupIngressResponse;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;
import software.amazon.awssdk.services.ec2.model.IpPermission;
import software.amazon.awssdk.services.ec2.model.CreateSecurityGroupResponse;
import software.amazon.awssdk.services.ec2.model.IpRange;
```
**Código da**
Primeiro, crie um Ec2Client
```
Region region = Region.US_WEST_2;
Ec2Client ec2 = Ec2Client.builder()
.region(region)
.build();
```
Em seguida, use o método `authorizeSecurityGroupIngress` do Ec2Client,
```
IpRange ipRange = IpRange.builder()
.cidrIp("0.0.0.0/0").build();
IpPermission ipPerm = IpPermission.builder()
.ipProtocol("tcp")
.toPort(80)
.fromPort(80)
.ipRanges(ipRange)
.build();
IpPermission ipPerm2 = IpPermission.builder()
.ipProtocol("tcp")
.toPort(22)
.fromPort(22)
.ipRanges(ipRange)
.build();
AuthorizeSecurityGroupIngressRequest authRequest =
AuthorizeSecurityGroupIngressRequest.builder()
.groupName(groupName)
.ipPermissions(ipPerm, ipPerm2)
.build();
AuthorizeSecurityGroupIngressResponse authResponse =
ec2.authorizeSecurityGroupIngress(authRequest);
System.out.printf(
"Successfully added ingress policy to Security Group %s",
groupName);
return resp.groupId();
} catch (Ec2Exception e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return "";
}
```
Para adicionar uma regra de saída ao grupo de segurança, forneça dados semelhantes em um [AuthorizeSecurityGroupEgressRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/AuthorizeSecurityGroupEgressRequest.html) ao método `authorizeSecurityGroupEgress` do Ec2Client.
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/0b1785e42949ebf959eaa0f0da4dc2a48f92ea25/javav2/example_code/ec2/src/main/java/com/example/ec2/CreateSecurityGroup.java) no GitHub.
## Descrever grupos de segurança
Para descrever os grupos de segurança ou obter informações sobre eles, chame o método `describeSecurityGroups` do Ec2Client. Ele retorna um [DescribeSecurityGroupsResponse](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeSecurityGroupsResponse.html) que pode ser usado para acessar a lista de grupos de segurança chamando o método `securityGroups`, que retorna uma lista de objetos [SecurityGroup](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/SecurityGroup.html).
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.DescribeSecurityGroupsRequest;
import software.amazon.awssdk.services.ec2.model.DescribeSecurityGroupsResponse;
import software.amazon.awssdk.services.ec2.model.SecurityGroup;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;
```
**Código da**
```
public static void describeEC2SecurityGroups(Ec2Client ec2, String groupId) {
try {
DescribeSecurityGroupsRequest request =
DescribeSecurityGroupsRequest.builder()
.groupIds(groupId).build();
DescribeSecurityGroupsResponse response =
ec2.describeSecurityGroups(request);
for(SecurityGroup group : response.securityGroups()) {
System.out.printf(
"Found Security Group with id %s, " +
"vpc id %s " +
"and description %s",
group.groupId(),
group.vpcId(),
group.description());
}
} catch (Ec2Exception e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/0b1785e42949ebf959eaa0f0da4dc2a48f92ea25/javav2/example_code/ec2/src/main/java/com/example/ec2/DescribeSecurityGroups.java) no GitHub.
## Exclua um grupo de segurança
Para excluir um grupo de segurança, chame o método `deleteSecurityGroup` do Ec2Client, passando um [DeleteSecurityGroupRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DeleteSecurityGroupRequest.html) que contenha o ID do grupo de segurança a ser excluído.
**Importações**
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.DeleteSecurityGroupRequest;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;
```
**Código da**
```
public static void deleteEC2SecGroup(Ec2Client ec2,String groupId) {
try {
DeleteSecurityGroupRequest request = DeleteSecurityGroupRequest.builder()
.groupId(groupId)
.build();
ec2.deleteSecurityGroup(request);
System.out.printf(
"Successfully deleted Security Group with id %s", groupId);
} catch (Ec2Exception e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
Veja o [exemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/0b1785e42949ebf959eaa0f0da4dc2a48f92ea25/javav2/example_code/ec2/src/main/java/com/example/ec2/DeleteSecurityGroup.java) no GitHub.
## Mais informações
+ [Grupos de segurança do Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html) no Guia do Usuário Amazon EC2 para Instâncias do Linux
+ [Autorizar tráfego de entrada para suas instâncias Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/authorizing-access-to-an-instance.html) no Guia do usuário do Amazon EC2 para instâncias Linux
+ [CreateSecurityGroup](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html), na Referência de API do Amazon EC2
+ [DescribeSecurityGroups](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroups.html), na Referência de API do Amazon EC2
+ [DeleteSecurityGroup](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteSecurityGroup.html) na Referência de API do Amazon EC2
+ [AuthorizeSecurityGroupIngress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_AuthorizeSecurityGroupIngress.html) na Referência de API do Amazon EC2
# Trabalhar com metadados da instância do Amazon EC2
Um cliente Java SDK para o Amazon EC2 Instance Metadata Service (cliente de metadados) permite que seus aplicativos acessem metadados em sua instância EC2 local. O cliente de metadados trabalha com a instância local do [IMDSv2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html)(Instance Metadata Service v2) e usa solicitações orientadas à sessão.
Duas classes de cliente estão disponíveis no SDK. O `[Ec2MetadataClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/imds/Ec2MetadataClient.html)` síncrono serve para operações de bloqueio e o [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/imds/Ec2MetadataAsyncClient.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/imds/Ec2MetadataAsyncClient.html) é para casos de uso assíncronos e sem bloqueio.
## Conceitos básicos
Para usar o cliente de metadados, adicione o artefato `imds` Maven ao seu projeto. Você também precisa de classes para um `[SdkHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/SdkHttpClient.html)` (ou um `[SdkAsyncHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/async/SdkAsyncHttpClient.html)` para a variante assíncrona) no caminho de classe.
O XML do Maven a seguir mostra trechos de dependência para usar o síncrono [UrlConnectionHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/urlconnection/UrlConnectionHttpClient.html)junto com a dependência para clientes de metadados.
```
software.amazon.awssdk
bom
VERSION
pom
import
software.amazon.awssdk
imds
software.amazon.awssdk
url-connection-client
```
Pesquise no [repositório central do Maven](https://central.sonatype.com/artifact/software.amazon.awssdk/bom) a versão mais recente do artefato `bom`.
Para usar um cliente HTTP assíncrono, substitua o trecho de dependência do artefato `url-connection-client`. Por exemplo, o trecho a seguir traz a [NettyNioAsyncHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/nio/netty/NettyNioAsyncHttpClient.html)implementação.
```
software.amazon.awssdk
netty-nio-client
```
## Usar o cliente de metadados
### Instanciar um cliente de metadados
Você pode instanciar uma instância de um `Ec2MetadataClient` síncrono quando somente uma implementação da interface `SdkHttpClient` está presente no caminho de classe. Para fazer isso, chame o método estático `Ec2MetadataClient#create()`, conforme mostrado no trecho a seguir.
```
Ec2MetadataClient client = Ec2MetadataClient.create(); // 'Ec2MetadataAsyncClient#create' is the asynchronous version.
```
Se seu aplicativo tiver várias implementações da interface `SdkHttpClient` ou `SdkHttpAsyncClient`, você deverá especificar uma implementação para o cliente de metadados usar, conforme mostrado na seção [Cliente HTTP configurável](#examples-ec2-IMDS-features-http).
**nota**
Para a maioria dos clientes de serviços, como o Amazon S3, o SDK for Java adiciona automaticamente implementações da interface `SdkHttpClient` ou `SdkHttpAsyncClient`. Se seu cliente de metadados usar a mesma implementação, o `Ec2MetadataClient#create()` funcionará. Se você precisar de uma implementação diferente, deverá especificá-la ao criar o cliente de metadados.
### Envie solicitações
Para recuperar os metadados da instância, instancie a classe `EC2MetadataClient` e chame o método `get` com um parâmetro de caminho que especifica a [categoria de metadados da instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-categories.html).
O exemplo a seguir imprime o valor associado à chave `ami-id` no console.
```
Ec2MetadataClient client = Ec2MetadataClient.create();
Ec2MetadataResponse response = client.get("/latest/meta-data/ami-id");
System.out.println(response.asString());
client.close(); // Closes the internal resources used by the Ec2MetadataClient class.
```
Se o caminho não for válido, o método `get` gerará uma exceção.
Reutilize a mesma instância do cliente para várias solicitações, mas chame `close` no cliente quando não for mais necessário liberar recursos. Depois que o método de fechamento é chamado, a instância do cliente não pode mais ser usada.
### Analisar respostas
Os metadados da instância EC2 podem ser gerados em formatos diferentes. Texto sem formatação e JSON são os formatos mais usados. Os clientes de metadados oferecem formas de trabalhar com esses formatos.
Como mostra o exemplo a seguir, use o método `asString` para obter os dados como uma string Java. Você também pode usar o método `asList` para separar uma resposta de texto sem formatação que retorna várias linhas.
```
Ec2MetadataClient client = Ec2MetadataClient.create();
Ec2MetadataResponse response = client.get("/latest/meta-data/");
String fullResponse = response.asString();
List splits = response.asList();
```
Se a resposta estiver em JSON, use o método `Ec2MetadataResponse#asDocument` para analisar a resposta JSON em uma instância de [Documento](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/document/Document.html), conforme mostrado no trecho de código a seguir.
```
Document fullResponse = response.asDocument();
```
Uma exceção será lançada se o formato dos metadados não estiver em JSON. Se a resposta for analisada com sucesso, você poderá usar a [API do documento](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/document/package-summary.html) para inspecionar a resposta com mais detalhes. Consulte o [gráfico de categorias de metadados](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-categories.html) da instância para saber quais categorias de metadados fornecem respostas em formato JSON.
## Configurar um cliente de metadados
### Novas tentativas
Você pode configurar um cliente de metadados com um mecanismo de repetição. Se você fizer isso, o cliente poderá repetir automaticamente as solicitações que falharem por motivos inesperados. Por padrão, o cliente tenta novamente três vezes em uma solicitação com falha, com um tempo de recuo exponencial entre as tentativas.
Se seu caso de uso exigir um mecanismo de repetição diferente, você poderá personalizar o cliente usando o método `retryPolicy` em seu construtor. Por exemplo, o exemplo a seguir mostra um cliente síncrono configurado com um atraso fixo de dois segundos entre as tentativas e cinco tentativas de repetição.
```
BackoffStrategy fixedBackoffStrategy = FixedDelayBackoffStrategy.create(Duration.ofSeconds(2));
Ec2MetadataClient client =
Ec2MetadataClient.builder()
.retryPolicy(retryPolicyBuilder -> retryPolicyBuilder.numRetries(5)
.backoffStrategy(fixedBackoffStrategy))
.build();
```
Há várias [BackoffStrategies](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/retry/backoff/package-summary.html)que você pode usar com um cliente de metadados.
Você também pode desativar totalmente o mecanismo de repetição, como mostra o trecho a seguir.
```
Ec2MetadataClient client =
Ec2MetadataClient.builder()
.retryPolicy(Ec2MetadataRetryPolicy.none())
.build();
```
O uso do `Ec2MetadataRetryPolicy#none()` desativa a política de repetição padrão para que o cliente de metadados não tente fazer novas tentativas.
### Versão IP
Por padrão, um cliente de metadados usa o IPV4 endpoint em. `http://169.254.169.254` Para alterar o cliente para usar a IPV6 versão, use o `endpoint` método `endpointMode` ou o do construtor. Uma exceção ocorre se os dois métodos forem chamados no construtor.
Os exemplos a seguir mostram as duas IPV6 opções.
```
Ec2MetadataClient client =
Ec2MetadataClient.builder()
.endpointMode(EndpointMode.IPV6)
.build();
```
```
Ec2MetadataClient client =
Ec2MetadataClient.builder()
.endpoint(URI.create("http://[fd00:ec2::254]"))
.build();
```
## Recursos principais do
### Cliente assíncrono
Para usar a versão sem bloqueio do cliente, instancie uma instância da classe `Ec2MetadataAsyncClient`. O código no exemplo a seguir cria um cliente assíncrono com configurações padrão e usa o método `get` para recuperar o valor da chave `ami-id`.
```
Ec2MetadataAsyncClient asyncClient = Ec2MetadataAsyncClient.create();
CompletableFuture response = asyncClient.get("/latest/meta-data/ami-id");
```
O `java.util.concurrent.CompletableFuture` retornado pelo método `get` é concluído quando a resposta retorna. O exemplo a seguir imprime os metadados `ami-id` no console.
```
response.thenAccept(metadata -> System.out.println(metadata.asString()));
```
### Cliente HTTP configurável
O construtor de cada cliente de metadados tem um método `httpClient` que você pode usar para fornecer um cliente HTTP personalizado.
O exemplo a seguir mostra o código para uma instância personalizada do `UrlConnectionHttpClient`.
```
SdkHttpClient httpClient =
UrlConnectionHttpClient.builder()
.socketTimeout(Duration.ofMinutes(5))
.proxyConfiguration(proxy -> proxy.endpoint(URI.create("http://proxy.example.net:8888"))))
.build();
Ec2MetadataClient metaDataClient =
Ec2MetadataClient.builder()
.httpClient(httpClient)
.build();
// Use the metaDataClient instance.
metaDataClient.close(); // Close the instance when no longer needed.
```
O exemplo a seguir mostra o código de uma instância personalizada do `NettyNioAsyncHttpClient` com um cliente de metadados assíncrono.
```
SdkAsyncHttpClient httpAsyncClient =
NettyNioAsyncHttpClient.builder()
.connectionTimeout(Duration.ofMinutes(5))
.maxConcurrency(100)
.build();
Ec2MetadataAsyncClient asyncMetaDataClient =
Ec2MetadataAsyncClient.builder()
.httpClient(httpAsyncClient)
.build();
// Use the asyncMetaDataClient instance.
asyncMetaDataClient.close(); // Close the instance when no longer needed.
```
O tópico [Configure clientes HTTP no AWS SDK for Java 2.x](http-configuration.md) deste guia fornece detalhes sobre como configurar os clientes HTTP que estão disponíveis no SDK para Java.
### Armazenamento em cache de tokens
Como os metadados usados pelos clientes IMDSv2, todas as solicitações são associadas a uma sessão. Uma sessão é definida por um token que tem uma expiração, que o cliente de metadados gerencia para você. Cada solicitação de metadados reutiliza automaticamente o token até que ele expire.
Por padrão, um token dura seis horas (21.600 segundos). Recomendamos que você mantenha o time-to-live valor padrão, a menos que seu caso de uso específico exija configuração avançada.
Se necessário, configure a duração usando o método `tokenTtl` do construtor. Por exemplo, o código no trecho a seguir cria um cliente com duração de sessão de cinco minutos.
```
Ec2MetadataClient client =
Ec2MetadataClient.builder()
.tokenTtl(Duration.ofMinutes(5))
.build();
```
Se você omitir a chamada do método `tokenTtl` no construtor, a duração padrão de 21.600 será usada em vez disso.