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

# 应用程序应用程序 ID 变更集
<a name="applications-applicationid-changesets"></a>

## URI
<a name="applications-applicationid-changesets-url"></a>

`/applications/applicationId/changesets`

## HTTP 方法
<a name="applications-applicationid-changesets-http-methods"></a>

### POST
<a name="applications-applicationid-changesetspost"></a>

**操作 ID：**`CreateCloudFormationChangeSet`

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


**路径参数**  

| Name | Type | 必需 | 描述 | 
| --- |--- |--- |--- |
| applicationId | 字符串 | True | 应用程序的 Amazon 资源名称（ARN）。 | 


**响应**  

| 状态代码 | 响应模型 | 说明 | 
| --- |--- |--- |
| 201 | ChangeSetDetails | 成功 | 
| 400 | BadRequestException | 请求中的参数之一无效。 | 
| 403 | ForbiddenException | 客户端未通过身份验证。 | 
| 429 | TooManyRequestsException | 客户端每单位时间发送的请求数超过了允许的请求数。 | 
| 500 | InternalServerErrorException | 该 AWS Serverless Application Repository 服务遇到了内部错误。 | 

### OPTIONS
<a name="applications-applicationid-changesetsoptions"></a>


**路径参数**  

| Name | Type | 必需 | 描述 | 
| --- |--- |--- |--- |
| applicationId | 字符串 | True | 应用程序的 Amazon 资源名称（ARN）。 | 


**响应**  

| 状态代码 | 响应模型 | 说明 | 
| --- |--- |--- |
| 200 | 无 | 200 条回复 | 

## 架构
<a name="applications-applicationid-changesets-schemas"></a>

### 请求正文
<a name="applications-applicationid-changesets-request-examples"></a>

#### POST 架构
<a name="applications-applicationid-changesets-request-body-post-example"></a>

```
{
  "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"
    }
  ]
}
```

### 响应正文
<a name="applications-applicationid-changesets-response-examples"></a>

#### ChangeSetDetails 架构
<a name="applications-applicationid-changesets-response-body-changesetdetails-example"></a>

```
{
  "applicationId": "string",
  "semanticVersion": "string",
  "changeSetId": "string",
  "stackId": "string"
}
```

#### BadRequestException 架构
<a name="applications-applicationid-changesets-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### ForbiddenException 架构
<a name="applications-applicationid-changesets-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### TooManyRequestsException 架构
<a name="applications-applicationid-changesets-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### InternalServerErrorException 架构
<a name="applications-applicationid-changesets-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Properties
<a name="applications-applicationid-changesets-properties"></a>

### BadRequestException
<a name="applications-applicationid-changesets-model-badrequestexception"></a>

请求中的参数之一无效。


| 属性 | Type | 必需 | 描述 | 
| --- |--- |--- |--- |
| errorCode | 字符串 | False | 400 | 
| message | 字符串 | False | 请求中的参数之一无效。 | 

### ChangeSetDetails
<a name="applications-applicationid-changesets-model-changesetdetails"></a>

变更集的详细信息。


