UpdateInstance - 集群升配

调用该接口时，请注意：

• 当实例状态为生效中（activating）、失效（invalid）和冻结（inactive）时，无法变更配置。

• 如果集群负载过高且索引没有副本，同时在升配或者降配过程中存在大量的写入或查询等情况，业务可能会出现偶发的访问超时现象。建议在集群变更前，在客户端访问机制中配置重试机制，以减小对业务的影响。

• 每次只能变更一种类型的节点（数据节点、专有主节点、冷数据节点、协调节点、Kibana 节点、弹性节点）的配置。

• 出于您的集群健康和稳定性的考虑，自 2021 年 5 月起，阿里云 Elasticsearch 已不支持购买 1 核 2 GB 规格、专有主节点的 2 核 2 GB 规格和 7.4 版本实例，如果您已确认已购规格不再支持售卖，那么您需要先完成以下操作：

  • 对于 1 核 2 GB 和 2 核 2 GB 规格，建议提前升配至购买页开放的稳定的售卖规格。购买页开放的售卖规格请参见购买页面参数（商业版）或者购买页面参数（增强版）。

  • 对于 7.4 版本，建议您重新选购 7.10 版本实例，然后再进行数据迁移。数据迁移请参见迁移方案选取指南。

更多注意事项，请参见升配集群和降配集群。

Elasticsearch 支持的节点规格列表，请参见产品规格。

请求体参数示例如下： 升配

• 升配存储空间 目前仅支持数据节点、冷数据节点和弹性数据节点升配存储空间。

  将冷数据节点的存储空间升配至 1000 GiB。

{
  "warmNodeConfiguration": {
   "disk": 1000
  }
}

• 升配存储类型 目前仅支持数据节点、弹性数据节点和专有主节点升配存储类型。

  • 将专有主节点的存储类型升配为 ESSD 云盘类型。

{
  "masterConfiguration": {
    "diskType": "cloud_essd"
  }
}

• 当专有主节点的存储类型为 ESSD 云盘类型时，将节点存储性能级别升配为 PL3。 指定 performanceLevel 后，diskType 会默认填充为cloud_essd。 指定cloud_essd后，performanceLevel 默认为 PL1。

```

{
  "masterConfiguration": {
	"performanceLevel": "PL3"
  }
}
```

• 升配节点数量 目前仅支持数据节点、冷数据节点、弹性数据节点和协调节点升配节点数量。 数据节点升配节点数量的方式与其他节点不同，具体参见下文示例。

  • 将数据节点的节点数量升至 12 个。

{
  "nodeAmount": 12
}

• 将其他类型节点（以冷数据节点为例）的节点数量升至 12 个。

{
  "warmNodeConfiguration": {
    "amount": 12
  }
}

• 升配节点规格 将数据节点的规格升至 4 核 32 GB。

{
  "nodeSpec": {
    "spec": "elasticsearch.r5.xlarge"
  }
}

• 同时升配同一节点的几种配置 同时升配同一节点的几种配置，需要您同时写入升配资源 RequestBody。

  • 将协调节点的节点数量升至 8，规格升至 4 核 8 GB。

{
  "clientNodeConfiguration": {
    "amount": 8,
    "spec": "elasticsearch.sn1ne.xlarge"
  }
}

• 将数据节点的节点数量升至 12，存储类型升至 ESSD 云盘。

{
  "nodeAmount": 12,
  "nodeSpec": {
    "diskType": "cloud_essd"
  }
}

• 启用节点 您可以参见 createInstance 接口设置完整的节点资源配置。

  • 启用协调节点，同时设置协调节点配置。

{
  "clientNodeConfiguration": {
    "amount": 5,
    "disk": 20,
    "spec": "elasticsearch.sn1ne.xlarge"
  }
}

• 启用弹性数据节点，同时设置弹性数据节点配置（此配置只适用于中国站）。

{
  "elasticNodeConfiguration": {
    "disk": 200,
    "amount": 5,
    "diskType": "cloud_essd",
    "spec": "elasticsearch.sn1ne.xlarge"
  }
}

• 启用冷数据节点，同时设置冷数据节点配置。

{
  "warmNodeConfiguration": {
    "disk": 1000,
    "amount": 3,
    "spec": "elasticsearch.sn1ne.xlarge"
  }
}

• 升配开启 OpenStore（此配置只适用于中国站） 已启用冷数据节点的实例以及数据节点存储类型为 ESSD 云盘的实例，目前不支持升配开启 OpenStore。 如果实例类型为普通商业版，升配开启 OpenStore 后，实例类型同时由普通商业版升配至开启 Indexing Service 的日志增强版。

  • 冷数据节点打开 OpenStore。

{
  "warmNodeConfiguration": {
    "amount": 5,
    "spec": "openstore.i2g.4xlarge"
  }
}

• 数据节点规格转换为 OpenStore。

{
  "nodeAmount": 6,
  "nodeSpec": {
    "spec": "openstore.i2g.4xlarge",
    "diskType": "cloud_ssd",
    "disk": 100
  }
}

• 指定变更方式

  • 变更方式默认为智能变更，将其指定为蓝绿变更（blue_green）或原地变更（normal）。

{
  "nodeSpec": {
    "spec": "elasticsearch.r5.xlarge"
  },
  "updateType": "blue_green"  ## 原地变更为 normal。
}

• 开启强制变更。

{
  "nodeSpec": {
    "spec": "elasticsearch.r5.xlarge"
  },
  "force": true
}

• 使用 dryRun 接口进行升配预校验 在 RequestBody 中添加 dryRun 字段。

{
  "nodeSpec": {
    "spec": "elasticsearch.r5.xlarge"
  },
  "dryRun": true
}

降配

• 降配存储类型 降配时，不支持变更冷数据节点（不变更实例类型）、协调节点、Kibana 节点的存储类型。

将专有主节点的存储类型变更为 SSD 云盘。

{
  "masterConfiguration": {
    "diskType": "cloud_ssd"
  }
}

• 降配规格 将数据节点的规格降配至 4 核 32 GB。

{
  "nodeSpec": {
    "spec": "elasticsearch.r5.xlarge"
  }
}