Applications

URI

/applications

HTTP方法

GET

操作 ID：ListApplications

列出请求者所拥有的应用程序。

查询参数
名称	Type	必需	描述
`maxItems`	String	False	要退货的商品总数。
`nextToken`	String	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 条回复

架构

请求正文


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

响应正文


{
  "applications": [
    {
      "applicationId": "string",
      "name": "string",
      "description": "string",
      "author": "string",
      "spdxLicenseId": "string",
      "labels": [
        "string"
      ],
      "creationTime": "string",
      "homePageUrl": "string"
    }
  ],
  "nextToken": "string"
}


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


{
  "message": "string",
  "errorCode": "string"
}


{
  "message": "string",
  "errorCode": "string"
}


{
  "message": "string",
  "errorCode": "string"
}


{
  "message": "string",
  "errorCode": "string"
}


{
  "message": "string",
  "errorCode": "string"
}


{
  "message": "string",
  "errorCode": "string"
}

属性

Application

有关应用程序的详细信息。

属性	类型	必需	描述
`applicationId`	字符串	True	应用程序 Amazon 资源名称 (ARN)。
`author`	字符串	True	发布应用程序的作者的姓名。最小长度 = 1。最大长度 = 127。模式 “^ [a-z0-9] ([a-z0-9] \|-(？! -)) * [a-z0-9])？ $”;
`creationTime`	字符串	False	此资源的创建日期和时间。
`description`	字符串	True	关于应用程序的描述。最小长度 = 1。最大长度 =256
`homePageUrl`	字符串	False	A URL 包含有关应用程序的更多信息，例如应用程序 GitHub 存储库的位置。
`isVerifiedAuthor`	布尔值	False	指定此应用程序的作者是否已通过验证。这意味着，作为一个合理而谨慎的服务提供商， AWS 它已对请求者提供的信息进行了真诚的审查，并确认请求者的身份与所声称的相同。
`labels`	类型的数组 string	False	用于改善搜索结果中应用程序发现率的标签。最小长度 = 1。最大长度 = 127。标签的最大数量：10 模式："^[a-zA-Z0-9+\\-_:\\/@]+$";
`licenseUrl`	字符串	False	指向应用程序许可证文件的链接，该文件与您的应用程序的 spdxLicense ID 值相匹配。最大大小 5 MB
`name`	字符串	True	应用程序的名称。最小长度 = 1。最大长度 =140 模式："[a-zA-Z0-9\\-]+";
`readmeUrl`	字符串	False	指向 Markdown 语言的自述文件链接，其中包含对应用程序及其工作原理的更详细描述。最大大小 5 MB
`spdxLicenseId`	字符串	False	来自 https://spdx.org/licenses/ 的有效标识符。
`verifiedAuthorUrl`	字符串	False	经过验证URL的作者的公开个人资料。URL这是提交人提交的。
`version`	版本	False	有关应用程序的版本信息。

ApplicationPage

应用程序详细信息列表。

属性	类型	必需	描述
`applications`	类型的数组 ApplicationSummary	True	一系列应用程序摘要。
`nextToken`	字符串	False	用于请求下一页结果的令牌。

ApplicationSummary

有关应用程序的详细信息摘要。

属性	类型	必需	描述
`applicationId`	字符串	True	应用程序 Amazon 资源名称 (ARN)。
`author`	字符串	True	发布应用程序的作者的姓名。最小长度 = 1。最大长度 = 127。模式 “^ [a-z0-9] ([a-z0-9] \|-(？! -)) * [a-z0-9])？ $”;
`creationTime`	字符串	False	此资源的创建日期和时间。
`description`	字符串	True	关于应用程序的描述。最小长度 = 1。最大长度 =256
`homePageUrl`	字符串	False	A URL 包含有关应用程序的更多信息，例如应用程序 GitHub 存储库的位置。
`labels`	类型的数组 string	False	用于改善搜索结果中应用程序发现率的标签。最小长度 = 1。最大长度 = 127。标签的最大数量：10 模式："^[a-zA-Z0-9+\\-_:\\/@]+$";
`name`	字符串	True	应用程序的名称。最小长度 = 1。最大长度 =140 模式："[a-zA-Z0-9\\-]+";
`spdxLicenseId`	字符串	False	来自 https://spdx.org/licenses/ 的有效标识符。

