URI Metode HTTP Skema Sifat-sifat Lihat juga

Aplikasi Application ID Changesets

URI

/applications/applicationId/changesets

Metode HTTP

POST

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 respon	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.

OPSI

Parameter jalur
Nama	Tipe	Diperlukan	Deskripsi
`applicationId`	String	True	Amazon Resource Name (ARN) aplikasi.

Respons
Kode status	Model respon	Deskripsi
`200`	Tidak ada	200 tanggapan

Skema

Meminta badan


{
  "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 tanggapan


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


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


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


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


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

Sifat-sifat

BadRequestException

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

Rincian set perubahan.

Properti	Tipe	Diperlukan	Deskripsi
`applicationId`	string	True	Aplikasi Nama Sumber Daya Amazon (ARN).
`changeSetId`	string	True	Nama Sumber Daya Amazon (ARN) dari set perubahan. Panjang batasan: Panjang minimum 1. Pola: ARN: [-a-zA-Z0-9:/] *
`semanticVersion`	string	True	Versi semantik dari aplikasi: https://semver.org/
`stackId`	string	True	ID unik dari tumpukan.

CreateCloudFormationChangeSetInput

Buat permintaan set perubahan aplikasi.

Properti	Tipe	Diperlukan	Deskripsi
`capabilities`	Array tipe string	False	Daftar nilai yang harus Anda tentukan sebelum Anda dapat menerapkan aplikasi tertentu. Beberapa aplikasi mungkin menyertakan sumber daya yang dapat memengaruhi izin di AWS akun Anda, misalnya, dengan membuat pengguna baru 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, AWS: :IAM::, AWS: :IAM: :Policy InstanceProfile, 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, AWS:: IAM:Policy,: AWS::ApplicationAutoScaling: ScalingPolicy, AWS: :S3:: BucketPolicy, AWS: :SQS:: QueuePolicy, dan AWS::. SNS:TopicPolicy Aplikasi 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, sebaiknya tinjau 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 API.
`clientToken`	string	False	Properti ini sesuai dengan parameter dengan nama yang sama untuk AWS CloudFormation CreateChangeSet API.
`description`	string	False	Properti ini sesuai dengan parameter dengan nama yang sama untuk AWS CloudFormation CreateChangeSet API.
`notificationArns`	Array tipe string	False	Properti ini sesuai dengan parameter dengan nama yang sama untuk AWS CloudFormation CreateChangeSet API.
`parameterOverrides`	Array tipe 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 API.
`rollbackConfiguration`	RollbackConfiguration	False	Properti ini sesuai dengan parameter dengan nama yang sama untuk AWS CloudFormation CreateChangeSet API.
`semanticVersion`	string	False	Versi semantik dari aplikasi: https://semver.org/
`stackName`	string	True	Properti ini sesuai dengan parameter dengan nama yang sama untuk CloudFormation CreateChangeSet API.
`tags`	Array tipe Tag	False	Properti ini sesuai dengan parameter dengan nama yang sama untuk AWS CloudFormation CreateChangeSet API.
`templateId`	string	False	UUID dikembalikan oleh CreateCloudFormationTemplate. Pola: [0-9a-fA-F] {8}\ - [0-9a-fA-F] {4}\ - [0-9a-f] {4}\ - [0-9a-fA-F] {4}\ - [0-9a-fA-F] {12} A-F

ForbiddenException

Klien tidak diautentikasi.

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

InternalServerErrorException

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

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

Properti ini sesuai dengan Ti CloudFormation RollbackConfiguration pe Data.

Properti	Tipe	Diperlukan	Deskripsi
`monitoringTimeInMinutes`	Integer	False	Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe AWS CloudFormation RollbackConfiguration Data.
`rollbackTriggers`	Array tipe RollbackTrigger	False	Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe AWS CloudFormation RollbackConfiguration Data.

RollbackTrigger

Properti ini sesuai dengan Ti CloudFormation RollbackTrigger pe Data.

Properti	Tipe	Diperlukan	Deskripsi
`arn`	string	True	Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe AWS CloudFormation RollbackTrigger Data.
`type`	string	True	Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe AWS CloudFormation RollbackTrigger Data.

Tag

Properti ini sesuai dengan Ti CloudFormation pe Data Tag.

Properti	Tipe	Diperlukan	Deskripsi
`key`	string	True	Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe Data AWS CloudFormation Tag.
`value`	string	True	Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe Data AWS CloudFormation Tag.

TooManyRequestsException

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

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

CreateCloudFormationChangeSet

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Aplikasi ID Aplikasi

Aplikasi Application ID Dependensi