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

Elasticsearch

类别

API

描述

实例管理

createInstance

创建Elasticsearch实例。

ListInstance

在列表中展示所有或指定实例的详细信息。

DescribeInstance

查询指定实例的详细信息。

EstimatedRestartTime

获取重启实例的预估时间。

RestartInstance

重启指定实例。

UpdateInstanceChargeType

将按量付费实例转换为包年包月实例。

UpdateDescription

更新指定实例的名称。

DeleteInstance

释放指定按量付费类型的实例。释放后,实例所使用的物理资源都被回收,相关数据全部丢失且不可恢复;挂载实例节点的云盘和相应的快照都会被释放。

CancelDeletion

恢复释放后被冻结的实例。

RenewInstance

为包年包月实例续费。

ActivateZones

恢复已下线的可用区中的节点。仅对多可用区实例有效。

DeactivateZones

在有多个可用区的情况下,下线部分可用区。并将下线的可用区中的节点迁移到其他可用区。

DescribeRegions

获取阿里云Elasticsearch的地域信息。

UpdateReadWritePolicy

开启或关闭集群的写入高可用特性。目前仅支持华北2(北京)地域的实例。

InterruptElasticsearchTask

中断变更中的实例。仅对状态为生效中的实例有效,中断后,实例进入变更中断(suspended)状态。

ResumeElasticsearchTask

恢复中断变更的实例。

ListAllNode

获取集群下的所有节点信息。

DescribeElasticsearchHealth

获取指定实例的健康情况。

GetElastictask

获取集群的弹性扩缩容规则。必须在创建实例时购买弹性节点,才可调用此接口。

ModifyElastictask

更新集群弹性扩缩容规则。

ListInstanceIndices

获取集群的索引列表。

MigrateToOtherZone

迁移对应可用区下的节点到目标可用区。

MoveResourceGroup

迁移实例到指定资源组。

ModifyInstanceMaintainTime

更改并开启实例的可维护时间。

GetRegionConfiguration

获取当前地域的开放配置信息。接口返回值为全量数据供参考,以控制台和售卖页实际展示值为准。

ListShardRecoveries

获取有关正在进行和已完成的分片恢复的数据进度列表,默认返回正在进行的分片恢复信息。

CapacityPlan

用于系统根据业务场景、QPS和日志产生量等情况为您推荐集群容量规划的最佳配置信息。

GetOpenStoreUsage

统计OpenStore实例的存储容量和使用情况。

CreateComponentIndex

创建Elasticsearch组合模板。

ListComponentIndices

获取Elasticsearch的组合模板列表。

DescribeComponentIndex

查看Elasticsearch的组合模板详情。

UpdateComponentIndex

更新Elasticsearch的组合模板。

DeleteComponentIndex

删除Elasticsearch的组合模板。

ListDeprecatedTemplates

查看历史索引模板列表。

DescribeDeprecatedTemplate

查看历史索引模板详情。

DeleteDeprecatedTemplate

删除历史索引模板。

标签管理

ListTags

查询所有可见的用户标签。

ListTagResources

查询可见的资源标签关系。

TagResources

创建标签资源关系。

UntagResources

删除用户资源标签关系。

数据迁移

GetTransferableNodes

指定节点类型和个数,获取可进行数据迁移的节点。

ValidateTransferableNodes

校验是否可以迁移指定实例中某些节点上的数据。

TransferNode

执行数据迁移任务。

ListDataTasks

获取数据迁移任务信息。

CreateDataTasks

创建索引迁移任务,将所选集群中的数据迁移到当前集群。

GetClusterDataInformation

获取集群的数据信息。

DeleteDataTask

删除索引迁移任务。

CancelTask

取消数据迁移任务。

实例升降配

GetSuggestShrinkableNodes

指定节点类型和数量,获取可缩容的节点。

ValidateShrinkNodes

校验指定实例中的某些节点是否可以缩容。

ShrinkNode

执行集群节点缩容操作。

UpgradeEngineVersion

升级Elasticsearch的实例版本或内核补丁版本。升级实例版本功能目前只支持5.5.3版本升级到5.6.16版本、5.6.16版本升级到6.3.2版本、6.3.2版本升级到6.7.0版本,暂不支持其他版本间的升级。详情请参见升级版本

