View a markdown version of this page

Aplikasi Versi ApplicationId SemanticVersion - AWS Serverless Application Repository
URIMetode HTTPSkemaSifat-sifatLihat juga

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

Aplikasi Versi ApplicationId SemanticVersion

URI

/applications/applicationId/versions/semanticVersion

Metode HTTP

PUT

ID Operasi: CreateApplicationVersion

Membuat versi aplikasi.

Parameter jalur
NamaTipeDiperlukanDeskripsi
applicationIdStringTrue

Amazon Resource Name (ARN) aplikasi.

semanticVersionStringTrue

Versi semantik dari versi baru.

Respons
Kode statusModel responsDeskripsi
201Version

Berhasil

400BadRequestException

Salah satu parameter dalam permintaan tidak valid.

403ForbiddenException

Klien tidak diautentikasi.

409ConflictException

Sumber daya sudah ada.

429TooManyRequestsException

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

500InternalServerErrorException

AWS Serverless Application Repository Layanan mengalami kesalahan internal.

OPSI

Parameter jalur
NamaTipeDiperlukanDeskripsi
applicationIdStringTrue

Amazon Resource Name (ARN) aplikasi.

semanticVersionStringTrue

Versi semantik dari versi baru.

Respons
Kode statusModel responsDeskripsi
200Tidak ada

200 tanggapan

Skema

Meminta badan

{
  "templateBody": "string",
  "templateUrl": "string",
  "sourceCodeUrl": "string",
  "sourceCodeArchiveUrl": "string"
}

Badan tanggapan

