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

# `pcluster create-cluster`
<a name="pcluster.create-cluster-v3"></a>

创建集 AWS ParallelCluster 群。

```
pcluster create-cluster [-h]
                 --cluster-configuration CLUSTER_CONFIGURATION
                 --cluster-name CLUSTER_NAME
                [--debug]
                [--dryrun DRYRUN]   
                [--query QUERY]
                [--region REGION]
                [--rollback-on-failure ROLLBACK_ON_FAILURE]
                [--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]                        
                [--validation-failure-level {INFO,WARNING,ERROR}]
```

## 命名的参数
<a name="pcluster-v3.create-cluster.namedargs"></a>

**-h, --help**  
显示 `pcluster create-cluster` 的帮助文本。

**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***  
指定 YAML 集群配置文件。

**--cluster-name, -n *CLUSTER\$1NAME***  
指定要创建的集群的名称。  
名称必须以字母字符开头。名称最多可以包含 60 个字符。如果启用 Slurm 会计，则名称最多可包含 40 个字符。  
有效字符：A-Z、a-z、0-9 和 -（连字符）。

**--debug**  
启用调试日志记录。

**--dryrun *DRYRUN***  
当为 `true` 时，该命令执行验证而不创建任何资源。您可以使用此参数来验证集群配置。（默认值为 `false`。）

**--query *QUERY***  
指定要对输出执行的 JMESPath 查询。

**--region, -r *REGION***  
指定 AWS 区域 要使用的。 AWS 区域 必须使用群集配置文件中的[`Region`](cluster-configuration-file-v3.md#yaml-Region)设置、`AWS_DEFAULT_REGION`环境变量、`~/.aws/config`文件`[default]`部分的`region`设置或`--region`参数来指定。

**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***  
当为 `true` 时，会在失败时自动启动集群堆栈回滚。（默认值为 `true`。）

**--suppress-validators *SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS* ...]**  
标识一个或多个要禁止的配置验证器。  
 格式：(`ALL`\$1type:`[A-Za-z0-9]+`)

**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**  
指定将导致创建失败的最低验证级别。（默认值为 `ERROR`。）

**使用 AWS ParallelCluster 版本 3.1.4 的示例：**

```
$ pcluster create-cluster -c cluster-config.yaml -n cluster-v3
{
  "cluster": {
    "clusterName": "cluster-v3",
    "cloudformationStackStatus": "CREATE_IN_PROGRESS",
    "cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
    "region": "us-east-1",
    "version": "3.1.4",
    "clusterStatus": "CREATE_IN_PROGRESS"
  }
}
```