

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Meluncurkan, mencantumkan, dan menghapus instans Amazon EC2 di AWS CLI
<a name="cli-services-ec2-instances"></a>

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk meluncurkan, mencantumkan, dan menghapus instans Amazon Elastic Compute Cloud (Amazon EC2). Jika meluncurkan instans yang tidak berada dalam Tingkat AWS Gratis, Anda akan ditagih setelah meluncurkan instans dan dikenakan biaya untuk waktu instans berjalan, meskipun instans tersebut tetap menganggur.

**catatan**  
Untuk contoh perintah tambahan, lihat [referensi](https://docs.aws.amazon.com/cli/latest/reference/index.html).

**Topics**
+ [Prasyarat](#cli-services-ec2-instances-prereqs)
+ [Luncurkan instans Anda](#launching-instances)
+ [Menambahkan perangkat blokir ke instans Anda](#block-device-mapping)
+ [Tambahkan tag ke instance Anda](#tagging-instances)
+ [Terhubung ke instans Anda.](#connecting-to-instances)
+ [Buat daftar instans Anda](#listing-instances)
+ [Hapus instans Anda](#terminating-instances)
+ [Referensi](#cli-services-ec2-instances-references)

## Prasyarat
<a name="cli-services-ec2-instances-prereqs"></a>

Untuk menjalankan `ec2` perintah dalam topik ini, Anda perlu:
+ Instal dan konfigurasikan AWS CLI. Untuk informasi selengkapnya, lihat [Menginstal atau memperbarui ke versi terbaru dari AWS CLI](getting-started-install.md) dan [Otentikasi dan akses kredensional untuk AWS CLI](cli-chap-authentication.md).
+ Setel izin IAM Anda untuk memungkinkan akses Amazon EC2. *Untuk informasi selengkapnya tentang izin IAM untuk Amazon EC2, [lihat kebijakan IAM untuk Amazon EC2 di Panduan Pengguna Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-policies-for-amazon-ec2.html).*
+ Buat [key pair](cli-services-ec2-keypairs.md) dan [grup keamanan](cli-services-ec2-sg.md).
+ Pilih Amazon Machine Image (AMI) dan catat ID AMI. Untuk informasi selengkapnya, lihat [Menemukan AMI yang Sesuai](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html) di *Panduan Pengguna Amazon EC2*.

## Luncurkan instans Anda
<a name="launching-instances"></a>

Untuk meluncurkan instans Amazon EC2 menggunakan AMI yang Anda pilih, gunakan perintah. `[aws ec2 run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html)` Anda dapat meluncurkan instance ke virtual private cloud (VPC).

Awalnya, instance Anda muncul di `pending` negara bagian, tetapi berubah ke `running` status setelah beberapa menit.

Contoh berikut menunjukkan cara meluncurkan `t2.micro` instance di subnet yang ditentukan dari VPC. Ganti nilai *italicized* parameter dengan nilai Anda sendiri.

```
$ aws ec2 run-instances --image-id ami-xxxxxxxx --count 1 --instance-type t2.micro --key-name MyKeyPair --security-group-ids sg-903004f8 --subnet-id subnet-6e7f829e
{
    "OwnerId": "123456789012",
    "ReservationId": "r-5875ca20",
    "Groups": [
        {
            "GroupName": "my-sg",
            "GroupId": "sg-903004f8"
        }
    ],
    "Instances": [
        {
            "Monitoring": {
                "State": "disabled"
            },
            "PublicDnsName": null,
            "Platform": "windows",
            "State": {
                "Code": 0,
                "Name": "pending"
            },
            "EbsOptimized": false,
            "LaunchTime": "2013-07-19T02:42:39.000Z",
            "PrivateIpAddress": "10.0.1.114",
            "ProductCodes": [],
            "VpcId": "vpc-1a2b3c4d",
            "InstanceId": "i-5203422c",
            "ImageId": "ami-173d747e",
            "PrivateDnsName": "ip-10-0-1-114.ec2.internal",
            "KeyName": "MyKeyPair",
            "SecurityGroups": [
                {
                    "GroupName": "my-sg",
                    "GroupId": "sg-903004f8"
                }
            ],
            "ClientToken": null,
            "SubnetId": "subnet-6e7f829e",
            "InstanceType": "t2.micro",
            "NetworkInterfaces": [
                {
                    "Status": "in-use",
                    "SourceDestCheck": true,
                    "VpcId": "vpc-1a2b3c4d",
                    "Description": "Primary network interface",
                    "NetworkInterfaceId": "eni-a7edb1c9",
                    "PrivateIpAddresses": [
                        {
                            "PrivateDnsName": "ip-10-0-1-114.ec2.internal",
                            "Primary": true,
                            "PrivateIpAddress": "10.0.1.114"
                        }
                    ],
                    "PrivateDnsName": "ip-10-0-1-114.ec2.internal",
                    "Attachment": {
                        "Status": "attached",
                        "DeviceIndex": 0,
                        "DeleteOnTermination": true,
                        "AttachmentId": "eni-attach-52193138",
                        "AttachTime": "2013-07-19T02:42:39.000Z"
                    },
                    "Groups": [
                        {
                            "GroupName": "my-sg",
                            "GroupId": "sg-903004f8"
                        }
                    ],
                    "SubnetId": "subnet-6e7f829e",
                    "OwnerId": "123456789012",
                    "PrivateIpAddress": "10.0.1.114"
                }              
            ],
            "SourceDestCheck": true,
            "Placement": {
                "Tenancy": "default",
                "GroupName": null,
                "AvailabilityZone": "us-west-2b"
            },
            "Hypervisor": "xen",
            "BlockDeviceMappings": [
                {
                    "DeviceName": "/dev/sda1",
                    "Ebs": {
                        "Status": "attached",
                        "DeleteOnTermination": true,
                        "VolumeId": "vol-877166c8",
                        "AttachTime": "2013-07-19T02:42:39.000Z"
                    }
                }              
            ],
            "Architecture": "x86_64",
            "StateReason": {
                "Message": "pending",
                "Code": "pending"
            },
            "RootDeviceName": "/dev/sda1",
            "VirtualizationType": "hvm",
            "RootDeviceType": "ebs",
            "Tags": [
                {
                    "Value": "MyInstance",
                    "Key": "Name"
                }
            ],
            "AmiLaunchIndex": 0
        }
    ]
}
```

## Menambahkan perangkat blokir ke instans Anda
<a name="block-device-mapping"></a>

Setiap instance yang Anda luncurkan memiliki volume perangkat root terkait. Anda dapat menggunakan pemetaan perangkat blokir untuk menentukan volume Amazon Elastic Block Store (Amazon EBS) tambahan atau volume penyimpanan instans untuk dilampirkan ke instance saat diluncurkan.

Untuk menambahkan perangkat blok ke instans Anda, tentukan `--block-device-mappings` opsi saat Anda menggunakan`run-instances`.

Parameter contoh berikut menyediakan volume Amazon EBS standar yang berukuran 20 GB, dan memetakannya ke instans Anda menggunakan pengenal`/dev/sdf`.

```
--block-device-mappings "[{\"DeviceName\":\"/dev/sdf\",\"Ebs\":{\"VolumeSize\":20,\"DeleteOnTermination\":false}}]"
```

Contoh berikut menambahkan volume Amazon EBS, dipetakan ke`/dev/sdf`, berdasarkan snapshot yang ada. Snapshot mewakili gambar yang dimuat ke volume untuk Anda. Saat Anda menentukan snapshot, Anda tidak perlu menentukan ukuran volume; itu akan cukup besar untuk menampung gambar Anda. Namun, jika Anda menentukan ukuran, itu harus lebih besar dari atau sama dengan ukuran snapshot.

```
--block-device-mappings "[{\"DeviceName\":\"/dev/sdf\",\"Ebs\":{\"SnapshotId\":\"snap-a1b2c3d4\"}}]"
```

Contoh berikut menambahkan dua volume ke instance Anda. Jumlah volume yang tersedia untuk instans Anda bergantung pada jenis instance-nya.

```
--block-device-mappings "[{\"DeviceName\":\"/dev/sdf\",\"VirtualName\":\"ephemeral0\"},{\"DeviceName\":\"/dev/sdg\",\"VirtualName\":\"ephemeral1\"}]"
```

Contoh berikut membuat pemetaan (`/dev/sdj`), tetapi tidak menyediakan volume untuk instance.

```
--block-device-mappings "[{\"DeviceName\":\"/dev/sdj\",\"NoDevice\":\"\"}]"
```

Untuk informasi selengkapnya, lihat [Memblokir Pemetaan Perangkat](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html) di Panduan *Pengguna Amazon EC2*.

## Tambahkan tag ke instance Anda
<a name="tagging-instances"></a>

Tag adalah label yang Anda tetapkan ke AWS sumber daya. Ini memungkinkan Anda untuk menambahkan metadata ke sumber daya Anda yang dapat Anda gunakan untuk berbagai tujuan. Untuk informasi selengkapnya, lihat [Menandai Sumber Daya Anda](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html) di Panduan *Pengguna Amazon EC2*.

Contoh berikut menunjukkan bagaimana menambahkan tag dengan nama kunci "`Name`" dan nilai "`MyInstance`" untuk contoh yang ditentukan, dengan menggunakan `[aws ec2 create-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-tags.html)` perintah.

```
$ aws ec2 create-tags --resources i-5203422c --tags Key=Name,Value=MyInstance
```

## Terhubung ke instans Anda.
<a name="connecting-to-instances"></a>

Ketika instans Anda berjalan, Anda dapat terhubung ke sana dan menggunakannya sama seperti Anda akan menggunakan komputer yang duduk di depan Anda. Untuk informasi selengkapnya, lihat [Connect ke Instans Amazon EC2 Anda](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect-to-linux-instance.html) di Panduan Pengguna *Amazon EC2*.

## Buat daftar instans Anda
<a name="listing-instances"></a>

Anda dapat menggunakan AWS CLI untuk daftar instance Anda dan melihat informasi tentang mereka. Anda dapat membuat daftar semua instance Anda, atau memfilter hasil berdasarkan instance yang Anda minati.

Contoh berikut menunjukkan cara menggunakan `[aws ec2 describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html)` perintah.

Perintah berikut mencantumkan semua instance Anda.

```
$ aws ec2 describe-instances
```

Perintah berikut memfilter daftar ke hanya `t2.micro` instance Anda dan hanya mengeluarkan `InstanceId` nilai untuk setiap kecocokan.

```
$ aws ec2 describe-instances --filters "Name=instance-type,Values=t2.micro" --query "Reservations[].Instances[].InstanceId"
[
    "i-05e998023d9c69f9a"
]
```

Perintah berikut mencantumkan salah satu instance Anda yang memiliki tag`Name=MyInstance`.

```
$ aws ec2 describe-instances --filters "Name=tag:Name,Values=MyInstance"
```

Perintah berikut mencantumkan instance Anda yang diluncurkan menggunakan salah satu dari berikut ini AMIs:`ami-x0123456`,`ami-y0123456`, dan`ami-z0123456`.

```
$ aws ec2 describe-instances --filters "Name=image-id,Values=ami-x0123456,ami-y0123456,ami-z0123456"
```

## Hapus instans Anda
<a name="terminating-instances"></a>

Anda dapat menggunakan AWS CLI untuk menghentikan (menghapus) instans Amazon EC2 saat Anda tidak lagi membutuhkannya.

**penting**  
**Mengakhiri sebuah instance bersifat permanen dan ireversibel.**  
Setelah Anda menghentikan sebuah instance, Anda tidak dapat lagi terhubung dengannya, dan itu tidak dapat dipulihkan. Semua volume Amazon EBS terlampir yang dikonfigurasi untuk dihapus saat penghentian juga dihapus secara permanen dan tidak dapat dipulihkan. Semua data yang disimpan pada volume penyimpanan instance hilang secara permanen. Untuk informasi selengkapnya, lihat [Cara kerja penghentian instans](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/how-ec2-instance-termination-works.html).  
Sebelum menghentikan instans, pastikan bahwa Anda telah mencadangkan semua data yang perlu disimpan setelah penghentian penyimpanan persisten.

Segera setelah status instans berubah menjadi `shutting-down` atau`terminated`, Anda berhenti menimbulkan biaya untuk contoh itu. Jika Anda ingin menyambung kembali ke instance nanti, gunakan [stop-instance](https://docs.aws.amazon.com/cli/v1/reference/ec2/stop-instances.html) sebagai gantinya. `terminate-instances` Untuk informasi selengkapnya, lihat [Menghentikan Instans Anda](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html) di Panduan *Pengguna Amazon EC2*.

Contoh berikut menunjukkan cara menghapus instance menggunakan `[aws ec2 terminate-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/terminate-instances.html)` perintah.

```
$ aws ec2 terminate-instances --instance-ids i-5203422c
{
    "TerminatingInstances": [
        {
            "InstanceId": "i-5203422c",
            "CurrentState": {
                "Code": 32,
                "Name": "shutting-down"
            },
            "PreviousState": {
                "Code": 16,
                "Name": "running"
            }
        }
    ]
}
```

## Referensi
<a name="cli-services-ec2-instances-references"></a>

**AWS CLI Referensi:**
+ `[aws ec2](https://docs.aws.amazon.com/cli/latest/reference/ec2/index.html)`
+ `[aws ec2 create-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-tags.html)`
+ `[aws ec2 describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html)`
+ `[aws ec2 run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html)`
+ `[aws ec2 terminate-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/terminate-instances.html)`

**Referensi lainnya:**
+ [Dokumentasi Cloud Komputasi Elastis Amazon](https://docs.aws.amazon.com/ec2/)
+ Untuk melihat dan berkontribusi pada AWS SDK dan contoh AWS CLI kode, lihat [Repositori Contoh AWS Kode](https://github.com/awsdocs/aws-doc-sdk-examples/) di. *GitHub*