1
0
Fork 0
arangodb/Documentation/DocuBlocks/Rest/Analyzers/post_api_analyzer.md

61 lines
1.6 KiB
Markdown

@startDocuBlock post_api_analyzer
@brief creates a new analyzer based on the provided definition
@RESTHEADER{POST /_api/analyzer, Create an analyzer with the suppiled definition, RestAnalyzerHandler:Create}
@RESTBODYPARAM{name,string,required,string}
The analyzer name.
@RESTBODYPARAM{type,string,required,string}
The analyzer type.
@RESTBODYPARAM{properties,string,optional,string}
The properties used to configure the specified type.
Value may be a string, an object or null.
The default value is *null*.
@RESTBODYPARAM{features,array,optional,string}
The set of features to set on the analyzer generated fields.
The default value is an empty array.
@RESTDESCRIPTION
Creates a new analyzer based on the provided configuration.
@RESTRETURNCODES
@RESTRETURNCODE{200}
An analyzer with a matching name and definition already exists.
@RESTRETURNCODE{201}
A new analyzer definition was successfully created.
@RESTRETURNCODE{400}
One or more of the required parameters is missing or one or more of the parameters
is not valid.
@RESTRETURNCODE{403}
The user does not have permission to create and analyzer with this configuration.
@EXAMPLES
@EXAMPLE_ARANGOSH_RUN{RestAnalyzerPost}
var analyzers = require("@arangodb/analyzers");
var db = require("@arangodb").db;
var analyzerName = "testAnalyzer";
// creation
var url = "/_api/analyzer";
var body = {
name: "testAnalyzer",
type: "identity"
};
var response = logCurlRequest('POST', url, body);
assert(response.code === 201);
logJsonResponse(response);
analyzers.remove(analyzerName, true);
@END_EXAMPLE_ARANGOSH_RUN
@endDocuBlock