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

Create

当 template developer 创建包含自定义资源的堆栈时,将发送 RequestType 已设置为 "Create" 的自定义资源提供者请求。

请求

创建请求包含以下字段:

RequestType

将为“Create”。

请求 ID

请求的唯一 ID。

ResponseURL

响应 URL 标识预签名的 S3 存储桶,该存储桶接收 custom resource provider 到 AWS CloudFormation 的响应。

ResourceType

AWS CloudFormation 模板中模板开发人员选择的自定义资源的资源类型。自定义资源类型名称的长度最多为 60 个字符,并且可包含字母数字字符和以下字符:_@-

LogicalResourceId

AWS CloudFormation 模板中 template developer 选择的自定义资源名称(逻辑 ID)。

堆栈 ID

标识包含自定义资源的堆栈的 Amazon 资源名称 (ARN)。

ResourceProperties

该字段包含 template developer 发送的 Properties 对象的内容。其内容由 custom resource provider 定义。

示例

{ "RequestType" : "Create", "RequestId" : "unique id for this create request", "ResponseURL" : "pre-signed-url-for-create-response", "ResourceType" : "Custom::MyCustomResourceType", "LogicalResourceId" : "name of resource in template", "StackId" : "arn:aws:cloudformation:us-east-2:namespace:stack/stack-name/guid", "ResourceProperties" : { "key1" : "string", "key2" : [ "list" ], "key3" : { "key4" : "map" } } }

响应

成功

创建请求成功时,必须向 S3 存储桶发送包含以下字段的响应:

状态

必须为“SUCCESS”。

LogicalResourceId

AWS CloudFormation 模板中 template developer 选择的自定义资源名称(逻辑 ID)。 此响应值应从请求中复制 verbatim

请求 ID

请求的唯一 ID。 此响应值应从请求中复制 verbatim

堆栈 ID

标识包含自定义资源的堆栈的 Amazon 资源名称 (ARN)。 此响应值应从请求中复制 verbatim

PhysicalResourceId

该值应是对于自定义资源供应商具有唯一性的标识符,最大大小为 1 Kb。该值必须是非空字符串,并且在所有响应中对于相同资源必须相同。

Data

要在响应中发送的custom resource provider定义的名称-值对(可选)。您可以使用 Fn::GetAtt 在模板中按名称访问此处提供的值。

示例

{ "Status" : "SUCCESS", "LogicalResourceId" : "name of resource in template (copied from request)", "RequestId" : "unique id for this create request (copied from request)", "StackId" : "arn:aws:cloudformation:us-east-2:namespace:stack/stack-name/guid (copied from request)", "PhysicalResourceId" : "required vendor-defined physical id that is unique for that vendor", "Data" : { "keyThatCanBeUsedInGetAtt1" : "data for key 1", "keyThatCanBeUsedInGetAtt2" : "data for key 2" } }

已失败

创建请求失败时,必须向 S3 存储桶发送包含以下字段的响应:

状态

必须为“FAILED”。

原因

描述响应失败的原因。

LogicalResourceId

AWS CloudFormation 模板中 template developer 选择的自定义资源名称(逻辑 ID)。 此响应值应从请求中复制 verbatim

PhysicalResourceId

该值应是对于自定义资源供应商具有唯一性的标识符,最大大小为 1 Kb。该值必须是非空字符串,并且在所有响应中对于相同资源必须相同。

请求 ID

请求的唯一 ID。 此响应值应从请求中复制 verbatim

堆栈 ID

标识包含自定义资源的堆栈的 Amazon 资源名称 (ARN)。 此响应值应从请求中复制 verbatim

示例

{ "Status" : "FAILED", "Reason" : "Required failure reason string", "LogicalResourceId" : "name of resource in template (copied from request)", "PhysicalResourceId" : "required vendor-defined physical id that is unique for that vendor", "RequestId" : "unique id for this create request (copied from request)", "StackId" : "arn:aws:cloudformation:us-east-2:namespace:stack/stack-name/guid (copied from request)" }

本页内容: