---
title: "Update an observed database"
method: PATCH
path: "/v1/dbo/databases/{entityId}"
tags: ["dbo"]
---

# Update an observed database

`PATCH /v1/dbo/databases/{entityId}`

## Path parameters

- `entityId` string, required

## Request body

- DboUpdateDatabaseRequest
  - `name` string — Name for the observed database entity
  - `configOptions` CommonKeyValuePair[] — Optional advanced configuration options for plugins, e.g. disable-sampling set to true. An existing config option can be removed by setting its value to empty string.
    - `key` string, required — Key.
    - `value` string, required — Value.
  - `dbConnOptions` DboDatabaseConnectionOptionsUpdate
    - `host` string — Database server host
    - `port` string — Database server port
    - `dbname` string — Database schema name
    - `encryptedCredentials` string — Encrypted credentials for connecting to the database server when using basic authentication (username, password) can be generated using this command: ./dbo-headless-installer -swoparams=<SwoParamasJsonFile> --encrypt-creds --user=<USERNAME> --password=<PASSWORD> Use the dbo-headless-installer binary located at: https://agent-binaries.cloud.solarwinds.com/?prefix=dbo-headless-installer/latest/
    - `user` string — Username for connecting to database server needed only for auth methods other than basic auth
    - `sslEnabled` boolean — Enable ssl when agent connects to database server
    - `sslOptions` DboDatabaseSslOptionsUpdate
      - `sslMode` 'require' | 'verify-ca' | 'verify-full'
      - `sslCAPath` string — CA file path
      - `sslKeyPath` string — SSL key file path
      - `sslCertPath` string — SSL cert file path
    - `cloudRegion` string — Cloud region in case of database managed by cloud provider, required for IAM authentication
    - `bindings` string — binding for packet sniffing for sniffer captureMethod (on-host), example: 0.0.0.0:6379,[::]:6379
    - `additionalOptions` CommonKeyValuePair[] — Additional database-type-specific connection options as key-value pairs. For Oracle: service_name (Oracle service name), sid (Oracle SID).
      - `key` string, required — Key.
      - `value` string, required — Value.
  - `tags` CommonKeyValuePair[] — Tags for observed database entity. An existing tag can be removed by setting its value to empty string.
    - `key` string, required — Key.
    - `value` string, required — Value.
  - `deployedOn` string[] — Host entity/entities where database server is deployed on

## Response `204`

There is no content to send for this request, but the headers may be useful.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `403` — Access is forbidden.
- `404` — The server cannot find the requested resource.
- `500` — Server error

---

[API](https://skmtc.net/solarwinds/apis/solarwinds-observability.md) · [All operations](https://skmtc.net/solarwinds/apis/solarwinds-observability/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarwinds/solarwinds-observability/versions/994e5ca64961/schema)