

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

# **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 \$1 --create]** 

 **eb appversion [-d \$1 --delete] *version-label*** 

 **eb appversion lifecycle [-p \$1 --print]** 

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


****  

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

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

![\[Application window showing version history with three entries and no current deployment.\]](http://docs.aws.amazon.com/zh_cn/elasticbeanstalk/latest/dg/images/InteractiveModeNoEnvironment.png)


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

![\[Application versions table showing 4 versions, with the latest labeled "Sample Application" deployed 2 minutes ago.\]](http://docs.aws.amazon.com/zh_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
```