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

# **eb appversion**
<a name="eb3-appversion"></a>

## 说明
<a name="eb3-appversion-description"></a>

EB CLI `appversion` 命令管理 Elastic Beanstalk [应用程序版本](concepts.md#concepts-version)。您可以在无部署的情况下创建应用程序的新版本、删除应用程序的版本或创建[应用程序版本生命周期](applications-lifecycle.md)。如果您不带任何选项调用命令，它将进入[交互模式](#eb3-appversion-interactive)。

使用 `--create` 选项可创建应用程序的新版本。

使用 `--delete` 选项可删除应用程序的某个版本。

使用 `lifecycle` 选项可显示或创建应用程序的版本生命周期策略。有关更多信息，请参阅 [配置应用程序版本生命周期设置](applications-lifecycle.md)。

## 语法
<a name="eb3-appversion-syntax"></a>

 **eb appversion** 

 **eb appversion [-c \| --create]** 

 **eb appversion [-d \| --delete] {{version-label}}** 

 **eb appversion lifecycle [-p \| --print]** 

## 选项
<a name="eb3-appversion-options"></a>


****  

|  Name  |  描述 类型：字符串  | 
| --- | --- | 
| -a {{application-name}}<br />或者<br />--应用程序名称 {{application-name}} |  应用程序的名称。如果未找到具有指定名称的应用程序，则 EB CLI 会为新应用程序创建应用程序版本。<br />仅适用于 `--create` 选项。<br />类型：字符串 | 
| -c<br />或<br />--create | 创建应用程序的[新版本](concepts.md#concepts-version)。 | 
| -d {{version-label}}<br />或者<br />--删除 {{version-label}} | 删除带有标签的应用程序版本{{version-label}}。 | 
| `-l` {{version\_label}}<br />或者<br />`--label` {{version\_label}} | 指定要用作 EB CLI 所创建版本的标签。如果您不使用此选项，EB CLI 将生成新的唯一标签。如果您提供了版本标签，请确保它是唯一的。<br />仅适用于 `--create` 选项。<br />类型：字符串 | 
| 生命周期 | 调用默认编辑器以创建新的应用程序版本生命周期策略。使用此策略可避免达到[应用程序版本配额](https://docs.amazonaws.cn/general/latest/gr/elasticbeanstalk.html#limits_elastic_beanstalk)。 | 
| lifecycle -p<br />或<br />lifecycle --print | 显示当前应用程序生命周期策略。 | 
| `-m` "{{version\_description}}"<br />或者<br />`--message` "{{version\_description}}" | 应用程序版本的描述。它用双引号引起来。<br />仅适用于 `--create` 选项。<br />类型：字符串 | 
| `-p`<br />或<br />`--process` | 预处理并验证源代码包中的环境清单和配置文件。验证配置文件可以识别问题。我们建议您在将应用程序版本部署到此环境中之前执行此操作。<br />仅适用于 `--create` 选项。 | 
| `--source codecommit/{{repository-name}}/{{branch-name}}` | CodeCommit 存储库和分支。<br />仅适用于 `--create` 选项。 | 
| `--staged` | 使用 git 索引中暂存的文件（而不是 HEAD 提交）来创建应用程序版本。<br />仅适用于 `--create` 选项。 | 
| `--timeout` {{minutes}} | 命令超时之前的分钟数。<br />仅适用于 `--create` 选项。 | 
| [常用选项](eb3-cmd-options.md) |  | 

## 以交互方式使用命令
<a name="eb3-appversion-interactive"></a>

如果您使用不带任何参数的命令，则将显示应用程序的版本。它们按时间倒序方式列出，最新版本列在首位。有关屏幕示例，请参阅 **Examples**（示例）部分。注意显示在底部的状态行。状态行显示上下文相关信息。

按 `d` 可删除应用程序版本，按 `l` 可管理应用程序的生命周期策略，按 `q` 可退出且不保存任何更改。

**注意**  
如果版本部署到了任何环境，则您无法删除此版本。

## Output
<a name="eb3-appversion-output"></a>

带有 `--create` 选项的命令会显示一条消息，确认应用程序版本已创建。

带有`--delete`{{version-label}}选项的命令会显示一条消息，确认应用程序版本已删除。

## 示例
<a name="eb3-appversion-example"></a>

下面的示例显示了未进行任何部署的应用程序的交互式窗口。

![应用程序版本列表显示了三个版本，包括标签、创建日期、年龄和描述。](http://docs.amazonaws.cn/elasticbeanstalk/latest/dg/images/InteractiveModeNoEnvironment.png)


下面的示例显示了已部署第四个版本、版本标签为 **Sample Application**（示例应用程序）的应用程序的交互式窗口。

![版本表显示了以 Health Green 状态部署的第 4 版示例应用程序。](http://docs.amazonaws.cn/elasticbeanstalk/latest/dg/images/InteractiveModeWithEnvironment.png)


以下示例显示了**eb appversion lifecycle -p**命令的输出，其中{{ACCOUNT-ID}}是用户的账户 ID：

```
Application details for: lifecycle
  Region: sa-east-1
  Description: Application created from the EB CLI using "eb init"
  Date Created: 2016/12/20 02:48 UTC
  Date Updated: 2016/12/20 02:48 UTC
  Application Versions: ['Sample Application']
  Resource Lifecycle Config(s):
    VersionLifecycleConfig:
      MaxCountRule:
        DeleteSourceFromS3: False
        Enabled: False
        MaxCount: 200
      MaxAgeRule:
        DeleteSourceFromS3: False
        Enabled: False
        MaxAgeInDays: 180
    ServiceRole: arn:aws:iam::{{ACCOUNT-ID}}:role/aws-elasticbeanstalk-service-role
```