Selesaikan properti hanya tulis - AWS CloudFormation
Properti yang saling eksklusifJenis yang saling eksklusifArraypropertiProperti opsionalPeringatan dan langkah selanjutnya

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

Selesaikan properti hanya tulis

Dengan generator CloudFormation IAC, Anda dapat membuat template menggunakan sumber daya yang disediakan di akun Anda yang belum dikelola oleh. CloudFormation Namun, properti sumber daya tertentu ditetapkan sebagai write-only, yang berarti mereka dapat ditulis tetapi tidak dapat dibaca oleh CloudFormation, misalnya, kata sandi database.

Saat membuat CloudFormation templat dari sumber daya yang ada, properti khusus tulis menimbulkan tantangan. Dalam kebanyakan kasus, CloudFormation mengubah properti ini menjadi parameter dalam template yang dihasilkan. Ini memungkinkan Anda untuk memasukkan properti sebagai nilai parameter selama operasi impor. Namun, ada skenario di mana konversi ini tidak mungkin, dan CloudFormation menangani kasus ini secara berbeda.

Properti yang saling eksklusif

Beberapa sumber daya memiliki beberapa set properti yang saling eksklusif, setidaknya beberapa di antaranya hanya ditulis. Dalam kasus ini, generator IAc tidak dapat menentukan kumpulan properti eksklusif mana yang diterapkan ke sumber daya selama pembuatan. Misalnya, Anda dapat memberikan kode untuk AWS::Lambda::Functionmenggunakan salah satu set properti ini.

  • Code/S3Bucket,Code/S3Key, dan secara opsional Code/S3ObjectVersion

  • Code/ImageUri

  • Code/ZipFile

Semua properti ini hanya ditulis. Generator IAc memilih salah satu set properti eksklusif dan menambahkannya ke template yang dihasilkan. Parameter ditambahkan untuk masing-masing properti write-only. Nama parameter termasuk OneOf dan deskripsi parameter menunjukkan bahwa properti yang sesuai dapat diganti dengan properti eksklusif lainnya. Generator IAc menetapkan jenis peringatan MUTUALLY_EXCLUSIVE_PROPERTIES untuk properti yang disertakan.

Jenis yang saling eksklusif

Dalam beberapa kasus, properti write-only dapat terdiri dari beberapa tipe data. Misalnya, Body properti AWS::ApiGateway::RestApidapat berupa a object atau astring. Ketika ini terjadi, generator IAc menyertakan properti dalam template yang dihasilkan menggunakan jenis string dan menetapkan jenis MUTUALLY_EXCLUSIVE_TYPES peringatan.

Arrayproperti

Jika properti write-only memiliki tipearray, generator IAc tidak dapat memasukkannya ke dalam template yang dihasilkan karena parameter hanya dapat berupa nilai skalar. Dalam hal ini, properti dihilangkan dari template, dan jenis peringatan UNSUPPORTED_PROPERTIES ditetapkan.

Properti opsional

Untuk properti write-only opsional, generator IAc tidak dapat mendeteksi apakah properti digunakan saat menyiapkan sumber daya. Dalam hal ini, properti dihilangkan dari template yang dihasilkan, dan jenis peringatan UNSUPPORTED_PROPERTIES disetel.

Peringatan dan langkah selanjutnya

Untuk menentukan properti mana yang hanya ditulis, Anda harus melihat peringatan yang dikembalikan oleh konsol generator IAc. AWS referensi jenis sumber daya dan propertiDokumentasi tidak menunjukkan apakah properti hanya ditulis, atau jika mendukung beberapa jenis.

Atau, Anda dapat melihat properti mana yang hanya ditulis dari skema penyedia sumber daya. Untuk mengunduh skema penyedia sumber daya, lihatCloudFormation skema penyedia sumber daya. Untuk informasi selengkapnya, lihat Skema penyedia sumber daya di Panduan Pengguna Antarmuka Baris CloudFormation Perintah.

Untuk mengatasi masalah dengan properti khusus tulis

  1. Buka halaman generator IAC CloudFormation konsol.

  2. Pada bilah navigasi di bagian atas layar, pilih Wilayah AWS untuk template Anda.

  3. Pilih tab Template, lalu pilih nama template yang Anda buat.

  4. Pada tab Definisi templat, ketika template yang dihasilkan menyertakan sumber daya dengan properti khusus tulis, konsol generator IAc menampilkan peringatan dengan ringkasan jenis masalah. Sebagai contoh:

    Peringatan konsol generator IAC tentang properti hanya tulis di template yang dihasilkan

  5. Pilih Lihat detail peringatan untuk detail selengkapnya. Sumber daya dengan properti write-only diidentifikasi oleh ID logis yang digunakan dalam template yang dihasilkan dan jenis sumber daya.

    Gunakan daftar peringatan untuk mengidentifikasi sumber daya dengan properti hanya tulis dan lihat setiap sumber daya untuk menentukan perubahan apa (jika ada) yang perlu dilakukan pada templat yang dihasilkan.

    Konsol generator IAC peringatan terperinci tentang properti hanya tulis dalam templat yang dihasilkan

  6. Jika template Anda harus diperbarui untuk menyelesaikan masalah dengan properti write-only, lakukan hal berikut:

    1. Pilih Unduh untuk mengunduh salinan templat.

    2. Edit template Anda.

    3. Saat perubahan selesai, Anda dapat memilih tombol Impor templat yang diedit untuk melanjutkan proses impor.