CreateDataStream - 创建数据流-检索分析服务 Elasticsearch版(ES)-阿里云帮助中心

接口说明

说明

您创建的数据流名称需要与索引模板中的索引模式一一对应，且该索引模板已开启数据流。例如：索引模板中的索引模式为 ds-*，则对应的数据流名称应该为 ds-。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

elasticsearch:CreateDataStream

none

*全部资源

*

无

POST /openapi/instances/{InstanceId}/data-streams HTTP/1.1

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID。	es-cn-nif24adwc0082****

名称	类型	必填	描述	示例值
ClientToken	string	否	用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大不超过 64 个 ASCII 字符。	5A2CFF0E-5718-45B5-9D4D-70B3FF***
body	string	否	待创建的数据流名称，采用 JSON 字符串表示。	{"name":"ds-"}

RequestBody 中需要填入以下参数，用来指定待创建数据流。

参数	类型	是否必填	示例值	描述
name	String	是	ds-	数据流名称。

说明

当系统返回【DatastreamUnmatchedIndexTemplateError】消息时，表示数据流没有匹配的索引模板，请修改数据流名称，或前往索引模板管理进行创建或修改。- 当系统返回【DatastreamDuplicatedError】消息时，表示数据流已经存在时，请重新命名，或前往索引模板管理进行创建或修改。

正常返回示例

JSON格式

{
  "RequestId": "F99407AB-2FA9-489E-A259-40CF6DCC****",
  "Result": {
    "name": "ds-"
  }
}

访问错误中心查看更多错误码。

更多信息，参考变更详情。