Replace All Rules | Ruby API Client V1 (Deprecated)

This version of the Ruby API client has been deprecated in favor of the latest version of the Ruby API client.

Required API Key: any key with the editSettings ACL

Method signature

index.replace_all_rules(Array rules)
index.replace_all_rules(Array rules, {
  'forwardToReplicas': Boolean
})

See code examples

About this method

Push a new set of rules and erase all previous ones.

This method, like replaceAllObjects, guarantees zero downtime.

All existing rules are deleted and replaced with the new ones, in a single, atomic operation.

Examples

Replace all rules

Copy

1
2
3
4
5
6
7
8
9
10
11
12
$client = Algolia\AlgoliaSearch\SearchClient::create(
  'YourApplicationID',
  'YourWriteAPIKey'
);

$rules = /* Fetch your rules */;

$index = $client->initIndex('your_index_name');
$index->replaceAllRules($rules);

// Or if you want to also replace rules on replicas
$index->replaceAllRules($rules, ['forwardToReplicas' => true]);

1
2
3
4
5
6
7
8
9
10
11
12
client = Algolia::Client.new({
    :application_id => 'YourApplicationID',
    :api_key => 'YourWriteAPIKey'
})

rules = [] # Fetch your rules

index = client.init_index('your_index_name')
index.replace_all_rules(rules)

# Or if you want to also replace rules on replicas
index.replace_all_rules(rules, {'forwardToReplicas': true})

1
2
3
4
5
6
7
8
9
10
11
12
13
const client = algoliasearch('YourApplicationID', 'YourWriteAPIKey');

const index = client.initIndex('your_index_name');
const rules = [/* Fetch your rules */];

index.replaceAllRules(rules).then(() => {
  // done
});

// Or if you want to also replace rules on replicas
index.replaceAllRules(rules, { forwardToReplicas: true }).then(() => {
  // done
});

1
2
3
4
5
6
7
8
9
client = algoliasearch.Client("YourApplicationID", 'YourWriteAPIKey')

rules = [] # Fetch your rules

index = client.init_index('your_index_name')
index.replace_all_rules(rules)

# Or if you want to also replace rules on replicas
index.replace_all_rules(rules, { 'forwardToReplicas': True })

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
let client = SearchClient(appID: "YourApplicationID", apiKey: "YourWriteAPIKey")
let index = client.index(withName: "your_index_name")

let rules: [Rule] = [/* Fetch your rules */]

index.replaceAllRules(with: rules) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

// Or if you want to also replace synonyms on replicas
index.replaceAllRules(with: rules,
                      forwardToReplicas: true) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
SearchClient client = new SearchClient("YourApplicationID", "YourWriteAPIKey");
SearchIndex index = client.InitIndex("your_index_name");

List<Rule> rules = /* Fetch your rules */

index.ReplaceAllRules(rules);

// Or if you want to also replace synonyms on replicas
index.ReplaceAllRules(synonyms, forwardToReplicas: true);

// Asynchronous
await index.ReplaceAllRulesAsync(synonyms, forwardToReplicas: true);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
SearchClient client = 
DefaultSearchClient.create("YourApplicationID", "YourWriteAPIKey");

SearchIndex index = client.initIndex("your_index_name");

List<Rule> rules = /* Fetch your rules */

index.replaceAllRules(rules);

// Or if you want to also replace rules on replicas
index.replaceAllRules(rules, true);

// Async
index.replaceAllRules(synonyms);
index.replaceAllRules(synonyms, true);

Parameters

`rules`	type: list Required See rule.
`forwardToReplicas`	type: boolean default: false Optional Also replace rules on replicas
`requestOptions`	type: key/value mapping default: No request options Optional A mapping of request options to send along with the request.

Response

No response.

Did you find this page helpful?