应用程序 applicationId 版本 semanticVersion

URI

/applications/applicationId/versions/semanticVersion

HTTP方法

PUT

操作 ID：CreateApplicationVersion

创建应用程序版本。

路径参数
名称	Type	必需	描述
`applicationId`	String	True	应用程序的 Amazon 资源名称 (ARN)。
`semanticVersion`	String	True	新版本的语义版本。

响应
状态代码	响应模型	描述
`201`	`Version`	成功
`400`	`BadRequestException`	请求中的参数之一无效。
`403`	`ForbiddenException`	客户端未通过身份验证。
`409`	`ConflictException`	该资源已存在。
`429`	`TooManyRequestsException`	客户端每单位时间发送的请求数超过了允许的请求数。
`500`	`InternalServerErrorException`	该 AWS Serverless Application Repository 服务遇到了内部错误。

OPTIONS

路径参数
名称	Type	必需	描述
`applicationId`	String	True	应用程序的 Amazon 资源名称 (ARN)。
`semanticVersion`	String	True	新版本的语义版本。

响应
状态代码	响应模型	描述
`200`	无	200 条回复

架构

请求正文


{
  "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
`message`	字符串	False	请求中的参数之一无效。

Capability

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

CAPABILITY_IAM
CAPABILITY_NAMED_IAM
CAPABILITY_AUTO_EXPAND
CAPABILITY_RESOURCE_POLICY

ConflictException

该资源已存在。

属性	类型	必需	描述
`errorCode`	字符串	False	409
`message`	字符串	False	该资源已存在。

CreateApplicationVersionInput

创建版本请求。

属性	类型	必需	描述
`sourceCodeArchiveUrl`	字符串	False	指向 S3 对象的链接，其中包含此版本应用程序的源代码ZIP存档。最大大小 50 MB
`sourceCodeUrl`	字符串	False	指向应用程序源代码的公共存储库的链接，例如特定 GitHub 提交的源代码。URL
`templateBody`	字符串	False	应用程序的原始打包 AWS SAM 模板。
`templateUrl`	字符串	False	指向应用程序打包 AWS SAM 模板的链接。

ForbiddenException

客户端未通过身份验证。

属性	类型	必需	描述
`errorCode`	字符串	False	403
`message`	字符串	False	客户端未通过身份验证。

InternalServerErrorException

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

属性	类型	必需	描述
`errorCode`	字符串	False	500
`message`	字符串	False	该 AWS Serverless Application Repository 服务遇到了内部错误。

ParameterDefinition

应用程序支持的参数。

属性	类型	必需	描述
`allowedPattern`	字符串	False	一个正则表达式，表示要允许 `String` 类型使用的模式。
`allowedValues`	类型的数组 string	False	包含参数允许值列表的阵列。
`constraintDescription`	字符串	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 个字符。
`maxLength`	整数	False	一个整数值，用于确定要允许的`String`类型的最大字符数。
`maxValue`	整数	False	一个数值，用于确定要允许`Number`类型使用的最大数值。
`minLength`	整数	False	一个整数值，用于确定要允许`String`类型使用的最小字符数。
`minValue`	整数	False	一个数值，用于确定要允许`Number`类型使用的最小数值。
`name`	字符串	True	参数的名称。
`noEcho`	布尔值	False	每当有人调用描述堆栈时，是否要屏蔽参数值。如果将该值设置为 true，则使用星号 (*****) 掩盖参数值。
`referencedByResources`	类型的数组 string	True	使用此参数的 AWS SAM 资源列表。
`type`	字符串	False	参数的类型。有效值：`String \| Number \| List<Number> \| CommaDelimitedList` `String`: 一个字面字符串。例如，用户可以指定`"MyUserName"`。 `Number`: 整数或浮点数。 AWS CloudFormation 将参数值验证为数字。但是，当您在模板的其他地方使用该参数时（例如，通过使用`Ref`内部函数），参数值将变为字符串。例如，用户可以指定`"8888"`。 `List<Number>`: 用逗号分隔的整数或浮点数组。 AWS CloudFormation 将参数值验证为数字。但是，当您在模板的其他地方使用该参数时（例如，通过使用`Ref`内部函数），参数值将变成字符串列表。例如，用户可以指定 “80,20”，然后`Ref`得出结果。`["80","20"]` `CommaDelimitedList`：用逗号分隔的文字字符串数组。字符串的总数应比逗号总数多 1。此外，每个成员字符串都经过空格修剪。例如，用户可以指定 “测试、开发、生产”，然后输入`Ref`结果。`["test","dev","prod"]`

TooManyRequestsException

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

属性	类型	必需	描述
`errorCode`	字符串	False	429
`message`	字符串	False	客户端每单位时间发送的请求数超过了允许的请求数。

Version

应用程序版本详情。

属性	类型	必需	描述
`applicationId`	字符串	True	应用程序 Amazon 资源名称 (ARN)。
`creationTime`	字符串	True	此资源的创建日期和时间。
`parameterDefinitions`	类型的数组 ParameterDefinition	True	应用程序支持的参数类型数组。
`requiredCapabilities`	类型的数组能力	True	在部署某些应用程序之前必须指定的值列表。某些应用程序可能包含可能影响您 AWS 账户权限的资源，例如，通过创建新 AWS Identity and Access Management (IAM) 用户。对于这些应用程序，必须通过指定此参数来明确确认其功能。唯一有效的值是`CAPABILITY_IAM`、`CAPABILITY_NAMED_IAMCAPABILITY_RESOURCE_POLICY`、和`CAPABILITY_AUTO_EXPAND`。以下资源要求您指定`CAPABILITY_IAM`或`CAPABILITY_NAMED_IAM`::: AWS::IAM::Group :、:IAM: InstanceProfile、AWS:AWS::IAM:Policy :IAM: Rol e。如果应用程序包含IAM资源，则可以指定`CAPABILITY_IAM`或`CAPABILITY_NAMED_IAM`。如果应用程序包含具有自定义名称的IAM资源，则必须指定`CAPABILITY_NAMED_IAM`。以下资源要求你指定`CAPABILITY_RESOURCE_POLICY`::: LambdaAWS:: Permission、AWS:: Policy IAM、:: AWS::ApplicationAutoScaling::ScalingPolicy AWS::S3::BucketPolicy 和:SQS::。AWS::SQS::QueuePolicy 包含一个或多个嵌套应用程序的应用程序要求您指定 `CAPABILITY_AUTO_EXPAND`。如果您的应用程序模板包含上述任何资源，我们建议您在部署之前查看与该应用程序关联的所有权限。如果您没有为需要功能的应用程序指定此参数，则调用将失败。
`resourcesSupported`	布尔值	True	检索该应用程序所在的区域是否支持此应用程序中包含的所有 AWS 资源。
`semanticVersion`	字符串	True	应用程序的语义版本： https://semver.org/
`sourceCodeArchiveUrl`	字符串	False	指向 S3 对象的链接，其中包含此版本应用程序的源代码ZIP存档。最大大小 50 MB
`sourceCodeUrl`	字符串	False	指向应用程序源代码的公共存储库的链接，例如特定 GitHub 提交的源代码。URL
`templateUrl`	字符串	True	指向应用程序打包 AWS SAM 模板的链接。

另请参阅

有关在特定语言 AWS SDKs和参考文献API中使用它的更多信息，请参阅以下内容：

CreateApplicationVersion

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

应用程序 applicationId 版本

文档历史记录