API Reference / API Methods / Query rules / Batch rules
Feb. 26, 2019

Batch rules

Required API Key: any key with the editSettings ACL
Method signature
$index->saveRules(array rules)

$index->saveRules(array rules, [
  // All the following parameters are optional
  'forwardToReplicas' => boolean
  'clearExistingRules' => boolean
])

About this method

Create or update a specified set of rules, or all rules.

Each rule will be created or updated, depending on whether a rule with the same objectID already exists.

Examples

1
2
3
$rules = [$rule1, $rule2];

$index->saveRules($rules);

Parameters

rules
type: list of rule objects
Required

See rule.

clearExistingRules
type: boolean
default: false
Optional

Whether the batch will remove all exisiting rules before adding/updating the rules.

forwardToReplicas
type: boolean
default: false
Optional

Whether to forward the operation to the replica indices.

Response

In this section we document the JSON response returned by the API. Each language will encapsulate this response inside objects specific to the language and/or the implementation. So the actual type in your language might differ from what is documented.

JSON format

1
2
3
4
{
  "updatedAt":"2013-01-18T15:33:13.556Z",
  "taskID": 678
}
updatedAt
string

Date at which the batch rules job has been created.

taskID
integer

The taskID used with the waitTask method.

Did you find this page helpful?