本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 識別資源 AWS 雲端控制 API
<a name="resource-identifier"></a>

每個資源類型都有定義為其*主要識別符*的屬性。對於指定 AWS 帳戶 和 中該類型的每個資源，此屬性的值必須是唯一的 AWS 區域。例如，許多資源類型包含`Name`屬性，對於該類型的每個資源都必須是唯一的。在某些情況下，主要識別符定義為多個屬性的組合，這些屬性共同形成唯一識別符。透過使用此主要識別符與資源類型結合，您可以指定要在其中執行資源操作的確切資源，例如 `update-resource`或 `delete-resource`。

此外，某些資源類型會定義*次要識別符*，也可以用來唯一識別該類型的資源。

若要判斷哪個資源屬性 （或屬性組合） 是資源類型的主要識別符，請參閱資源類型結構描述的`primaryIdentifier`屬性。結構描述也包含定義的次要識別符。如需詳細資訊，請參閱[檢視資源類型結構描述](resource-types.md#resource-types-schemas)。

## 取得資源的主要識別符
<a name="resource-identifier-getting"></a>

您可以使用 Cloud Control API 命令來尋找特定資源的識別符*值*。下列每個命令都會傳回包含指定資源主要識別符的`ProgressEvent`物件：
+ 

  ```
  cancel-resource-request
  ```
+ 

  ```
  create-resource
  ```
+ 

  ```
  get-resource-request-status
  ```
+ 

  ```
  list-resource-requests
  ```

## 使用資源的主要識別符
<a name="resource-identifier-using"></a>

使用 Cloud Control API 命令時，您可以在其資源結構描述中指定主要識別符或任何為資源類型定義的次要識別符。您只能指定一個識別符。主要識別符可以指定為字串或 JSON；次要識別符必須指定為 JSON。

對於複合主要識別符 （即由多個資源屬性組成的一個），若要將主要識別符指定為字串，請依在主要識別符定義中*指定的順序*列出屬性值，並以 分隔`|`。

例如，資源的主要識別符定義為：

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

因此，若要將資源的主要識別符指定為字串，請使用下列格式。

`DatabaseName|TableName`

例如，指定資料庫名稱為 `MyDatabase`且資料表名稱為 的資料庫`MyTable`，您可以指定 `MyDatabase|MyTable`。

對於指定為 JSON 的複合識別符，不需要屬性順序，如下列範例所示。

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

如需資源識別符的詳細資訊，請參閱 *CloudFormation 命令列界面使用者移動以進行延伸開發*中的[主要識別符](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier)。