CosmosDB REST API 一些细节

背景

由于Azure CosmosDB（DocumentDB） SDK 的局限性，在Ruby 中使用的话用官方REST API 比较方便，但官方文档对于API的教程描述的不是很直白，老外朋友们也是各种问题~以至于使用时各种错误，400 , 401 ,404 … 在通过各种被坑，及脱坑后，做下总结。

1 . Authorization 认证

出现最多的问题就是它，无论哪种资源的请求，Header必须添加该属性，
生成方式官方有Code。进入 Access Control .
值得注意的是Resource Token 的生成是根据你URL 及要访问的资源而区分的。
如： dbs/ToList dbs/ToList/colls/sample 对应的Resource Link（id） ：
就是db 及coll 的id 而不是r_id. Resource Type 是请求资源的逻辑存储名称，如： dbs colls docs .

2. Partition Key

如果你的Collection 设置了Partition Key 这里对该集合中的Document的操作会有些变化.
如: Get a Document 则需要为Header添加x-ms-documentdb-Partition key 属性，其值为 Array 。Item 为需要获取的Document对应的Partition Key value.

3. GitHub 上的Code

REST API version 的一些升级，目前Google到的资源有些请求都不能用了，如果测试的话不推荐去细读.

4. 建议

官方的介绍视频该Video 时长很短，强烈建议认真去看一遍。
如果Response 出错了的话不推荐在代码中去修改。可以用Rest API 的一些测试工具。
有很多。
个人用的是Postman, 官方有该工具测试的Import File ， Git下来直接设置下环境变量就可以测试了。(●’◡’●)

5 . 官方文档