This resource address creates a new user in the security database.
URL Parameters | |
---|---|
format |
The format of the posted data. Can be either
html , json , or xml (default). This value overrides
the Accept header if both are present.
|
Upon success, MarkLogic Server returns status code 201 (Created). If the user already exists or if the payload is malformed, a status code of 400 (Bad Request) is returned. A status code of 401 (Unauthorized) is returned if the user does not have the necessary privileges.
security
and
manage-admin
roles.
The structure of the data in the request body
is shown below. The user-name
and password
properties are required.
Note: The properties described here are for XML payloads. In general they are
the same for JSON, with the exception that, in JSON, roles
,
external-names
, permissions
, and collections
are
expressed in singular form. For example, in JSON, permissions
is
instead permission
and the format is:
"permission":[{"role-name":"name", "capability":"cap"}]
.
user-name
description
password
external-names
This is a complex structure with the following children:
external-name
roles
This is a complex structure with the following children:
role
permissions
This is a complex structure with the following children:
permission
This is a complex structure with the following children:
role-name
capability
collections
This is a complex structure with the following children:
collection
curl -X POST --anyauth -u admin:admin --header "Content-Type:application/json" \ -d '{"user-name":"joe", "password": "cool", "role": [ "rest-reader", "rest-writer" ] }' \ http://localhost:8002/manage/v2/users ==> Creates a user, named '"joe" with the "rest-reader" and "rest-writer" roles, in the Security database.
Stack Overflow: Get the most useful answers to questions from the MarkLogic community, or ask your own question.