調(diào)用CreateDataStream，創(chuàng)建數(shù)據(jù)流。僅適用于日志增強(qiáng)版實(shí)例。

說(shuō)明 您創(chuàng)建的數(shù)據(jù)流名稱需要與索引模板中的索引模式一一對(duì)應(yīng)，且該索引模板已開啟數(shù)據(jù)流。例如：索引模板中的索引模式為ds-*，則對(duì)應(yīng)的數(shù)據(jù)流名稱應(yīng)該為ds-。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

請(qǐng)求頭

該接口使用公共請(qǐng)求頭，無(wú)特殊請(qǐng)求頭。請(qǐng)參見(jiàn)公共請(qǐng)求參數(shù)文檔。

請(qǐng)求語(yǔ)法

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

請(qǐng)求參數(shù)

名稱 類型 位置 是否必選 示例值 描述
InstanceId String Path 是 es-cn-nif24adwc0082****

實(shí)例ID。
ClientToken String Query 否 5A2CFF0E-5718-45B5-9D4D-70B3FF***

用于保證請(qǐng)求的冪等性。由客戶端生成該參數(shù)值，要保證在不同請(qǐng)求間唯一，最大不超過(guò)64個(gè)ASCII字符。

RequestBody中需要填入以下參數(shù)，用來(lái)指定待創(chuàng)建數(shù)據(jù)流。

參數(shù)

類型

是否必填

示例值

描述

name

String

是

ds-

數(shù)據(jù)流名稱。

返回?cái)?shù)據(jù)

名稱 類型 示例值 描述
RequestId String F99407AB-2FA9-489E-A259-40CF6DCC****

請(qǐng)求ID。
Result Object

返回創(chuàng)建的數(shù)據(jù)流名稱。
name String ds-

數(shù)據(jù)流名稱。
說(shuō)明
  • 當(dāng)系統(tǒng)返回【DatastreamUnmatchedIndexTemplateError】消息時(shí)，表示數(shù)據(jù)流沒(méi)有匹配的索引模板，請(qǐng)修改數(shù)據(jù)流名稱，或前往索引模板管理進(jìn)行創(chuàng)建或修改。
  • 當(dāng)系統(tǒng)返回【DatastreamDuplicatedError】消息時(shí)，表示數(shù)據(jù)流已經(jīng)存在時(shí)，請(qǐng)重新命名，或前往索引模板管理進(jìn)行創(chuàng)建或修改。

示例

請(qǐng)求示例

POST /openapi/instances/es-cn-nif24adwc0082****/data-streams HTTP/1.1
公共請(qǐng)求頭
{
  "name": "ds-"
}

正常返回示例

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

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

錯(cuò)誤碼

訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。