标识资源 - Cloud Control API
获取资源的主标识符使用资源的主标识符
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

标识资源

每种资源类型都有一个定义为其主标识符的属性。对于给定和中该类型的每种资源，此属性的值必须是唯一 Amazon Web Services 账户 的 Amazon Web Services 区域。例如，许多资源类型包括一个 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。