View a markdown version of this page

Alasan kegagalan API Amazon ECS - Amazon Elastic Container Service

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

Alasan kegagalan API Amazon ECS

Ketika tindakan API yang telah Anda picu melalui Amazon ECS API, konsol, atau pintu AWS CLI keluar dengan pesan failures kesalahan, 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 bahwa 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 di Referensi API Layanan Kontainer Amazon Elastic.

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

Tindakan API Alasan kegagalan atau alasan yang dihentikan Penyebab

DescribeClusters

MISSING

Klaster yang ditentukan tidak ditemukan. Verifikasi ejaan nama klaster.

DescribeInstances

MISSING

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

MISSING

Layanan yang ditentukan tidak ditemukan. Verifikasi bahwa klaster yang benar atau wilayah yang ditentukan dan bahwa layanan ARN atau nama adalah valid.

DescribeTasks

MISSING

Tugas yang ditentukan tidak ditemukan. Verifikasi klaster yang benar atau wilayah yang ditentukan dan bahwa kedua ARN tugas atau ID valid.

DescribeTasks

TaskFailedToStart: RESOURCE:*

Untuk RESOURCE:CPU kesalahan, jumlah CPU yang diminta oleh tugas tidak tersedia pada instance kontainer Anda. Hal ini umumnya terjadi ketika persyaratan unit CPU dalam definisi tugas Anda lebih besar dari ukuran CPU instans Amazon EC2 yang ditentukan dalam grup Penskalaan Otomatis yang dipetakan ke penyedia kapasitas. Anda perlu memeriksa konfigurasi penyedia kapasitas Anda.

Untuk RESOURCE:MEMORY kesalahan, jumlah memori yang diminta oleh tugas tidak tersedia pada instance kontainer Anda. Hal ini umumnya terjadi ketika kebutuhan jumlah memori dalam definisi tugas Anda lebih besar dari memori yang didukung pada instans Amazon EC2 yang ditentukan dalam grup Penskalaan Otomatis yang dipetakan ke penyedia kapasitas. Anda perlu memeriksa konfigurasi penyedia kapasitas Anda.

TaskFailedToStart: AGENT

Instans kontainer tempat Anda mencoba untuk meluncurkan tugas memiliki agen yang saat ini terputus. Untuk mencegah waktu tunggu diperpanjang untuk penempatan tugas, permintaan ditolak.

Untuk informasi tentang cara memecahkan masalah agen yang terputus, lihat Bagaimana cara memecahkan masalah agen Amazon ECS yang terputus.

TaskFailedToStart: MemberOf placement constraint unsatisfied

Tidak ada instance kontainer yang memenuhi batasan penempatan yang ditentukan dalam definisi tugas Anda.

TaskFailedToStart: ATTRIBUTE

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 dan Konfigurasi agen kontainer Amazon ECS.
TaskFailedToStart: NO ACTIVE INSTANCES Tidak ada instans aktif di penyedia kapasitas Anda. Untuk informasi tentang cara mengelola grup Penskalaan Otomatis, lihat grup Penskalaan Otomatis di Panduan Pengguna Penskalaan Otomatis Amazon EC2.

TaskFailedToStart: EMPTY CAPACITY PROVIDER

 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 Penskalaan Otomatis, lihat grup Penskalaan Otomatis di Panduan Pengguna Penskalaan Otomatis Amazon EC2.

GetTaskProtection

MISSING

Tugas yang ditentukan tidak ditemukan. Verifikasi bahwa nama cluster atau ARN dan ARN atau ID tugas valid.

TASK_NOT_VALID

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

RESOURCE:*

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.

Untuk RESOURCE:ENI kesalahan, cluster Anda tidak memiliki titik lampiran antarmuka jaringan elastis yang tersedia, yang diperlukan untuk tugas yang menggunakan mode awsvpc jaringan. Instans Amazon EC2 memiliki batas 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 Instans di Panduan Pengguna Amazon EC2.

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.

AGENT

Instans kontainer tempat Anda mencoba untuk meluncurkan tugas memiliki agen yang saat ini terputus. Untuk mencegah waktu tunggu diperpanjang untuk penempatan tugas, permintaan ditolak.

Untuk informasi tentang cara memecahkan masalah agen yang terputus, lihat Bagaimana cara memecahkan masalah agen Amazon ECS yang terputus.

LOCATION

Instans kontainer tempat Anda coba untuk meluncurkan tugas ada di Availability Zone yang berbeda dari subnet yang Anda tentukan di awsVpcConfiguration.

ATTRIBUTE

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 dan Konfigurasi agen kontainer Amazon ECS.

StartTask

MISSING

Instance kontainer yang Anda coba luncurkan tugas tidak dapat ditemukan. Periksa apakah cluster atau Region yang salah ditentukan, atau contoh kontainer ARN atau ID salah eja.

INACTIVE

Instans kontainer yang Anda coba luncurkan tugas sebelumnya telah dibatalkan pendaftaran dengan Amazon ECS dan tidak dapat digunakan.

StopServiceDeployment

ECS deployment failed

 Akun penipuan menjalankan StopServiceDeployment API.

TagResource

InvalidParameterException

 ARN untuk layanan yang Anda tandai memiliki format pendek. Anda harus bermigrasi ke format panjang. Untuk informasi tentang cara memigrasi ARN, lihatMemigrasikan ARN layanan pendek Amazon ECS ke ARN panjang.

UpdateTaskProtection

DEPLOYMENT_BLOCKED

Tidak dapat mengatur perlindungan tugas karena satu atau lebih tugas yang dilindungi mencegah penyebaran layanan mencapai kondisi mapan. Batalkan perlindungan tugas pada tugas yang ada atau tunggu hingga perlindungan tugas berakhir.

MISSING

Tugas yang ditentukan tidak ditemukan. Verifikasi bahwa nama cluster atau ARN dan ARN atau ID tugas valid.

TASK_NOT_VALID

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 Kes alahan Umum.