content/operate/rs/references/rest-api/requests/bdbs/passwords.md
| Method | Path | Description |
|---|---|---|
| PUT | /v1/bdbs/{uid}/passwords | Update database password |
| POST | /v1/bdbs/{uid}/passwords | Add database password |
| DELETE | /v1/bdbs/{uid}/passwords | Delete database password |
PUT /v1/bdbs/{int: uid}/passwords
Set a single password for the bdb's default user (i.e., for AUTH <password> authentications).
| Permission name |
|---|
| [update_bdb]({{< relref "/operate/rs/references/rest-api/permissions#update_bdb" >}}) |
PUT /v1/bdbs/1/passwords
{
"password": "new password"
}
The above request resets the password of the bdb to ‘new password’.
| Key | Value | Description |
|---|---|---|
| Host | cnm.cluster.fqdn | Domain name |
| Accept | application/json | Accepted media type |
| Field | Type | Description |
|---|---|---|
| uid | integer | The unique ID of the database to update the password. |
| Field | Type | Description |
|---|---|---|
| password | string | New password |
Returns a status code that indicates password update success or failure.
| Code | Description |
|---|---|
| 200 OK | The password was changed. |
| 404 Not Found | A nonexistent database. |
| 406 Not Acceptable | Invalid configuration parameters provided. |
POST /v1/bdbs/{int: uid}/passwords
Add a password to the bdb's default user (i.e., for AUTH <password> authentications).
| Permission name |
|---|
| [update_bdb]({{< relref "/operate/rs/references/rest-api/permissions#update_bdb" >}}) |
POST /v1/bdbs/1/passwords
{
"password": "password to add"
}
The above request adds a password to the bdb.
| Key | Value | Description |
|---|---|---|
| Host | cnm.cluster.fqdn | Domain name |
| Accept | application/json | Accepted media type |
| Field | Type | Description |
|---|---|---|
| uid | integer | The unique ID of the database to add password. |
| Field | Type | Description |
|---|---|---|
| password | string | Password to add |
Returns a status code that indicates password creation success or failure.
| Code | Description |
|---|---|
| 200 OK | The password was added. |
| 404 Not Found | A nonexistent database. |
| 406 Not Acceptable | Invalid configuration parameters provided. |
DELETE /v1/bdbs/{int: uid}/passwords
Delete a password from the bdb's default user (i.e., for AUTH <password> authentications).
| Permission name |
|---|
| [update_bdb]({{< relref "/operate/rs/references/rest-api/permissions#update_bdb" >}}) |
DELETE /v1/bdbs/1/passwords
{
"password": "password to delete"
}
The above request deletes a password from the bdb.
| Key | Value | Description |
|---|---|---|
| Host | cnm.cluster.fqdn | Domain name |
| Accept | application/json | Accepted media type |
| Field | Type | Description |
|---|---|---|
| uid | integer | The unique ID of the database to delete password. |
| Field | Type | Description |
|---|---|---|
| password | string | Password to delete |
Returns a status code that indicates password deletion success or failure.
| Code | Description |
|---|---|
| 200 OK | The password was deleted. |
| 404 Not Found | A nonexistent database. |
| 406 Not Acceptable | Invalid configuration parameters provided. |