本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
識別資源
每個資源類型都有定義為其主要識別碼的屬性。對於指定和中該類型的每個資源,此屬性的值都必須是唯一 AWS 帳戶 的 AWS 區域。例如,許多資源類型都包含一個Name
屬性,該屬性對於該類型的每個資源都必須是唯一的。在某些情況下,主標識符被定義為多個屬性的組合,這些屬性在一起形成唯一標識符。透過使用此主要識別碼 (結合資源類型),您可以準確指定要在其上執行資源作業的資源,例如update-resource
或delete-resource
。
此外,某些資源類型定義次要識別碼,也可用於唯一識別該類型的資源。
若要判斷哪個資源內容 (或內容組合) 是資源類型的主要識別碼,請參閱資源類型結構描述的primaryIdentifier
屬性。結構描述也包含定義的次要識別碼。如需詳細資訊,請參閱 檢視資源類型綱要。
獲取資源的主標識符
您可以使用 Cloud Control 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 命令列介面使用者移動中的主要識別碼。