令牌API 2.0

令牌API允許您創建、列出和撤銷令牌,這些令牌可用於驗證和訪問Databricks REST API。

重要的

要訪問Databricks的REST api,您必須進行身份驗證

創建

端點

HTTP方法

2.0 /令牌/創建

帖子

創建並返回一個令牌。這個調用返回錯誤QUOTA_EXCEEDED如果當前未過期的令牌數量超過令牌配額。每個用戶的token配額為600。

例子

請求

curl——netrc——請求POST\https:// < databricks-instance > / api / 2.0 /令牌創建\——數據{"comment": "這是一個token示例","lifetime_seconds": 7776000} "\|金橋。

替換:

  • < databricks-instance >與磚工作區實例名例如,dbc-a1b2345c-d6e7.cloud.www.eheci.com

  • 一個例子令牌並將描述附加到令牌上。

  • 7776000使用令牌的生命周期,單位為秒。這個示例指定90天。

此示例使用. netrc文件和金橋

響應

“token_value”“dapi1a2b3c45d67890e1f234567a8bc9012d”“token_info”“token_id”“1234567890 a12bc3456de789012f34ab56c78d9012e3fabc4de56f7a89b012c3”“creation_time”1626286601651“expiry_time”1634062601651“評論”"這是一個示例令牌"

請求結構

字段名

類型

描述

lifetime_seconds

令牌的生存期,以秒為單位。如果沒有指定生存期,令牌將無限期有效。

評論

字符串

附加到令牌上的可選描述。

響應結構

字段名

類型

描述

token_value

字符串

新創建的令牌的值。

token_info

公共牌信息

新創建令牌的公共元數據。

列表

端點

HTTP方法

2.0 /令牌列表

得到

列出用戶-工作空間對的所有有效令牌。

例子

請求

curl——netrc——請求GET\https:// < databricks-instance > / api / 2.0 /令牌/列表\|金橋。

取代< databricks-instance >與磚工作區實例名例如,dbc-a1b2345c-d6e7.cloud.www.eheci.com

此示例使用. netrc文件和金橋

響應

“token_infos”“token_id”“1234567890 a12bc3456de789012f34ab56c78d9012e3fabc4de56f7a89b012c3”“creation_time”1626286601651“expiry_time”1634062601651“評論”"這是一個示例令牌"},“token_id”“2345678901 a12bc3456de789012f34ab56c78d9012e3fabc4de56f7a89b012c4”“creation_time”1626286906596“expiry_time”1634062906596“評論”"這是另一個token的例子"

響應結構

字段名

類型

描述

token_infos

一個數組的公共牌信息

用戶-工作空間對的令牌信息列表。

撤銷

端點

HTTP方法

2.0 /令牌/刪除

帖子

撤銷訪問令牌。這個調用返回錯誤RESOURCE_DOES_NOT_EXIST如果帶有指定ID的令牌無效。

例子

curl——netrc——請求POST\https:// < databricks-instance > / api / 2.0 /令牌/刪除\——數據'{"token_id": ""}'

此示例使用. netrc文件。

替換:

  • < databricks-instance >與磚工作區實例名例如,dbc-a1b2345c-d6e7.cloud.www.eheci.com

  • < token-id >例如,使用令牌的ID1234567890 a12bc3456de789012f34ab56c78d9012e3fabc4de56f7a89b012c3

請求結構

字段名

類型

描述

token_id

字符串

要撤銷的令牌的ID。

數據結構

在本節中:

公共牌信息

描述訪問令牌的公共元數據的數據結構。

字段名

類型

描述

token_id

字符串

令牌的ID。

creation_time

創建令牌時的服務器時間(以epoch毫秒為單位)。

expiry_time

令牌將過期的服務器時間(以epoch毫秒為單位),如果不適用,則為-1。

評論

字符串

注釋所創建的令牌(如果適用)。