識別資源 - 雲端控制 API

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

識別資源

每個資源類型都有定義為其屬性主要識別符。此屬性的值對於給定中該類型的每個資源都必須是唯一的AWS 帳戶和AWS 區域。例如,許多資源類型都包含Name屬性對於該類型的每個資源必須是唯一的。在某些情況下,主標識符被定義為多個屬性的組合,這些屬性在一起形成唯一標識符。透過使用此主要識別碼 (結合資源類型),您可以準確指定要在其上執行資源作業的資源,例如update-resource或者delete-resource

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

若要判斷哪個資源屬性 (或屬性組合) 是資源類型的主要識別碼,請參閱primaryIdentifier資源類型模式的屬性。結構描述也包含定義的次要識別碼。如需詳細資訊,請參閱「」檢視資源類型結構描述

獲取資源的主標識符

您可以找到識別符使用雲控制 API 命令獲取特定資源。下列各個命令會傳回ProgressEvent包含指定資源的主標識符的對象:

  • cancel-resource-request

  • create-resource

  • get-resource-request-status

  • list-resource-requests

使用資源的主要識別碼

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

對於複合主要識別碼 (亦即,由串連在一起的多個資源屬性組成的識別碼),若要將主要識別碼指定為字串,請列出屬性值依指定它們的順序在主要識別碼定義中,以下列方式分隔|

例如,資源定義為:

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

所以,要指定一個的主標識符資源作為一個字符串,您使用以下格式。

DatabaseName|TableName

例如,給定一個數據庫具有數據庫名稱MyDatabase和資料表名稱MyTable,您指定MyDatabase|MyTable

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

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

如需資源識別符的詳細資訊,請參閱主要標識符中的CloudFormation 擴充功能開發命令列介面使用者指南