MLflow 身份验证 REST API

MLflow Authentication REST API 允许您创建、获取、更新和删除用户、实验权限以及已注册模型的权限。该 API 托管在 MLflow 跟踪服务器的 /api 路由下。例如，要列出托管在 http://localhost:5000 的跟踪服务器上的实验，可访问 http://localhost:5000/api/2.0/mlflow/users/create。

重要

MLflow 的 REST API 要求所有 POST 请求的内容类型为 application/json。

---

端点	HTTP 方法
2.0/mlflow/users/create	POST

请求结构

字段名	类型	描述
用户名	STRING	用户名。
密码	STRING	密码。

响应结构

字段名	类型	描述
用户	User	一个用户对象。

---

端点	HTTP 方法
2.0/mlflow/users/get	GET

请求结构

字段名	类型	描述
用户名	STRING	用户名。

响应结构

字段名	类型	描述
用户	User	一个用户对象。

---

端点	HTTP 方法
2.0/mlflow/users/update-password	PATCH

请求结构

字段名	类型	描述
用户名	STRING	用户名。
密码	STRING	新密码。

---

端点	HTTP 方法
2.0/mlflow/users/update-admin	PATCH

请求结构

字段名	类型	描述
用户名	STRING	用户名。
is_admin	BOOLEAN	新的管理员状态。

---

端点	HTTP 方法
2.0/mlflow/users/delete	DELETE

请求结构

字段名	类型	描述
用户名	STRING	用户名。

---

端点	HTTP 方法
2.0/mlflow/experiments/permissions/create	POST

请求结构

字段名	类型	描述
experiment_id	STRING	实验 ID。
用户名	STRING	用户名。
权限	Permission	授予权限。

响应结构

字段名	类型	描述
experiment_permission	ExperimentPermission	一个实验权限对象。

---

端点	HTTP 方法
2.0/mlflow/experiments/permissions/get	GET

请求结构

字段名	类型	描述
experiment_id	STRING	实验 ID。
用户名	STRING	用户名。

响应结构

字段名	类型	描述
experiment_permission	ExperimentPermission	一个实验权限对象。

---

端点	HTTP 方法
2.0/mlflow/experiments/permissions/update	PATCH

请求结构

字段名	类型	描述
experiment_id	STRING	实验 id.
用户名	STRING	用户名。
permission	Permission	要授予的新权限。

---

端点	HTTP 方法
2.0/mlflow/experiments/permissions/delete	DELETE

请求结构

字段名	类型	描述
experiment_id	STRING	实验 ID。
用户名	STRING	用户名。

---

端点	HTTP 方法
2.0/mlflow/registered-models/permissions/create	CREATE

请求结构

字段名	类型	描述
名称	STRING	已注册模型的名称。
用户名	STRING	用户名。
权限	Permission	授予权限。

响应结构

字段名	类型	描述
registered_model_permission	RegisteredModelPermission	一个注册模型权限对象。

---

端点	HTTP 方法
2.0/mlflow/registered-models/permissions/get	GET

请求结构

字段名	类型	描述
名称	STRING	已注册模型的名称。
用户名	STRING	用户名。

响应结构

字段名	类型	描述
registered_model_permission	RegisteredModelPermission	一个注册模型权限对象。

---

端点	HTTP 方法
2.0/mlflow/registered-models/permissions/update	PATCH

请求结构

字段名	类型	描述
名称	STRING	已注册模型的名称。
用户名	STRING	用户名。
权限	Permission	要授予的新权限。

---

端点	HTTP 方法
2.0/mlflow/registered-models/permissions/delete	DELETE

请求结构

字段名	类型	描述
名称	STRING	已注册模型的名称。
用户名	STRING	用户名。

用户

字段名	类型	描述
标识符	STRING	用户 ID.
用户名	STRING	用户名。
is_admin	BOOLEAN	用户是否为管理员。
experiment_permissions	一个由 ExperimentPermission 组成的数组	明确授予用户的所有实验权限。
registered_model_permissions	一个由 RegisteredModelPermission 组成的数组	明确授予用户的所有已注册模型权限。

权限

用户对实验或已注册模型的权限。

名称	描述
读取	可以读取。
编辑	可以读取并更新。
管理	可以读取、更新、删除和管理。
NO_PERMISSIONS	没有权限。

ExperimentPermission

字段名	类型	描述
experiment_id	STRING	实验 id.
user_id	STRING	用户 id.
权限	Permission	已授予权限。

RegisteredModelPermission

字段名	类型	描述
名称	STRING	已注册模型的名称。
user_id	STRING	用户 ID。
权限	Permission	已授予权限。