## 索引一個文檔 文檔通過`index` API被索引——使數據可以被存儲和搜索。但是首先我們需要決定文檔所在。正如我們討論的，文檔通過其`_index`、`_type`、`_id`唯一確定。們可以自己提供一個`_id`，或者也使用`index` API 為我們生成一個。 ### 使用自己的ID 如果你的文檔有自然的標識符（例如`user_account`字段或者其他值表示文檔），你就可以提供自己的`_id`，使用這種形式的`index` API： ```Javascript PUT /{index}/{type}/{id} { "field": "value", ... } ``` 例如我們的索引叫做`“website”`，類型叫做`“blog”`，我們選擇的ID是`“123”`，那么這個索引請求就像這樣： ```Javascript PUT /website/blog/123 { "title": "My first blog entry", "text": "Just trying this out...", "date": "2014/01/01" } ``` Elasticsearch的響應： ```Javascript { "_index": "website", "_type": "blog", "_id": "123", "_version": 1, "created": true } ``` 響應指出請求的索引已經被成功創建，這個索引中包含`_index`、`_type`和`_id`元數據，以及一個新元素：`_version`。 Elasticsearch中每個文檔都有版本號，每當文檔變化（包括刪除）都會使`_version`增加。在《版本控制》章節中我們將探討如何使用`_version`號確保你程序的一部分不會覆蓋掉另一部分所做的更改。 ### 自增ID 如果我們的數據沒有自然ID，我們可以讓Elasticsearch自動為我們生成。請求結構發生了變化：`PUT`方法——`“在這個URL中存儲文檔”`變成了`POST`方法——`"在這個類型下存儲文檔"`。（譯者注：原來是把文檔存儲到某個ID對應的空間，現在是把這個文檔添加到某個`_type`下）。 URL現在只包含`_index`和`_type`兩個字段： ```Javascript POST /website/blog/ { "title": "My second blog entry", "text": "Still trying this out...", "date": "2014/01/01" } ``` 響應內容與剛才類似，只有`_id`字段變成了自動生成的值： ```Javascript { "_index": "website", "_type": "blog", "_id": "wM0OSFhDQXGZAWDf0-drSA", "_version": 1, "created": true } ``` 自動生成的ID有22個字符長，URL-safe, Base64-encoded string universally unique identifiers, 或者叫 [UUIDs](http://en.wikipedia.org/wiki/Uuid)。