From 1ccbcd218e32b3041f61fa5be83d6d7b26a5bde6 Mon Sep 17 00:00:00 2001
From: hectorcast-db <hector.castejon@databricks.com>
Date: Fri, 30 Aug 2024 09:12:20 +0200
Subject: [PATCH] [Doc] Add Data Plane access documentation (#732)

## Changes
Add Data Plane access documentation

## Tests
<!--
How is this tested? Please see the checklist below and also describe any
other relevant tests
-->

- [ ] `make test` run locally
- [ ] `make fmt` applied
- [ ] relevant integration tests applied
---
 docs/dataplane.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 docs/dataplane.md

diff --git a/docs/dataplane.md b/docs/dataplane.md
new file mode 100644
index 000000000..51e3d0225
--- /dev/null
+++ b/docs/dataplane.md
@@ -0,0 +1,27 @@
+# Data Plane APIs
+
+Some APIs such as Model Serving support direct Data Plane access for higher throughput and lower latency requests. 
+To access Data Plane access, a dedicated short-lived OAuth token must be used. The SDK is able to generate and refresh 
+such tokens transparently for the user.
+
+## Prerequisites
+Databricks SDK must be configured using a supported OAuth token. For more information, see
+[Supported Databricks authentication types](https://docs.databricks.com/en/dev-tools/auth/index.html)
+
+The desired service or endpoint must have direct Data Plane access enabled.
+
+## Usage
+Databricks SDK provides a separate service to be used for Data Plane access, which includes a `_data_plane` suffix.
+This service contains the subset of the methods for the original service which are supported in the Data Plane.
+
+Example:
+
+```python
+from databricks.sdk import WorkspaceClient
+# Control Plane
+w = WorkspaceClient()
+w.serving_endpoints.query(...)
+# Data Plane
+w.serving_endpoints_data_plane.query(...)
+```
+