| 属性 | Type | 必需 | 描述 | 
| --- |--- |--- |--- |
| applicationId | 字符串 | True |  应用程序 Amazon 资源名称 (ARN)。 | 
| changeSetId | 字符串 | True | 变更集的亚马逊资源名称 (ARN)。长度限制：最小长度为 1。模式：ARN：[-a-za-z0-9：/] \$1 | 
| semanticVersion | 字符串 | True | 应用程序的语义版本： [https://semver.org/](https://semver.org/)  | 
| stackId | 字符串 | True | 堆栈的唯一 ID。 | 

### CreateCloudFormationChangeSetInput
<a name="applications-applicationid-changesets-model-createcloudformationchangesetinput"></a>

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


| 属性 | Type | 必需 | 说明 | 
| --- |--- |--- |--- |
| capabilities | string 类型的数组 | False | 在部署某些应用程序之前必须指定的值列表。某些应用程序可能包含可能影响您 AWS 账户权限的资源，例如，通过创建新 AWS Identity and Access Management (IAM) 用户。对于这些应用程序，必须通过指定此参数来明确确认其功能。唯一有效的值是`CAPABILITY_IAM`、`CAPABILITY_NAMED_IAM``CAPABILITY_RESOURCE_POLICY`、和`CAPABILITY_AUTO_EXPAND`。以下资源需要您指定`CAPABILITY_IAM`或`CAPABILITY_NAMED_IAM`：[AWS::IAM::Group](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html)、[AWS::IAM::InstanceProfile[AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html)、和[AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)。如果应用程序包含 IAM 资源，则可以指定`CAPABILITY_IAM`或`CAPABILITY_NAMED_IAM`。如果应用程序包含具有自定义名称的 IAM 资源，您必须指定 `CAPABILITY_NAMED_IAM`。以下资源要求您指定`CAPABILITY_RESOURCE_POLICY`:[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)、[AWS:: iam: Policy、、[AWS::ApplicationAutoScaling::ScalingPolicy[AWS::S3::BucketPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html)、[AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)和 AWS::](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html) SN [S](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html):。TopicPolicy包含一个或多个嵌套应用程序的应用程序要求您指定 `CAPABILITY_AUTO_EXPAND`。如果您的应用程序模板包含上述任何资源，我们建议您在部署之前查看与该应用程序关联的所有权限。如果您没有为需要功能的应用程序指定此参数，则调用将失败。 | 
| changeSetName | 字符串 | False | 此属性与 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API 的同名参数相对应。 | 
| clientToken | 字符串 | False | 此属性与 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API 的同名参数相对应。 | 
| description | 字符串 | False | 此属性与 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API 的同名参数相对应。 | 
| notificationArns | string 类型的数组 | False | 此属性与 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API 的同名参数相对应。 | 
| parameterOverrides | [ParameterValue](#applications-applicationid-changesets-model-parametervalue) 类型的数组 | False | 应用程序参数的参数值列表。 | 
| resourceTypes | string 类型的数组 | False | 此属性与 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API 的同名参数相对应。 | 
| rollbackConfiguration | [RollbackConfiguration](#applications-applicationid-changesets-model-rollbackconfiguration) | False | 此属性与 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API 的同名参数相对应。 | 
| semanticVersion | 字符串 | False | 应用程序的语义版本： [https://semver.org/](https://semver.org/)  | 
| stackName | 字符串 | True | 此属性与 *CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API 的同名参数相对应。 | 
| tags | [Tag](#applications-applicationid-changesets-model-tag) 类型的数组 | False | 此属性与 *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API 的同名参数相对应。 | 
| templateId | 字符串 | False | 返回的 UUID。 CreateCloudFormationTemplate模式：[0-9a-fa-f] \$18\$1\$1-[0-9a-fa-f] \$14\$1\$1-[0-9a-fa-f] \$14\$1\$1-[0-9a-fa-f] \$14\$1\$1-[0-9a-fa-f] \$112\$1 | 

### ForbiddenException
<a name="applications-applicationid-changesets-model-forbiddenexception"></a>

客户端未通过身份验证。


| 属性 | Type | 必需 | 描述 | 
| --- |--- |--- |--- |
| errorCode | 字符串 | False | 403 | 
| message | 字符串 | False | 客户端未通过身份验证。 | 

### InternalServerErrorException
<a name="applications-applicationid-changesets-model-internalservererrorexception"></a>

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


| 属性 | Type | 必需 | 描述 | 
| --- |--- |--- |--- |
| errorCode | 字符串 | False | 500 | 
| message | 字符串 | False | 该 AWS Serverless Application Repository 服务遇到了内部错误。 | 

### ParameterValue
<a name="applications-applicationid-changesets-model-parametervalue"></a>

应用程序的参数值。


| 属性 | Type | 必需 | 描述 | 
| --- |--- |--- |--- |
| name | 字符串 | True | 与参数关联的键。如果您没有为特定参数指定键和值，则 CloudFormation 使用模板中指定的默认值。 | 
| value | 字符串 | True | 与参数关联的输入值。 | 

### RollbackConfiguration
<a name="applications-applicationid-changesets-model-rollbackconfiguration"></a>

此属性对应于*CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*数据类型。


| 属性 | Type | 必需 | 说明 | 
| --- |--- |--- |--- |
| monitoringTimeInMinutes | 整数 | False | 此属性对应于*AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*数据类型的同名内容。 | 
| rollbackTriggers | [RollbackTrigger](#applications-applicationid-changesets-model-rollbacktrigger) 类型的数组 | False | 此属性对应于*AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*数据类型的同名内容。 | 

### RollbackTrigger
<a name="applications-applicationid-changesets-model-rollbacktrigger"></a>

此属性对应于*CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*数据类型。


| 属性 | Type | 必需 | 描述 | 
| --- |--- |--- |--- |
| arn | 字符串 | True | 此属性对应于*AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*数据类型的同名内容。 | 
| type | 字符串 | True | 此属性对应于*AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*数据类型的同名内容。 | 

### Tag
<a name="applications-applicationid-changesets-model-tag"></a>

此属性对应于*CloudFormation [标签](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*数据类型。


| 属性 | Type | 必需 | 描述 | 
| --- |--- |--- |--- |
| key | 字符串 | True | 此属性对应于*AWS CloudFormation [标签](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*数据类型的同名内容。 | 
| value | 字符串 | True | 此属性对应于*AWS CloudFormation [标签](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*数据类型的同名内容。 | 

### TooManyRequestsException
<a name="applications-applicationid-changesets-model-toomanyrequestsexception"></a>

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


| 属性 | Type | 必需 | 描述 | 
| --- |--- |--- |--- |
| errorCode | 字符串 | False | 429 | 
| message | 字符串 | False | 客户端每单位时间发送的请求数超过了允许的请求数。 | 

## 另请参阅
<a name="applications-applicationid-changesets-see-also"></a>

有关在特定语言 AWS SDKs 和参考中使用此 API 的更多信息，请参阅以下内容：

### CreateCloudFormationChangeSet
<a name="CreateCloudFormationChangeSet-see-also"></a>
+ [AWS 命令行界面 V2](/goto/cli2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [适用于.NET 的 AWS 开发工具包 V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [适用于 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [适用于 Go 的 AWS SDK v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [适用于 Java V2 的 AWS SDK](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [适用于 JavaScript V3 的 AWS 开发工具包](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [适用于 Kotlin 的 AWS 开发工具包](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [适用于 PHP 的 Amazon SDK V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [适用于 Python 的 Amazon SDK](/goto/boto3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [适用于 Ruby 的 Amazon SDK V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)