Applications applicationId Changesets - AWS Serverless Application Repository
[URI]HTTP メソッドスキーマプロパティ以下も参照してください。

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

Applications applicationId Changesets

[URI]

/applications/applicationId/changesets

HTTP メソッド

POST

オペレーション ID: CreateCloudFormationChangeSet

AWS CloudFormation 特定のアプリケーションの変更セットを作成します。

パスパラメータ
名前型必須説明
applicationIdStringTrue

アプリケーションの Amazon リソースネーム (ARN) です。

レスポンス
ステータスコードレスポンスモデル説明
201ChangeSetDetails

成功

400BadRequestException

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

403ForbiddenException

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

429TooManyRequestsException

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

500InternalServerErrorException

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

OPTIONS

パスパラメータ
名前型必須説明
applicationIdStringTrue

アプリケーションの Amazon リソースネーム (ARN) です。

レスポンス
ステータスコードレスポンスモデル説明
200None

200 レスポンスです。

スキーマ

リクエストボディ

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

レスポンス本文

{
  "applicationId": "string",
  "semanticVersion": "string",
  "changeSetId": "string",
  "stackId": "string"
}
{
  "message": "string",
  "errorCode": "string"
}
{
  "message": "string",
  "errorCode": "string"
}
{
  "message": "string",
  "errorCode": "string"
}
{
  "message": "string",
  "errorCode": "string"
}

プロパティ

BadRequestException

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

プロパティタイプ必須説明
errorCode

文字列

False

400

message

文字列

False

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

ChangeSetDetails

変更セットの詳細。

プロパティタイプ必須説明
applicationId

文字列

True

アプリケーションの Amazon リソースネーム (ARN)。

changeSetId

文字列

True

変更セットの Amazon リソースネーム (ARN)。

長さの制限: 最小長は 1 です。

パターン: ARN:[-a-zA-Z0-9:/]*

semanticVersion

文字列

True

アプリケーションのセマンティックバージョン：

https://semver.org/

stackId

文字列

True

スタックの一意の ID。

CreateCloudFormationChangeSetInput

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

プロパティタイプ必須説明
機能

string タイプの配列

False

特定のアプリケーションをデプロイする前に指定する必要がある値のリスト。一部のアプリケーションには、例えば新しい AWS Identity and Access Management (IAM) ユーザーを作成することによって AWS アカウントのアクセス許可に影響を及ぼす可能性のあるリソースが含まれている場合があります。このようなアプリケーションの場合は、このパラメータを指定して、それらの機能を明示的に認識する必要があります。

有効な値は、CAPABILITY_IAM、CAPABILITY_NAMED_IAM、CAPABILITY_RESOURCE_POLICY、および CAPABILITY_AUTO_EXPAND のみです。

次のリソースでは、AWS::IAM::Group、AWS::IAM::InstanceProfileAWS::IAM::Policy、CAPABILITY_IAMCAPABILITY_NAMED_IAMAWS::IAM::Roleまたはを指定する必要があります。アプリケーションに IAM リソースがある場合、CAPABILITY_IAM または CAPABILITY_NAMED_IAM のいずれかを指定できます。アプリケーションにカスタム名を持つ IAM リソースがある場合は、CAPABILITY_NAMED_IAM を指定する必要があります。

次のリソースではAWS::Lambda::Permission、CAPABILITY_RESOURCE_POLICY:、AWS:: IAM: Policy、、、AWS::ApplicationAutoScaling::ScalingPolicyAWS::S3::BucketPolicyAWS::SQS::QueuePolicy、および AWS:: SNS: を指定する必要があります。TopicPolicy

1 つまたは複数のネストされたアプリケーションが含まれているアプリケーションでは、CAPABILITY_AUTO_EXPAND を指定する必要があります。

アプリケーションテンプレートに前述のリソースが含まれている場合、デプロイする前にアプリケーションに関連付けられたすべてのアクセス許可を確認することをお勧めします。機能を必要とするアプリケーションにこのパラメータを指定しないと、呼び出しは失敗します。

changeSetName

文字列

False

このプロパティは API の同じ名前のパラメータに対応しています。AWS CloudFormationCreateChangeSet

clientToken

文字列

False

このプロパティは AWS CloudFormationCreateChangeSetAPI の同じ名前のパラメータに対応します。

説明

string

False

このプロパティは AWS CloudFormationCreateChangeSetAPI の同じ名前のパラメータに対応します。

notificationArns

string タイプの配列

False

このプロパティは AWS CloudFormationCreateChangeSetAPI の同じ名前のパラメータに対応します。

parameterOverrides

ParameterValue タイプの配列

False

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

resourceTypes

string タイプの配列

False

このプロパティは AWS CloudFormationCreateChangeSetAPI の同じ名前のパラメータに対応します。

rollbackConfiguration

RollbackConfiguration

False

このプロパティは AWS CloudFormationCreateChangeSetAPI の同じ名前のパラメータに対応します。

semanticVersion

文字列

False

アプリケーションのセマンティックバージョン：

https://semver.org/

stackName

文字列

True

このプロパティは AWS CloudFormationCreateChangeSetAPI の同じ名前のパラメータに対応します。

タグ

Tag タイプの配列

False

このプロパティは AWS CloudFormationCreateChangeSetAPI の同じ名前のパラメータに対応します。

templateId

文字列

False

によって返される UUID。 CreateCloudFormationTemplate

パターン: [0-9a-fA-F]{8}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{12}

ForbiddenException

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

プロパティタイプ必須説明
errorCode

文字列

False

403

message

文字列

False

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

InternalServerErrorException

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

プロパティタイプ必須説明
errorCode

文字列

False

500

message

文字列

False

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

ParameterValue

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

プロパティタイプ必須説明
名前

文字列

True

パラメータに関連付けられたキー。特定のパラメータにキーと値が指定されていない場合、AWS CloudFormation はテンプレートに指定されているデフォルト値を使用します。

値

文字列

True

パラメータに関連付けられた入力値。

RollbackConfiguration

AWS CloudFormationRollbackConfigurationこのプロパティはデータ型に対応します。

プロパティタイプ必須説明
monitoringTimeIn議事録

integer

False

このプロパティは、AWS CloudFormationRollbackConfigurationデータタイプの同名のコンテンツに対応します。

rollbackTriggers

RollbackTrigger タイプの配列

False

AWS CloudFormationRollbackConfigurationこのプロパティはデータタイプの同名のコンテンツに対応します。

RollbackTrigger

AWS CloudFormationRollbackTriggerこのプロパティはデータ型に対応します。

プロパティタイプ必須説明
arn

文字列

True

AWS CloudFormationRollbackTriggerこのプロパティはデータタイプの同名のコンテンツに対応します。

type

文字列

True

AWS CloudFormationRollbackTriggerこのプロパティはデータタイプの同名のコンテンツに対応します。

Tag

このプロパティは AWS CloudFormation Tag データタイプに対応します。

プロパティタイプ必須説明
key

文字列

True

このプロパティは、AWS CloudFormation Tag データタイプの同じ名前のコンテンツに対応します。

値

文字列

True

このプロパティは、AWS CloudFormation Tag データタイプの同じ名前のコンテンツに対応します。

TooManyRequestsException

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

プロパティタイプ必須説明
errorCode

文字列

False

429

message

文字列

False

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

以下も参照してください。

言語固有の AWS SDK およびリファレンスのいずれかでこの API を使用する方法の詳細については、次を参照してください。

CreateCloudFormationChangeSet