調用CreateDataStream，創建數據流。僅適用于日志增強版實例。
說明 您創建的數據流名稱需要與索引模板中的索引模式一一對應，且該索引模板已開啟數據流。例如：索引模板中的索引模式為ds-*，則對應的數據流名稱應該為ds-。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求頭
該接口使用公共請求頭，無特殊請求頭。請參見公共請求參數文檔。
請求語法
POST /openapi/instances/{InstanceId}/data-streams HTTP/1.1請求參數
| 名稱 | 類型 | 位置 | 是否必選 | 示例值 | 描述 |
|---|---|---|---|---|---|
| InstanceId | String | Path | 是 | es-cn-nif24adwc0082**** |
實例ID。 |
| ClientToken | String | Query | 否 | 5A2CFF0E-5718-45B5-9D4D-70B3FF*** |
用于保證請求的冪等性。由客戶端生成該參數值，要保證在不同請求間唯一，最大不超過64個ASCII字符。 |
RequestBody中需要填入以下參數，用來指定待創建數據流。
|
參數 |
類型 |
是否必填 |
示例值 |
描述 |
|---|---|---|---|---|
|
name |
String |
是 |
ds- |
數據流名稱。 |
返回數據
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | F99407AB-2FA9-489E-A259-40CF6DCC**** |
請求ID。 |
| Result | Object |
返回創建的數據流名稱。 |
|
| name | String | ds- |
數據流名稱。 |
說明
- 當系統返回【DatastreamUnmatchedIndexTemplateError】消息時，表示數據流沒有匹配的索引模板，請修改數據流名稱，或前往索引模板管理進行創建或修改。
- 當系統返回【DatastreamDuplicatedError】消息時，表示數據流已經存在時，請重新命名，或前往索引模板管理進行創建或修改。
示例
請求示例
POST /openapi/instances/es-cn-nif24adwc0082****/data-streams HTTP/1.1
公共請求頭
{
"name": "ds-"
}正常返回示例
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "F99407AB-2FA9-489E-A259-40CF6DCC****",
"Result" : {
"name" : "ds-"
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。