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

# Mengedit data konfigurasi untuk ekstensi di akun Anda
<a name="registry-set-configuration"></a>

Topik ini memberikan panduan tentang mengedit data konfigurasi untuk ekstensi di akun Anda dalam Wilayah tertentu. Ekstensi dapat menyertakan properti konfigurasi yang berlaku untuk semua instance ekstensi untuk akun dan Wilayah tertentu. Ini didefinisikan oleh pembuat ekstensi dalam definisi konfigurasi ekstensi. Jika ada properti yang diperlukan dalam definisi konfigurasi ekstensi, Anda harus menentukan properti tersebut sebelum dapat menggunakan ekstensi di akun dan Wilayah Anda.

Untuk informasi selengkapnya tentang bagaimana definisi konfigurasi didefinisikan saat mengembangkan ekstensi, lihat dokumentasi berikut.
+ [Referensi sintaks skema konfigurasi hook](https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hook-configuration-schema.html)
+ [Mendefinisikan konfigurasi tingkat akun ekstensi](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-model.html#resource-type-howto-configuration)

**Topics**
+ [Izin diperlukan untuk menggunakan referensi dinamis](#registry-set-configuration-considerations)
+ [Mengedit data konfigurasi untuk ekstensi (konsol)](#registry-set-configuration-procedure-console)
+ [Mengedit data konfigurasi untuk ekstensi (AWS CLI)](#registry-set-configuration-procedure-cli)

## Izin diperlukan untuk menggunakan referensi dinamis
<a name="registry-set-configuration-considerations"></a>

Jika data konfigurasi Anda menyertakan referensi dinamis ke nilai yang disimpan dalam AWS Systems Manager atau AWS Secrets Manager, peran apa pun yang digunakan untuk menyediakan tipe (misalnya, saat membuat atau memperbarui tumpukan) harus memiliki izin yang tepat untuk mengambil nilai tersebut. Secara khusus:
+ Jika data konfigurasi berisi parameter yang disimpan di AWS Systems Manager Parameter Store, pengguna atau peran yang digunakan untuk menyediakan tipe harus memiliki izin untuk memanggil [https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html).
+ Jika data konfigurasi berisi rahasia yang disimpan AWS Secrets Manager, pengguna atau peran yang digunakan untuk menyediakan tipe harus memiliki izin untuk memanggil [https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html). 

Untuk informasi selengkapnya, lihat [Dapatkan nilai yang disimpan di layanan lain menggunakan referensi dinamis](dynamic-references.md).

## Mengedit data konfigurasi untuk ekstensi (konsol)
<a name="registry-set-configuration-procedure-console"></a>

Ikuti langkah-langkah di bagian ini untuk menggunakan konsol untuk:
+ Melihat data konfigurasi saat ini untuk ekstensi
+ Perbarui data konfigurasi ekstensi untuk akun Anda

**Untuk melihat data konfigurasi saat ini untuk ekstensi**

1. Masuk ke Konsol Manajemen AWS dan buka CloudFormation konsol di [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).

1. Pada bilah navigasi di bagian atas layar, pilih Anda Wilayah AWS.

1. Dari panel navigasi, di bawah **Registry**, pilih **Ekstensi yang diaktifkan**.

1. Temukan ekstensi yang ingin Anda lihat. Untuk informasi selengkapnya, lihat [Lihat ekstensi yang tersedia dan diaktifkan di CloudFormation registri](registry-view.md).

1. Pilih ekstensi untuk melihat detail ekstensi.

1. Pada halaman detail ekstensi, pilih tab **Konfigurasi**.

1. Perluas tab **skema Konfigurasi** untuk melihat skema konfigurasi yang ditentukan untuk ekstensi.

1. Perluas tab **Konfigurasi** untuk melihat konfigurasi saat ini yang telah Anda tetapkan untuk ekstensi ini.

**Untuk memperbarui data konfigurasi untuk ekstensi**

1. Pada halaman detail ekstensi, dari tab **Konfigurasi**, pilih **Edit konfigurasi**.

   Atau, dari **Tindakan**, pilih **Edit**, lalu pilih **Edit konfigurasi**.

   CloudFormation menampilkan halaman **ekstensi Konfigurasi**. Pastikan **skema konfigurasi View diaktifkan untuk melihat skema** definisi konfigurasi ekstensi saat ini.

1. Di kotak teks **Konfigurasi JSON**, masukkan string JSON yang mewakili skema konfigurasi yang ingin Anda atur untuk ekstensi ini. Itu harus memvalidasi terhadap skema yang didefinisikan dalam skema **Konfigurasi**.

1. Pilih **Konfigurasi ekstensi**.

## Mengedit data konfigurasi untuk ekstensi (AWS CLI)
<a name="registry-set-configuration-procedure-cli"></a>

Ikuti langkah-langkah di bagian ini untuk menggunakan AWS CLI to:
+ Melihat data konfigurasi saat ini untuk ekstensi
+ Perbarui data konfigurasi ekstensi untuk akun Anda

**Untuk melihat data konfigurasi saat ini untuk ekstensi**
+ Gunakan [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html)perintah untuk mengembalikan informasi terperinci tentang ekstensi. `ConfigurationSchema`Elemen output berisi definisi konfigurasi ekstensi saat ini di Wilayah tertentu.

  Atau, gunakan [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/batch-describe-type-configurations.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/batch-describe-type-configurations.html)perintah untuk mengembalikan data konfigurasi tentang beberapa ekstensi.

**Untuk memperbarui data konfigurasi untuk ekstensi**
+ Gunakan [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html)perintah untuk menentukan data konfigurasi. JSON yang Anda lewati `--configuration` harus memvalidasi terhadap skema konfigurasi ekstensi. 

  Dalam contoh berikut, **set-type-configuration** perintah menentukan data konfigurasi *`"{"CredentialKey": "testUserCredential"}"`* untuk `--configuration` opsi.

  ```
  aws cloudformation set-type-configuration --type RESOURCE \
    --type-name My::Resource::Example \
    --configuration-alias default \
    --configuration "{"CredentialKey": "testUserCredential"}" \
    --region us-west-2
  ```