operationId: databases_get_user
summary: Retrieve an Existing Database User
description: |
To show information about an existing database user, send a GET request to
`/v2/databases/$DATABASE_ID/users/$USERNAME`.
Note: User management is not supported for Caching or Valkey clusters.
The response will be a JSON object with a `user` key. This will be set to an object
containing the standard database user attributes. The user's password will not show
up unless the `database:view_credentials` scope is present.
For MySQL clusters, additional options will be contained in the `mysql_settings`
object.
For PostgreSQL clusters, additional options will be contained in the `settings`
object (for example, `pg_allow_replication`).
For Kafka clusters, additional options will be contained in the `settings` object.
For MongoDB clusters, additional information will be contained in the mongo_user_settings object
tags:
- Databases
parameters:
- $ref: 'parameters.yml#/database_cluster_uuid'
- $ref: 'parameters.yml#/username'
responses:
'200':
$ref: 'responses/user.yml'
'401':
$ref: '../../shared/responses/unauthorized.yml'
'404':
$ref: '../../shared/responses/not_found.yml'
'429':
$ref: '../../shared/responses/too_many_requests.yml'
'500':
$ref: '../../shared/responses/server_error.yml'
default:
$ref: '../../shared/responses/unexpected_error.yml'
x-codeSamples:
- $ref: 'examples/curl/databases_get_user.yml'
- $ref: 'examples/go/databases_get_user.yml'
- $ref: 'examples/python/databases_get_user.yml'
security:
- bearer_auth:
- 'database:read'