Aplikasi applicationId Changesets - AWS Serverless Application Repository
URIHTTPmetodeSkemaPropertiLihat juga

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

Aplikasi applicationId Changesets

URI

/applications/applicationId/changesets

HTTPmetode

POST

ID Operasi: CreateCloudFormationChangeSet

Membuat set AWS CloudFormation perubahan untuk aplikasi yang diberikan.

Parameter jalur
NamaTipeDiperlukanDeskripsi
applicationIdStringTrue

Nama Sumber Daya Amazon (ARN) dari aplikasi.

Respons
Kode statusModel responsDeskripsi
201ChangeSetDetails

Berhasil

400BadRequestException

Salah satu parameter dalam permintaan tidak valid.

403ForbiddenException

Klien tidak diautentikasi.

429TooManyRequestsException

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

500InternalServerErrorException

AWS Serverless Application Repository Layanan mengalami kesalahan internal.

OPTIONS

Parameter jalur
NamaTipeDiperlukanDeskripsi
applicationIdStringTrue

Nama Sumber Daya Amazon (ARN) dari aplikasi.

Respons
Kode statusModel responsDeskripsi
200Tidak ada

200 respon

Skema

Permintaan 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 respons

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

Properti

BadRequestException

Salah satu parameter dalam permintaan tidak valid.

PropertiTipeDiperlukanDeskripsi
errorCode

string

False

400

message

string

False

Salah satu parameter dalam permintaan tidak valid.

ChangeSetDetails

Detail dari set perubahan.

PropertiTipeDiperlukanDeskripsi
applicationId

string

True

Aplikasi Amazon Resource Name (ARN).

changeSetId

string

True

Amazon Resource Name (ARN) dari set perubahan.

Panjang batasan: Panjang minimum 1.

Pola:ARN: [-A-za-Z0-9:/] *

semanticVersion

string

True

Versi semantik aplikasi:

https://semver.org/

stackId

string

True

ID unik dari tumpukan.

CreateCloudFormationChangeSetInput

Buat permintaan set perubahan aplikasi.

PropertiTipeDiperlukanDeskripsi
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 adalahCAPABILITY_IAM,CAPABILITY_NAMED_IAM,CAPABILITY_RESOURCE_POLICY, danCAPABILITY_AUTO_EXPAND.

Sumber daya berikut mengharuskan Anda untuk menentukan CAPABILITY_IAM atauCAPABILITY_NAMED_IAM: AWS:IAM: :Group, AWS::::InstanceProfile, IAMAWS:: :Policy, danIAM: AWS:IAM: :Role. Jika aplikasi berisi IAM sumber daya, Anda dapat menentukan salah satu CAPABILITY_IAM atauCAPABILITY_NAMED_IAM. Jika aplikasi berisi IAM sumber daya dengan nama khusus, Anda harus menentukanCAPABILITY_NAMED_IAM.

Sumber daya berikut mengharuskan Anda untuk menentukanCAPABILITY_RESOURCE_POLICY: AWS: :Lambda: :Permission, AWS: ::PolicyIAM,::: AWS::,ApplicationAutoScaling: AWS:S3ScalingPolicy:::::, danBucketPolicy:: AWS: SQS. QueuePolicy AWS SNS TopicPolicy

Aplikasi yang berisi satu atau lebih aplikasi bersarang mengharuskan Anda untuk menentukanCAPABILITY_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 CreateChangeSetAPI.

clientToken

string

False

Properti ini sesuai dengan parameter dengan nama yang sama untuk AWS CloudFormation CreateChangeSetAPI.

description

string

False

Properti ini sesuai dengan parameter dengan nama yang sama untuk AWS CloudFormation CreateChangeSetAPI.

notificationArns

Array tipe string

False

Properti ini sesuai dengan parameter dengan nama yang sama untuk AWS CloudFormation CreateChangeSetAPI.

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

rollbackConfiguration

RollbackConfiguration

False

Properti ini sesuai dengan parameter dengan nama yang sama untuk AWS CloudFormation CreateChangeSetAPI.

semanticVersion

string

False

Versi semantik aplikasi:

https://semver.org/

stackName

string

True

Properti ini sesuai dengan parameter dengan nama yang sama untuk AWS CloudFormation CreateChangeSetAPI.

tags

Array tipe Tag

False

Properti ini sesuai dengan parameter dengan nama yang sama untuk AWS CloudFormation CreateChangeSetAPI.

templateId

string

False

Yang UUID dikembalikan oleh CreateCloudFormationTemplate.

Pola: [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

Klien tidak diautentikasi.

PropertiTipeDiperlukanDeskripsi
errorCode

string

False

403

message

string

False

Klien tidak diautentikasi.

InternalServerErrorException

AWS Serverless Application Repository Layanan mengalami kesalahan internal.

PropertiTipeDiperlukanDeskripsi
errorCode

string

False

500

message

string

False

AWS Serverless Application Repository Layanan mengalami kesalahan internal.

ParameterValue

Nilai parameter aplikasi.

PropertiTipeDiperlukanDeskripsi
name

string

True

Kunci yang terkait dengan parameter. Jika Anda tidak menetapkan kunci dan nilai untuk parameter tertentu, AWS CloudFormation menggunakan nilai default yang ditentukan dalam templat Anda.

value

string

True

Nilai input yang terkait dengan parameter.

RollbackConfiguration

Properti ini sesuai dengan Tipe AWS CloudFormation RollbackConfigurationData.

PropertiTipeDiperlukanDeskripsi
monitoringTimeInMinutes

Integer

False

Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe AWS CloudFormation RollbackConfigurationData.

rollbackTriggers

Array tipe RollbackTrigger

False

Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe AWS CloudFormation RollbackConfigurationData.

RollbackTrigger

Properti ini sesuai dengan Tipe AWS CloudFormation RollbackTriggerData.

PropertiTipeDiperlukanDeskripsi
arn

string

True

Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe AWS CloudFormation RollbackTriggerData.

type

string

True

Properti ini sesuai dengan konten dengan nama yang sama untuk Tipe AWS CloudFormation RollbackTriggerData.

Tag

Properti ini sesuai dengan Tipe Data AWS CloudFormation Tag.

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

PropertiTipeDiperlukanDeskripsi
errorCode

string

False

429

message

string

False

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

Lihat juga

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

CreateCloudFormationChangeSet