Elasticsearch API汇总 - 检索分析服务Elasticsearch版

本文为您提供阿里云Elasticsearch、Kibana、Logstash和Beats的API接口及说明。如果您需要使用本文中没有提到的接口，请联系阿里云技术支持工程师获取。

Elasticsearch

类别	API	描述
实例管理	createInstance	创建Elasticsearch实例。
	ListInstance	在列表中展示所有或指定实例的详细信息。
	DescribeInstance	查询指定实例的详细信息。
	EstimatedRestartTime	获取重启实例的预估时间。
	RestartInstance	重启指定实例。
	UpdateInstanceChargeType	将按量付费实例转换为包年包月实例。
	UpdateDescription	更新指定实例的名称。
	DeleteInstance	释放指定按量付费类型的实例。释放后，实例所使用的物理资源都被回收，相关数据全部丢失且不可恢复；挂载实例节点的云盘和相应的快照都会被释放。
	CancelDeletion	恢复释放后被冻结的实例。
	RenewInstance	为包年包月实例续费。
	ActivateZones	恢复已下线的可用区中的节点。仅对多可用区实例有效。
	DeactivateZones	在有多个可用区的情况下，下线部分可用区。并将下线的可用区中的节点迁移到其他可用区。
	DescribeRegions	获取阿里云Elasticsearch的地域信息。
	InterruptElasticsearchTask	中断变更中的实例。仅对状态为生效中的实例有效，中断后，实例进入变更中断（suspended）状态。
	ResumeElasticsearchTask	恢复中断变更的实例。
	ListAllNode	获取集群下的所有节点信息。
	DescribeElasticsearchHealth	获取指定实例的健康情况。
	ListInstanceIndices	获取集群的索引列表。
	MigrateToOtherZone	迁移对应可用区下的节点到目标可用区。
	MoveResourceGroup	迁移实例到指定资源组。
	ModifyInstanceMaintainTime	更改并开启实例的可维护时间。
	GetRegionConfiguration	获取当前地域的开放配置信息。接口返回值为全量数据供参考，以控制台和售卖页实际展示值为准。
	ListShardRecoveries	获取有关正在进行和已完成的分片恢复的数据进度列表，默认返回正在进行的分片恢复信息。
	CapacityPlan	用于系统根据业务场景、QPS和日志产生量等情况为您推荐集群容量规划的最佳配置信息。
标签管理	ListTags	查询所有可见的用户标签。
	ListTagResources	查询可见的资源标签关系。
	TagResources	创建标签资源关系。
	UntagResources	删除用户资源标签关系。
数据迁移	GetTransferableNodes	指定节点类型和个数，获取可进行数据迁移的节点。
	ValidateTransferableNodes	校验是否可以迁移指定实例中某些节点上的数据。
	TransferNode	执行数据迁移任务。
	ListDataTasks	获取数据迁移任务信息。
	CreateDataTasks	创建索引迁移任务，将所选集群中的数据迁移到当前集群。
	GetClusterDataInformation	获取集群的数据信息。
	DeleteDataTask	删除索引迁移任务。
	CancelTask	取消数据迁移任务。
实例升降配	GetSuggestShrinkableNodes	指定节点类型和数量，获取可缩容的节点。
	ValidateShrinkNodes	校验指定实例中的某些节点是否可以缩容。
	ShrinkNode	执行集群节点缩容操作。
	UpgradeEngineVersion	升级实例版本或内核补丁版本。升级实例版本功能仅支持将6.3版本的实例升级至6.7版本。
	UpdateInstance	变更集群配置（升配或降配）。
