updateCluster
更新集群。
请求语法
PUT /v3/clusters/{clusterName} { "clusterConfiguration": "string", "dryrun": boolean, "forceUpdate": boolean, "region": "string", "suppressValidators": "string", "validationFailureLevel": "string" }
请求正文
- clusterConfiguration
-
集群配置作为 YAML 文档。
必需：是
- clusterName
-
集群的名称。
类型：字符串。
必需：是
- dryrun
-
如果设置为
true，则仅执行请求验证而不创建任何资源。使用此参数可验证集群配置和更新要求。默认为false。类型：布尔值
必需：否
- forceUpdate
-
如果设置为
true，则忽略更新验证错误并强制更新。默认为false。类型：布尔值
必需：否
- region
-
集群所在的 AWS 区域。
类型：字符串
必需：否
- suppressValidators
-
标识一个或多个要禁止的配置验证器。
类型：字符串
格式：
(ALL|type:[A-Za-z0-9]+)必需：否
有效值示例：
currentValue、requestedValue、message - validationFailureLevel
-
导致更新失败的最低验证级别。
类型：字符串
有效值：
INFO | WARNING | ERROR必需：否
响应语法
{ "cluster": { "clusterName": "string", "region": "string", "version": "string", "cloudformationStackArn": "string", "cloudformationStackStatus": "UPDATE_IN_PROGRESS", "clusterStatus": "UPDATE_IN_PROGRESS", "scheduler": { "type": "string", "metadata": { "name": "string", "version": "string" } } }, "validationMessages": [ { "id": "string", "type": "string", "level": "INFO", "message": "string" } ], "changeSet": [ { "parameter": "string", "currentValue": "string", "requestedValue": "string" } ] }
响应正文
- changeSet
-
集群更新的更改集。
- currentValue
-
要更新的参数的当前值。
类型：字符串
- 参数
-
要更新的参数。
类型：字符串
- requestedValue
-
要更新的参数的请求值。
类型：字符串
- cluster
-
- cloudformationStackArn
-
主 CloudFormation 堆栈的 Amazon 资源名称 (ARN)。
类型：字符串
- cloudformationStackStatus
-
CloudFormation 堆栈状态。
类型：字符串
有效值：
CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | ROLLBACK_IN_PROGRESS | ROLLBACK_FAILED | ROLLBACK_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE - clusterName
-
集群的名称。
类型：字符串
- clusterStatus
-
集群状态。
类型：字符串
有效值：
CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED - region
-
在其中创建集群的 AWS 区域。
类型：字符串
- scheduler
-
- metadata
-
调度器元数据。
- name
-
调度器的名称。
类型：字符串
- 版本
-
调度器版本。
类型：字符串
- type
-
调度器类型。
类型：字符串
- 版本
-
用于创建集群的 AWS ParallelCluster 版本。
类型：字符串
- validationMessages
-
验证级别低于
validationFailureLevel的消息的列表。消息列表是在配置验证期间收集的。- id
-
验证器的 ID。
类型：字符串
- level
-
验证级别。
类型：字符串
有效值：
INFO | WARNING | ERROR - 消息
-
验证消息。
类型：字符串
- type
-
验证器的类型。
类型：字符串
示例
