MLflow 认证 REST API

MLflow 认证 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	密码。

响应结构

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

---

获取用户

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

请求结构

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

响应结构

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

---

更新用户密码

端点	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

请求结构

字段名称	类型	描述
实验_id	STRING	实验ID。
用户名	STRING	用户名。
权限	mlflow权限	授予权限。

响应结构

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

---

获取实验权限

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

请求结构

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

响应结构

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

---

更新实验权限

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

请求结构

字段名称	类型	描述
实验_id	STRING	实验ID。
用户名	STRING	用户名。
权限	mlflow权限	新的权限授予。

---

删除实验权限

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

请求结构

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

---

创建注册模型权限

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

请求结构

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

响应结构

字段名称	类型	描述
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	用户名。
权限	mlflow权限	新的权限授予。

---

删除已注册模型权限

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

请求结构

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

数据结构

用户

字段名称	类型	描述
id	STRING	用户ID。
用户名	STRING	用户名。
is_admin	BOOLEAN	用户是否为管理员。
实验权限	一个 实验权限 的数组	所有实验权限均明确授予用户。
registered_model_permissions	一个 RegisteredModelPermission 的数组	所有注册的模型权限都明确授予用户。

权限

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

名称	描述
读	可以阅读。
编辑	可以读取和更新。
管理	可以读取、更新、删除和管理。
无权限	无权限。

实验权限

字段名称	类型	描述
实验_id	STRING	实验ID。
用户ID	STRING	用户ID。
权限	mlflow权限	权限已授予。

RegisteredModelPermission

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