Mengidentifikasi sumber daya

Setiap jenis sumber daya memiliki properti yang didefinisikan sebagai pengidentifikasi utamanya. Nilai properti ini harus unik untuk setiap sumber daya dari jenis yang diberikan Akun AWS dan Wilayah AWS. Misalnya, banyak jenis sumber daya menyertakan Name properti yang harus unik untuk setiap sumber daya dari jenis itu. Dalam beberapa kasus, pengidentifikasi utama didefinisikan sebagai kombinasi dari beberapa properti yang bersama-sama membentuk pengidentifikasi unik. Dengan menggunakan pengenal utama ini, dikombinasikan dengan jenis sumber daya, Anda dapat menentukan dengan tepat sumber daya mana yang ingin Anda lakukan operasi sumber daya seperti update-resource ataudelete-resource.

Selain itu, beberapa jenis sumber daya mendefinisikan pengidentifikasi sekunder yang juga dapat digunakan untuk mengidentifikasi sumber daya secara unik dari jenis itu.

Untuk menentukan properti sumber daya (atau kombinasi properti) yang merupakan pengidentifikasi utama untuk jenis sumber daya, lihat primaryIdentifier atribut skema tipe sumber daya. Skema ini mencakup pengidentifikasi sekunder yang didefinisikan, juga. Untuk informasi selengkapnya, lihat Melihat skema tipe sumber daya.

Mendapatkan pengenal utama sumber daya

Anda dapat menemukan nilai pengenal untuk sumber daya tertentu dengan menggunakan perintah Cloud Control API. Masing-masing perintah berikut mengembalikan ProgressEvent objek yang berisi pengenal utama dari sumber daya yang ditentukan:

• cancel-resource-request

• create-resource

• get-resource-request-status

• list-resource-requests

Menggunakan pengenal utama sumber daya

Saat menggunakan perintah Cloud Control API, Anda dapat menentukan pengenal utama atau pengenal sekunder apa pun yang ditentukan untuk jenis sumber daya dalam skema sumber dayanya. Anda hanya dapat menentukan satu pengenal. Pengidentifikasi primer dapat ditentukan sebagai string atau JSON; pengidentifikasi sekunder harus ditentukan sebagai JSON.

Untuk pengidentifikasi primer majemuk (yaitu, yang terdiri dari beberapa properti sumber daya yang dirangkai bersama), untuk menentukan pengidentifikasi utama sebagai string, daftarkan nilai properti dalam urutan yang ditentukan dalam definisi pengidentifikasi utama, dipisahkan oleh. |

Misalnya, pengidentifikasi utama untuk sumber daya didefinisikan sebagai:

"primaryIdentifier": [ "/properties/DatabaseName", "/properties/TableName" ]

Jadi, untuk menentukan pengenal utama sumber daya sebagai string, Anda menggunakan format berikut.

DatabaseName|TableName

Misalnya, diberikan database dengan nama database MyDatabase dan nama tabelMyTable, Anda menentukanMyDatabase|MyTable.

Untuk pengidentifikasi senyawa yang ditentukan sebagai JSON, urutan properti tidak diperlukan, seperti yang ditunjukkan pada contoh berikut.

{
  "TableName": "MyTable",
  "DatabaseName": "MyDatabase"
}

Untuk informasi selengkapnya tentang pengenal sumber daya, lihat primary identifier di CloudFormation Command Line Interface User Move for Extension Development.