本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
用以下方法识别资源 AWS Cloud Control API
每种资源类型都有一个定义为其主标识符的属性。对于给定和中该类型的每种资源,此属性的值必须是唯一 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 命令行界面用户移动》中的 p rimary identifier。