

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Aplikasi ApplicationId Changesets
<a name="applications-applicationid-changesets"></a>

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

`/applications/applicationId/changesets`

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

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

**ID Operasi:** `CreateCloudFormationChangeSet`

Membuat set AWS CloudFormation perubahan untuk aplikasi yang diberikan.


**Parameter jalur**  

| Nama | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| applicationId | String | True | Amazon Resource Name (ARN) aplikasi. | 


**Respons**  

| Kode status | Model respons | Deskripsi | 
| --- |--- |--- |
| 201 | ChangeSetDetails | Berhasil | 
| 400 | BadRequestException | Salah satu parameter dalam permintaan tidak valid. | 
| 403 | ForbiddenException | Klien tidak diautentikasi. | 
| 429 | TooManyRequestsException | Klien mengirim lebih dari jumlah permintaan yang diizinkan per unit waktu. | 
| 500 | InternalServerErrorException |  AWS Serverless Application Repository Layanan mengalami kesalahan internal. | 

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


**Parameter jalur**  

| Nama | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| applicationId | String | True | Amazon Resource Name (ARN) aplikasi. | 


**Respons**  

| Kode status | Model respons | Deskripsi | 
| --- |--- |--- |
| 200 | Tidak ada | 200 respon | 

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

### Permintaan badan
<a name="applications-applicationid-changesets-request-examples"></a>

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

### Badan respons
<a name="applications-applicationid-changesets-response-examples"></a>

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

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

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

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

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

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

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

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

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

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

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

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

Salah satu parameter dalam permintaan tidak valid.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| errorCode | string | False | 400 | 
| message | string | False | Salah satu parameter dalam permintaan tidak valid. | 

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

Rincian set perubahan.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| applicationId | string | True | Aplikasi Amazon Resource Name (ARN). | 
| changeSetId | string | True | Nama Sumber Daya Amazon (ARN) dari set perubahan.Panjang batasan: Panjang minimum 1.Pola: ARN: [-A-ZA-Z0-9:/] \$1 | 
| semanticVersion | string | True | Versi semantik aplikasi: [https://semver.org/](https://semver.org/)  | 
| stackId | string | True | ID unik dari tumpukan. | 

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

Buat permintaan set perubahan aplikasi.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| capabilities | Array tipe string | False | Daftar nilai yang harus Anda tentukan sebelum Anda dapat menyebarkan aplikasi tertentu. Beberapa aplikasi mungkin menyertakan sumber daya yang dapat memengaruhi izin di AWS akun Anda, misalnya, dengan membuat pengguna new AWS Identity and Access Management (IAM). Untuk aplikasi tersebut, Anda harus secara eksplisit mengakui kemampuannya dengan menentukan parameter ini.Satu-satunya nilai yang valid adalah`CAPABILITY_IAM`,`CAPABILITY_NAMED_IAM`,`CAPABILITY_RESOURCE_POLICY`, dan`CAPABILITY_AUTO_EXPAND`.Sumber daya berikut mengharuskan Anda untuk menentukan `CAPABILITY_IAM` atau`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), dan [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html). Jika aplikasi berisi sumber daya IAM, Anda dapat menentukan salah satu `CAPABILITY_IAM` atau`CAPABILITY_NAMED_IAM`. Jika aplikasi berisi sumber daya IAM dengan nama khusus, Anda harus menentukan`CAPABILITY_NAMED_IAM`.Sumber daya berikut mengharuskan Anda untuk menentukan`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[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)dan [AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html): :SNS:. TopicPolicyAplikasi yang berisi satu atau lebih aplikasi bersarang mengharuskan Anda untuk menentukan`CAPABILITY_AUTO_EXPAND`.Jika template aplikasi Anda berisi salah satu sumber daya di atas, kami sarankan Anda meninjau semua izin yang terkait dengan aplikasi sebelum menerapkan. Jika Anda tidak menentukan parameter ini untuk aplikasi yang membutuhkan kemampuan, panggilan akan gagal. | 
| changeSetName | string | False | Properti ini sesuai dengan parameter dengan nama yang sama untuk *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| clientToken | string | False | Properti ini sesuai dengan parameter dengan nama yang sama untuk *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| description | string | False | Properti ini sesuai dengan parameter dengan nama yang sama untuk *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| notificationArns | Array tipe string | False | Properti ini sesuai dengan parameter dengan nama yang sama untuk *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| parameterOverrides | Array tipe [ParameterValue](#applications-applicationid-changesets-model-parametervalue) | False | Daftar nilai parameter untuk parameter aplikasi. | 
| resourceTypes | Array tipe string | False | Properti ini sesuai dengan parameter dengan nama yang sama untuk *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| rollbackConfiguration | [RollbackConfiguration](#applications-applicationid-changesets-model-rollbackconfiguration) | False | Properti ini sesuai dengan parameter dengan nama yang sama untuk *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| semanticVersion | string | False | Versi semantik aplikasi: [https://semver.org/](https://semver.org/)  | 
| stackName | string | True | Properti ini sesuai dengan parameter dengan nama yang sama untuk *CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| tags | Array tipe [Tag](#applications-applicationid-changesets-model-tag) | False | Properti ini sesuai dengan parameter dengan nama yang sama untuk *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| templateId | string | False | UUID kembali. CreateCloudFormationTemplatePola: [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>

Klien tidak diautentikasi.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| errorCode | string | False | 403 | 
| message | string | False | Klien tidak diautentikasi. | 

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

 AWS Serverless Application Repository Layanan mengalami kesalahan internal.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| errorCode | string | False | 500 | 
| message | string | False |  AWS Serverless Application Repository Layanan mengalami kesalahan internal. | 

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

Nilai parameter aplikasi.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| name | string | True | Kunci yang terkait dengan parameter. Jika Anda tidak menetapkan kunci dan nilai untuk parameter tertentu, CloudFormation menggunakan nilai default yang ditentukan dalam templat Anda. | 
| value | string | True | Nilai input yang terkait dengan parameter. | 

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

Properti ini sesuai dengan Tipe *CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*Data.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| monitoringTimeInMinutes | Integer | False | Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*Data. | 
| rollbackTriggers | Array tipe [RollbackTrigger](#applications-applicationid-changesets-model-rollbacktrigger) | False | Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*Data. | 

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

Properti ini sesuai dengan Tipe *CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*Data.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| arn | string | True | Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*Data. | 
| type | string | True | Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*Data. | 

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

Properti ini sesuai dengan Tipe Data *CloudFormation [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| key | string | True | Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe Data *AWS CloudFormation [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 
| value | string | True | Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe Data *AWS CloudFormation [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 

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

Klien mengirim lebih dari jumlah permintaan yang diizinkan per unit waktu.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- |--- |--- |--- |
| errorCode | string | False | 429 | 
| message | string | False | Klien mengirim lebih dari jumlah permintaan yang diizinkan per unit waktu. | 

## Lihat juga
<a name="applications-applicationid-changesets-see-also"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs dan referensi, lihat berikut ini:

### CreateCloudFormationChangeSet
<a name="CreateCloudFormationChangeSet-see-also"></a>
+ [Antarmuka Baris Perintah AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK untuk V3 JavaScript ](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK untuk Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK untuk Python](/goto/boto3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)