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

# Mengidentifikasi sumber daya dengan AWS Cloud Control API
<a name="resource-identifier"></a>

Setiap jenis sumber daya memiliki properti yang didefinisikan sebagai *pengenal 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` atau`delete-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 tipe 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](resource-types.md#resource-types-schemas).

## Mendapatkan pengenal utama sumber daya
<a name="resource-identifier-getting"></a>

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
<a name="resource-identifier-using"></a>

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 tabel`MyTable`, Anda menentukan`MyDatabase|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](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier) di *CloudFormation Command Line Interface User Move* for Extension Development.