令牌API 2.0

令牌API允许您创建、列表和撤销令牌,可用于身份验证和访问数据砖REST API。

重要的

访问数据砖REST api,你必须进行身份验证

创建

端点

HTTP方法

2.0 /令牌/创建

帖子

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

例子

请求

curl——netrc POST请求\https:// < databricks-instance > / api / 2.0 /令牌/创建\——数据{“评论”:“这是一个令牌”、“lifetime_seconds”: 7776000}”\|金桥。

替换:

  • < databricks-instance >与砖工作区实例名例如,1234567890123456.7.gcp.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请求\https:// < databricks-instance > / api / 2.0 /令牌列表\|金桥。

取代< databricks-instance >与砖工作区实例名例如,1234567890123456.7.gcp.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 POST请求\https:// < databricks-instance > / api / 2.0 /令牌/删除\——数据”{token_id”:“< token-id >“}”

这个示例使用. netrc文件。

替换:

  • < databricks-instance >与砖工作区实例名例如,1234567890123456.7.gcp.www.neidfyre.com

  • < token-id >例如,与标记的ID1234567890 a12bc3456de789012f34ab56c78d9012e3fabc4de56f7a89b012c3

请求结构

字段名

类型

描述

token_id

字符串

标记的ID被撤销。

数据结构

在本节中:

公共牌信息

一种数据结构,描述了公共元数据的一个访问令牌。

字段名

类型

描述

token_id

字符串

标记的ID。

creation_time

服务器时间(毫秒)时代令牌时创建的。

expiry_time

服务器时间(毫秒)时代令牌何时到期,如果不适用或1。

评论

字符串

评论创建令牌,如果适用的话。