名称类型

对于某些资源，您可以指定自定义名称。在默认情况下，Amazon CloudFormation 会生成唯一物理 ID，来命名资源。举例来说，CloudFormation 可能会使用物理 ID stack123123123123-s3bucket-abcdefghijk1 来命名 Amazon S3 桶。借助自定义名称，您可以指定一个更易于读取和识别的名称，如 production-app-logs 或 business-metrics。

资源名称在您的所有活动堆栈中必须是唯一的。如果您重复使用模板来创建多个堆栈，则必须从模板来更改或删除自定义名称。如果您没有指定名称，则 CloudFormation 将生成一个唯一物理 ID 来为资源命名。名称必须以字母开头，只能包含 ASCII 字母、数字和连字符，并且不能以连字符结尾或包含两个连续的连字符。

此外，请勿管理 CloudFormation 外部的堆栈资源。举例来说，如果重命名一个资源，该资源属于未使用 CloudFormation 的堆栈，每次当您尝试更新或删除该堆栈时，都可能发生错误。

示例

如果您想要使用自定义名称，请在 CloudFormation 模板中为该资源指定名称属性。支持自定义名称的每个资源都具有可以指定的自身属性。例如，要命名一个 DynamoDB 表，您可以使用 TableName 属性，如以下示例所示：

"myDynamoDBTable" : {
   "Type" : "AWS::DynamoDB::Table",
   "Properties" : {
      "KeySchema" : {
         "HashKeyElement": {
            "AttributeName" : "AttributeName1",
            "AttributeType" : "S"
         },
         "RangeKeyElement" : {
            "AttributeName" : "AttributeName2",
            "AttributeType" : "N"
         }
      },
      "ProvisionedThroughput" : {
         "ReadCapacityUnits" : "5",
         "WriteCapacityUnits" : "10"
      },
      "TableName" : "SampleTable"
   }
}

myDynamoDBTable: 
  Type: AWS::DynamoDB::Table
  Properties: 
    KeySchema: 
      HashKeyElement: 
        AttributeName: "AttributeName1"
        AttributeType: "S"
      RangeKeyElement: 
        AttributeName: "AttributeName2"
        AttributeType: "N"
    ProvisionedThroughput: 
      ReadCapacityUnits: "5"
      WriteCapacityUnits: "10"
    TableName: "SampleTable"

支持的资源

以下资源类型支持自定义名称：