集群配置	UpdateInstanceSettings	更新指定实例的YML参数配置。
	UpdateHotIkDicts	更新指定实例的IK热词词典。
	UpdateSynonymsDicts	更新指定实例的同义词词典。
	UpdateDict	冷更新阿里云Elasticsearch实例的IK分词插件，包括IK主分词词库和IK停用词词库。
	UpdateAliwsDict	更新AliNLP分词插件（analysis-aliws）的词典文件。支持自定义词库配置。
	ListDictInformation	在添加用户OSS存储的词典文件时，获取和校验用户OSS词典文件的详情。
	UpdateAdvancedSetting	更改指定实例的垃圾回收器配置。
	ListDicts	获取指定类型的词典详情以及签名生成的公网可下载链接。
插件管理	ListPlugins	获取指定实例的插件列表。
	InstallSystemPlugin	安装系统预置插件。
	UninstallPlugin	卸载已安装的预置插件。
	InstallUserPlugins	安装用户自定义的已经上传至Elasticsearch控制台的插件。
日志查询	ListSearchLog	查看实例日志。
安全配置	TriggerNetwork	开启或关闭Elasticsearch、Kibana的公网或私网访问。
	UpdatePrivateNetworkWhiteIps	更新指定实例的VPC私网访问白名单。
	UpdatePublicWhiteIps	更新指定实例的公网地址访问白名单。
	UpdatePublicNetwork	开启或关闭指定实例的公网地址。
	UpdateWhiteIps	更新指定实例的VPC私网访问白名单。
	ModifyWhiteIps	更新指定实例的访问白名单。
	UpdateAdminPassword	更新指定实例的elastic账号的密码。
	OpenHttps	开启HTTPS协议。除8.5版本、7.16版本外，开启前请确保您已购买协调节点。
	CloseHttps	关闭HTTPS协议。
	AddConnectableCluster	配置实例网络互通。
	DeleteConnectedCluster	移除互通实例。
	DescribeConnectableClusters	获取能够与当前实例进行网络互通的实例列表。不包括已经打通的实例。
	ListConnectedClusters	获取已经与当前实例进行了网络互通的实例列表。
	CreateVpcEndpoint	创建服务账号VPC下的终端节点，用于连接用户VPC下的终端节点服务，以单向打通网络。
	DeleteVpcEndpoint	删除服务VPC下的终端节点。
	ListVpcEndpoints	查看服务VPC下的终端节点状态。
数据备份	CreateSnapshot	手动对集群进行快照备份。
	DescribeSnapshotSetting	获取集群的数据备份配置。
	UpdateSnapshotSetting	更新指定实例的数据备份配置。
	ListSnapshotReposByInstanceId	获取当前实例的跨集群OSS仓库设置列表。
	ListAlternativeSnapshotRepos	获取当前实例可添加的OSS引用仓库。
	AddSnapshotRepo	在设置跨集群OSS仓库时，创建引用仓库。
	DeleteSnapshotRepo	删除一个跨集群OSS引用仓库。
智能运维	OpenDiagnosis	打开实例的智能运维功能。
	CloseDiagnosis	关闭实例的智能运维功能。
	DiagnoseInstance	即刻诊断实例。
	ListDiagnoseReport	获取智能运维的历史报告。
	ListDiagnoseReportIds	获取智能运维历史报告的ID。
	ListDiagnoseIndices	获取指定实例智能运维模块中，健康诊断的诊断索引。
	DescribeDiagnoseReport	查看智能运维的历史报告。
	DescribeDiagnosisSettings	获取智能运维的场景设置。
	UpdateDiagnosisSettings	更新实例的智能运维场景设置。

Kibana

API	描述
DescribeKibanaSettings	获取Kibana配置。
UpdateKibanaSettings	修改Kibana配置。目前仅支持修改Kibana语言配置。
ListKibanaPlugins	获取Kibana插件列表。
InstallKibanaSystemPlugin	安装Kibana预置插件。要求Kibana的规格为2核4 GB及以上。
UninstallKibanaPlugin	卸载Kibana插件。
UpdateKibanaWhiteIps	更新指定实例的Kibana访问白名单。

Logstash

