应用程序 applicationID 版本语义版本 - Amazon Serverless Application Repository
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

应用程序 applicationID 版本语义版本

URI

/applications/applicationId/versions/semanticVersion

HTTP 方法

PUT

操作 ID:CreateApplicationVersion

创建应用程序版本。

路径参数
名称类型必需描述
applicationIdStringTrue

应用程序的 Amazon 资源名称(ARN)。

语义版本StringTrue

新版本的语义版本。

响应
状态代码响应模型描述
201Version

成功

400BadRequestException

请求中的参数之一无效。

403ForbiddenException

客户端未通过身份验证。

409ConflictException

该资源已存在。

429TooManyRequestsException

客户端每单位时间发送的请求数超过了允许的请求数。

500InternalServerErrorException

Amazon Serverless Application Repository 服务遇到了内部错误。

OPTIONS

路径参数
名称类型必需描述
applicationIdStringTrue

应用程序的 Amazon 资源名称(ARN)。

语义版本StringTrue

新版本的语义版本。

响应
状态代码响应模型描述
200None

200 条回复

Schemas

请求正文

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

响应正文

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

属性

BadRequestException

请求中的参数之一无效。

属性类型必需描述
errorCode

字符串

False

400

消息

字符串

False

请求中的参数之一无效。

Capability

部署某些应用程序时必须指定的值。

  • CAPABILITY_IAM

  • CAPABILITY_NAMED_IAM

  • CAPABILITY_AUTO_EXPAND

  • CAPABILITY_RESOURCE_POLICY

ConflictException

该资源已存在。

属性类型必需描述
errorCode

字符串

False

409

消息

字符串

False

该资源已存在。

CreateApplicationVersionInput

创建版本请求。

属性类型必需描述
sourceCodeArchive网址

字符串

False

指向 S3 对象的链接,其中包含此版本应用程序的源代码的 ZIP 存档。

最大大小 50 MB

sourceCodeUrl

字符串

False

指向应用程序源代码的公共存储库的链接,例如特定 GitHub 提交的 URL。

templateBody

字符串

False

应用程序的原始打包Amazon SAM模板。

模板网址

字符串

False

指向应用程序打包Amazon SAM模板的链接。

ForbiddenException

客户端未通过身份验证。

属性类型必需描述
errorCode

字符串

False

403

消息

字符串

False

客户端未通过身份验证。

InternalServerErrorException

Amazon Serverless Application Repository 服务遇到了内部错误。

属性类型必需描述
errorCode

字符串

False

500

消息

字符串

False

Amazon Serverless Application Repository 服务遇到了内部错误。

ParameterDefinition

应用程序支持的参数。

属性类型必需描述
allowedPattern

字符串

False

一个正则表达式,表示要允许 String 类型使用的模式。

allowedValues

string 类型的数组

False

包含参数允许值列表的阵列。

约束描述

字符串

False

用于在违反约束时说明该约束的字符串。例如,在没有约束条件描述的情况下,具有允许的 [A-Za-z0-9]+ 模式的参数会在用户指定无效值时显示以下错误消息:

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

通过添加约束条件描述(例如 “必须仅包含大写和小写字母和数字”),可以显示以下自定义错误消息:

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

defaultValue

字符串

False

模板适当类型的值,用于在创建堆栈时未指定值的情况下。如果您定义参数的约束,则必须指定一个符合这些约束的值。

description

字符串

False

描述参数的字符串,最多 4,000 个字符。

最大长度

integer

False

一个整数值,用于确定要允许的String类型的最大字符数。

最大值

integer

False

一个数值,用于确定要允许Number类型使用的最大数值。

最小长度

integer

False

一个整数值,用于确定要允许String类型使用的最小字符数。

最小值

integer

False

一个数值,用于确定要允许Number类型使用的最小数值。

name

字符串

True

参数的名称。

noeCho

布尔值

False

