应用程序 applicationId 变更集 - Amazon Serverless Application Repository
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

应用程序 applicationId 变更集

URI

/applications/applicationId/changesets

HTTP 方法

帖子

操作 ID: CreateCloudFormationChangeSet

创建Amazon为给定应用程序设置 CloudFormation。

路径参数
名称类型必需描述
applicationIdStringTrue

应用程序的 Amazon 资源名称 (ARN)。

响应
状态代码响应模型描述
201变更集详细信息

成功

400BadRequestException

请求中的参数之一无效。

403禁止的例外

客户端未经过身份验证。

429TooManyRequestsException

客户端发送的请求超过了允许的每个单位时间的请求数。

500InternalServerErrorException

Amazon Serverless Application Repository 服务遇到了内部错误。

Schemas

请求正文

{ "stackName": "string", "semanticVersion": "string", "templateId": "string", "parameterOverrides": [ { "name": "string", "value": "string" } ], "capabilities": [ "string" ], "changeSetName": "string", "clientToken": "string", "description": "string", "notificationArns": [ "string" ], "resourceTypes": [ "string" ], "rollbackConfiguration": { "rollbackTriggers": [ { "arn": "string", "type": "string" } ], "monitoringTimeInMinutes": integer }, "tags": [ { "key": "string", "value": "string" } ] }

响应正文

{ "applicationId": "string", "semanticVersion": "string", "changeSetId": "string", "stackId": "string" }
{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }

属性

BadRequestException

请求中的参数之一无效。

属性类型必需描述
errorCode

字符串

False

400

message

字符串

False

请求中的参数之一无效。

变更集详细信息

更改集的详细信息。

属性类型必需描述
applicationId

字符串

True

应用程序 Amazon 资源名称 (ARN)。

变更 SetID

字符串

True

更改集的 Amazon 资源名称 (ARN)。

长度约束:最小长度为 1。

模式:ARN: [-a-zA-Z0-9:/] *

语义版

字符串

True

应用程序的语义版本:

https://semver.org/;

StackId

字符串

True

堆栈的唯一 ID。

创建 CloudFORMATION 变更集输入

创建应用程序更改集请求。

属性类型必需描述
capabilities

类型的数组string

False

必须在可以部署某些应用程序之前指定的值列表。一些应用程序中包含的资源会影响您的中的权限。Amazon例如,通过创建新账户Amazon Identity and Access Management(IAM) 用户。对于这些应用程序,您必须指定此参数以显示确认它们的功能。

有效值仅为CAPABILITY_IAMCAPABILITY_NAMED_IAMCAPABILITY_RESOURCE_POLICY, 和CAPABILITY_AUTO_EXPAND.

以下资源要求您指定CAPABILITY_IAM要么CAPABILITY_NAMED_IAMAWS::IAM::GroupAWS::IAM::InstanceProfileAWS::IAM::Policy, 和AWS::IAM::Role. 如果应用程序包含 IAM 资源,您可以指定任一内容:CAPABILITY_IAM要么CAPABILITY_NAMED_IAM. 如果应用程序包含具有自定义名称的 IAM 资源,您必须指定 CAPABILITY_NAMED_IAM

以下资源要求您指定CAPABILITY_RESOURCE_POLICYAWS::Lambda::PermissionAmazon። IAM: 政策AWS::ApplicationAutoScaling::ScalingPolicyAWS::S3::BucketPolicyAWS::SQS::QueuePolicy, 和Amazon። SNS: 主题政策.

包含一个或多个嵌套应用程序的应用程序要求您指定 CAPABILITY_AUTO_EXPAND

如果应用程序模板包含以上任何资源,我们建议您在部署之前检查与应用程序关联的所有权限。如果您不为需要功能的应用程序指定此参数,则该调用将失败。

ChangeSetName

字符串

False

此属性对应于的同名参数。Amazon CloudFormation CreateChangeSet API。

clientToken

字符串

False

此属性对应于的同名参数。Amazon CloudFormation CreateChangeSet API。

description

字符串

False

此属性对应于的同名参数。Amazon CloudFormation CreateChangeSet API。

NotificationARN

类型的数组string

False

此属性对应于的同名参数。Amazon CloudFormation CreateChangeSet API。

覆盖参数

类型的数组ParameterValue

False

应用程序参数的参数值列表。

resourceTypes

类型的数组string

False

此属性对应于的同名参数。Amazon CloudFormation CreateChangeSet API。

回滚配置

RollbackConfiguration

False

此属性对应于的同名参数。Amazon CloudFormation CreateChangeSet API。

语义版

字符串

False

应用程序的语义版本:

https://semver.org/;

StackName

字符串

True

此属性对应于的同名参数。Amazon CloudFormation CreateChangeSet API。

标签

类型的数组Tag

False

此属性对应于的同名参数。Amazon CloudFormation CreateChangeSet API。

TemplateId

字符串

False

CreateCloudFormationTemplate 返回的 UUID。

模式:[0-9a-FA-F] {8}\-[0-9a-FA-F] {4}\-[0-9a-FA-F] {4}\-[0-9a-FA-F] {4}\-[0-9a-FA-F] {12}

禁止的例外

客户端未经过身份验证。

属性类型必需描述
errorCode

字符串

False

403

message

字符串

False

客户端未经过身份验证。

InternalServerErrorException

Amazon Serverless Application Repository 服务遇到了内部错误。

属性类型必需描述
errorCode

字符串

False

500

message

字符串

False

Amazon Serverless Application Repository 服务遇到了内部错误。

ParameterValue

应用程序的参数值。

属性类型必需描述
名称

字符串

True

与参数关联的键。如果未指定特定参数的键和值,Amazon CloudFormation使用模板中指定的默认值。

字符串

True

与参数关联的输入值。

RollbackConfiguration

此属性对应于Amazon CloudFormation RollbackConfiguration 数据类型

属性类型必需描述
在几分钟内监控时间

integer

False

此属性对应于的相同名称的内容Amazon CloudFormation RollbackConfiguration 数据类型

RollBackTr

类型的数组RollbackTrigger

False

此属性对应于的相同名称的内容Amazon CloudFormation RollbackConfiguration 数据类型

RollbackTrigger

此属性对应于Amazon CloudFormation RollbackTrigger 数据类型

属性类型必需描述
arn

字符串

True

此属性对应于的相同名称的内容Amazon CloudFormation RollbackTrigger 数据类型。

type

字符串

True

此属性对应于的相同名称的内容Amazon CloudFormation RollbackTrigger 数据类型。

标签

此属性对应于Amazon CloudFormation 标记 数据类型。

属性类型必需描述
key

字符串

True

此属性对应于的相同名称的内容Amazon CloudFormation 标记 数据类型。

字符串

True

此属性对应于的相同名称的内容Amazon CloudFormation 标记 数据类型。

TooManyRequestsException

客户端发送的请求超过了允许的每个单位时间的请求数。

属性类型必需描述
errorCode

字符串

False

429

message

字符串

False

客户端发送的请求超过了允许的每个单位时间的请求数。