aws:executeAutomation – Jalankan otomatisasi lain

Menjalankan otomatisasi sekunder dengan memanggil runbook sekunder. Dengan tindakan ini, Anda dapat membuat runbook untuk operasi Anda yang paling umum, dan referensi runbook tersebut selama otomatisasi. Tindakan ini dapat menyederhanakan runbook Anda dengan menghapus kebutuhan untuk menduplikasi langkah-langkah di runbook serupa.

Otomatisasi sekunder berjalan dalam konteks pengguna yang memulai otomatisasi utama. Ini berarti bahwa otomatisasi sekunder menggunakanAWS Identity and Access Management (IAM) role yang sama atau pengguna sebagai pengguna yang memulai otomatisasi pertama.

penting

Jika Anda menetapkan parameter dalam otomatisasi sekunder yang menggunakan peran asumsi (peran yang menggunakan kebijakan iam:passRole), maka pengguna atau peran yang memulai otomatisasi utama harus memiliki izin untuk melewati peran asumsi yang ditentukan dalam otomatisasi sekunder. Untuk informasi lebih lanjut tentang pengaturan peran asumsi untuk otomatisasi, lihat Metode 2: Gunakan IAM untuk mengonfigurasi peran untuk Otomatisasi.

Masukan

YAML

name: Secondary_Automation
action: aws:executeAutomation
maxAttempts: 3
timeoutSeconds: 3600
onFailure: Abort
inputs:
  DocumentName: secondaryAutomation
  RuntimeParameters:
    instanceIds:
    - i-1234567890abcdef0

JSON

{
   "name":"Secondary_Automation",
   "action":"aws:executeAutomation",
   "maxAttempts":3,
   "timeoutSeconds":3600,
   "onFailure":"Abort",
   "inputs":{
      "DocumentName":"secondaryAutomation",
      "RuntimeParameters":{
         "instanceIds":[
            "i-1234567890abcdef0"
         ]
      }
   }
}

DocumentName

Nama runbook sekunder yang dijalankan selama langkah. Untuk runbook yang sama Akun AWS, tentukan nama runbook. Untuk runbook bersama dari Akun AWS yang berbeda, tentukan Amazon Resource Name (ARN) runbook. Untuk informasi tentang menggunakan runbook bersama, lihat Menggunakan dokumen SSM bersama.

Jenis: String

Wajib: Ya

DocumentVersion

Runbook versi sekunder yang akan dijalankan. Jika tidak ditentukan, Otomatisasi menjalankan runbook versi default.

Jenis: String

Wajib: Tidak

MaxConcurrency

Jumlah maksimum target yang diizinkan untuk menjalankan tugas ini secara parallel. Anda dapat menentukan nomor, seperti 10, atau persentase, seperti 10%.

Tipe: String

Wajib: Tidak

MaxErrors

Jumlah kesalahan yang diizinkan sebelum maka sistem berhenti menjalankan otomatisasi pada target tambahan. Anda dapat menentukan jumlah kesalahan absolut, misalnya 10, atau persentase target yang ditetapkan, misalnya 10%. Jika Anda menentukan 3, misalnya, maka sistem berhenti menjalankan otomatisasi saat kesalahan keempat diterima. Jika Anda menentukan 0, maka sistem berhenti menjalankan otomatisasi pada target tambahan setelah hasil kesalahan pertama dikembalikan. Jika Anda menjalankan otomatisasi pada 50 sumber daya dan mengaturMaxErrors menjadi 10%, maka sistem berhenti menjalankan otomatisasi pada target tambahan saat kesalahan keenam diterima.

Otomatisasi yang sudah berjalan saatMaxErrors ambang batas tercapai diperbolehkan untuk menyelesaikan, tetapi beberapa otomatisasi ini mungkin gagal juga. Jika Anda perlu memastikan bahwa tidak akan ada otomatisasi yang lebih gagal daripada yang ditentukanMaxErrors, aturMaxConcurrency ke 1 sehingga otomatisasi dilanjutkan satu per satu.

Tipe: String

Wajib: Tidak

RuntimeParameters

Diperlukan parameter untuk runbook sekunder. Pemetaan menggunakan format berikut: {"parameter1" : "value1", "parameter2" : "value2" }

Jenis: Peta

Wajib: Tidak

Tanda

Metadata opsional yang Anda tetapkan ke sumber daya. Anda dapat menentukan maksimal lima tag untuk otomatisasi.

Jenis: MapList

Wajib: Tidak

TargetLocations

Lokasi adalah kombinasi dariWilayah AWS dan/atauAkun AWS tempat Anda ingin menjalankan otomatisasi. Jumlah minimum 1 item harus ditentukan dan jumlah maksimum 100 item dapat ditentukan.

Jenis: MapList

Wajib: Tidak

TargetMaps

Daftar pemetaan nilai-kunci dari parameter dokumen untuk menargetkan sumber daya. KeduanyaTargets dan tidakTargetMaps dapat ditentukan bersama.

Jenis: MapList

Wajib: Tidak

TargetParameterName

Nama parameter yang digunakan sebagai sumber daya target untuk otomatisasi tingkat dikendalikan. Diperlukan jika Anda menentukanTargets.

Tipe: String

Wajib: Tidak

Target

Daftar pemetaan nilai-kunci untuk menargetkan sumber daya. Diperlukan jika Anda menentukanTargetParameterName.

Jenis: MapList

Wajib: Tidak

Output

Output

Output yang dihasilkan oleh otomatisasi sekunder. Anda dapat mereferensikan output dengan menggunakan format berikut: Secondary_Automation_Step_Name.Output

Jenis: StringList

Berikut ini contohnya:

- name: launchNewWindowsInstance
  action: 'aws:executeAutomation'
  onFailure: Abort
  inputs:
    DocumentName: launchWindowsInstance
  nextStep: getNewInstanceRootVolume
- name: getNewInstanceRootVolume
  action: 'aws:executeAwsApi'
  onFailure: Abort
  inputs:
    Service: ec2
    Api: DescribeVolumes
    Filters:
    - Name: attachment.device
      Values:
      - /dev/sda1
    - Name: attachment.instance-id
      Values:
      - '{{launchNewWindowsInstance.Output}}'
  outputs:
  - Name: rootVolumeId
    Selector: '$.Volumes[0].VolumeId'
    Type: String
  nextStep: snapshotRootVolume
- name: snapshotRootVolume
  action: 'aws:executeAutomation'
  onFailure: Abort
  inputs:
    DocumentName: AWS-CreateSnapshot
    RuntimeParameters:
    VolumeId:
    - '{{getNewInstanceRootVolume.rootVolumeId}}'
    Description:
    - 'Initial root snapshot for {{launchNewWindowsInstance.Output}}'

ExecutionId

ID otomatisasi sekunder.

Jenis: String

Status

Status otomatisasi sekunder.

Jenis: String