Link Search Menu Expand Document Documentation Menu
文档

创建索引

1.0 版引入

虽然您可以使用文档作为基础创建索引，但您也可以创建空索引以供后续使用。

创建索引时，您可以指定其映射、设置和别名。

端点

PUT <index>

索引命名限制

OpenSearch 索引有以下命名限制：

  • 所有字母必须是小写。
  • 索引名称不能以下划线 (_) 或连字符 (-) 开头。

  • 索引名称不能包含空格、逗号或以下字符：

    :、"、*、+、/、\、|、?、#、> 或 <

路径参数

参数 数据类型 描述
索引 字符串 索引名称。必须符合索引命名限制。必需。

查询参数

您可以在请求中包含以下查询参数。所有参数都是可选的。

参数 类型 描述
wait_for_active_shards 字符串 指定在 OpenSearch 处理请求之前必须可用的活动分片数量。默认值为 1（仅主分片）。设置为 all 或正整数。大于 1 的值需要副本。例如，如果您指定值为 3，则索引必须有两个副本分布在两个额外的节点上，请求才能成功。
cluster_manager_timeout 时间 等待连接到集群管理器节点的时间。默认值为 30s。
timeout 时间 等待请求返回的时间。默认值为 30s。

请求正文

作为请求的一部分，您可以选择指定索引设置、映射、别名和索引上下文。

请求示例

PUT /sample-index1
{
  "settings": {
    "index": {
      "number_of_shards": 2,
      "number_of_replicas": 1
    }
  },
  "mappings": {
    "properties": {
      "age": {
        "type": "integer"
      }
    }
  },
  "aliases": {
    "sample-alias1": {}
  }
}

剩余 350 字符

有问题？。

想贡献？或。