MUpdateAsync #

Updates multiple documents.

Returns a partial error (error code 206) if one or more documents cannot be updated.

Conflicts may occur if the same document gets updated multiple times within a short timespan in a database cluster.

You can set the retryOnConflict optional argument (with a retry count), to tell Kuzzle to retry the failing updates the specified amount of times before rejecting the request with an error.

Arguments #

public async Task<JArray> MUpdateAsync(
  string index, 
  string collection, 
  JArray documents, 
  bool waitForRefresh = false, 
  int retryOnConflict = 0);

Argument	Type	Description
`index`	string	Index name
`collection`	string	Collection name
`documents`	JArray	JArray of documents to update
`waitForRefresh`	bool (`false`)	If `true`, waits for the change to be reflected for `search` (up to 1s)
`retryOnConflict`	int (`0`)	The number of times the database layer should retry in case of version conflict

documents #

Each document has the following properties:

Property	Type	Description
`_id`	string	Document ID
`body`	JObject	Document body

Return #

A JArray representing the replaced documents.

Each document has the following properties:

Property	Type	Description
`_id`	string	ID of the newly created document
`_version`	int	Version of the document in the persistent data storage
`_source`	JObject	JObject representing the created document
`result`	string	Set to `updated`.

Exceptions #

Throws a KuzzleException if there is an error. See how to handle errors.

Usage #

try {
  JArray documents = JArray.Parse(@"
    [
      {
        ""_id"": ""some-id"",
        ""body"": {""category"": ""sedan""}
      },
      {
        ""_id"": ""some-other-id"",
        ""body"": {""category"": ""limousine""}
      }
    ]
  ");
  JArray response = await kuzzle.Document.MUpdateAsync(
    "nyc-open-data",
    "yellow-taxi",
    documents);
  Console.WriteLine(response.ToString());
    /*
      [ { _id: 'some-id',
        _source:
          { _kuzzle_info:
            { active: true,
              author: '-1',
              updater: null,
              updatedAt: null,
              deletedAt: null,
              createdAt: 1538639586995 },
            capacity: 4,
            category: "sedan"},
        _version: 2,
        result: 'updated',
        status: 200 },
      { _id: 'some-other-id',
        _source:
          { _kuzzle_info:
            { active: true,
              author: '-1',
              updater: null,
              updatedAt: null,
              deletedAt: null,
              createdAt: 1538639586995 },
            capacity: 4,
            category: "limousine" },
        _version: 2,
        result: 'updated',
        status: 200 } ]
    */
  Console.WriteLine($"Successfully updated {response.Count} documents");
} catch (KuzzleException e) {
  Console.Error.WriteLine(e);
}

Edit this page on Github