BadRequestException

请求中的参数之一无效。

属性	类型	必需	描述
`errorCode`	字符串	False	400
`message`	字符串	False	请求中的参数之一无效。

Capability

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

CAPABILITY_IAM
CAPABILITY_NAMED_IAM
CAPABILITY_AUTO_EXPAND
CAPABILITY_RESOURCE_POLICY

ConflictException

该资源已存在。

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

CreateApplicationInput

创建应用程序请求。

属性	类型	必需	描述
`author`	字符串	True	发布应用程序的作者的姓名。最小长度 = 1。最大长度 = 127。模式 “^ [a-z0-9] ([a-z0-9] \|-(？! -)) * [a-z0-9])？ $”;
`description`	字符串	True	关于应用程序的描述。最小长度 = 1。最大长度 =256
`homePageUrl`	字符串	False	A URL 包含有关应用程序的更多信息，例如应用程序 GitHub 存储库的位置。
`labels`	类型的数组 string	False	用于改善搜索结果中应用程序发现率的标签。最小长度 = 1。最大长度 = 127。标签的最大数量：10 模式："^[a-zA-Z0-9+\\-_:\\/@]+$";
`licenseBody`	字符串	False	一个本地文本文件，其中包含与您的应用程序的 spdxLicense ID 值相匹配的应用程序许可证。该文件的格式为`file://<path>/<filename>`。最大大小 5 MB 您只能指定`licenseBody`和中的一个`licenseUrl`；否则，将出现错误。
`licenseUrl`	字符串	False	指向 S3 对象的链接，其中包含与您的应用程序的 spdxLicense ID 值相匹配的应用程序许可证。最大大小 5 MB 您只能指定`licenseBody`和中的一个`licenseUrl`；否则，将出现错误。
`name`	字符串	True	您要发布的应用程序的名称。最小长度 = 1。最大长度 =140 模式："[a-zA-Z0-9\\-]+";
`readmeBody`	字符串	False	Markdown 语言的本地文本自述文件，其中包含对应用程序及其工作原理的更详细描述。该文件的格式为`file://<path>/<filename>`。最大大小 5 MB 您只能指定`readmeBody`和中的一个`readmeUrl`；否则，将出现错误。
`readmeUrl`	字符串	False	指向 Markdown 语言中的 S3 对象的链接，其中包含对应用程序及其工作原理的更详细描述。最大大小 5 MB 您只能指定`readmeBody`和中的一个`readmeUrl`；否则，将出现错误。
`semanticVersion`	字符串	False	应用程序的语义版本： https://semver.org/
`sourceCodeArchiveUrl`	字符串	False	指向 S3 对象的链接，其中包含此版本应用程序的源代码ZIP存档。最大大小 50 MB
`sourceCodeUrl`	字符串	False	指向应用程序源代码的公共存储库的链接，例如特定 GitHub 提交的源代码。URL
`spdxLicenseId`	字符串	False	来自 https://spdx.org/licenses/ 的有效标识符。
`templateBody`	字符串	False	应用程序的本地原始打包 AWS SAM 模板文件。该文件的格式为`file://<path>/<filename>`。只能指定`templateBody`和中的一个`templateUrl`；否则会出现错误。
`templateUrl`	字符串	False	指向包含应用程序打包 AWS SAM 模板的 S3 对象的链接。只能指定`templateBody`和中的一个`templateUrl`；否则会出现错误。

ForbiddenException

客户端未通过身份验证。

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

InternalServerErrorException

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

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

NotFoundException

请求中指定的资源（例如访问策略声明）不存在。

属性	类型	必需	描述
`errorCode`	字符串	False	404
`message`	字符串	False	请求中指定的资源（例如访问策略声明）不存在。

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中使用它的更多信息，请参阅以下内容：

ListApplications

CreateApplication

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

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

文档惯例

资源

应用程序 applicationId