创建指定名称的index。
命令样例如下：
curl -X PUT "https://localhost:9200/testindex_002?pretty" -H 'Content-Type: application/json' -d'
{
"settings": {
"index": {
"number_of_shards": 3,
"number_of_replicas": 2
}
}
}
' --cacert $ES_HOME/config/certs/http_ca.crt -u "elastic:ohCxPH=QBE+s5=*lo7F9"
或者
curl -X PUT "https://localhost:9200/testindex_002?pretty" -H 'Content-Type: application/json' -d'
{
"settings": {
"number_of_shards": 3,
"number_of_replicas": 2
}
}
' --cacert $ES_HOME/config/certs/http_ca.crt -u "elastic:ohCxPH=QBE+s5=*lo7F9"
执行结果的样例，如下：
{
"acknowledged" : true,
"shards_acknowledged" : true,
"index" : "testindex_002"
}
index的名称
有如下规范：
- 只允许使用小写字母。
- 不允许使用特殊字符，如下：
\/*?"<>|- 空格
,#- 仅在7.0之前的版本，允许使用
:。
- 不允许使用如下字符作为开头：
-_+
- 不允许使用
.和..。 - 名称的长度小于255个字节，注意不是字符。
- 使用
.作为开头的index，仅供ElasticSearch内部使用。
方法参数
wait_for_active_shards，默认值为1，即主分片。
可能取值为all或者大于0小于number_of_replicas+1的正整数，表示等待收到响应的分片的数量。
命令样例如下：
curl -X PUT "https://localhost:9200/testindex_003?pretty" -H 'Content-Type: application/json' -d'
{
"settings": {
"index.number_of_shards": 3,
"index.number_of_replicas": 2,
"index.write.wait_for_active_shards": "2"
}
}
' --cacert $ES_HOME/config/certs/http_ca.crt -u "elastic:ohCxPH=QBE+s5=*lo7F9"
或者
curl -X PUT "https://localhost:9200/testindex_003?wait_for_active_shards=2&pretty" -H 'Content-Type: application/json' -d'
{
"settings": {
"index.number_of_shards": 3,
"index.number_of_replicas": 2
}
}
' --cacert $ES_HOME/config/certs/http_ca.crt -u "elastic:ohCxPH=QBE+s5=*lo7F9"
执行结果的样例，如下：
{
"acknowledged" : true,
"shards_acknowledged" : false,
"index" : "testindex_003"
}
方法的请求消息体
在创建index时，允许指定：
index的工作参数。index的字段的映射及参数。index的别名。
方法的响应消息体
acknowledged
在超时前，创建请求的结果。
true，创建成功。false，在超时前，未能完成创建，但创建操作并未停止。
shards_acknowledged
在超时前，创建请求的结果。
true，各分片均返回创建成功。false，在超时前，未能完成创建，但创建操作并未停止。
相关资料
- Create index API
- Index API
- Mapping
- Field data types
- Mapping parameters
- Index modules
