AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

名称类型

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

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

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

重要

您无法执行导致自定义命名的资源被更换的更新。如果必须替换资源,请指定新名称。

示例

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

JSON

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

YAML

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

支持的资源

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

本页内容: