aws:branch – Jalankan langkah-langkah otomatisasi bersyarat - AWS Systems Manager

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

aws:branch – Jalankan langkah-langkah otomatisasi bersyarat

Tindakan aws:branch tersebut mengizinkan Anda membuat otomatisasi dinamis yang mengevaluasi pilihan yang berbeda dalam satu langkah dan kemudian melompat ke langkah di runbook yang berbeda berdasarkan hasil evaluasi tersebut.

Bila Anda menentukan aws:branch tindakan untuk sebuah langkah, Anda menentukan Choices bahwa otomatisasi harus mengevaluasi. Dapat Choices didasarkan pada nilai yang Anda tentukan dalam Parameters bagian runbook, atau nilai dinamis yang dihasilkan sebagai output dari langkah sebelumnya. Otomatisasi mengevaluasi setiap pilihan dengan menggunakan ekspresi Boolean. Jika pilihan pertama adalah benar, maka otomatisasi melompat ke langkah yang ditetapkan untuk pilihan tersebut. Jika pilihan pertama salah, otomatisasi mengevaluasi pilihan berikutnya. Otomatisasi terus mengevaluasi setiap pilihan sampai memproses pilihan yang benar. Selanjutnya, otomatisasi melompat ke langkah yang ditetapkan untuk pilihan yang benar tersebut.

Jika tidak ada pilihan yang benar, otomatisasi memeriksa untuk melihat apakah langkah berisi default nilai. Nilai default menentukan langkah yang harus dilakukan otomatisasi jika tidak ada pilihan yang benar. Jika tidak ada default nilai yang ditentukan untuk langkah, otomatisasi akan memproses langkah berikutnya dalam runbook.

Tindakan aws:branch tersebut mendukung evaluasi pilihan kompleks dengan menggunakan kombinasi And, Not, dan Or operator. Untuk informasi lebih lanjut tentang cara menggunakan aws:branch, termasuk contoh runbook dan contoh yang menggunakan operator yang berbeda, lihat Menggunakan pernyataan bersyarat di runbook.

Input

Tentukan satu atau lebih Choices dalam satu langkah. Dapat Choices didasarkan pada nilai yang Anda tentukan dalam Parameters bagian runbook, atau nilai dinamis yang dihasilkan sebagai output dari langkah sebelumnya. Berikut adalah sampel YAML yang mengevaluasi parameter.

mainSteps: - name: chooseOS action: aws:branch inputs: Choices: - NextStep: runWindowsCommand Variable: "{{Name of a parameter defined in the Parameters section. For example: OS_name}}" StringEquals: windows - NextStep: runLinuxCommand Variable: "{{Name of a parameter defined in the Parameters section. For example: OS_name}}" StringEquals: linux Default: sleep3

Berikut adalah sampel YAML yang mengevaluasi output dari langkah sebelumnya.

mainSteps: - name: chooseOS action: aws:branch inputs: Choices: - NextStep: runPowerShellCommand Variable: "{{Name of a response object. For example: GetInstance.platform}}" StringEquals: Windows - NextStep: runShellCommand Variable: "{{Name of a response object. For example: GetInstance.platform}}" StringEquals: Linux Default: sleep3
Pilihan

Satu ekspresi atau lebih bahwa Otomatisasi harus mengevaluasi ketika menentukan langkah berikutnya untuk proses. Pilihan dievaluasi dengan menggunakan ekspresi Boolean. Setiap templat menyertakan menentukan opsi berikut:

  • NextStep: Langkah runbook berikutnya adalah memproses apa pilihan yang ditunjuk true.

  • Variabel: Tenentukan nama parameter yang didefinisikan dalam Parameters bagian dari buku runbook. Atau tentukan objek output dari langkah sebelumnya dalam runbook. Untuk informasi lebih lanjut tentang permbuatan variabel untuk aws:branch, lihat Tentang membuat variabel output.

  • Operasi: Kriteria yang digunakan untuk mengevaluasi pilihan. Tindakan aws:branch tersebut mendukung operasi berikut:

    Operasi String
    • StringEquals

    • EqualsIgnoreCase

    • StartsWith

    • EndsWith

    • Berisi

    Operasi numerik
    • NumericEquals

    • NumericGreater

    • NumericLesser

    • NumericGreaterOrEquals

    • NumericLesser

    • NumericLesserOrEquals

    Operasi Boolean
    • BooleanEquals

    penting

    Ketika Anda membuat runbook, sistem memvalidasi setiap operasi di runbook. Jika operasi tidak didukung, sistem akan mengembalikan kesalahan saat Anda mencoba membuat runbook.

Default

Nama langkah yang harus dilakukan otomatisasi jika tidak ada Choices yang benar.

Jenis: String

Wajib: Tidak

catatan

Tindakan aws:branch tersebut mendukung And, Or, dan Not operator. Misalnya aws:branch yang menggunakan operator, lihat Menggunakan pernyataan bersyarat di runbook.