Azure CosmosDB REST创建文档时出错

Question

尝试使用REST API创建文档时，出现以下错误：

The input content is invalid because the required properties - 'id; ' - are missing

在各种SDK中，有一个可选参数要包含，disableAutomaticID生成，如果设置为true则如果未提供ID，将拒绝带有此错误的请求。我提出了一个非常简单的REST请求，所以我自己没有添加这个参数（我甚至不知道我会添加什么头——大概是头——因为RESTAPI的文档没有涵盖它）。

唯一需要注意的是，集合有一个定义的分区键。我找不到任何文档说如果定义了分区键就需要一个ID，但是情况似乎就是这样。

除非有人能回答为什么会发生这种情况，否则我将考虑我的“必须定义如果分区键定义”的答案。

下面的请求(不是裸HTTP，但那些是内容):

{
    "headers": {
        "content-type": "application/json",
        "x-ms-version": "2017-02-22",
        "x-ms-date": "Mon, 25 Mar 2019 17:57:03 GMT"
    },
    "body": {
        "data": "myData",
        // "id": "some_id" //I don't want to do this because I want Cosmos to auto-generate this like when I create a document in the Portal!
    },
    "method": "post",
    "url": "https://my-database-server.documents.azure.com/dbs/MyDatabase/colls/MyCollection/docs"
}

还有几个问题需要解决...

创建文档文档说明需要id，因此门户可能实际上是在浏览器端创建它，然后将其包含在请求中，但如果是这样，为什么SDK中存在disableAutomaticIdGeneration选项？

同样，同样的文件说明（突出显示是我的）：

它是标识文档的唯一id，也就是说，没有两个文档应该共享同一个ID。id不得超过255个字符。在未指定ID值的情况下创建文档时，会自动添加ID字段。但是，您始终可以通过在请求正文中为ID值分配一个自定义值来更新它。

通过粗体部分，似乎需要键id，但也许我可以传递null或空字符串？但是，我尝试了这两种方法，两次都出现错误（一个说不允许null，另一个是字符串不能为空）。

Answer 1

当前SDK自动生成缺失的ids作为Guid值。Azure门户使用JS SDK，这就是为什么您会看到门户体验为您创建id如果您不添加它。

关于REST API的文档似乎有误导性，需要根据您分享的内容进行调整，因为REST API不会自动生成< code>id，但它会验证它是否在有效负载中。

总之，如果您正在实现自己的REST客户端，您可以在客户端添加自己的自动生成逻辑（就像SDK一样），REST API的必要条件是它包含在有效负载中。