翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Applications applicationId Changesets
<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 変更セットを作成します。


**パスパラメータ**  

| 名前 | 型 | 必須 | 説明 | 
| --- |--- |--- |--- |
| applicationId | String | True | アプリケーションの Amazon リソースネーム (ARN) です。 | 


**レスポンス**  

| ステータスコード | レスポンスモデル | 説明 | 
| --- |--- |--- |
| 201 | ChangeSetDetails | Success | 
| 400 | BadRequestException | リクエストに含まれているパラメータの 1 つが無効です。 | 
| 403 | ForbiddenException | クライアントは認証されていません。 | 
| 429 | TooManyRequestsException | クライアントが、単位時間あたりの許可されるリクエスト数よりも多くのリクエストを送信しています。 | 
| 500 | InternalServerErrorException |  AWS Serverless Application Repository サービスで内部エラーが発生しました。 | 

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


**パスパラメータ**  

| 名前 | 型 | 必須 | 説明 | 
| --- |--- |--- |--- |
| 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>

リクエストに含まれているパラメータの 1 つが無効です。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| errorCode | string | False | 400 | 
| メッセージ | string | False | リクエストに含まれているパラメータの 1 つが無効です。 | 

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

変更セットの詳細。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| applicationId | string | True | アプリケーションの Amazon リソースネーム (ARN)。 | 
| changeSetId | string | True | 変更セットの Amazon リソースネーム (ARN)。長さの制限: 最小長は 1 です。パターン: ARN:[-a-zA-Z0-9:/]\$1 | 
| semanticVersion | string | True | アプリケーションのセマンティックバージョン： [https://semver.org/](https://semver.org/)  | 
| stackId | string | True | スタックの一意の ID。 | 

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

アプリケーション変更セットリクエストを作成します。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| 機能 | string タイプの配列 | False | 特定のアプリケーションをデプロイする前に指定する必要がある値のリスト。一部のアプリケーションには、新しい AWS Identity and Access Management (IAM) ユーザーを作成するなど、 AWS アカウントのアクセス許可に影響を与える可能性のあるリソースが含まれている場合があります。このようなアプリケーションの場合は、このパラメータを指定して、それらの機能を明示的に認識する必要があります。有効な値は、`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](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)、および [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](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) を指定する必要があります。1 つまたは複数のネストされたアプリケーションが含まれているアプリケーションでは、`CAPABILITY_AUTO_EXPAND` を指定する必要があります。アプリケーションテンプレートに前述のリソースが含まれている場合、デプロイする前にアプリケーションに関連付けられたすべてのアクセス許可を確認することをお勧めします。機能を必要とするアプリケーションにこのパラメータを指定しないと、呼び出しは失敗します。 | 
| changeSetName | string | False | このプロパティは、*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) *API の同じ名前のパラメータに対応します。 | 
| clientToken | string | False | このプロパティは、*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) *API の同じ名前のパラメータに対応します。 | 
| 説明 | string | 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 | string | False | アプリケーションのセマンティックバージョン： [https://semver.org/](https://semver.org/)  | 
| stackName | string | True | このプロパティは、*CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) *API の同じ名前のパラメータに対応します。 | 
| タグ | [Tag](#applications-applicationid-changesets-model-tag) タイプの配列 | False | このプロパティは、*AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) *API の同じ名前のパラメータに対応します。 | 
| templateId | string | 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>

クライアントは認証されていません。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| errorCode | string | False | 403 | 
| メッセージ | string | False | クライアントは認証されていません。 | 

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

 AWS Serverless Application Repository サービスで内部エラーが発生しました。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| errorCode | string | False | 500 | 
| メッセージ | string | False |  AWS Serverless Application Repository サービスで内部エラーが発生しました。 | 

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

アプリケーションのパラメータ値。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| 名前 | string | True | パラメータに関連付けられたキー。特定のパラメータにキーと値が指定されていない場合、 CloudFormation はテンプレートに指定されているデフォルト値を使用します。 | 
| 値 | string | True | パラメータに関連付けられた入力値。 | 

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

このプロパティは *CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration) *データタイプに対応します。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| monitoringTimeInMinutes | integer | 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) *データタイプに対応します。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| arn | string | True | このプロパティは、*AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger) *データタイプの同じ名前のコンテンツに対応します。 | 
| 型 | string | 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 [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag) *データタイプに対応します。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| key | string | True | このプロパティは、*AWS CloudFormation [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag) *データタイプの同じ名前のコンテンツに対応します。 | 
| 値 | string | True | このプロパティは、*AWS CloudFormation [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag) *データタイプの同じ名前のコンテンツに対応します。 | 

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

クライアントが、単位時間あたりの許可されるリクエスト数よりも多くのリクエストを送信しています。


| プロパティ | タイプ | 必須 | 説明 | 
| --- |--- |--- |--- |
| errorCode | string | False | 429 | 
| メッセージ | string | 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)
+ [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 for JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK for Kotlin](/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)