创建或更新所需节点 API
编辑创建或更新所需节点 API编辑
此功能旨在供 Elasticsearch Service、Elastic Cloud Enterprise 和 Elastic Cloud on Kubernetes 间接使用。不支持直接使用。
创建或更新所需节点。
请求编辑
PUT /_internal/desired_nodes/<history_id>/<version>
{
"nodes" : [
{
"settings" : {
"node.name" : "instance-000187",
"node.external_id": "instance-000187",
"node.roles" : ["data_hot", "master"],
"node.attr.data" : "hot",
"node.attr.logical_availability_zone" : "zone-0"
},
"processors" : 8.0,
"memory" : "58gb",
"storage" : "2tb"
}
]
}
查询参数编辑
-
master_timeout - （可选，时间单位）等待主节点的时间段。如果在超时到期之前主节点不可用，则请求失败并返回错误。默认为
30 秒。也可以设置为-1以指示请求永不超时。 -
dry_run - （可选，布尔值）如果为
true，则请求模拟更新并返回dry_run字段设置为true的响应。
描述编辑
此 API 创建或更新所需节点。外部编排器可以使用此 API 让 Elasticsearch 了解集群拓扑，包括未来的更改，例如添加或删除节点。使用此信息，系统能够做出更好的决策。
可以通过添加 ?dry_run 查询参数以“试运行”模式运行更新。这将验证请求结果，但不会实际执行更新。
示例编辑
在此示例中，将为历史记录为 Ywkh3INLQcuPT49f6kcppA 的所需节点创建新版本。此 API 仅接受单调递增的版本。
PUT /_internal/desired_nodes/Ywkh3INLQcuPT49f6kcppA/100
{
"nodes" : [
{
"settings" : {
"node.name" : "instance-000187",
"node.external_id": "instance-000187",
"node.roles" : ["data_hot", "master"],
"node.attr.data" : "hot",
"node.attr.logical_availability_zone" : "zone-0"
},
"processors" : 8.0,
"memory" : "58gb",
"storage" : "2tb"
}
]
}
API 返回以下结果
{
"replaced_existing_history_id": false,
"dry_run": false
}
此外，还可以指定处理器范围。这在 Elasticsearch 节点可以部署在主机上的环境中很有用，在这些环境中，Elasticsearch 进程可以使用的处理器数量保证至少为下限，最多为上限。这是使用 cgroups 的 Linux 部署中的常见情况。
PUT /_internal/desired_nodes/Ywkh3INLQcuPT49f6kcppA/101
{
"nodes" : [
{
"settings" : {
"node.name" : "instance-000187",
"node.external_id": "instance-000187",
"node.roles" : ["data_hot", "master"],
"node.attr.data" : "hot",
"node.attr.logical_availability_zone" : "zone-0"
},
"processors_range" : {"min": 8.0, "max": 10.0},
"memory" : "58gb",
"storage" : "2tb"
}
]
}