应用程序应用程序 ID 变更集 - Amazon Serverless Application Repository
URIHTTP 方法架构属性
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

应用程序应用程序 ID 变更集

URI

/applications/applicationId/changesets

HTTP 方法

POST

操作 ID：CreateCloudFormationChangeSet

为给定的应用程序创建 Amazon CloudFormation 更改集。

路径参数
名称Type必需描述
应用程序 IDStringTrue

应用程序的 Amazon 资源名称（ARN）。

响应
状态代码响应模型描述
201ChangeSetDetails

成功

400BadRequestException

请求中的参数之一无效。

403ForbiddenException

客户端未通过身份验证。

429TooManyRequestsException

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

500InternalServerErrorException

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

OPTIONS

路径参数
名称Type必需描述
应用程序 IDStringTrue

应用程序的 Amazon 资源名称（ARN）。

响应
状态代码响应模型描述
200无

200 条回复

架构

请求正文

{
  "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

请求中的参数之一无效。

ChangeSetDetails

变更集的详细信息。

属性类型必需描述
applicationId

字符串

True

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

changeSetId

字符串

True

变更集的亚马逊资源名称 (ARN)。

长度限制：最小长度为 1。

模式：ARN：[-a-za-z0-9：/] *

semanticVersion

字符串

True

应用程序的语义版本：

https://semver.org/

stackId

字符串

True

堆栈的唯一 ID。

CreateCloudFormationChangeSetInput

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

属性类型必需描述
capabilities

string 类型的数组

False

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

唯一有效的值是CAPABILITY_IAM、CAPABILITY_NAMED_IAMCAPABILITY_RESOURCE_POLICY、和CAPABILITY_AUTO_EXPAND。

以下资源需要您指定CAPABILITY_IAM或CAPABILITY_NAMED_IAM：AWS::IAM::Group、AWS::IAM::InstanceProfileAWS::IAM::Policy、和AWS::IAM::Role。如果应用程序包含 IAM 资源，则可以指定CAPABILITY_IAM或CAPABILITY_NAMED_IAM。如果应用程序包含具有自定义名称的 IAM 资源，您必须指定 CAPABILITY_NAMED_IAM。

以下资源要求您指定CAPABILITY_RESOURCE_POLICY:AWS::Lambda::Permission、AWS:: iam: Policy、、AWS::ApplicationAutoScaling::ScalingPolicyAWS::S3::BucketPolicy、AWS::SQS::QueuePolicy和 AWS:: SN S:。TopicPolicy

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

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

changeSetName

字符串

False

此属性与 Amazon CloudFormation CreateChangeSetAPI 的同名参数相对应。

clientToken

字符串

False

此属性与 Amazon CloudFormation CreateChangeSetAPI 的同名参数相对应。

description

字符串

False

此属性与 Amazon CloudFormation CreateChangeSetAPI 的同名参数相对应。

notificationArns

string 类型的数组

False

此属性与 Amazon CloudFormation CreateChangeSetAPI 的同名参数相对应。

parameterOverrides

ParameterValue 类型的数组

False

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

resourceTypes

string 类型的数组

False

此属性与 Amazon CloudFormation CreateChangeSetAPI 的同名参数相对应。

rollbackConfiguration

RollbackConfiguration

False

此属性与 Amazon CloudFormation CreateChangeSetAPI 的同名参数相对应。

semanticVersion

字符串

False

应用程序的语义版本：

https://semver.org/

stackName

字符串

True

此属性与 Amazon CloudFormation CreateChangeSetAPI 的同名参数相对应。

tags

Tag 类型的数组

False

此属性与 Amazon CloudFormation CreateChangeSetAPI 的同名参数相对应。

templateId

字符串

False

返回的 UUID。 CreateCloudFormationTemplate

模式：[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}

ForbiddenException

客户端未通过身份验证。

属性类型必需描述
errorCode

字符串

False

403

message

字符串

False

客户端未通过身份验证。

InternalServerErrorException

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

属性类型必需描述
errorCode

字符串

False

500

message

字符串

False

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

ParameterValue

应用程序的参数值。

属性类型必需描述
name

字符串

True

与参数关联的键。如果您没有为特定参数指定键和值，则 Amazon CloudFormation 使用模板中指定的默认值。

value

字符串

True

与参数关联的输入值。

RollbackConfiguration

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

属性类型必需描述
monitoringTimeInMinutes

整数

False

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

rollbackTriggers

RollbackTrigger 类型的数组

False

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

RollbackTrigger

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

属性类型必需描述
arn

字符串

True

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

type

字符串

True

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

Tag

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

属性类型必需描述
key

字符串

True

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

value

字符串

True

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

TooManyRequestsException

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

属性类型必需描述
errorCode

字符串

False

429

message

字符串

False

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