Get an external datastore definition

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Get an external datastore definition in Dynatrace Grail by its name with the External Datastores API to inspect how an external source is set up.

Overview

You use the storeName path parameter to read one external datastore definition, for example to check its settings before you update it. The operation returns the stored definition with a 200 response. To change it afterward, use the full or partial update operation with the optimistic-locking-version that matches the stored definition.

Authentication

To execute this request, you need a platform token or OAuth access token with storage:external-datastore-definitions:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Response

{
  "type": "s3://",
  "name": "my-s3-store",
  "displayName": "My S3 Store",
  "bucketName": "my-s3-bucket",
  "region": "us-east-2",
  "connectionId": "my-connection-id",
  "connectionName": "my-connection-name",
  "version": 1
}

{
  "error": {
    "message": "Constraint Violations",
    "details": {
      "constraintViolations": [
        {
          "message": "must not be blank",
          "parameterDescriptor": "storeName"
        }
      ]
    },
    "code": 400
  }
}