Alasan kegagalan Amazon ECS API - 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 Amazon ECS API

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 merupakan wilayah yang khusus, jadi ketika menggunakan konsol tersebut pastikan bahwa 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 dalam Referensi API Amazon Elastic Container Service.

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

Tindakan API Alasan kegagalan atau alasan berhenti 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 yang CPUs diminta oleh tugas tidak tersedia pada instance penampung Anda. Ini biasanya terjadi ketika persyaratan unit CPU dalam definisi tugas Anda lebih besar dari ukuran CPU EC2 instans Amazon yang ditentukan dalam grup Auto Scaling 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 penampung Anda. Ini biasanya terjadi ketika persyaratan jumlah memori dalam definisi tugas Anda lebih besar daripada memori yang didukung pada EC2 instans Amazon yang ditentukan dalam grup Auto Scaling 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 jenis peluncuran Fargate dan Konfigurasi agen kontainer Amazon ECS.

TaskFailedToStart: NO ACTIVE INSTANCES Tidak ada contoh aktif di penyedia kapasitas Anda. Untuk informasi tentang cara mengelola grup Auto Scaling, lihat grup Auto Scaling di Panduan Pengguna Amazon Auto EC2 Scaling.

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

GetTaskProtection

MISSING

Tugas yang ditentukan tidak ditemukan. Verifikasi bahwa nama cluster atau ARN dan tugas ARN atau ID 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, klaster Anda tidak memiliki titik lampiran elastic network interface yang tersedia, yang diperlukan untuk tugas yang menggunakan mode awsvpc jaringan. EC2 Instans Amazon 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 di Panduan EC2 Pengguna Amazon.

Untuk RESOURCE:GPU kesalahan, jumlah yang GPUs diminta oleh tugas tidak tersedia dan Anda mungkin perlu menambahkan instance kontainer berkemampuan GPU ke klaster 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 jenis peluncuran Fargate dan Konfigurasi agen kontainer Amazon ECS.

StartTask

MISSING

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.

INACTIVE

Instance container yang Anda coba untuk meluncurkan tugas sebelumnya telah dideregistrasi dengan Amazon ECS dan tidak dapat digunakan.

StopServiceDeployment

ECS deployment failed

Akun penipuan menjalankan StopServiceDeployment API.

TagResource

InvalidParameterException

ARN untuk layanan yang Anda beri tag memiliki format pendek. Anda harus bermigrasi ke format panjang. Untuk informasi tentang cara memigrasi ARN, lihat. Migrasikan ARN layanan singkat Amazon ECS ke ARN yang panjang

UpdateTaskProtection

DEPLOYMENT_BLOCKED

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 kedaluwarsa.

MISSING

Tugas yang ditentukan tidak ditemukan. Verifikasi bahwa nama cluster atau ARN dan tugas ARN atau ID 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 Kesalahan Umum.