Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengambil metadata AMI Amazon ECS-optimized Linux
Anda dapat mengambil metadata Amazon AMI ECS-optimized secara terprogram. Metadata mencakup nama AMI, versi agen penampung Amazon ECS, dan versi runtime Amazon ECS yang mencakup versi Docker.
Saat Anda membuat klaster menggunakan konsol, Amazon ECS membuat template peluncuran untuk instans Anda dengan AMI terbaru yang terkait dengan sistem operasi yang dipilih.
Saat Anda menggunakan CloudFormation untuk membuat klaster, parameter SSM adalah bagian dari template peluncuran Amazon EC2 untuk instans grup Auto Scaling. Anda dapat mengonfigurasi template untuk menggunakan parameter Systems Manager dinamis untuk menentukan apa yang akan digunakan oleh Amazon ECS Optimized AMI. Parameter ini memastikan bahwa setiap kali Anda menerapkan tumpukan itu akan memeriksa untuk melihat apakah ada pembaruan yang tersedia yang perlu diterapkan ke instans EC2. Untuk contoh cara menggunakan parameter Systems Manager, lihat [Membuat klaster Amazon ECS dengan Amazon ECS-optimized Amazon Linux 2023 AMI](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecs-cluster.html#aws-resource-ecs-cluster--examples--Create_an_cluster_with_the_Amazon_Linux_2023_ECS-Optimized-AMI) di *AWS CloudFormation Panduan Pengguna*.
ID AMI, nama gambar, sistem operasi, versi agen kontainer, nama gambar sumber, dan versi runtime untuk setiap varian ECS-optimized AMI Amazon dapat diambil secara terprogram dengan menanyakan Systems Manager Parameter Store API. Untuk informasi selengkapnya tentang Systems Manager Parameter Store API, lihat [GetParameters](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameters.html)dan [GetParametersByPath](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParametersByPath.html).
**catatan**
Pengguna administratif Anda harus memiliki izin IAM berikut untuk mengambil metadata Amazon AMI ECS-optimized . Izin ini telah ditambahkan ke kebijakan `AmazonECS_FullAccess` IAM.
ssm: GetParameters
ssm: GetParameter
ssm: GetParametersByPath
## Systems Manager Parameter Menyimpan format parameter
Berikut ini adalah format nama parameter untuk setiap varian Amazon ECS-optimized AMI.
** ECS-optimized AMI Amazon Linux**
+ Metadata AMI Amazon Linux 2023:
```
/aws/service/ecs/optimized-ami/amazon-linux-2023/{{}}
```
+ Amazon Linux 2023 (arm64) metadata AMI:
```
/aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/{{}}
```
+ Amazon Linux 2023 (Neuron) metadata AMI:
```
/aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/{{}}
```
+ Amazon Linux 2023 (GPU) metadata AMI:
```
/aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/{{}}
```
Amazon Linux 2 AMI metadata:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/{{}}
```
+ Amazon Linux 2 kernel 5.10 metadata AMI:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/{{}}
```
+ Amazon Linux 2 (arm64) AMI metadata:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/arm64/{{}}
```
+ Amazon Linux 2 kernel 5.10 (arm64) metadata AMI:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/{{}}
```
+ GPU-optimized Kernel Amazon ECS 5.10 metadata AMI:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/{{}}
```
+ Amazon Linux 2 (GPU) AMI metadata:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/gpu/{{}}
```
+ Amazon ECS mengoptimalkan metadata kernel Amazon Linux 2 (Neuron) 5.10 AMI:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/{{}}
```
+ Amazon Linux 2 (Neuron) metadata AMI:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/inf/{{}}
```
Format nama parameter berikut mengambil ID gambar dari Amazon ECS-optimized Amazon Linux 2 AMI terbaru yang direkomendasikan dengan menggunakan `image_id` sub-parameter.
```
/aws/service/ecs/optimized-ami/amazon-linux-2/{{recommended/image_id}}
```
Format nama parameter berikut mengambil metadata versi Amazon AMI tertentu dengan menentukan nama ECS-optimized AMI.
+ Amazon ECS-optimized Amazon Linux 2 metadata AMI:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/{{amzn2-ami-ecs-hvm-2.0.20181112-x86_64-ebs}}
```
**catatan**
Semua versi Amazon ECS-optimized Amazon Linux 2 AMI tersedia untuk diambil. Hanya versi Amazon ECS-optimized AMI `amzn-ami-2017.09.l-amazon-ecs-optimized` (Linux) dan yang lebih baru yang dapat diambil.
## Contoh
Contoh berikut menunjukkan cara Anda dapat mengambil metadata untuk setiap varian Amazon AMI ECS-optimized .
### Mengambil metadata dari Amazon AMI terbaru yang direkomendasikan ECS-optimized
Anda dapat mengambil Amazon ECS-optimized AMI terbaru yang AWS CLI direkomendasikan menggunakan AWS CLI perintah berikut.
** ECS-optimized AMI Amazon Linux**
+ **Untuk Amazon ECS-optimized Amazon Linux 2023 AMI:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended --region {{us-east-1}}
```
+ **Untuk Amazon ECS-optimized Amazon Linux 2023 (arm64) AMI:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/recommended --region {{us-east-1}}
```
+ **Untuk Amazon ECS-optimized Amazon Linux 2023 (Neuron) AMI:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/recommended --region {{us-east-1}}
```
+ **Untuk AMI GPU ECS-optimized Amazon Amazon Linux 2023:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/recommended --region {{us-east-1}}
```
+ **Untuk Amazon ECS-optimized Amazon Linux 2 kernel 5.10 AMI:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended --region {{us-east-1}}
```
+ **Untuk Amazon ECS-optimized Amazon Linux 2 AMI:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended --region {{us-east-1}}
```
+ **Untuk Amazon ECS-optimized Amazon Linux 2 kernel 5.10 (arm64) AMI:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/recommended --region {{us-east-1}}
```
+ **Untuk Amazon ECS-optimized Amazon Linux 2 (arm64) AMI:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/recommended --region {{us-east-1}}
```
+ **Untuk GPU-optimized kernel Amazon ECS 5.10 AMI:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/recommended --region {{us-east-1}}
```
+ **Untuk Amazon ECS GPU-optimized AMI:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region {{us-east-1}}
```
+ **Untuk Amazon ECS yang dioptimalkan Amazon Linux 2 (Neuron) kernel 5.10 AMI:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/recommended --region {{us-east-1}}
```
+ **Untuk Amazon ECS yang dioptimalkan Amazon Linux 2 (Neuron) AMI:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/inf/recommended --region {{us-east-1}}
```
### Mengambil ID gambar dari Amazon ECS-optimized Amazon Linux 2023 AMI terbaru yang direkomendasikan
Anda dapat mengambil ID gambar dari ID AMI Amazon ECS-optimized Amazon Linux 2023 terbaru yang direkomendasikan dengan menggunakan sub-parameter. `image_id`
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/{{recommended/image_id}} --region {{us-east-1}}
```
Untuk mengambil nilai `image_id` saja, Anda dapat meng-kueri nilai parameter tertentu; misalnya:
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended/{{image_id}} --region us-east-1 --query "{{Parameters[0].Value}}"
```
### Mengambil metadata dari versi AMI Amazon ECS-optimized Amazon Linux 2 tertentu
Ambil metadata versi AMI Amazon Amazon ECS-optimized Linux tertentu menggunakan perintah AWS CLI berikut. AWS CLI Ganti nama AMI dengan nama Amazon ECS-optimized Amazon Linux AMI untuk diambil.
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/{{amzn2-ami-ecs-hvm-2.0.20200928-x86_64-ebs}} --region {{us-east-1}}
```
### Mengambil metadata AMI kernel ECS-optimized Amazon Amazon Linux 2 5.10 AMI menggunakan Systems Manager API GetParametersByPath
Ambil metadata ECS-optimized Amazon Amazon Linux 2 AMI dengan Systems Manager GetParametersByPath API menggunakan perintah AWS CLI berikut.
```
aws ssm get-parameters-by-path --path /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/ --region {{us-east-1}}
```
### Mengambil ID gambar dari kernel Amazon ECS-optimized Amazon Linux 2 terbaru yang direkomendasikan 5.10 AMI
Anda dapat mengambil ID gambar dari ID AMI kernel 5.10 Amazon ECS-optimized Amazon Linux 2 terbaru yang direkomendasikan dengan menggunakan sub-parameter. `image_id`
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/{{recommended/image_id}} --region {{us-east-1}}
```
Untuk mengambil nilai `image_id` saja, Anda dapat meng-kueri nilai parameter tertentu; misalnya:
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended/{{image_id}} --region us-east-1 --query "{{Parameters[0].Value}}"
```
### Menggunakan Amazon ECS-optimized AMI terbaru yang direkomendasikan dalam CloudFormation template
Anda dapat mereferensikan Amazon ECS-optimized AMI terbaru yang direkomendasikan dalam CloudFormation template dengan mereferensikan nama penyimpanan parameter Systems Manager.
**Contoh Linux**
```
Parameters:kernel-5.10
LatestECSOptimizedAMI:
Description: AMI ID
Type: AWS::SSM::Parameter::Value
Default: {{/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended/image_id}}
```