Ini adalah Panduan Pengembang AWS CDK v2. CDK v1 yang lebih lama memasuki pemeliharaan pada 1 Juni 2022 dan mengakhiri dukungan pada 1 Juni 2023.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Gunakan sumber daya dari AWS CloudFormation Public Registry
AWS CloudFormation Public Registry memungkinkan Anda mengelola ekstensi, baik publik maupun pribadi, seperti sumber daya, modul, dan kait yang tersedia untuk digunakan di AWS akun Anda. Anda dapat menggunakan ekstensi sumber daya publik di aplikasi AWS Cloud Development Kit (AWS CDK) Anda dengan [https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html)konstruksinya.
Untuk mempelajari lebih lanjut tentang Registri AWS CloudFormation Publik, lihat [Menggunakan AWS CloudFormation registri](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) di *Panduan AWS CloudFormation Pengguna*.
Semua ekstensi publik yang diterbitkan oleh AWS tersedia untuk semua akun di semua Wilayah tanpa tindakan apa pun dari Anda. Namun, Anda harus mengaktifkan setiap ekstensi pihak ketiga yang ingin Anda gunakan, di setiap akun dan Wilayah tempat Anda ingin menggunakannya.
**catatan**
Ketika Anda menggunakan AWS CloudFormation dengan jenis sumber daya pihak ketiga, Anda akan dikenakan biaya. Biaya didasarkan pada jumlah operasi handler yang Anda jalankan per bulan dan durasi operasi handler. Lihat [CloudFormation harga](https://aws.amazon.com/cloudformation/pricing/) untuk detail lengkapnya.
Untuk mempelajari lebih lanjut tentang ekstensi publik, lihat [Menggunakan ekstensi publik CloudFormation di](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html) *Panduan AWS CloudFormation Pengguna*
## Aktifkan sumber daya pihak ketiga di akun dan Wilayah Anda
Ekstensi yang diterbitkan oleh AWS tidak memerlukan aktivasi. Mereka selalu tersedia di setiap akun dan Wilayah. Anda dapat mengaktifkan ekstensi pihak ketiga melalui konsol AWS manajemen, melalui antarmuka baris AWS perintah, atau dengan menggunakan AWS CloudFormation sumber daya khusus.
**Untuk mengaktifkan ekstensi pihak ketiga melalui Konsol AWS Manajemen atau melihat sumber daya apa yang tersedia**
![\[aktifkan ekstensi cfn\]](http://docs.aws.amazon.com/id_id/cdk/v2/guide/images/activate-cfn-extension.png)
1. Masuk ke AWS akun tempat Anda ingin menggunakan ekstensi, lalu beralih ke Wilayah tempat Anda ingin menggunakannya.
1. Arahkan ke CloudFormation konsol melalui menu **Layanan**.
1. Pilih **Ekstensi publik** di bilah navigasi, lalu aktifkan tombol radio **pihak ketiga** di bawah **Penerbit**. Daftar ekstensi publik pihak ketiga yang tersedia muncul. (Anda juga dapat memilih ** AWS **untuk melihat daftar ekstensi publik yang diterbitkan oleh AWS, meskipun Anda tidak perlu mengaktifkannya.)
1. Jelajahi daftar dan temukan ekstensi yang ingin Anda aktifkan. Atau, cari, lalu aktifkan tombol radio di sudut kanan atas kartu ekstensi.
1. Pilih tombol **Aktifkan** di bagian atas daftar untuk mengaktifkan ekstensi yang dipilih. Halaman **Aktifkan** ekstensi muncul.
1. Di halaman **Aktifkan**, Anda dapat mengganti nama default ekstensi dan menentukan peran eksekusi dan konfigurasi logging. Anda juga dapat memilih apakah akan memperbarui ekstensi secara otomatis saat versi baru dirilis. Ketika Anda telah mengatur opsi ini sesuka Anda, pilih **Aktifkan ekstensi** di bagian bawah halaman.
**Untuk mengaktifkan ekstensi pihak ketiga menggunakan AWS CLI**
+ Gunakan perintah `activate-type`. Gantikan ARN dari jenis kustom yang ingin Anda gunakan jika ditunjukkan.
Berikut ini adalah contohnya:
```
aws cloudformation activate-type --public-type-arn --auto-update-activated
```
**Untuk mengaktifkan ekstensi pihak ketiga melalui CloudFormation atau CDK**
1. Menyebarkan sumber daya tipe ` AWS::CloudFormation::TypeActivation` dan menentukan properti berikut:
1. `TypeName`- Nama jenisnya, seperti`AWSQS::EKS::Cluster`.
1. `MajorVersion`- Nomor versi utama ekstensi yang Anda inginkan. Abaikan jika Anda menginginkan versi terbaru.
1. `AutoUpdate`- Apakah akan memperbarui ekstensi ini secara otomatis ketika versi minor baru dirilis oleh penerbit. (Pembaruan versi utama memerlukan perubahan `MajorVersion` properti secara eksplisit.)
1. `ExecutionRoleArn`- ARN dari peran IAM di mana ekstensi ini akan berjalan.
1. `LoggingConfig`- Konfigurasi logging untuk ekstensi.
`TypeActivation`Sumber daya dapat digunakan oleh CDK menggunakan konstruksi. [https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html) Ini ditampilkan untuk ekstensi yang sebenarnya di bagian berikut.
## Menambahkan sumber daya dari AWS CloudFormation Public Registry ke aplikasi CDK
Gunakan [https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnResource.html)konstruksi untuk menyertakan sumber daya dari AWS CloudFormation Public Registry dalam aplikasi Anda. Konstruksi ini ada di modul CDK. `aws-cdk-lib`
Misalnya, anggaplah ada sumber daya publik bernama `MY::S5::UltimateBucket` yang ingin Anda gunakan dalam aplikasi AWS CDK Anda. Sumber daya ini mengambil satu properti: nama bucket. `CfnResource`Instantiasi yang sesuai terlihat seperti ini.
**Example**
```
const ubucket = new CfnResource(this, 'MyUltimateBucket', {
type: 'MY::S5::UltimateBucket::MODULE',
properties: {
BucketName: 'UltimateBucket'
}
});
```
```
const ubucket = new CfnResource(this, 'MyUltimateBucket', {
type: 'MY::S5::UltimateBucket::MODULE',
properties: {
BucketName: 'UltimateBucket'
}
});
```
```
ubucket = CfnResource(self, "MyUltimateBucket",
type="MY::S5::UltimateBucket::MODULE",
properties=dict(
BucketName="UltimateBucket"))
```
```
CfnResource.Builder.create(this, "MyUltimateBucket")
.type("MY::S5::UltimateBucket::MODULE")
.properties(java.util.Map.of( // Map.of requires Java 9+
"BucketName", "UltimateBucket"))
.build();
```
```
new CfnResource(this, "MyUltimateBucket", new CfnResourceProps
{
Type = "MY::S5::UltimateBucket::MODULE",
Properties = new Dictionary
{
["BucketName"] = "UltimateBucket"
}
});
```