Items - Delete ML Model

服务:

MLModel

API 版本:

v1

删除指定的机器学习模型。

权限

调用方必须具有 ML 模型的 写入 权限。

所需的委派范围

MLModel.ReadWrite.All 或 Item.ReadWrite.All

Microsoft Entra 支持的标识

此 API 支持本节中列出的Microsoft 标识。

身份	支持
用户	是的
服务主体和托管标识	否

接口

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mlModels/{mlModelId}

具有可选参数:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mlModels/{mlModelId}?hardDelete={hardDelete}

URI 参数

名称	在	必需	类型	说明
mlModelId	path	True	string (uuid)	机器学习模型 ID。
workspaceId	path	True	string (uuid)	工作区 ID。
hardDelete	query		boolean	指定是否执行硬删除。 设置为 true“设置为”时，该项目将永久删除，并且无法恢复。 设置为 false 或未指定项时，如果项类型支持该项，则会软删除该项。

响应

名称	类型	说明
200 OK		请求成功完成。
429 Too Many Requests	ErrorResponse	超出服务速率限制。 服务器返回一个 Retry-After 标头，指示客户端在发送其他请求之前必须等待的时间（以秒为单位）。 标头 Retry-After: integer
Other Status Codes	ErrorResponse	常见错误代码： ItemNotFound - 找不到请求的项目。 InsufficientWorkspaceRole - 用户没有足够的工作区角色。 FeatureNotAvailable - 这可能是由于软删除功能不可用。 UnsupportedItemType - 这可能是由于请求的项类型不支持软删除功能。 TenantSwitchDisabled - 这可能是由于租户管理员禁用了软删除功能。 InvalidTargetItemStateForSoftDeletion - 该项处于软删除无效状态。 InvalidParentItemStateForSoftDeletion - 项的父项未处于活动状态。

示例

Delete a machine learning model example

Hard delete a machine learning model example

Delete a machine learning model example

示例请求

HTTP

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/mlModels/5b218778-e7a5-4d73-8187-f10824047715

示例响应

状态代码:

200

Hard delete a machine learning model example

示例请求

HTTP

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/mlModels/5b218778-e7a5-4d73-8187-f10824047715?hardDelete=True

示例响应

状态代码:

200

定义

名称	说明
ErrorRelatedResource	与错误相关的资源详细信息对象。
ErrorResponse	错误响应。
ErrorResponseDetails	错误响应详细信息。

ErrorRelatedResource

对象

与错误相关的资源详细信息对象。

名称	类型	说明
resourceId	string	错误中涉及的资源 ID。
resourceType	string	错误中涉及的资源的类型。

ErrorResponse

对象

错误响应。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message	string	错误的人工可读表示形式。
moreDetails	ErrorResponseDetails[]	其他错误详细信息的列表。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。
requestId	string (uuid)	与错误关联的请求的 ID。

ErrorResponseDetails

对象

错误响应详细信息。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message	string	错误的人工可读表示形式。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。