本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Applications ## URI `/applications` ## HTTP 方法 ### GET **操作 ID：**`ListApplications` 列出请求者所拥有的应用程序。 **查询参数** | Name | Type | 必需 | 描述 | | --- |--- |--- |--- | | maxItems | 字符串 | False | 要退货的商品总数。 | | nextToken | 字符串 | False | 指定从何处开始分页的令牌。 | **响应** | 状态代码 | 响应模型 | 说明 | | --- |--- |--- | | 200 | ApplicationPage | 成功 | | 400 | BadRequestException | 请求中的参数之一无效。 | | 403 | ForbiddenException | 客户端未通过身份验证。 | | 404 | NotFoundException | 请求中指定的资源（例如访问策略声明）不存在。 | | 500 | InternalServerErrorException | 该 AWS Serverless Application Repository 服务遇到了内部错误。 | ### POST **操作 ID：**`CreateApplication` 创建应用程序，可以选择包含一个 AWS SAM 文件，以便在同一次调用中创建第一个应用程序版本。 **响应** | 状态代码 | 响应模型 | 说明 | | --- |--- |--- | | 201 | Application | 成功 | | 400 | BadRequestException | 请求中的参数之一无效。 | | 403 | ForbiddenException | 客户端未通过身份验证。 | | 409 | ConflictException | 该资源已存在。 | | 429 | TooManyRequestsException | 客户端每单位时间发送的请求数超过了允许的请求数。 | | 500 | InternalServerErrorException | 该 AWS Serverless Application Repository 服务遇到了内部错误。 | ### OPTIONS **响应** | 状态代码 | 响应模型 | 说明 | | --- |--- |--- | | 200 | 无 | 200 条回复 | ## 架构 ### 请求正文 #### POST 架构 ``` { "name": "string", "description": "string", "author": "string", "spdxLicenseId": "string", "licenseBody": "string", "licenseUrl": "string", "readmeBody": "string", "readmeUrl": "string", "labels": [ "string" ], "homePageUrl": "string", "semanticVersion": "string", "templateBody": "string", "templateUrl": "string", "sourceCodeUrl": "string", "sourceCodeArchiveUrl": "string" } ``` ### 响应正文 #### ApplicationPage 架构 ``` { "applications": [ { "applicationId": "string", "name": "string", "description": "string", "author": "string", "spdxLicenseId": "string", "labels": [ "string" ], "creationTime": "string", "homePageUrl": "string" } ], "nextToken": "string" } ``` #### Application 架构 ``` { "applicationId": "string", "name": "string", "description": "string", "author": "string", "isVerifiedAuthor": boolean, "verifiedAuthorUrl": "string", "spdxLicenseId": "string", "licenseUrl": "string", "readmeUrl": "string", "labels": [ "string" ], "creationTime": "string", "homePageUrl": "string", "version": { "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 } } ``` #### BadRequestException 架构 ``` { "message": "string", "errorCode": "string" } ``` #### ForbiddenException 架构 ``` { "message": "string", "errorCode": "string" } ``` #### NotFoundException 架构 ``` { "message": "string", "errorCode": "string" } ``` #### ConflictException 架构 ``` { "message": "string", "errorCode": "string" } ``` #### TooManyRequestsException 架构 ``` { "message": "string", "errorCode": "string" } ``` #### InternalServerErrorException 架构 ``` { "message": "string", "errorCode": "string" } ``` ## Properties ### Application 有关应用程序的详细信息。 | 属性 | Type | 必需 | 描述 | | --- |--- |--- |--- | | applicationId | 字符串 | True | 应用程序 Amazon 资源名称 (ARN)。 | | author | 字符串 | True | 发布应用程序的作者的姓名。最小长度 = 1。最大长度 = 127。模式 “^ [a-z0-9] ([a-z0-9] \$1-(？\$1 -)) \$1 [a-z0-9])？ \$1”; | | creationTime | 字符串 | False | 此资源的创建日期和时间。 | | description | 字符串 | True | 关于应用程序的描述。最小长度 = 1。最大长度 =256 | | homePageUrl | 字符串 | False | 包含有关应用程序的更多信息（例如应用程序 GitHub 存储库的位置）的 URL。 | | isVerifiedAuthor | 布尔值 | False | 指定此应用程序的作者是否已通过验证。这意味着，作为一个合理而谨慎的服务提供商， AWS 它已对请求者提供的信息进行了真诚的审查，并确认请求者的身份与所声称的相同。 | | labels | string 类型的数组 | False | 用于改善搜索结果中应用程序发现率的标签。最小长度 = 1。最大长度 = 127。标签的最大数量：10模式："^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | licenseUrl | 字符串 | False | 指向应用程序许可证文件的链接，该文件与您的应用程序的 spdxLicenseId 值相匹配。最大大小 5 MB | | name | 字符串 | True | 应用程序的名称。最小长度 = 1。最大长度 =140模式："[a-zA-Z0-9\$1\$1-]\$1"; | | readmeUrl | 字符串 | False | 指向 Markdown 语言的自述文件链接，其中包含对应用程序及其工作原理的更详细描述。最大大小 5 MB | | spdxLicenseId | 字符串 | False | 来自 https://spdx.org/licenses/ 的有效标识符。 | | verifiedAuthorUrl | 字符串 | False | 经过验证的作者的公开个人资料网址。此 URL 由作者提交。 | | version | [版本](#applications-model-version) | False | 有关应用程序的版本信息。 | ### ApplicationPage 应用程序详细信息列表。 | 属性 | Type | 必需 | 说明 | | --- |--- |--- |--- | | applications | [ApplicationSummary](#applications-model-applicationsummary) 类型的数组 | True | 一系列应用程序摘要。 | | nextToken | 字符串 | False | 用于请求下一页结果的令牌。 | ### ApplicationSummary 有关应用程序的详细信息摘要。 | 属性 | Type | 必需 | 描述 | | --- |--- |--- |--- | | applicationId | 字符串 | True | 应用程序 Amazon 资源名称 (ARN)。 | | author | 字符串 | True | 发布应用程序的作者的姓名。最小长度 = 1。最大长度 = 127。模式 “^ [a-z0-9] ([a-z0-9] \$1-(？\$1 -)) \$1 [a-z0-9])？ \$1”; | | creationTime | 字符串 | False | 此资源的创建日期和时间。 | | description | 字符串 | True | 关于应用程序的描述。最小长度 = 1。最大长度 =256 | | homePageUrl | 字符串 | False | 包含有关应用程序的更多信息（例如应用程序 GitHub 存储库的位置）的 URL。 | | labels | string 类型的数组 | False | 用于改善搜索结果中应用程序发现率的标签。最小长度 = 1。最大长度 = 127。标签的最大数量：10模式："^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | name | 字符串 | True | 应用程序的名称。最小长度 = 1。最大长度 =140模式："[a-zA-Z0-9\$1\$1-]\$1"; | | spdxLicenseId | 字符串 | False | 来自 [https://spdx.org/licenses/](https://spdx.org/licenses/) 的有效标识符。 | ### BadRequestException 请求中的参数之一无效。 | 属性 | Type | 必需 | 描述 | | --- |--- |--- |--- | | errorCode | 字符串 | False | 400 | | message | 字符串 | False | 请求中的参数之一无效。 | ### Capability 部署某些应用程序时必须指定的值。 + `CAPABILITY_IAM` + `CAPABILITY_NAMED_IAM` + `CAPABILITY_AUTO_EXPAND` + `CAPABILITY_RESOURCE_POLICY` ### ConflictException 该资源已存在。 | 属性 | Type | 必需 | 描述 | | --- |--- |--- |--- | | errorCode | 字符串 | False | 409 | | message | 字符串 | False | 该资源已存在。 | ### CreateApplicationInput 创建应用程序请求。 | 属性 | Type | 必需 | 描述 | | --- |--- |--- |--- | | author | 字符串 | True | 发布应用程序的作者的姓名。最小长度 = 1。最大长度 = 127。模式 “^ [a-z0-9] ([a-z0-9] \$1-(？\$1 -)) \$1 [a-z0-9])？ \$1”; | | description | 字符串 | True | 关于应用程序的描述。最小长度 = 1。最大长度 =256 | | homePageUrl | 字符串 | False | 包含有关应用程序的更多信息（例如应用程序 GitHub 存储库的位置）的 URL。 | | labels | string 类型的数组 | False | 用于改善搜索结果中应用程序发现率的标签。最小长度 = 1。最大长度 = 127。标签的最大数量：10模式："^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | | licenseBody | 字符串 | False | 一个本地文本文件，其中包含与您的应用程序的 spdxLicenseId 值相匹配的应用程序许可证。该文件的格式为`file:///`。最大大小 5 MB您只能指定`licenseBody`和中的一个`licenseUrl`；否则，将出现错误。 | | licenseUrl | 字符串 | False | 指向 S3 对象的链接，其中包含与您的应用程序的 spdxLicenseID 值相匹配的应用程序许可证。最大大小 5 MB您只能指定`licenseBody`和中的一个`licenseUrl`；否则，将出现错误。 | | name | 字符串 | True | 您要发布的应用程序的名称。最小长度 = 1。最大长度 =140模式："[a-zA-Z0-9\$1\$1-]\$1"; | | readmeBody | 字符串 | False | Markdown 语言的本地文本自述文件，其中包含对应用程序及其工作原理的更详细描述。该文件的格式为`file:///`。最大大小 5 MB您只能指定`readmeBody`和中的一个`readmeUrl`；否则，将出现错误。 | | readmeUrl | 字符串 | False | 指向 Markdown 语言中的 S3 对象的链接，其中包含对应用程序及其工作原理的更详细描述。最大大小 5 MB您只能指定`readmeBody`和中的一个`readmeUrl`；否则，将出现错误。 | | semanticVersion | 字符串 | False | 应用程序的语义版本： [https://semver.org/](https://semver.org/) | | sourceCodeArchiveUrl | 字符串 | False | 指向 S3 对象的链接，其中包含此版本应用程序的源代码的 ZIP 存档。最大大小 50 MB | | sourceCodeUrl | 字符串 | False | 指向应用程序源代码的公共存储库的链接，例如特定 GitHub 提交的 URL。 | | spdxLicenseId | 字符串 | False | 来自 [https://spdx.org/licenses/](https://spdx.org/licenses/) 的有效标识符。 | | templateBody | 字符串 | False | 应用程序的本地原始打包 AWS SAM 模板文件。该文件的格式为`file:///`。只能指定`templateBody`和中的一个`templateUrl`；否则会出现错误。 | | templateUrl | 字符串 | False | 指向包含应用程序打包 AWS SAM 模板的 S3 对象的链接。只能指定`templateBody`和中的一个`templateUrl`；否则会出现错误。 | ### ForbiddenException 客户端未通过身份验证。 | 属性 | Type | 必需 | 描述 | | --- |--- |--- |--- | | errorCode | 字符串 | False | 403 | | message | 字符串 | False | 客户端未通过身份验证。 | ### InternalServerErrorException 该 AWS Serverless Application Repository 服务遇到了内部错误。 | 属性 | Type | 必需 | 描述 | | --- |--- |--- |--- | | errorCode | 字符串 | False | 500 | | message | 字符串 | False | 该 AWS Serverless Application Repository 服务遇到了内部错误。 | ### NotFoundException 请求中指定的资源（例如访问策略声明）不存在。 | 属性 | Type | 必需 | 描述 | | --- |--- |--- |--- | | errorCode | 字符串 | False | 404 | | message | 字符串 | False | 请求中指定的资源（例如访问策略声明）不存在。 | ### ParameterDefinition 应用程序支持的参数。 | 属性 | Type | 必需 | 描述 | | --- |--- |--- |--- | | 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，则使用星号 (\$1\$1\$1\$1\$1) 掩盖参数值。 | | referencedByResources | string 类型的数组 | True | 使用此参数的 AWS SAM 资源列表。 | | type | 字符串 | False | 参数的类型。有效值：`String \| Number \| List \| CommaDelimitedList` `String`: 一个字面字符串。例如，用户可以指定`"MyUserName"`。 `Number`: 整数或浮点数。 CloudFormation 将参数值验证为数字。但是，当您在模板的其他地方使用该参数时（例如，通过使用`Ref`内部函数），参数值将变为字符串。例如，用户可以指定`"8888"`。 `List`: 用逗号分隔的整数或浮点数组。 CloudFormation 将参数值验证为数字。但是，当您在模板的其他地方使用该参数时（例如，通过使用`Ref`内部函数），参数值将变成字符串列表。例如，用户可以指定 “80,20”，然后`Ref`得出结果。`["80","20"]` `CommaDelimitedList`：用逗号分隔的文字字符串数组。字符串的总数应比逗号总数多 1。此外，每个成员字符串都经过空格修剪。例如，用户可以指定 “测试、开发、生产”，然后输入`Ref`结果。`["test","dev","prod"]` | ### TooManyRequestsException 客户端每单位时间发送的请求数超过了允许的请求数。 | 属性 | Type | 必需 | 描述 | | --- |--- |--- |--- | | errorCode | 字符串 | False | 429 | | message | 字符串 | False | 客户端每单位时间发送的请求数超过了允许的请求数。 | ### Version 应用程序版本详情。 | 属性 | Type | 必需 | 描述 | | --- |--- |--- |--- | | applicationId | 字符串 | True | 应用程序 Amazon 资源名称 (ARN)。 | | creationTime | 字符串 | True | 此资源的创建日期和时间。 | | parameterDefinitions | [ParameterDefinition](#applications-model-parameterdefinition) 类型的数组 | True | 应用程序支持的参数类型数组。 | | requiredCapabilities | [Capability](#applications-model-capability) 类型的数组 | True | 在部署某些应用程序之前必须指定的值列表。某些应用程序可能包含可能影响您 AWS 账户权限的资源，例如，通过创建新 AWS Identity and Access Management (IAM) 用户。对于这些应用程序，必须通过指定此参数来明确确认其功能。唯一有效的值是`CAPABILITY_IAM`、`CAPABILITY_NAMED_IAM``CAPABILITY_RESOURCE_POLICY`、和`CAPABILITY_AUTO_EXPAND`。以下资源需要您指定`CAPABILITY_IAM`或`CAPABILITY_NAMED_IAM`：[AWS::IAM::Group](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html)、[AWS::IAM::InstanceProfile[AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html)、和[AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)。如果应用程序包含 IAM 资源，则可以指定`CAPABILITY_IAM`或`CAPABILITY_NAMED_IAM`。如果应用程序包含具有自定义名称的 IAM 资源，您必须指定 `CAPABILITY_NAMED_IAM`。以下资源需要您指定`CAPABILITY_RESOURCE_POLICY`：[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)、[AWS:: iam: Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html)、、[AWS::ApplicationAutoScaling::ScalingPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html)、[AWS::S3::BucketPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html)和。[AWS::SQS::QueuePolicy[AWS::SNS::TopicPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)包含一个或多个嵌套应用程序的应用程序要求您指定 `CAPABILITY_AUTO_EXPAND`。如果您的应用程序模板包含上述任何资源，我们建议您在部署之前查看与该应用程序关联的所有权限。如果您没有为需要功能的应用程序指定此参数，则调用将失败。 | | resourcesSupported | 布尔值 | True | 检索该应用程序所在的区域是否支持此应用程序中包含的所有 AWS 资源。 | | semanticVersion | 字符串 | True | 应用程序的语义版本： [https://semver.org/](https://semver.org/) | | sourceCodeArchiveUrl | 字符串 | False | 指向 S3 对象的链接，其中包含此版本应用程序的源代码的 ZIP 存档。最大大小 50 MB | | sourceCodeUrl | 字符串 | False | 指向应用程序源代码的公共存储库的链接，例如特定 GitHub 提交的 URL。 | | templateUrl | 字符串 | True | 指向应用程序打包 AWS SAM 模板的链接。 | ## 另请参阅 有关在特定语言 AWS SDKs 和参考中使用此 API 的更多信息，请参阅以下内容： ### ListApplications + [AWS 命令行界面 V2](/goto/cli2/serverlessrepo-2017-09-08/ListApplications) + [适用于.NET 的 AWS 开发工具包 V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/ListApplications) + [适用于 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/ListApplications) + [适用于 Go 的 AWS SDK v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/ListApplications) + [适用于 Java V2 的 AWS SDK](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/ListApplications) + [适用于 JavaScript V3 的 AWS 开发工具包](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/ListApplications) + [适用于 Kotlin 的 AWS 开发工具包](/goto/SdkForKotlin/serverlessrepo-2017-09-08/ListApplications) + [适用于 PHP 的 Amazon SDK V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/ListApplications) + [适用于 Python 的 Amazon SDK](/goto/boto3/serverlessrepo-2017-09-08/ListApplications) + [适用于 Ruby 的 Amazon SDK V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/ListApplications) ### CreateApplication + [AWS 命令行界面 V2](/goto/cli2/serverlessrepo-2017-09-08/CreateApplication) + [适用于.NET 的 AWS 开发工具包 V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplication) + [适用于 C\$1\$1 的 AWS SDK](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplication) + [适用于 Go 的 AWS SDK v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplication) + [适用于 Java V2 的 AWS SDK](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplication) + [适用于 JavaScript V3 的 AWS 开发工具包](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplication) + [适用于 Kotlin 的 AWS 开发工具包](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateApplication) + [适用于 PHP 的 Amazon SDK V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateApplication) + [适用于 Python 的 Amazon SDK](/goto/boto3/serverlessrepo-2017-09-08/CreateApplication) + [适用于 Ruby 的 Amazon SDK V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateApplication)