Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bekerja dengan Amazon EC2
Bagian ini memberikan contoh pemrograman [Amazon EC2](https://docs.aws.amazon.com/ec2/)yang menggunakan AWS SDK untuk Java 2.x.
**Topics**
+ [Kelola Amazon EC2 instance](examples-ec2-instances.md)
+ [Zona Penggunaan Wilayah AWS dan Ketersediaan](examples-ec2-regions-zones.md)
+ [Bekerja dengan kelompok keamanan di Amazon EC2](examples-ec2-security-groups.md)
+ [Bekerja dengan metadata instans Amazon EC2](examples-ec2-IMDS.md)
# Kelola Amazon EC2 instance
## Buatlah sebuah instans
Buat Amazon EC2 instance baru dengan memanggil [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))metode [Ec2Client](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/Ec2Client.html), sediakan dengan [RunInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/RunInstancesRequest.html)berisi [Amazon Machine Image (AMI)](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/AMIs.html) untuk digunakan dan jenis [instance](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/instance-types.html).
**Impor**
```
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;
```
**Kode**
```
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 "";
}
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/CreateInstance.java) di GitHub.
## Memulai instans
Untuk memulai sebuah Amazon EC2 instance, panggil [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))metode Ec2Client, sediakan dengan ID [StartInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/StartInstancesRequest.html)yang berisi instance untuk memulai.
**Impor**
```
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;
```
**Kode**
```
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);
}
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/StartStopInstance.java) di GitHub.
## Menghentikan instans
Untuk menghentikan Amazon EC2 instance, panggil [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))metode Ec2Client, berikan ID yang [StopInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/StopInstancesRequest.html)berisi instance untuk berhenti.
**Impor**
```
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;
```
**Kode**
```
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);
}
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/StartStopInstance.java) di GitHub.
## Menyalakan ulang instans
Untuk me-reboot sebuah Amazon EC2 instance, panggil [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))metode Ec2Client, berikan ID yang [RebootInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/RebootInstancesRequest.html)berisi instance untuk reboot.
**Impor**
```
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;
```
**Kode**
```
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);
}
}
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/RebootInstance.java) di GitHub.
## Menjelaskan instans
Untuk membuat daftar instance Anda, buat [DescribeInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeInstancesRequest.html)dan panggil metode 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)) Ini akan mengembalikan [DescribeInstancesResponse](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeInstancesResponse.html)objek yang dapat Anda gunakan untuk daftar Amazon EC2 instance untuk akun dan wilayah Anda.
*Instans dikelompokkan berdasarkan reservasi.* Setiap reservasi sesuai dengan panggilan `startInstances` yang meluncurkan instance. Untuk membuat daftar instance Anda, Anda harus terlebih dahulu memanggil `reservations` metode `DescribeInstancesResponse` kelas, dan kemudian memanggil `instances` setiap objek [Reservasi](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/Reservation.html) yang dikembalikan.
**Impor**
```
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;
```
**Kode**
```
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);
}
}
```
Hasil paged; Anda bisa mendapatkan hasil lebih lanjut dengan meneruskan nilai yang dikembalikan dari `nextToken` metode objek hasil ke `nextToken` metode objek permintaan baru, kemudian menggunakan objek permintaan baru dalam panggilan berikutnya. `describeInstances`
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/DescribeInstances.java) di GitHub.
## Memantau sebuah instance
Anda dapat memantau berbagai aspek Amazon EC2 instance Anda, seperti CPU dan pemanfaatan jaringan, memori yang tersedia, dan ruang disk yang tersisa. Untuk mempelajari lebih lanjut tentang pemantauan instans, lihat [Pemantauan Amazon EC2](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/monitoring_ec2.html) di Panduan Amazon EC2 Pengguna untuk Instans Linux.
Untuk mulai memantau instance, Anda harus membuat [MonitorInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/MonitorInstancesRequest.html)dengan ID instance untuk dipantau, dan meneruskannya ke metode [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))Ec2Client.
**Impor**
```
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;
```
**Kode**
```
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);
}
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/MonitorInstance.java) di GitHub.
## Hentikan pemantauan instans
Untuk menghentikan pemantauan instance, buat [UnmonitorInstancesRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/UnmonitorInstancesRequest.html)dengan ID instance untuk menghentikan pemantauan, dan teruskan ke metode 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))
**Impor**
```
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;
```
**Kode**
```
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);
}
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/ac748d8ef99cd17e297cb74fe13aa671e2679088/javav2/example_code/ec2/src/main/java/com/example/ec2/MonitorInstance.java) di GitHub.
## Informasi selengkapnya
+ [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html)di Referensi Amazon EC2 API
+ [DescribeInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html)di Referensi Amazon EC2 API
+ [StartInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StartInstances.html)di Referensi Amazon EC2 API
+ [StopInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StopInstances.html)di Referensi Amazon EC2 API
+ [RebootInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RebootInstances.html)di Referensi Amazon EC2 API
+ [MonitorInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_MonitorInstances.html)di Referensi Amazon EC2 API
+ [UnmonitorInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_UnmonitorInstances.html)di Referensi Amazon EC2 API
# Zona Penggunaan Wilayah AWS dan Ketersediaan
## Menjelaskan Wilayah
Untuk mencantumkan Wilayah yang tersedia untuk akun Anda, hubungi metode Ec2Client. `describeRegions` Ini mengembalikan a [DescribeRegionsResponse](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeRegionsResponse.html). Panggil `regions` metode objek yang dikembalikan untuk mendapatkan daftar objek [Region](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/Region.html) yang mewakili setiap Region.
**Impor**
```
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;
```
**Kode**
```
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);
}
}
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/7486a1a092aa8e16a21698ef26f9d524fef62e55/javav2/example_code/ec2/src/main/java/com/example/ec2/DescribeRegionsAndZones.java) di GitHub.
## Jelaskan zona ketersediaan
Untuk mencantumkan setiap Availability Zone yang tersedia untuk akun Anda, hubungi metode Ec2Client. `describeAvailabilityZones` Ini mengembalikan a [DescribeAvailabilityZonesResponse](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeAvailabilityZonesResponse.html). Panggil `availabilityZones` metodenya untuk mendapatkan daftar [AvailabilityZone](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/AvailabilityZone.html)objek yang mewakili setiap Availability Zone.
**Impor**
```
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;
```
**Kode**
Buat Ec2Client.
```
Ec2AsyncClient ec2AsyncClient = Ec2AsyncClient.builder()
.region(Region.US_EAST_1)
.build();
```
Kemudian panggil describeAvailabilityZones () dan ambil hasilnya.
```
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);
}
}
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/7486a1a092aa8e16a21698ef26f9d524fef62e55/javav2/example_code/ec2/src/main/java/com/example/ec2/DescribeRegionsAndZones.java) di GitHub.
## Jelaskan akun
Untuk membuat daftar informasi EC2 terkait tentang akun Anda, hubungi metode Ec2Client. `describeAccountAttributes` Metode ini mengembalikan [DescribeAccountAttributesResponse](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeAccountAttributesResponse.html)objek. Memanggil `accountAttributes` metode objek ini untuk mendapatkan daftar [AccountAttribute](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/AccountAttribute.html)objek. Anda dapat mengulangi melalui daftar untuk mengambil objek`AccountAttribute`.
Anda bisa mendapatkan nilai atribut akun Anda dengan menjalankan `attributeValues` metode `AccountAttribute` objek. Metode ini mengembalikan daftar [AccountAttributeValue](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/AccountAttributeValue.html)objek. Anda dapat mengulangi melalui daftar kedua ini untuk menampilkan nilai atribut (lihat contoh kode berikut).
**Impor**
```
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;
```
**Kode**
```
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()));
});
}
});
}
}
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/7486a1a092aa8e16a21698ef26f9d524fef62e55/javav2/example_code/ec2/src/main/java/com/example/ec2/DescribeAccount.java) di GitHub.
## Informasi selengkapnya
+ [Wilayah dan Availability Zone](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/using-regions-availability-zones.html) di Panduan Amazon EC2 Pengguna untuk Instans Linux
+ [DescribeRegions](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeRegions.html)di Referensi Amazon EC2 API
+ [DescribeAvailabilityZones](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeAvailabilityZones.html)di Referensi Amazon EC2 API
# Bekerja dengan kelompok keamanan di Amazon EC2
## Membuat grup keamanan
Untuk membuat grup keamanan, panggil `createSecurityGroup` metode Ec2Client dengan [CreateSecurityGroupRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/CreateSecurityGroupRequest.html)yang berisi nama kunci.
**Impor**
```
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;
```
**Kode**
```
CreateSecurityGroupRequest createRequest = CreateSecurityGroupRequest.builder()
.groupName(groupName)
.description(groupDesc)
.vpcId(vpcId)
.build();
CreateSecurityGroupResponse resp= ec2.createSecurityGroup(createRequest);
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/0b1785e42949ebf959eaa0f0da4dc2a48f92ea25/javav2/example_code/ec2/src/main/java/com/example/ec2/CreateSecurityGroup.java) di GitHub.
## Konfigurasikan grup keamanan
Grup keamanan dapat mengontrol lalu lintas masuk (masuk) dan keluar (keluar) ke instans Anda. Amazon EC2
Untuk menambahkan aturan ingress ke grup keamanan Anda, gunakan `authorizeSecurityGroupIngress` metode Ec2Client, dengan memberikan nama grup keamanan dan aturan akses ([IpPermission](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/IpPermission.html)) yang ingin Anda tetapkan di dalam objek. [AuthorizeSecurityGroupIngressRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/AuthorizeSecurityGroupIngressRequest.html) Contoh berikut menunjukkan cara menambahkan izin IP ke grup keamanan.
**Impor**
```
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;
```
**Kode**
Pertama, buat Ec2Client
```
Region region = Region.US_WEST_2;
Ec2Client ec2 = Ec2Client.builder()
.region(region)
.build();
```
Kemudian gunakan metode Ec2Client, `authorizeSecurityGroupIngress`
```
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 "";
}
```
Untuk menambahkan aturan keluar ke grup keamanan, berikan data serupa dalam metode Ec2Client. [AuthorizeSecurityGroupEgressRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/AuthorizeSecurityGroupEgressRequest.html)`authorizeSecurityGroupEgress`
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/0b1785e42949ebf959eaa0f0da4dc2a48f92ea25/javav2/example_code/ec2/src/main/java/com/example/ec2/CreateSecurityGroup.java) di GitHub.
## Jelaskan kelompok keamanan
Untuk mendeskripsikan grup keamanan Anda atau mendapatkan informasi tentang mereka, hubungi metode Ec2Client. `describeSecurityGroups` Ia mengembalikan [DescribeSecurityGroupsResponse](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DescribeSecurityGroupsResponse.html)yang dapat Anda gunakan untuk mengakses daftar grup keamanan dengan memanggil `securityGroups` metodenya, yang mengembalikan daftar [SecurityGroup](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/SecurityGroup.html)objek.
**Impor**
```
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;
```
**Kode**
```
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);
}
}
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/0b1785e42949ebf959eaa0f0da4dc2a48f92ea25/javav2/example_code/ec2/src/main/java/com/example/ec2/DescribeSecurityGroups.java) di GitHub.
## Menghapus grup keamanan
Untuk menghapus grup keamanan, panggil `deleteSecurityGroup` metode Ec2Client, berikan [DeleteSecurityGroupRequest](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/ec2/model/DeleteSecurityGroupRequest.html)yang berisi ID grup keamanan untuk dihapus.
**Impor**
```
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;
```
**Kode**
```
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);
}
}
```
Lihat [contoh lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/0b1785e42949ebf959eaa0f0da4dc2a48f92ea25/javav2/example_code/ec2/src/main/java/com/example/ec2/DeleteSecurityGroup.java) di GitHub.
## Informasi lain
+ [Amazon EC2 Grup Keamanan](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html) dalam Panduan Amazon EC2 Pengguna untuk Instans Linux
+ [Otorisasi lalu lintas masuk untuk Instans Linux Anda](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/authorizing-access-to-an-instance.html) di Panduan Amazon EC2 Pengguna untuk Instans Linux
+ [CreateSecurityGroup](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html)di Referensi Amazon EC2 API
+ [DescribeSecurityGroups](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroups.html)di Referensi Amazon EC2 API
+ [DeleteSecurityGroup](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteSecurityGroup.html)di Referensi Amazon EC2 API
+ [AuthorizeSecurityGroupIngress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_AuthorizeSecurityGroupIngress.html)di Referensi Amazon EC2 API
# Bekerja dengan metadata instans Amazon EC2
Klien Java SDK untuk Layanan Metadata Instans Amazon EC2 (klien metadata) memungkinkan aplikasi Anda mengakses metadata pada instans EC2 lokal mereka. Klien metadata bekerja dengan instance lokal [IMDSv2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html)(Instance Metadata Service v2) dan menggunakan permintaan berorientasi sesi.
Dua kelas klien tersedia di SDK. Sinkron `[Ec2MetadataClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/imds/Ec2MetadataClient.html)` adalah untuk memblokir operasi, dan untuk kasus penggunaan asinkron, non-pemblokiran. [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)
## Memulai
Untuk menggunakan klien metadata, tambahkan artefak `imds` Maven ke proyek Anda. Anda juga memerlukan kelas untuk `[SdkHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/SdkHttpClient.html)` (atau `[SdkAsyncHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/async/SdkAsyncHttpClient.html)` untuk varian asinkron) pada classpath.
Berikut Maven XMLmenunjukkan cuplikan dependensi untuk menggunakan sinkron [UrlConnectionHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/urlconnection/UrlConnectionHttpClient.html)bersama dengan ketergantungan untuk klien metadata.
```
software.amazon.awssdk
bom
VERSION
pom
import
software.amazon.awssdk
imds
software.amazon.awssdk
url-connection-client
```
Cari [repositori pusat Maven](https://central.sonatype.com/artifact/software.amazon.awssdk/bom) untuk versi artefak terbaru. `bom`
Untuk menggunakan klien HTTP asinkron, ganti cuplikan ketergantungan untuk artefak. `url-connection-client` Misalnya, cuplikan berikut membawa implementasi. [NettyNioAsyncHttpClient](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/nio/netty/NettyNioAsyncHttpClient.html)
```
software.amazon.awssdk
netty-nio-client
```
## Gunakan klien metadata
### Membuat instance klien metadata
Anda dapat membuat instance sinkron `Ec2MetadataClient` ketika hanya satu implementasi `SdkHttpClient` antarmuka yang ada di classpath. Untuk melakukannya, panggil `Ec2MetadataClient#create()` metode statis seperti yang ditunjukkan pada cuplikan berikut.
```
Ec2MetadataClient client = Ec2MetadataClient.create(); // 'Ec2MetadataAsyncClient#create' is the asynchronous version.
```
Jika aplikasi Anda memiliki beberapa implementasi `SdkHttpAsyncClient` antarmuka `SdkHttpClient` atau, Anda harus menentukan implementasi untuk klien metadata untuk digunakan seperti yang ditunjukkan di bagian. [Klien HTTP yang dapat dikonfigurasi](#examples-ec2-IMDS-features-http)
**catatan**
Untuk sebagian besar klien layanan, seperti Amazon S3, SDK for Java secara otomatis menambahkan implementasi antarmuka atau. `SdkHttpClient` `SdkHttpAsyncClient` Jika klien metadata Anda menggunakan implementasi yang sama, maka `Ec2MetadataClient#create()` akan berfungsi. Jika Anda memerlukan implementasi yang berbeda, Anda harus menentukannya saat Anda membuat klien metadata.
### Kirim permintaan
[Untuk mengambil metadata instance, buat instance `EC2MetadataClient` class dan panggil `get` method dengan parameter path yang menentukan kategori metadata instance.](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-categories.html)
Contoh berikut mencetak nilai yang terkait dengan `ami-id` kunci ke konsol.
```
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.
```
Jika jalur tidak valid, `get` metode melempar pengecualian.
Gunakan kembali instance klien yang sama untuk beberapa permintaan, tetapi panggil `close` klien ketika tidak lagi diperlukan untuk melepaskan sumber daya. Setelah metode close dipanggil, instance klien tidak dapat digunakan lagi.
### Mengurai tanggapan
Metadata instans EC2 dapat menjadi output dalam format yang berbeda. Teks biasa dan JSON adalah format yang paling umum digunakan. Klien metadata menawarkan cara untuk bekerja dengan format tersebut.
Seperti contoh berikut menunjukkan, menggunakan `asString` metode untuk mendapatkan data sebagai string Java. Anda juga dapat menggunakan `asList` metode ini untuk memisahkan respons teks biasa yang mengembalikan beberapa baris.
```
Ec2MetadataClient client = Ec2MetadataClient.create();
Ec2MetadataResponse response = client.get("/latest/meta-data/");
String fullResponse = response.asString();
List splits = response.asList();
```
Jika respon dalam JSON, gunakan `Ec2MetadataResponse#asDocument` metode untuk mengurai respon JSON ke dalam contoh [Dokumen](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/document/Document.html) seperti yang ditunjukkan dalam cuplikan kode berikut.
```
Document fullResponse = response.asDocument();
```
Pengecualian akan dilemparkan jika format metadata tidak ada di JSON. Jika respons berhasil diuraikan, Anda dapat menggunakan [API dokumen](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/document/package-summary.html) untuk memeriksa respons secara lebih rinci. Lihat [bagan kategori metadata instance untuk mempelajari kategori](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-categories.html) metadata mana yang memberikan respons berformat JSON.
## Konfigurasikan klien metadata
### Percobaan ulang
Anda dapat mengonfigurasi klien metadata dengan mekanisme coba lagi. Jika Anda melakukannya, maka klien dapat secara otomatis mencoba kembali permintaan yang gagal karena alasan yang tidak terduga. Secara default, klien mencoba ulang tiga kali pada permintaan yang gagal dengan waktu backoff eksponensial di antara upaya.
Jika kasus penggunaan Anda memerlukan mekanisme coba lagi yang berbeda, Anda dapat menyesuaikan klien menggunakan `retryPolicy` metode pada pembuatnya. Misalnya, contoh berikut menunjukkan klien sinkron yang dikonfigurasi dengan penundaan tetap dua detik antara upaya dan lima upaya coba lagi.
```
BackoffStrategy fixedBackoffStrategy = FixedDelayBackoffStrategy.create(Duration.ofSeconds(2));
Ec2MetadataClient client =
Ec2MetadataClient.builder()
.retryPolicy(retryPolicyBuilder -> retryPolicyBuilder.numRetries(5)
.backoffStrategy(fixedBackoffStrategy))
.build();
```
Ada beberapa [BackoffStrategies](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/retry/backoff/package-summary.html)yang dapat Anda gunakan dengan klien metadata.
Anda juga dapat menonaktifkan mekanisme coba lagi sepenuhnya, seperti yang ditunjukkan cuplikan berikut.
```
Ec2MetadataClient client =
Ec2MetadataClient.builder()
.retryPolicy(Ec2MetadataRetryPolicy.none())
.build();
```
Menggunakan `Ec2MetadataRetryPolicy#none()` menonaktifkan kebijakan coba ulang default sehingga klien metadata tidak mencoba lagi.
### Versi IP
Secara default, klien metadata menggunakan titik IPV4 akhir di. `http://169.254.169.254` Untuk mengubah klien untuk menggunakan IPV6 versi, gunakan salah satu `endpointMode` atau `endpoint` metode pembangun. Hasil pengecualian jika kedua metode dipanggil pada pembangun.
Contoh berikut menunjukkan kedua IPV6 opsi.
```
Ec2MetadataClient client =
Ec2MetadataClient.builder()
.endpointMode(EndpointMode.IPV6)
.build();
```
```
Ec2MetadataClient client =
Ec2MetadataClient.builder()
.endpoint(URI.create("http://[fd00:ec2::254]"))
.build();
```
## Fitur utama
### Klien asinkron
Untuk menggunakan versi klien yang tidak memblokir, buat instance kelas. `Ec2MetadataAsyncClient` Kode dalam contoh berikut membuat klien asinkron dengan pengaturan default dan menggunakan `get` metode untuk mengambil nilai untuk kunci. `ami-id`
```
Ec2MetadataAsyncClient asyncClient = Ec2MetadataAsyncClient.create();
CompletableFuture response = asyncClient.get("/latest/meta-data/ami-id");
```
Yang `java.util.concurrent.CompletableFuture` dikembalikan oleh `get` metode selesai ketika respon kembali. Contoh berikut mencetak `ami-id` metadata ke konsol.
```
response.thenAccept(metadata -> System.out.println(metadata.asString()));
```
### Klien HTTP yang dapat dikonfigurasi
Builder untuk setiap klien metadata memiliki `httpClient` metode yang dapat Anda gunakan untuk menyediakan klien HTTP yang disesuaikan.
Contoh berikut menunjukkan kode untuk `UrlConnectionHttpClient` contoh kustom.
```
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.
```
Contoh berikut menunjukkan kode untuk `NettyNioAsyncHttpClient` instance kustom dengan klien metadata asinkron.
```
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.
```
[Konfigurasikan klien HTTP di AWS SDK for Java 2.x](http-configuration.md)Topik dalam panduan ini memberikan rincian tentang cara mengkonfigurasi klien HTTP yang tersedia di SDK for Java.
### Caching token
Karena klien metadata menggunakan IMDSv2, semua permintaan dikaitkan dengan sesi. Sesi ditentukan oleh token yang memiliki kedaluwarsa, yang dikelola klien metadata untuk Anda. Setiap permintaan metadata secara otomatis menggunakan kembali token hingga kedaluwarsa.
Secara default, token berlangsung selama enam jam (21.600 detik). Kami menyarankan Anda untuk mempertahankan time-to-live nilai default, kecuali kasus penggunaan khusus Anda memerlukan konfigurasi lanjutan.
Jika diperlukan, konfigurasikan durasinya dengan menggunakan metode `tokenTtl` builder. Misalnya, kode dalam cuplikan berikut membuat klien dengan durasi sesi lima menit.
```
Ec2MetadataClient client =
Ec2MetadataClient.builder()
.tokenTtl(Duration.ofMinutes(5))
.build();
```
Jika Anda menghilangkan pemanggilan `tokenTtl` metode pada builder, durasi default 21.600 digunakan sebagai gantinya.