기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 애플리케이션 applicationId 변경 세트
<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 변경 세트를 생성합니다.


**경로 파라미터**  

| 이름 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| applicationId | String | True | 애플리케이션의 Amazon 리소스 이름(ARN)입니다. | 


**응답**  

| 상태 코드 | 응답 모델 | 설명 | 
| --- |--- |--- |
| 201 | ChangeSetDetails | Success | 
| 400 | BadRequestException | 요청의 파라미터 중 하나가 잘못되었습니다. | 
| 403 | ForbiddenException | 클라이언트가 인증되지 않았습니다. | 
| 429 | TooManyRequestsException | 클라이언트가 시간 단위당 허용된 요청 수를 초과하여 전송하고 있습니다. | 
| 500 | InternalServerErrorException |  AWS Serverless Application Repository 서비스에서 내부 오류가 발생했습니다. | 

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


**경로 파라미터**  

| 이름 | Type | 필수 | 설명 | 
| --- |--- |--- |--- |
| applicationId | String | True | 애플리케이션의 Amazon 리소스 이름(ARN)입니다. | 


**응답**  

| 상태 코드 | 응답 모델 | 설명 | 
| --- |--- |--- |
| 200 | None | 응답 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"
}
```

## 속성
<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 | 변경 세트의 Amazon 리소스 이름(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 | 필수 | 설명 | 
| --- |--- |--- |--- |
| 기능 | 유형 string의 배열 | False | 특정 애플리케이션을 배포하기 전에 지정해야 하는 값 목록입니다. 일부 애플리케이션에는 예를 들어 새 AWS Identity and Access Management (IAM) 사용자를 생성하여 AWS 계정의 권한에 영향을 미칠 수 있는 리소스가 포함될 수 있습니다. 이러한 애플리케이션의 경우이 파라미터를 지정하여 해당 기능을 명시적으로 승인해야 합니다.유일하게 유효한 값은 `CAPABILITY_IAM`, `CAPABILITY_RESOURCE_POLICY`, `CAPABILITY_NAMED_IAM`및 입니다`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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html), [AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html), and [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`을 지정해야 합니다.AWS`CAPABILITY_RESOURCE_POLICY`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html), [AWS::IAM:Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html), [AWS::ApplicationAutoScaling::ScalingPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html), [AWS::S3::BucketPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html), [AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html) 및 [AWS::SNS:TopicPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html) 리소스를 지정해야 합니다.중첩 애플리케이션을 한 개 이상 포함하는 애플리케이션은 `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 | CreateCloudFormationTemplate에서 반환한 UUID입니다.패턴: [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 | 필수 | 설명 | 
| --- |--- |--- |--- |
| 이름 | 문자열 | True | 파라미터와 연결된 키입니다. 특정 파라미터에 키와 값을 지정하지 않으면는 템플릿에 지정된 기본값을 CloudFormation 사용합니다. | 
| 값 | 문자열 | 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 | 필수 | 설명 | 
| --- |--- |--- |--- |
| 키 | 문자열 | True | 이 속성은 *AWS CloudFormation [태그](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag) * 데이터 유형에 대해 동일한 이름의 콘텐츠에 해당합니다. | 
| 값 | 문자열 | 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 V4용 AWS SDK](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [Go v2용 AWS SDK](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [JavaScript V3용 AWS SDK](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [Kotlin용 AWS SDK](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for Python](/goto/boto3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)