UpdateInstance

变更集群配置(升配或降配)。

集群配置

UpdateInstanceSettings

更新指定实例的YML参数配置。

UpdateHotIkDicts

更新指定实例的IK热词词典。

UpdateSynonymsDicts

更新指定实例的同义词词典。

UpdateDict

更新指定实例的用户词典。

UpdateAliwsDict

更新指定实例AliNLP分词插件(analysis-aliws)的词典文件。支持自定义词库配置。

ListDictInformation

在添加用户OSS存储的词典文件时,获取和校验用户OSS词典文件的详情。

UpdateAdvancedSetting

更改指定实例的垃圾回收器配置。

DescribeTemplates

获取指定实例的场景模板配置。

UpdateExtendConfig

修改集群的场景化配置模板。

UpdateTemplate

修改集群的场景化模板配置内容。

RecommendTemplates

获取推荐的集群配置。

ListDicts

获取指定类型的词典详情以及签名生成的公网可下载链接。

插件管理

ListPlugins

获取指定实例的插件列表。

InstallSystemPlugin

安装系统预置插件。

UninstallPlugin

卸载已安装的预置插件。

InstallUserPlugins

安装用户自定义的已经上传至Elasticsearch控制台的插件。

集群监控

GetEmonMonitorData

查询实例的Grafana指标监控数据。

GetEmonGrafanaDashboards

获取Grafana大盘列表。

GetEmonGrafanaAlerts

获取Grafana报警列表。

PostEmonTryAlarmRule

发送测试的报警消息。

日志查询

ListSearchLog

查看实例日志。

安全配置

TriggerNetwork

开启或关闭Elasticsearch、Kibana的公网或私网访问。

UpdatePrivateNetworkWhiteIps

更新指定实例的VPC私网访问白名单。

UpdatePublicWhiteIps

更新指定实例的公网地址访问白名单。

UpdatePublicNetwork

开启或关闭指定实例的公网地址。

UpdateWhiteIps

更新指定实例的VPC私网访问白名单。

ModifyWhiteIps

更新指定实例的访问白名单。

UpdateAdminPassword

更新指定实例的elastic账号的密码。

OpenHttps

开启HTTPS协议。除8.5版本、7.16版本和部分地域的7.10版本外,开启前请确保您已购买协调节点。

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

更新实例的智能运维场景设置。

索引管理

CreateIndexTemplate

创建集群索引模板,可用于索引模板的组件化设置。

DeleteIndexTemplate

删除索引模板。

UpdateIndexTemplate

更新索引模板的组件化设置。

DescribeIndexTemplate

查看组件索引模板详情,包括索引生命周期。

ListIndexTemplates

查询索引模板列表。

DescribeILMPolicy

查询指定索引生命周期详情。

ListILMPolicies

查询已有的索引生命周期策略列表。

CreateILMPolicy

创建索引生命周期策略。

DeleteILMPolicy

删除指定的生命周期策略定义。

UpdateILMPolicy

修改索引生命周期策略。

CreateDataStream

创建数据流。

DeleteDataStream

删除数据流。

RolloverDataStream

手动滚动更新数据流下的匹配索引。进行此操作后,将为当前数据流创建一个新的索引,该索引将成为数据流的新写索引。

ListDataStreams

查看数据流列表。

CloseManagedIndex

关闭Indexing Service集群中某个索引的云端托管功能。此功能不可逆,关闭后无法再开启。

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

描述

ListInstanceHistoryEvents

查看Elasticsearch集群触发的硬件运维事件列表。

RebootInstanceNode

重启阿里云Elasticsearch中的ECS节点。

APM

API

描述

StartApm

调用StartApm,启动APM Server实例。

StopApm

调用StopApm,停止APM Server实例。

RemoveApm

调用RemoveApm,删除APM Server实例。

UpdateApm

调用UpdateApm,修改APM Server实例配置信息。

ListApm

调用ListApm,查询所有APM Server实例详情。

DescribeApm

调用DescribeApm,获取指定APM Server实例详情。

访问控制

API

描述

InitializeOperationRole

创建服务关联角色。

ValidateSlrPermission

验证是否已经创建服务关联角色。