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

# AWS SAM 模板元数据部分属性
<a name="serverless-sam-template-publishing-applications-metadata-properties"></a>

`AWS::ServerlessRepo::Application` 是元数据键，可用于指定要发布到 AWS Serverless Application Repository的应用程序信息。

**注意**  
CloudFormation `AWS::ServerlessRepo::Application`元数据[密钥不支持内部函数](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference.html)。

## Properties
<a name="serverless-sam-template-publishing-applications-metadata-properties-table"></a>

此表提供有关 AWS SAM 模板`Metadata`部分属性的信息。本节是 AWS Serverless Application Repository 使用向发布应用程序所必需的 AWS SAMCLI。


****  

| 属性 | Type | 必需 | 描述 | 
| --- | --- | --- | --- | 
| Name | 字符串 | TRUE |  应用程序的名称。<br />最小长度 = 1。最大长度 = 140。<br />模式：`"[a-zA-Z0-9\\-]+";` | 
| Description | 字符串 | TRUE | 关于应用程序的描述。<br />最小长度 = 1。最大长度 = 256。 | 
| Author | 字符串 | TRUE | 发布应用程序的作者的姓名。<br />最小长度 = 1。最大长度 = 127。<br />模式：`"^[a-z0-9](([a-z0-9]\|-(?!-))*[a-z0-9])?$";` | 
| SpdxLicenseId | 字符串 | FALSE | 有效的许可证标识符。要查看有效的许可证标识符列表，请参阅 Software Package Data Exchange (SPDX) 网站上的 [SPDX 许可证列表](https://spdx.org/licenses/)。 | 
| LicenseUrl | 字符串 | FALSE | 对本地许可文件的引用，或指向许可证文件的 Amazon S3 链接，其中该文件与您的应用程序的 spdxLicenseId 值相匹配。<br />未使用该`sam package`命令打包的 AWS SAM 模板文件可以引用此属性的本地文件。但是，要使用 `sam publish` 命令发布应用程序，此属性必须是对 Amazon S3 存储桶的引用。<br />最大大小：5 MB。<br />您必须为此属性提供一个值，才能使您的应用程序变为公有的。请注意，在应用程序发布后，您无法更新此属性。因此，要向应用程序添加许可证，必须先将其删除，或者发布具有不同名称的新应用程序。 | 
| ReadmeUrl | 字符串 | FALSE | 对本地自述文件的引用或指向自述文件的 Amazon S3 链接，其中该文件包含对应用程序及其工作原理的更详细描述。<br />未使用该`sam package`命令打包的 AWS SAM 模板文件可以引用此属性的本地文件。但是，要使用 `sam publish` 命令发布，此属性必须是对 Amazon S3 存储桶的引用。<br />最大大小：5 MB。 | 
| Labels | 字符串 | FALSE | 改善在搜索中发现应用程序的结果的标签。<br />最小长度 = 1。最大长度 = 127。最大标签数量：10。<br />模式：`"^[a-zA-Z0-9+\\-_:\\/@]+$";` | 
| HomePageUrl | 字符串 | FALSE | 包含有关应用程序的更多信息的 URL，例如应用程序 GitHub 存储库的位置。 | 
| SemanticVersion | 字符串 | FALSE | 应用程序的语义版本。有关语义版本控制规范，请访问[语义版本控制](https://semver.org/)网站。<br />您必须为此属性提供一个值，才能使您的应用程序变为公有的。 | 
| SourceCodeUrl | 字符串 | FALSE | 指向应用程序源代码的公共存储库的链接。 | 

## 使用案例
<a name="serverless-sam-template-publishing-applications-metadata-properties-cases"></a>

本节列出了发布应用程序的用例，以及为该用例处理的 `Metadata` 属性。*未*针对给定用例列出的属性将被忽略。
+ **创建新应用程序**-如果中没有 AWS Serverless Application Repository 与账户名称相匹配的应用程序，则会创建新的应用程序。
  + `Name`
  + `SpdxLicenseId`
  + `LicenseUrl`
  + `Description`
  + `Author`
  + `ReadmeUrl`
  + `Labels`
  + `HomePageUrl`
  + `SourceCodeUrl`
  + `SemanticVersion`
  +  AWS SAM 模板的内容（例如，任何事件源、资源和 Lambda 函数代码）

   
+ **创建应用程序版本**-如果中已经存在 AWS Serverless Application Repository 与账户名称相匹配的应用程序，*并且 SemanticVersion**正在*更改，则会创建应用程序版本。
  + `Description`
  + `Author`
  + `ReadmeUrl`
  + `Labels`
  + `HomePageUrl`
  + `SourceCodeUrl`
  + `SemanticVersion`
  +  AWS SAM 模板的内容（例如，任何事件源、资源和 Lambda 函数代码）

   
+ **更新应用程序**-如果中已经存在 AWS Serverless Application Repository 与账户名称相匹配的应用程序，*并且*该 SemanticVersion应用程序*没有*更改，则会更新应用程序。
  + `Description`
  + `Author`
  + `ReadmeUrl`
  + `Labels`
  + `HomePageUrl`

## 示例
<a name="serverless-sam-template-publishing-applications-metadata-properties-example"></a>

下面是 `Metadata` 部分的示例：

```
Metadata:
  AWS::ServerlessRepo::Application:
    Name: {{my-app}}
    Description: {{hello world}}
    Author: {{user1}}
    SpdxLicenseId: Apache-2.0
    LicenseUrl: {{LICENSE.txt}}
    ReadmeUrl: {{README.md}}
    Labels: {{['tests']}}
    HomePageUrl: {{https://github.com/user1/my-app-project}}
    SemanticVersion: {{0.0.1}}
    SourceCodeUrl: {{https://github.com/user1/my-app-project}}
```