类别	API	描述
实例管理	CreateLogstash	创建Logstash实例。
	ListLogstash	在列表中展示所有或指定Logstash实例的详细信息。
	DescribeLogstash	查询指定实例的详细信息。
	UpdateLogstash	修改指定实例的部分信息，例如节点数、配额、名称、硬盘大小等。
	RenewLogstash	为实例续费。
	RestartLogstash	重启指定实例。重启后，实例会进入生效中（activating）状态。
	UpdateLogstashDescription	修改指定实例的名称。
	UpdateLogstashChargeType	将按量付费的阿里云Logstash实例转换为包年包月实例。
	EstimatedLogstashRestartTime	获取Logstash实例重启的预估时间。
	DeleteLogstash	释放指定实例。
	CancelLogstashDeletion	恢复释放后被冻结的Logstash实例。
集群配置	UpdateLogstashSettings	更新指定Logstash实例的配置。
	ListExtendfiles	获取Logstash实例的扩展文件配置。
	UpdateExtendfiles	更新Logstash实例的扩展文件配置。
集群监控	ListAvailableEsInstanceIds	在设置Logstash实例的X-Pack监控时，获取可用的Elasticsearch实例列表（具备X-Pack监控能力）。
	ValidateConnection	在Logstash实例的监控报警配置中，验证提供X-Pack监控的Elasticsearch实例的联通性。
	UpdateXpackMonitorConfig	更新Logstash实例的X-Pack监控报警配置。
	DescribeXpackMonitorConfig	获取Logstash实例的X-Pack监控配置。
插件管理	ListLogstashPlugins	获取所有或指定插件的详细信息。
	InstallLogstashSystemPlugin	安装插件。
	UninstallLogstashPlugin	卸载已安装的插件。
日志查询	ListLogstashLog	查看Logstash实例的日志。
变更任务管理	InterruptLogstashTask	中断实例变更任务。中断后，实例会进入中断中（suspended）状态。
变更任务管理	ResumeLogstashTask	恢复实例的变更中断任务。恢复后实例会进入生效中（activating）状态。
管道管理	CreatePipelines	创建Logstash管道。
	ListPipeline	获取Logstash实例的管道列表。
	DescribePipeline	获取Logstash实例的管道信息。
	UpdatePipelines	更新Logstash管道信息。
	RunPipelines	立即部署Logstash管道。
	StopPipelines	停止运行Logstash管道。
	UpdatePipelineManagementConfig	更新Logstash管道管理方式。
	DescribePipelineManagementConfig	获取Logstash管道管理配置。
	DeletePipelines	删除指定的Logstash管道。
	ListPipelineIds	设置Kibana管道管理时，测试Logstash与Kibana连通性，并获取目标Kibana上创建的管道ID列表。

Beats

API	描述
CreateCollector	创建采集器。
DescribeCollector	获取采集器实例的详细信息。
ReinstallCollector	重试安装在创建时没有安装成功的采集器。
ListCollectors	获取采集器列表信息。
ListDefaultCollectorConfigurations	获取采集器的默认配置文件。
UpdateCollectorName	修改采集器名称。
UpdateCollector	更新采集器实例信息。
StartCollector	启动采集器。
RestartCollector	重启采集器。
StopCollector	停止运行中的采集器。
DeleteCollector	删除采集器。
ListEcsInstances	获取ECS机器列表。
ModifyDeployMachine	更新采集器安装的ECS机器。
ListNodes	查看安装采集器的ECS机器的状态。
ListAckClusters	获取容器服务Kubernetes版ACK（Container Service for Kubernetes）集群列表。
ListAckNamespaces	查看指定容器服务Kubernetes版ACK集群的所有命名空间。
DescribeAckOperator	查看指定容器服务Kubernetes版ACK集群上安装的Elasticsearch Operator信息。
InstallAckOperator	在指定容器服务Kubernetes版ACK集群上安装Elasticsearch Operator。

访问控制

API	描述
InitializeOperationRole	创建服务关联角色。
ValidateSlrPermission	验证是否已经创建服务关联角色。