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

# Alasan kegagalan Amazon ECS API
<a name="api_failures_messages"></a>

Jika tindakan API yang dipicu melalui Amazon ECS API, konsol, atau AWS CLI keluar dengan pesan `failures` galat, berikut ini mungkin membantu memecahkan masalah penyebabnya. Kegagalan mengembalikan alasan dan Nama Sumber Daya Amazon (ARN) dari sumber daya yang terkait dengan kegagalan.

Banyak sumber daya Region-specific, jadi saat menggunakan konsol, pastikan Anda mengatur Wilayah yang benar untuk sumber daya Anda. Saat menggunakan AWS CLI, pastikan AWS CLI perintah Anda dikirim ke Wilayah yang benar dengan `--region {{region}}` parameter.

Untuk informasi selengkapnya tentang struktur tipe `Failure` data, lihat [Kegagalan](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Failure.html) dalam *Referensi API Amazon Elastic Container Service*.

Berikut ini adalah contoh pesan kegagalan yang mungkin Anda terima saat menjalankan perintah API. 



- ** `DescribeClusters` **
  - **Alasan kegagalan atau alasan berhenti:** `MISSING`
  - **Penyebab:** Klaster yang ditentukan tidak ditemukan. Verifikasi ejaan nama klaster.

- ** `DescribeInstances` **
  - **Alasan kegagalan atau alasan berhenti:** `MISSING`
  - **Penyebab:** Instans kontainer yang ditentukan tidak ditemukan. Verifikasi bahwa Anda menetapkan klaster instans kontainer yang terdaftar dan bahwa kedua instans kontainer ARN atau ID adalah benar.

- ** `DescribeServices` **
  - **Alasan kegagalan atau alasan berhenti:** `MISSING`
  - **Penyebab:** Layanan yang ditentukan tidak ditemukan. Verifikasi bahwa klaster yang benar atau wilayah yang ditentukan dan bahwa layanan ARN atau nama adalah valid.

- ** `DescribeTasks` **
  - **Alasan kegagalan atau alasan berhenti:** `MISSING`
  - **Penyebab:** Tugas yang ditentukan tidak ditemukan. Verifikasi klaster yang benar atau wilayah yang ditentukan dan bahwa kedua ARN tugas atau ID valid.

