Get synonyms set
edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.
Get synonyms set
editRetrieves a synonyms set.
Request
editGET _synonyms/<synonyms_set>
Prerequisites
editRequires the manage_search_synonyms cluster privilege.
Path parameters
edit-
<synonyms_set> - (Required, string) Synonyms set identifier to retrieve.
Query parameters
edit-
from -
(Optional, integer) Starting offset for synonyms rules to retrieve. Defaults to
0. -
size -
(Optional, integer) Specifies the maximum number of synonyms rules to retrieve. Defaults to
10.
Response codes
edit-
400 -
The
synonyms_setidentifier was not provided. -
404(Missing resources) -
No synonyms set with the identifier
synonyms_setwas found.
Examples
editThe following example retrieves a synonyms set called my-synonyms-set:
resp = client.synonyms.get_synonym(
id="my-synonyms-set",
)
print(resp)
response = client.synonyms.get_synonym( id: 'my-synonyms-set' ) puts response
const response = await client.synonyms.getSynonym({
id: "my-synonyms-set",
});
console.log(response);
GET _synonyms/my-synonyms-set
The synonyms set information returned will include the total number of synonyms rules that the synonyms set contains, and the synonyms rules according to the from and size parameters.
A sample response:
{
"count": 3,
"synonyms_set": [
{
"id": "test-1",
"synonyms": "hello, hi"
},
{
"id": "test-2",
"synonyms": "bye, goodbye"
},
{
"id": "test-3",
"synonyms": "test => check"
}
]
}