每当有人调用描述堆栈时,是否要屏蔽参数值。如果将该值设置为 true,则使用星号 (*****) 掩盖参数值。

referencedByResources

string 类型的数组

True

使用此参数的Amazon SAM资源列表。

type

字符串

False

参数的类型。

有效值:String | Number | List<Number> | CommaDelimitedList

String: 文字字符串。

例如,用户可以指定"MyUserName"

Number: 整数或浮点数。 Amazon CloudFormation将参数值验证为数字。但是,当您在模板的其他地方使用该参数时(例如,使用Ref内部函数),参数值将变为字符串。

例如,用户可以指定"8888"

List<Number>: 用逗号分隔的整数或浮点数组。 Amazon CloudFormation将参数值验证为数字。但是,当您在模板的其他地方使用该参数时(例如,通过使用Ref内部函数),参数值将变成字符串列表。

例如,用户可以指定 “80,20”,然后Ref得出结果。["80","20"]

CommaDelimitedList:用逗号分隔的文字字符串数组。字符串的总数应比逗号总数多 1。此外,每个成员字符串都经过空格修剪。

例如,用户可以指定 “测试、开发、生产”,然后输入Ref结果。["test","dev","prod"]

TooManyRequestsException

客户端每单位时间发送的请求数超过了允许的请求数。

属性类型必需描述
errorCode

字符串

False

429

消息

字符串

False

客户端每单位时间发送的请求数超过了允许的请求数。

Version

应用程序版本详情。

属性类型必需描述
applicationId

字符串

True

应用程序 Amazon 资源名称 (ARN)。

creationTime

字符串

True

此资源的创建日期和时间。

参数定义

ParameterDefinition 类型的数组

True

应用程序支持的参数类型数组。

requiredCapabilities

Capability 类型的数组

True

在部署某些应用程序之前必须指定的值列表。某些应用程序可能包含可能影响您Amazon账户权限的资源,例如,通过创建新 Amazon Identity and Access Management (IAM) 用户。对于这些应用程序,必须通过指定此参数来明确确认其功能。

唯一有效的值是CAPABILITY_IAMCAPABILITY_NAMED_IAMCAPABILITY_RESOURCE_POLICY、和CAPABILITY_AUTO_EXPAND

以下资源需要您指定CAPABILITY_IAMCAPABILITY_NAMED_IAMAWS::IAM::GroupAWS::IAM::InstanceProfileAWS::IAM::Policy、和AWS::IAM::Role。如果应用程序包含 IAM 资源,则可以指定CAPABILITY_IAMCAPABILITY_NAMED_IAM。如果应用程序包含具有自定义名称的 IAM 资源,您必须指定 CAPABILITY_NAMED_IAM

以下资源需要您指定CAPABILITY_RESOURCE_POLICYAWS::Lambda::PermissionAWS:: iam: Policy、、AWS::ApplicationAutoScaling::ScalingPolicyAWS::S3::BucketPolicy和。AWS::SQS::QueuePolicyAWS::SNS::TopicPolicy

包含一个或多个嵌套应用程序的应用程序要求您指定 CAPABILITY_AUTO_EXPAND

如果您的应用程序模板包含上述任何资源,我们建议您在部署之前查看与该应用程序关联的所有权限。如果您没有为需要功能的应用程序指定此参数,则调用将失败。

支持的资源

布尔值

True

检索该应用程序所在的区域是否支持此应用程序中包含的所有Amazon资源。

语义版本

字符串

True

应用程序的语义版本:

https://semver.org/

sourceCodeArchive网址

字符串

False

指向 S3 对象的链接,其中包含此版本应用程序的源代码的 ZIP 存档。

最大大小 50 MB

sourceCodeUrl

字符串

False

指向应用程序源代码的公共存储库的链接,例如特定 GitHub 提交的 URL。

模板网址

字符串

True

指向应用程序打包Amazon SAM模板的链接。