applicationId Versi Aplikasi semanticVersion - 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.

applicationId Versi Aplikasi semanticVersion

URI

/applications/applicationId/versions/semanticVersion

HTTPmetode

PUT

ID Operasi: CreateApplicationVersion

Membuat versi aplikasi.

Parameter jalur
NamaTipeDiperlukanDeskripsi
applicationIdStringTrue

Nama Sumber Daya Amazon (ARN) dari 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.

OPTIONS

Parameter jalur
NamaTipeDiperlukanDeskripsi
applicationIdStringTrue

Nama Sumber Daya Amazon (ARN) dari aplikasi.

semanticVersionStringTrue

Versi semantik dari versi baru.

Respons
Kode statusModel responsDeskripsi
200Tidak ada

200 respon

Skema

Permintaan badan

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

Badan respons

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

Properti

BadRequestException

Salah satu parameter dalam permintaan tidak valid.

PropertiTipeDiperlukanDeskripsi
errorCode

string

False

400

message

string

False

Salah satu parameter dalam permintaan tidak valid.

Capability

Nilai yang harus ditentukan untuk menyebarkan 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 ZIP arsip 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 tertentu GitHub .

templateBody

string

False

AWS SAM Template paket mentah dari aplikasi Anda.

templateUrl

string

False

Sebuah link 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 “harus berisi hanya huruf besar dan kecil dan angka,” Anda dapat menampilkan pesan kesalahan yang disesuaikan 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

Sebuah 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 menetapkan nilai ke true, nilai parameter ditutupi dengan tanda bintang (*****).

referencedByResources

Array tipe string

True

Daftar AWS SAM sumber daya yang menggunakan parameter ini.

type

string

False

Jenis parameter.

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

String: Sebuah string literal.

Misalnya, pengguna dapat menentukan"MyUserName".

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

Misalnya, pengguna mungkin menentukan"8888".

List<Number>: Sebuah array bilangan bulat atau float yang dipisahkan oleh koma. AWS CloudFormation memvalidasi nilai parameter sebagai angka. Namun, ketika Anda menggunakan parameter di tempat lain di 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: Sebuah array string literal yang dipisahkan oleh koma. Jumlah total string harus satu lebih dari jumlah koma. Juga, setiap string anggota dipangkas spasi.

Misalnya, pengguna mungkin 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.

Version

Detail versi aplikasi.

PropertiTipeDiperlukanDeskripsi
applicationId

string

True

Aplikasi Amazon Resource Name (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 Kemampuan

True

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.

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 aplikasi:

https://semver.org/

sourceCodeArchiveUrl

string

False

Tautan ke objek S3 yang berisi ZIP arsip 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 tertentu GitHub .

templateUrl

string

True

Sebuah link ke AWS SAM template paket aplikasi Anda.

Lihat juga

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

CreateApplicationVersion