MethodPathDescription
PUT/v1/bdbs/{uid}/passwordsUpdate database password
POST/v1/bdbs/{uid}/passwordsAdd database password
DELETE/v1/bdbs/{uid}/passwordsDelete database password

Update database password

PUT /v1/bdbs/{int: uid}/passwords

Set a single password for the bdb’s default user (i.e., for AUTH <password> authentications).

Required permissions

Permission name
update_bdb

Request

Example HTTP request

PUT /bdbs/1/passwords 

Example JSON body

{
    "password": "new password"
}

The above request resets the password of the bdb to ‘new password’.

Request headers

KeyValueDescription
Hostcnm.cluster.fqdnDomain name
Acceptapplication/jsonAccepted media type

URL parameters

FieldTypeDescription
uidintegerThe unique ID of the database to update the password.

Request body

FieldTypeDescription
passwordstringNew password

Response

Returns a status code that indicates password update success or failure.

Status codes

CodeDescription
200 OKThe password was changed.
404 Not FoundA nonexistent database.
406 Not AcceptableInvalid configuration parameters provided.

Add database password

POST /v1/bdbs/{int: uid}/passwords

Add a password to the bdb’s default user (i.e., for AUTH <password> authentications).

Required permissions

Permission name
update_bdb

Request

Example HTTP request

POST /bdbs/1/passwords 

Example JSON body

{
    "password": "password to add"
}

The above request adds a password to the bdb.

Request headers

KeyValueDescription
Hostcnm.cluster.fqdnDomain name
Acceptapplication/jsonAccepted media type

URL parameters

FieldTypeDescription
uidintegerThe unique ID of the database to add password.

Request body

FieldTypeDescription
passwordstringPassword to add

Response

Returns a status code that indicates password creation success or failure.

Status codes

CodeDescription
200 OKThe password was added.
404 Not FoundA nonexistent database.
406 Not AcceptableInvalid configuration parameters provided.

Delete database password

DELETE /v1/bdbs/{int: uid}/passwords

Delete a password from the bdb’s default user (i.e., for AUTH <password> authentications).

Required permissions

Permission name
update_bdb

Request

Example HTTP request

DELETE /bdbs/1/passwords 

Example JSON body

{
    "password": "password to delete"
}

The above request deletes a password from the bdb.

Request headers

KeyValueDescription
Hostcnm.cluster.fqdnDomain name
Acceptapplication/jsonAccepted media type

URL parameters

FieldTypeDescription
uidintegerThe unique ID of the database to delete password.

Request body

FieldTypeDescription
passwordstringPassword to delete

Response

Returns a status code that indicates password deletion success or failure.

Status codes

CodeDescription
200 OKThe password was deleted.
404 Not FoundA nonexistent database.
406 Not AcceptableInvalid configuration parameters provided.