Pemecahan masalah Otomatisasi Systems Manager

Gunakan informasi berikut untuk membantu Anda memecahkan masalah dengan AWS Systems Manager Otomatisasi, kemampuan AWS Systems Manager. Topik ini mencakup tugas khusus untuk menyelesaikan masalah yang didasarkan pada pesan kesalahan Otomatisasi.

Kesalahan Otomatisasi umum

Bagian ini mencakup informasi tentang kesalahan otomatisasi umum.

VPC tidak didefinisikan 400

Secara default, ketika otomatisasi menjalankan AWS-UpdateLinuxAmi runbook atau AWS-UpdateWindowsAmi runbook, sistem menciptakan instans sementara dalam VPC default (172.30.0.0/16). Jika Anda menghapus VPC default, Anda akan menerima kesalahan berikut:

VPC not defined 400

Untuk mengatasi masalah ini, Anda harus menentukan nilai SubnetId parameter input.

Eksekusi otomatisasi gagal dimulai

Otomatisasi dapat gagal dengan kesalahan akses ditolak atau kesalahan peran asumsi yang tidak valid jika Anda belum mengonfigurasi peran AWS Identity and Access Management (IAM) dengan benar, dan kebijakan untuk Otomasi.

Akses ditolak

Contoh berikut menjelaskan situasi ketika otomatisasi gagal memulai dengan kesalahan akses ditolak.

Akses Ditolak ke API Systems Manager

Pesan kesalahan: User: user arn isn't authorized to perform: ssm:StartAutomationExecution on resource: document arn (Service: AWSSimpleSystemsManagement; Status Code: 400; Error Code: AccessDeniedException; Request ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

• Kemungkinan penyebab 1: Pengguna yang mencoba memulai otomatisasi tidak memiliki izin untuk menjalankan API. StartAutomationExecution Untuk mengatasi masalah ini, lampirkan kebijakan IAM yang diperlukan kepada pengguna yang digunakan untuk memulai otomatisasi.

• Kemungkinan penyebab 2: Pengguna yang mencoba memulai otomatisasi memiliki izin untuk menjalankan StartAutomationExecution API tetapi tidak memiliki izin untuk menjalankan API dengan menggunakan runbook tertentu. Untuk mengatasi masalah ini, lampirkan kebijakan IAM yang diperlukan kepada pengguna yang digunakan untuk memulai otomatisasi.

Akses Ditolak Karena PassRole Izin Hilang

Pesan kesalahan: User: user arn isn't authorized to perform: iam:PassRole on resource: automation assume role arn (Service: AWSSimpleSystemsManagement; Status Code: 400; Error Code: AccessDeniedException; Request ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

Pengguna yang mencoba memulai otomatisasi tidak memiliki PassRole izin untuk mengambil peran. Untuk mengatasi masalah ini, lampirkan PassRole kebijakan iam: ke peran pengguna yang mencoba memulai otomatisasi. Untuk informasi selengkapnya, lihat Tugas 2: Lampirkan PassRole kebijakan iam: ke peran Otomasi Anda.

Peran asumsi tidak valid

Ketika Anda menjalankan Otomatisasi, peran asumsi disediakan dalam runbook atau dilewatkan sebagai nilai parameter untuk runbook. Berbagai jenis kesalahan dapat terjadi jika peran aumsi tidak ditentukan atau dikonfigurasi dengan benar.

Peran Asumsi yang Salah Bentuk

Pesan kesalahan: The format of the supplied assume role ARN isn't valid. Peran asumsi tidak diformat dengan benar. Untuk mengatasi masalah ini, verifikasi bahwa peran asumsi yang valid ditentukan dalam runbook Anda atau sebagai parameter waktu aktif saat memulai otomatisasi.

Peran Asumsi Tidak Dapat Diasumsikan

Pesan kesalahan: The defined assume role is unable to be assumed. (Service: AWSSimpleSystemsManagement; Status Code: 400; Error Code: InvalidAutomationExecutionParametersException; Request ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

• Kemungkinan penyebab 1: Peran asumsi tidak ada. Untuk mengatasi masalah ini, buat peran. Untuk informasi selengkapnya, lihat Menyiapkan Otomatisasi. Detail khusus untuk membuat peran ini dijelaskan dalam topik berikut, Tugas 1: Buat peran layanan untuk otomatisasi.

• Kemungkinan penyebab 2: Peran asumsi tidak memiliki hubungan kepercayaan dengan layanan Systems Manager. Untuk mengatasi masalah ini, buat hubungan kepercayaan. Untuk informasi lebih lanjut, lihat Saya Tidak Bisa Mengasumsikan Peran di Panduan Pengguna IAM.

Eksekusi dimulai, tetapi status gagal

Kegagalan khusus tindakan

Runbook berisi langkah-langkah dan langkah-langkah yang dijalankan secara berurutan. Setiap langkah memanggil satu atau beberapa Layanan AWS API. API menentukan input, perilaku, dan output dari langkah. Ada beberapa tempat di mana kesalahan dapat menyebabkan langkah gagal. Pesan kegagalan menunjukkan kapan dan di mana kesalahan terjadi.

Untuk melihat pesan kegagalan di konsol Amazon Elastic Compute Cloud (Amazon EC2), pilih tautan Tampilkan Output dari langkah yang gagal. Untuk melihat pesan kegagalan dari AWS CLI, panggil get-automation-execution dan cari FailureMessage atribut dalam sebuah yang gagal StepExecution.

Dalam contoh berikut, langkah yang terkait dengan aws:runInstance tindakan gagal. Setiap contoh mengeksplorasi jenis kesalahan yang berbeda.

Gambar yang Hilang

Pesan kesalahan: Automation Step Execution fails when it's launching the instance(s). Get Exception from RunInstances API of ec2 Service. Exception Message from RunInstances API: [The image id '[ami id]' doesn't exist (Service: AmazonEC2; Status Code: 400; Error Code: InvalidAMIID.NotFound; Request ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)]. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.