- ** `DescribeTasks`  **
  - **Alasan kegagalan atau alasan berhenti:** `TaskFailedToStart: RESOURCE:*` / **Penyebab:** Untuk `RESOURCE:CPU` kesalahan, jumlah CPU yang diminta oleh tugas tidak tersedia pada instance container Anda. Ini biasanya terjadi ketika persyaratan unit CPU dalam definisi tugas Anda lebih besar dari ukuran CPU instans Amazon EC2 yang ditentukan dalam grup Auto Scaling yang dipetakan ke penyedia kapasitas. Anda perlu memeriksa konfigurasi penyedia kapasitas Anda.<br />Untuk `RESOURCE:MEMORY` kesalahan, jumlah memori yang diminta oleh tugas tidak tersedia pada instance container Anda. Ini biasanya terjadi ketika persyaratan jumlah memori dalam definisi tugas Anda lebih besar daripada memori yang didukung pada instans Amazon EC2 yang ditentukan dalam grup Auto Scaling yang dipetakan ke penyedia kapasitas. Anda perlu memeriksa konfigurasi penyedia kapasitas Anda.
  - **Alasan kegagalan atau alasan berhenti:** `TaskFailedToStart: AGENT` / **Penyebab:** Instans kontainer tempat Anda mencoba untuk meluncurkan tugas memiliki agen yang saat ini terputus. Untuk mencegah waktu tunggu diperpanjang untuk penempatan tugas, permintaan ditolak.<br />Untuk informasi tentang cara memecahkan masalah agen yang terputus, lihat [Bagaimana cara memecahkan masalah agen Amazon ECS yang terputus](https://repost.aws/knowledge-center/ecs-agent-disconnected-linux2-ami).
  - **Alasan kegagalan atau alasan berhenti:** `TaskFailedToStart: MemberOf placement constraint unsatisfied` / **Penyebab:** Tidak ada instance kontainer yang memenuhi batasan penempatan yang ditentukan dalam definisi tugas Anda.
  - **Alasan kegagalan atau alasan berhenti:** `TaskFailedToStart: ATTRIBUTE` / **Penyebab:** Ketentuan tugas Anda berisi parameter yang memerlukan atribut instans kontainer yang spesifik yang tidak tersedia pada instans kontainer Anda. Contohnya, jika tugas Anda menggunakan mode jaringan `awsvpc`, tetapi tidak ada instans dalam subnet yang Anda tentukan dengan atribut `ecs.capability.task-eni`. Untuk informasi lebih lanjut tentang atribut mana yang diperlukan untuk parameter ketentuan tugas tertentu dan variabel konfigurasi agen, lihat [Parameter definisi tugas Amazon ECS untuk Fargate](task_definition_parameters.md) dan [Konfigurasi agen kontainer Amazon ECS](ecs-agent-config.md).
  - **Alasan kegagalan atau alasan berhenti:** TaskFailedToStart: NO ACTIVE INSTANCES / **Penyebab:** Tidak ada contoh aktif di penyedia kapasitas Anda. Untuk informasi tentang cara mengelola grup Auto Scaling, lihat grup [Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) di Panduan Pengguna Amazon EC2 Auto Scaling.
  - **Alasan kegagalan atau alasan berhenti:** `TaskFailedToStart: EMPTY CAPACITY PROVIDER` / **Penyebab:** Tidak ada instance di cluster Anda. Ini kemungkinan besar karena penyedia kapasitas kosong, atau karena instance di penyedia kapasitas tidak terdaftar ke cluster. Untuk informasi tentang cara mengelola grup Auto Scaling, lihat grup [Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) di Panduan Pengguna Amazon EC2 Auto Scaling.

- ** `GetTaskProtection` **
  - **Alasan kegagalan atau alasan berhenti:** `MISSING` / **Penyebab:** Tugas yang ditentukan tidak ditemukan. Verifikasi bahwa nama cluster atau ARN dan tugas ARN atau ID valid.
  - **Alasan kegagalan atau alasan berhenti:** `TASK_NOT_VALID` / **Penyebab:** Tugas yang ditentukan bukan bagian dari layanan Amazon ECS. Hanya tugas yang dikelola layanan Amazon ECS yang dapat dilindungi. Verifikasi tugas ARN atau ID dan coba lagi.

- ** `RunTask` atau `StartTask` **
  - **Alasan kegagalan atau alasan berhenti:** `RESOURCE:*` / **Penyebab:** Sumber daya tersebut atau sumber daya yang diminta oleh tugas tidak tersedia pada instans kontainer dalam klaster. Jika sumber daya merupakan CPU, memori, port, atau antarmuka jaringan elastis, Anda mungkin perlu menambahkan instans kontainer tambahan untuk klaster Anda.<br />Untuk `RESOURCE:ENI` kesalahan, klaster Anda tidak memiliki titik lampiran elastic network interface yang tersedia, yang diperlukan untuk tugas yang menggunakan mode `awsvpc` jaringan. Instans Amazon EC2 memiliki batasan jumlah antarmuka jaringan yang dapat dilampirkan padanya, dan antarmuka jaringan utama dihitung sebagai satu. Untuk informasi selengkapnya tentang berapa banyak antarmuka jaringan yang didukung untuk setiap jenis instans, lihat [Alamat IP Per Antarmuka Jaringan Per Jenis Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#AvailableIpPerENI) di Panduan *Pengguna Amazon EC2*.<br />Untuk `RESOURCE:GPU` kesalahan, jumlah GPU yang diminta oleh tugas tidak tersedia dan Anda mungkin perlu menambahkan instance GPU-enabled kontainer ke cluster Anda. Untuk informasi selengkapnya, lihat [Definisi tugas Amazon ECS untuk beban kerja GPU](ecs-gpu.md).
  - **Alasan kegagalan atau alasan berhenti:** `AGENT` / **Penyebab:** Instans kontainer tempat Anda mencoba untuk meluncurkan tugas memiliki agen yang saat ini terputus. Untuk mencegah waktu tunggu diperpanjang untuk penempatan tugas, permintaan ditolak.<br />Untuk informasi tentang cara memecahkan masalah agen yang terputus, lihat [Bagaimana cara memecahkan masalah agen Amazon ECS yang terputus](https://repost.aws/knowledge-center/ecs-agent-disconnected-linux2-ami).
  - **Alasan kegagalan atau alasan berhenti:** `LOCATION` / **Penyebab:** Instans kontainer tempat Anda coba untuk meluncurkan tugas ada di Availability Zone yang berbeda dari subnet yang Anda tentukan di `awsVpcConfiguration`.
  - **Alasan kegagalan atau alasan berhenti:** `ATTRIBUTE` / **Penyebab:** Ketentuan tugas Anda berisi parameter yang memerlukan atribut instans kontainer yang spesifik yang tidak tersedia pada instans kontainer Anda. Contohnya, jika tugas Anda menggunakan mode jaringan `awsvpc`, tetapi tidak ada instans dalam subnet yang Anda tentukan dengan atribut `ecs.capability.task-eni`. Untuk informasi lebih lanjut tentang atribut mana yang diperlukan untuk parameter ketentuan tugas tertentu dan variabel konfigurasi agen, lihat [Parameter definisi tugas Amazon ECS untuk Fargate](task_definition_parameters.md) dan [Konfigurasi agen kontainer Amazon ECS](ecs-agent-config.md).

- ** `StartTask` **
  - **Alasan kegagalan atau alasan berhenti:** `MISSING` / **Penyebab:** Instance container yang Anda coba untuk meluncurkan tugas ke tidak dapat ditemukan. Periksa apakah cluster atau Region yang salah ditentukan, atau contoh kontainer ARN atau ID salah eja.
  - **Alasan kegagalan atau alasan berhenti:** `INACTIVE` / **Penyebab:** Instance container yang Anda coba untuk meluncurkan tugas sebelumnya telah dideregistrasi dengan Amazon ECS dan tidak dapat digunakan.

- ** `StopServiceDeployment` **
  - **Alasan kegagalan atau alasan berhenti:** `ECS deployment failed`
  - **Penyebab:** Akun penipuan menjalankan StopServiceDeployment API.

- ** `TagResource` **
  - **Alasan kegagalan atau alasan berhenti:** `InvalidParameterException`
  - **Penyebab:** ARN untuk layanan yang Anda beri tag memiliki format pendek. Anda harus bermigrasi ke format panjang. Untuk informasi tentang cara memigrasi ARN, lihat. [Memigrasikan ARN layanan pendek Amazon ECS ke ARN panjang](service-arn-migration.md)

- ** `UpdateTaskProtection` **
  - **Alasan kegagalan atau alasan berhenti:** `DEPLOYMENT_BLOCKED` / **Penyebab:** Tidak dapat mengatur perlindungan tugas karena satu atau lebih tugas yang dilindungi mencegah penyebaran layanan mencapai kondisi mapan. Hapus perlindungan tugas pada tugas yang ada atau tunggu hingga perlindungan tugas berakhir.
  - **Alasan kegagalan atau alasan berhenti:** `MISSING` / **Penyebab:** Tugas yang ditentukan tidak ditemukan. Verifikasi bahwa nama cluster atau ARN dan tugas ARN atau ID valid.
  - **Alasan kegagalan atau alasan berhenti:** `TASK_NOT_VALID` / **Penyebab:** Tugas yang ditentukan bukan bagian dari layanan Amazon ECS. Hanya tugas yang dikelola layanan Amazon ECS yang dapat dilindungi. Verifikasi tugas ARN atau ID dan coba lagi.



**catatan**  
Selain skenario kegagalan yang dijelaskan di sini, operasi API juga dapat gagal karena pengecualian, yang mengakibatkan respons kesalahan. Untuk daftar pengecualian tersebut, lihat [Kesalahan Umum](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/CommonErrors.html).