本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 應用程式 applicationId 變更集 ## URI `/applications/applicationId/changesets` ## HTTP 方法 ### POST **操作 ID：**`CreateCloudFormationChangeSet` 為指定的應用程式建立 AWS CloudFormation 變更集。 **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 201 | ChangeSetDetails | 成功 | | 400 | BadRequestException | 請求中的其中一個參數無效。 | | 403 | ForbiddenException | 用戶端未驗證。 | | 429 | TooManyRequestsException | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | | 500 | InternalServerErrorException | AWS Serverless Application Repository 服務發生內部錯誤。 | ### OPTIONS **路徑參數** | 名稱 | 類型 | 必要 | Description | | --- |--- |--- |--- | | applicationId | String | True | 應用程式的 Amazon Resource Name (ARN)。 | **回應** | 狀態碼 | 回應模型 | Description | | --- |--- |--- | | 200 | None | 200 個回應 | ## 結構描述 ### 請求內文 #### POST 結構描述 ``` { "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" } ] } ``` ### 回應內文 #### ChangeSetDetails 結構描述 ``` { "applicationId": "string", "semanticVersion": "string", "changeSetId": "string", "stackId": "string" } ``` #### BadRequestException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 結構描述 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### BadRequestException 請求中的其中一個參數無效。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 400 | | message | string | False | 請求中的其中一個參數無效。 | ### ChangeSetDetails 變更集的詳細資訊。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | applicationId | string | True | 應用程式 Amazon Resource Name (ARN)。 | | changeSetId | string | True | 變更集的 Amazon Resource Name (ARN)。長度限制：長度下限為 1。模式：ARN：【-a-zA-Z0-9：/】\$1 | | semanticVersion | string | True | 應用程式語意版本： [https://semver.org/](https://semver.org/) | | stackId | string | True | 堆疊的唯一 ID。 | ### CreateCloudFormationChangeSetInput 建立應用程式變更集請求。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | capabilities | 類型 string 的陣列 | False | 您必須先指定的值清單，才能部署特定應用程式。有些應用程式可能包含可能會影響您 AWS 帳戶中許可的資源，例如，建立新的 AWS Identity and Access Management (IAM) 使用者。對於這些應用程式，您必須指定此參數來明確認可其功能。唯一有效的值是 `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) 和 [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)。包含一個或多個巢狀應用程式的應用程式需要由您指定 `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 用戶端未驗證。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 403 | | message | string | False | 用戶端未驗證。 | ### InternalServerErrorException AWS Serverless Application Repository 服務發生內部錯誤。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 500 | | message | string | False | AWS Serverless Application Repository 服務發生內部錯誤。 | ### ParameterValue 應用程式參數值。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | name | string | True | 與參數相關聯的金鑰。如果您未指定特定參數的金鑰和值， CloudFormation 會使用範本中指定的預設值。 | | value | string | True | 與參數關聯的輸入值。 | ### RollbackConfiguration 此屬性對應至 *CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration) * 資料類型。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | 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 此屬性對應於 *CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger) * 資料類型。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | arn | string | True | 此屬性對應於 *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger) * 資料類型的相同名稱內容。 | | type | string | True | 此屬性對應於 *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger) * 資料類型的相同名稱內容。 | ### Tag 此屬性對應至*CloudFormation [標籤](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*資料類型。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | 金鑰 | string | True | 此屬性對應至*AWS CloudFormation [標籤](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*資料類型的相同名稱內容。 | | value | string | True | 此屬性對應至*AWS CloudFormation [標籤](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*資料類型的相同名稱內容。 | ### TooManyRequestsException 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | 屬性 | Type | 必要 | Description | | --- |--- |--- |--- | | errorCode | string | False | 429 | | message | string | False | 用戶端傳送的請求數量超過每單位時間允許的請求數量。 | ## 另請參閱如需在其中一種語言特定 AWS SDKs和參考中使用此 API 的詳細資訊，請參閱下列內容： ### CreateCloudFormationChangeSet + [AWS 命令列界面 V2](/goto/cli2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 .NET V4 的 AWS 開發套件](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 Go v2 的 AWS 開發套件](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 Java 的 AWS SDK 第 2 版](/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 V3 的 AWS 開發套件](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 Python 的 AWS 開發套件](/goto/boto3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) + [適用於 Ruby V3 的 AWS 開發套件](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)