Tindakan aws:runInstances menerima masukan untuk sebuah ImageId yang tidak ada. Untuk mengatasi masalah ini, perbarui runbook atau nilai parameter dengan ID AMI yang benar.

Kebijakan Peran Asumsi Tidak Memiliki Izin yang Memadai

Pesan kesalahan: Automation Step Execution fails when it's launching the instance(s). Get Exception from RunInstances API of ec2 Service. Exception Message from RunInstances API: [You aren't authorized to perform this operation. Encoded authorization failure message: xxxxxxx (Service: AmazonEC2; Status Code: 403; Error Code: UnauthorizedOperation; Request ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)]. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.

Peran asumsi tidak memiliki izin yang cukup untuk menjalankan RunInstances API pada instans EC2. Untuk mengatasi masalah ini, lampirkan kebijakan IAM untuk peran asumsi yang memiliki izin untuk menjalankan RunInstances API. Untuk informasi lebih lanjut, lihat Metode 2: Gunakan IAM untuk mengonfigurasi peran untuk Otomatisasi.

Keadaan tak terduga

Pesan kesalahan: Step fails when it's verifying launched instance(s) are ready to be used. Instance i-xxxxxxxxx entered unexpected state: shutting-down. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.

• Kemungkinan penyebab 1: Ada masalah dengan instans atau layanan Amazon EC2. Untuk mengatasi masalah ini, masuk ke instans atau tinjau log sistem instans untuk memahami mengapa instans mulai mematikan.

• Kemungkinan penyebab 2: Skrip data pengguna yang ditentukan untuk aws:runInstances tindakan memiliki masalah atau sintaks yang salah. Verifikasi sintaks skrip data pengguna. Juga, verifikasi bahwa skrip data pengguna tidak mematikan instans, atau menjalankan skrip lain yang mematikan instans.

Referensi Kegagalan Khusus Tindakan

Ketika langkah gagal, pesan kegagalan mungkin menunjukkan layanan yang sedang dijalankan ketika kegagalan terjadi. Tabel berikut mencantumkan layanan yang dijalankan oleh setiap tindakan. Tabel ini juga menyediakan tautan ke informasi tentang setiap layanan.

Action	Layanan AWSdipanggil oleh tindakan ini	Untuk informasi tentang layanan ini	Penyelesaian masalah konten
aws:runInstances	Amazon EC2	Panduan Pengguna Amazon EC2 untuk Instans Linux	Pemecahan Masalah Instans EC2
aws:changeInstanceState	Amazon EC2	Panduan Pengguna Amazon EC2 untuk Instans Linux	Memecahkan masalah instans EC2
aws:runCommand	Systems Manager	AWS Systems Manager Run Command	Memecahkan masalah Run Command Systems Manager
aws:createImage	Amazon EC2	Amazon Machine Images
aws:createStack	AWS CloudFormation	AWS CloudFormationPanduan Pengguna	Pemecahan masalah AWS CloudFormation
aws:deleteStack	AWS CloudFormation	AWS CloudFormationPanduan Pengguna	Pemecahan masalah AWS CloudFormation
aws:deleteImage	Amazon EC2	Gambar Amazon Machines
aws:copyImage	Amazon EC2	Amazon Machine Images
aws:createTag	Amazon EC2, Systems Manager	Sumber Daya dan Tag EC2
aws:invokeLambdaFunction	AWS Lambda	Panduan Developer AWS Lambda	Pemecahan Masalah Lambda

Kesalahan internal layanan otomatisasi

Pesan kesalahan: Internal Server Error. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.

Masalah dengan layanan otomatisasi adalah mencegah runbook tertentu berjalan dengan benar. Untuk mengatasi masalah ini, hubungi AWS Support. Sediakan ID eksekusi dan ID pelanggan, jika tersedia.

Eksekusi dimulai, tapi habis waktu

Pesan kesalahan: Step timed out while step is verifying launched instance(s) are ready to be used. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.

Sebuah langkah di aws:runInstances waktu aksi habis. Hal ini dapat terjadi jika langkah tindakan membutuhkan waktu lebih lama untuk menjalankan dari nilai yang ditentukan untuk timeoutSeconds dalam langkah. Untuk mengatasi masalah ini, tentukan nilai yang lebih lama untuk timeoutSeconds parameter dalam aws:runInstances tindakan. Jika itu tidak menyelesaikan masalah, selidiki mengapa langkah tersebut membutuhkan waktu lebih lama untuk berjalan dari yang diharapkan