{
  "applicationId": "string",
  "semanticVersion": "string",
  "sourceCodeUrl": "string",
  "sourceCodeArchiveUrl": "string",
  "templateUrl": "string",
  "creationTime": "string",
  "parameterDefinitions": [
    {
      "name": "string",
      "defaultValue": "string",
      "description": "string",
      "type": "string",
      "noEcho": boolean,
      "allowedPattern": "string",
      "constraintDescription": "string",
      "minValue": integer,
      "maxValue": integer,
      "minLength": integer,
      "maxLength": integer,
      "allowedValues": [
        "string"
      ],
      "referencedByResources": [
        "string"
      ]
    }
  ],
  "requiredCapabilities": [
    enum
  ],
  "resourcesSupported": boolean
}
{
  "message": "string",
  "errorCode": "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.

PropertiTipeDiperlukanDeskripsi
errorCode

string

False

400

message

string

False

Salah satu parameter dalam permintaan tidak valid.

Kemampuan

Nilai yang harus ditentukan untuk menerapkan beberapa aplikasi.

  • CAPABILITY_IAM

  • CAPABILITY_NAMED_IAM

  • CAPABILITY_AUTO_EXPAND

  • CAPABILITY_RESOURCE_POLICY

ConflictException

Sumber daya sudah ada.

PropertiTipeDiperlukanDeskripsi
errorCode

string

False

409

message

string

False

Sumber daya sudah ada.

CreateApplicationVersionInput

Buat permintaan versi.

PropertiTipeDiperlukanDeskripsi
sourceCodeArchiveUrl

string

False

Tautan ke objek S3 yang berisi arsip ZIP kode sumber untuk versi aplikasi Anda ini.

Ukuran maksimal 50 MB

sourceCodeUrl

string

False

Tautan ke repositori publik untuk kode sumber aplikasi Anda, misalnya URL komit GitHub tertentu.

templateBody

string

False

AWS SAM Template kemasan mentah aplikasi Anda.

templateUrl

string

False

Tautan ke AWS SAM template paket aplikasi Anda.

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.

ParameterDefinition

Parameter yang didukung oleh aplikasi.

PropertiTipeDiperlukanDeskripsi
allowedPattern

string

False

Suatu ekspresi reguler yang mewakili pola untuk memungkinkan String tipe.

allowedValues

Array tipe string

False

Array yang berisi daftar nilai yang diizinkan untuk parameter.

constraintDescription

string

False

Suatu string yang menjelaskan kendala ketika ia dilanggar. Sebagai contoh, tanpa deskripsi kendala, parameter yang memiliki pola yang diizinkan [A-Za-z0-9]+ menampilkan pesan kesalahan berikut ketika pengguna menentukan nilai yang tidak valid:

Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+

Dengan menambahkan deskripsi kendala, seperti “hanya harus berisi huruf besar dan kecil dan angka,” Anda dapat menampilkan pesan kesalahan khusus berikut:

Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.

defaultValue

string

False

Nilai tipe yang sesuai untuk templat untuk digunakan jika tidak ada nilai yang ditentukan ketika tumpukan dibuat. Jika Anda menentukan kendala untuk parameter, Anda harus menentukan nilai yang mematuhi kendala tersebut.

description

string

False

String hingga 4.000 karakter yang menggambarkan parameter.

maxLength

integer

False

Nilai integer yang menentukan jumlah karakter terbesar yang ingin Anda izinkan untuk String tipe.

maxValue

integer

False

Nilai numerik yang menentukan nilai numerik terbesar yang ingin Anda izinkan untuk Number tipe.

minLength

integer

False

Nilai integer yang menentukan jumlah karakter terkecil yang ingin Anda izinkan untuk String tipe.

minValue

integer

False

Nilai numerik yang menentukan nilai numerik terkecil yang ingin Anda izinkan untuk Number tipe.

name

string

True

Nama parameter.

noEcho

boolean

False

Apakah akan menutupi nilai parameter setiap kali ada yang membuat panggilan yang menjelaskan tumpukan. Jika Anda mengatur nilai ke true, nilai parameter ditutupi dengan tanda bintang (*****).

referencedByResources

Array tipe string

True

Daftar sumber AWS SAM daya yang menggunakan parameter ini.

type

string

False

Jenis parameter.

Nilai yang valid: String | Number | List<Number> | CommaDelimitedList

String: String literal.

Misalnya, pengguna dapat menentukan"MyUserName".

Number: Bilangan bulat atau float. CloudFormation memvalidasi nilai parameter sebagai angka. Namun, ketika Anda menggunakan parameter di tempat lain dalam template Anda (misalnya, dengan menggunakan fungsi Ref intrinsik), nilai parameter menjadi string.

Misalnya, pengguna dapat menentukan"8888".

List<Number>: Array bilangan bulat atau float yang dipisahkan oleh koma. CloudFormation memvalidasi nilai parameter sebagai angka. Namun, ketika Anda menggunakan parameter di tempat lain dalam template Anda (misalnya, dengan menggunakan fungsi Ref intrinsik), nilai parameter menjadi daftar string.

Misalnya, pengguna mungkin menentukan “80,20", dan kemudian Ref menghasilkan. ["80","20"]

CommaDelimitedList: Array string literal yang dipisahkan oleh koma. Jumlah total string harus satu lebih dari jumlah koma. Juga, setiap string anggota dipangkas spasi.

Misalnya, pengguna dapat menentukan “test, dev, prod”, dan kemudian Ref menghasilkan["test","dev","prod"].

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.

Versi

Detail versi aplikasi.

PropertiTipeDiperlukanDeskripsi
applicationId

string

True

Aplikasi Nama Sumber Daya Amazon (ARN).

creationTime

string

True

Tanggal dan waktu sumber daya ini dibuat.

parameterDefinitions

Array tipe ParameterDefinition

True

Array tipe parameter yang didukung oleh aplikasi.

requiredCapabilities

Array tipe Capability

True

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 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: :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 atauCAPABILITY_NAMED_IAM. Jika aplikasi berisi sumber daya IAM dengan nama khusus, Anda harus menentukanCAPABILITY_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 menentukanCAPABILITY_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.

resourcesSupported

boolean

True

Apakah semua sumber AWS daya yang terkandung dalam aplikasi ini didukung di wilayah di mana ia sedang diambil.

semanticVersion

string

True

Versi semantik dari aplikasi:

https://semver.org/

sourceCodeArchiveUrl

string

False

Tautan ke objek S3 yang berisi arsip ZIP kode sumber untuk versi aplikasi Anda ini.

Ukuran maksimal 50 MB

sourceCodeUrl

string

False

Tautan ke repositori publik untuk kode sumber aplikasi Anda, misalnya URL komit GitHub tertentu.

templateUrl

string

True

Tautan ke AWS SAM template paket aplikasi Anda.

Lihat juga

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

CreateApplicationVersion