AWS CloudFormation Filter target kait - AWS CloudFormation
Contoh filter target

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

AWS CloudFormation Filter target kait

Topik ini memberikan panduan tentang mengonfigurasi filter target untuk AWS CloudFormation Hooks. Anda dapat menggunakan filter target untuk kontrol yang lebih terperinci atas kapan dan sumber daya mana Hook Anda dipanggil. Anda dapat mengonfigurasi filter mulai dari penargetan tipe sumber daya sederhana hingga kombinasi jenis sumber daya, tindakan, dan titik pemanggilan yang lebih kompleks.

Untuk menentukan satu atau beberapa nama tumpukan sebagai filter dalam konfigurasi Hooks Anda, tambahkan TargetFilters kunci di bawahHookConfiguration.

TargetFiltersmendukung properti berikut.

TargetNames

Sebuah array string yang menentukan nama jenis sumber daya untuk menargetkan. Sebagai contoh, lihat Contoh 1: Filter target dasar.

Nama target mendukung nama target konkret dan pencocokan wildcard lengkap. Untuk informasi selengkapnya, lihat Menggunakan wildcard dengan nama target Hook.

Pola: ^[a-zA-Z0-9]{2,64}::[a-zA-Z0-9]{2,64}::[a-zA-Z0-9]{2,64}$

Maksimum: 50

Actions

Array string yang menentukan tindakan target untuk target yang Anda cantumkanTargetNames.

Nilai yang valid: CREATE | UPDATE | DELETE

catatan

Saat menggunakanRESOURCE,STACK, dan target CLOUD_CONTROL Hook, semua tindakan target berlaku. Saat menggunakan target CHANGE_SET Hook, hanya CREATE tindakan yang berlaku.

InvocationPoints

Sebuah array string yang menentukan titik pemanggilan untuk target yang Anda daftar di. TargetNames

Nilai yang valid: PRE_PROVISION

Targets

Sebuah array objek yang menentukan daftar target untuk digunakan untuk target pemfilteran.

Setiap target dalam array target memiliki properti berikut.

TargetNames

Nama jenis sumber daya untuk ditargetkan.

Actions

Tindakan untuk target yang ditentukan.

Nilai yang valid: CREATE | UPDATE | DELETE

InvocationPoints

Titik pemanggilan untuk target yang ditentukan.

Nilai yang valid: PRE_PROVISION

catatan

Anda tidak dapat menyertakan array Targets objek danTargetNames,Actions, atau InvocationPoints array secara bersamaan. Jika Anda ingin menggunakan ketiga item ini danTargets, Anda harus memasukkannya ke dalam array Targets objek. Sebagai contoh, lihat Contoh 2: Menggunakan array Targets objek.

Contoh filter target

Bagian ini memberikan contoh yang dapat Anda ikuti untuk membuat filter target untuk AWS CloudFormation Hooks.

Contoh 1: Filter target dasar

Untuk membuat filter target dasar yang berfokus pada jenis sumber daya tertentu, gunakan TargetFilters objek dengan TargetNames array. Konfigurasi filter target berikut akan memanggil Hook pada semua operasi pada bucket S3 dan tabel DynamoDB.

{
  "CloudFormationConfiguration": {
    "HookConfiguration": {
      "HookInvocationStatus": "ENABLED",
      "TargetOperations": [
        "STACK",
        "RESOURCE"
      ],
      "FailureMode": "WARN",
      "Properties": {},
      "TargetFilters": {
        "TargetNames": [
           "AWS::S3::Bucket",
           "AWS::DynamoDB::Table"
        ]
      }
    }
  }
}

Contoh 2: Menggunakan array Targets objek

Untuk filter yang lebih canggih, Anda dapat menggunakan array Targets objek untuk mencantumkan kombinasi target, tindakan, dan titik pemanggilan tertentu. Konfigurasi filter target berikut ini akan memanggil Hook sebelum CREATE dan UPDATE beroperasi pada bucket S3 dan tabel DynamoDB.

{
  "CloudFormationConfiguration": {
    "HookConfiguration": {
      "HookInvocationStatus": "ENABLED",
      "TargetOperations": [
        "STACK",
        "RESOURCE"
      ],
      "FailureMode": "WARN",
      "Properties": {},
      "TargetFilters": {
        "Targets": [
          {
             "TargetName": "AWS::S3::Bucket",
             "Action": "CREATE",
             "InvocationPoint": "PRE_PROVISION"
          },
          {
             "TargetName": "AWS::S3::Bucket",
             "Action": "UPDATE",
             "InvocationPoint": "PRE_PROVISION"
          },
          {
             "TargetName": "AWS::DynamoDB::Table",
             "Action": "CREATE",
             "InvocationPoint": "PRE_PROVISION"
          },
          {
             "TargetName": "AWS::DynamoDB::Table",
             "Action": "UPDATE",
             "InvocationPoint": "PRE_PROVISION"
          }
        ]               
      }
    }
  }
}