令牌API 2.0

令牌API允许您创建、列出和撤销可用于验证和访问Databricks REST API的令牌。

重要的

要访问Databricks REST api,必须进行身份验证

创建

端点

HTTP方法

2.0 /令牌/创建

帖子

创建并返回一个令牌。这个调用返回错误QUOTA_EXCEEDED如果当前未过期的令牌数量超过令牌配额。每个用户的token配额为600。

例子

请求

curl—netrc—请求POSThttps:// < databricks-instance > / api / 2.0 /令牌创建——数据'{"comment": "这是一个令牌示例","lifetime_seconds": 7776000}'|金桥。

替换:

  • < databricks-instance >和数据库工作空间实例名称例如,dbc-a1b2345c-d6e7.cloud.www.neidfyre.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—请求GEThttps:// < databricks-instance > / api / 2.0 /令牌/列表|金桥。

取代< databricks-instance >和数据库工作空间实例名称例如,dbc-a1b2345c-d6e7.cloud.www.neidfyre.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_infos

的数组公共令牌信息

用户-工作区对的令牌信息列表。

撤销

端点

HTTP方法

2.0 /令牌/删除

帖子

撤销访问令牌。这个调用返回错误RESOURCE_DOES_NOT_EXIST如果指定ID的令牌无效。

例子

curl—netrc—请求POSThttps:// < databricks-instance > / api / 2.0 /令牌/删除——数据'{"token_id": ""}'

本例使用. netrc文件。

替换:

  • < databricks-instance >和数据库工作空间实例名称例如,dbc-a1b2345c-d6e7.cloud.www.neidfyre.com

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

请求结构

字段名

类型

描述

token_id

字符串

要撤销的令牌的ID。

数据结构

公共令牌信息

描述访问令牌的公共元数据的数据结构。

字段名

类型

描述

token_id

字符串

令牌的ID。

creation_time

创建令牌时的服务器时间(以epoch毫秒为单位)。

expiry_time

令牌到期的服务器时间(以epoch毫秒为单位),如果不适用,则为-1。

评论

字符串

创建令牌时使用的注释(如果适用的话)。