Credential vault API - GET all credentials
This API is deprecated. Use the Credential vault API from the Environment API instead.
Lists all credentials for synthetic monitors stored in your environment.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/config/v1/credentials |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/credentials | |
Environment ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/config/v1/credentials |
Authentication
To execute this request, you need an access token with credentialVault.read
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
type | string | Filters the result by the specified credentials type.
| query | optional |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | CredentialsList | Success |
Response body objects
The CredentialsList
object
A list of credentials sets for Synthetic monitors.
Element | Type | Description |
---|---|---|
credentials | CredentialsResponseElement[] | A list of credentials sets for Synthetic monitors. |
nextPageKey | string | - |
pageSize | integer | - |
totalCount | integer | - |
The CredentialsResponseElement
object
Metadata of the credentials set.
Element | Type | Description |
---|---|---|
allowContextlessRequests | boolean | Allow access without app context, for example, from ad hoc functions in Workflows (requires the APP_ENGINE scope). |
allowedEntities | CredentialAccessData[] | The set of entities allowed to use the credential. |
credentialUsageSummary | CredentialUsageHandler[] | The list contains summary data related to the use of credentials. |
description | string | A short description of the credentials set. |
externalVault | ExternalVaultConfig | Configuration for external vault synchronization for username and password credentials. |
id | string | The ID of the credentials set. |
name | string | The name of the credentials set. |
owner | string | The owner of the credential (user for which used API token was created). |
ownerAccessOnly | boolean | Flag indicating that this credential is visible only to the owner. |
scope | string | The scope of the credentials set.
|
scopes | string[] | The set of scopes of the credentials set.
|
type | string | The type of the credentials set.
|
The CredentialAccessData
object
The set of entities allowed to use the credential.
Element | Type | Description |
---|---|---|
id | string | - |
type | string | -
|
The CredentialUsageHandler
object
Keeps information about credential's usage.
Element | Type | Description |
---|---|---|
count | integer | The number of uses. |
type | string | Type of usage. |
The ExternalVaultConfig
object
Configuration for external vault synchronization for username and password credentials.
Element | Type | Description |
---|---|---|
credentialsUsedForExternalSynchronization | string[] | - |
passwordSecretName | string | - |
sourceAuthMethod | string | Defines the actual set of fields depending on the value. See one of the following objects:
|
tokenSecretName | string | - |
type | string | -
|
usernameSecretName | string | - |
vaultUrl | string | - |
Response body JSON model
{"credentials": [{"credentialUsageSummary": [{"HTTP_MONITOR": 4}],"description": "Sample credentials for demo purposes","id": "CREDENTIALS_VAULT-E80203F993472E6D","name": "Sample username-password credentials","owner": "admin","ownerAccessOnly": true,"scope": "SYNTHETIC","type": "USERNAME_PASSWORD"},{"credentialUsageSummary": [],"description": "Sample credentials for demo purposes","id": "CREDENTIALS_VAULT-842DEF439999E15B","name": "Sample certificate credentials","owner": "John.Doe@domain.com","ownerAccessOnly": true,"scope": "EXTENSION","type": "CERTIFICATE"},{"credentialUsageSummary": [{"BROWSER_MONITOR": 11,"HTTP_MONITOR": 4}],"description": "Sample token for demo purposes","id": "CREDENTIALS_VAULT-854345639999E15B","name": "Sample token credentials","owner": "John.Doe@domain.com","ownerAccessOnly": true,"scope": "SYNTHETIC","type": "TOKEN"}]}
Example
In this example, the request lists all credentials of the USERNAME_PASSWORD type from the mySampleEnv environment.
The API token is passed in the Authorization header.
The result is truncated to two entries.
Curl
curl -X GET \'https://mySampleEnv.live.dynatrace.com/api/config/v1/credentials/?type=USERNAME_PASSWORD' \-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
https://mySampleEnv.live.dynatrace.com/api/config/v1/credentials/?type=USERNAME_PASSWORD
Response body
{"credentials": [{"name": "easyTravel","id": "CREDENTIALS_VAULT-9415C41E3649FE3C","type": "USERNAME_PASSWORD","description": "Credentials for easyTravel test app"},{"name": "google.com","id": "CREDENTIALS_VAULT-E6D8ED717C9689B2","type": "USERNAME_PASSWORD","description": "google.com"}]}
Response code
200