Items - Create ML Model
Crea un modelo de Machine Learning en el área de trabajo especificada.
Esta API admite operaciones de larga duración (LRO).
Esta API no admite la creación de un modelo de aprendizaje automático con definición.
Permisos
El autor de la llamada debe tener rol de colaborador o superior.
Ámbitos delegados necesarios
MLModel.ReadWrite.All o Item.ReadWrite.All
Limitaciones
- Para crear un modelo de Machine Learning, el área de trabajo debe estar en una capacidad de Fabric compatible. Para obtener más información, consulte: tipos de licencia de Microsoft Fabric.
Identidades admitidas de Microsoft Entra
Esta API admite las identidades de Microsoft enumeradas en esta sección.
Identidad | Apoyo |
---|---|
Usuario | Sí |
de entidad de servicio y identidades administradas | No |
Interfaz
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mlModels
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
Identificador del área de trabajo. |
Cuerpo de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
displayName | True |
string |
Nombre para mostrar del modelo de Machine Learning. El nombre para mostrar debe seguir las reglas de nomenclatura según el tipo de elemento. |
description |
string |
Descripción del modelo de Machine Learning. La longitud máxima es de 256 caracteres. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
201 Created |
Creado correctamente |
|
202 Accepted |
Solicitud aceptada y aprovisionamiento de modelos de Machine Learning en curso. Encabezados
|
|
Other Status Codes |
Códigos de error comunes:
|
Ejemplos
Create a machine learning model example
Solicitud de ejemplo
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/mlModels
{
"displayName": "MLModel_1",
"description": "A machine learning model description."
}
Respuesta de muestra
{
"displayName": "MLModel_1",
"description": "A machine learning model description.",
"type": "MLModel",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30
Definiciones
Nombre | Description |
---|---|
Create |
Cree una carga de solicitud de modelo de Machine Learning. |
Error |
Objeto de detalles del recurso relacionado con el error. |
Error |
Respuesta de error. |
Error |
Detalles de la respuesta de error. |
Item |
Tipo del elemento. Se pueden agregar tipos de elementos adicionales a lo largo del tiempo. |
MLModel |
Objeto de modelo de Machine Learning. |
CreateMLModelRequest
Cree una carga de solicitud de modelo de Machine Learning.
Nombre | Tipo | Description |
---|---|---|
description |
string |
Descripción del modelo de Machine Learning. La longitud máxima es de 256 caracteres. |
displayName |
string |
Nombre para mostrar del modelo de Machine Learning. El nombre para mostrar debe seguir las reglas de nomenclatura según el tipo de elemento. |
ErrorRelatedResource
Objeto de detalles del recurso relacionado con el error.
Nombre | Tipo | Description |
---|---|---|
resourceId |
string |
Identificador de recurso implicado en el error. |
resourceType |
string |
Tipo del recurso implicado en el error. |
ErrorResponse
Respuesta de error.
Nombre | Tipo | Description |
---|---|---|
errorCode |
string |
Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios. |
message |
string |
Representación legible del error. |
moreDetails |
Lista de detalles de error adicionales. |
|
relatedResource |
Detalles del recurso relacionado con el error. |
|
requestId |
string |
Identificador de la solicitud asociada al error. |
ErrorResponseDetails
Detalles de la respuesta de error.
Nombre | Tipo | Description |
---|---|---|
errorCode |
string |
Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios. |
message |
string |
Representación legible del error. |
relatedResource |
Detalles del recurso relacionado con el error. |
ItemType
Tipo del elemento. Se pueden agregar tipos de elementos adicionales a lo largo del tiempo.
Valor | Description |
---|---|
Dashboard |
Panel de PowerBI. |
DataPipeline |
Una canalización de datos. |
Datamart |
Datamart de PowerBI. |
Environment |
Un entorno. |
Eventhouse |
Un centro de eventos. |
Eventstream |
Una secuencia de eventos. |
GraphQLApi |
Una API para el elemento GraphQL. |
KQLDashboard |
Un panel de KQL. |
KQLDatabase |
Una base de datos KQL. |
KQLQueryset |
Un conjunto de consultas KQL. |
Lakehouse |
Una casa de lago. |
MLExperiment |
Un experimento de aprendizaje automático. |
MLModel |
Un modelo de aprendizaje automático. |
MirroredDatabase |
Una base de datos reflejada. |
MirroredWarehouse |
Un almacén reflejado. |
MountedDataFactory |
A MountedDataFactory. |
Notebook |
Un cuaderno. |
PaginatedReport |
Informe paginado de PowerBI. |
Reflex |
Un reflejo. |
Report |
Informe de PowerBI. |
SQLDatabase |
A SQLDatabase. |
SQLEndpoint |
Un punto de conexión de SQL. |
SemanticModel |
Modelo semántico de PowerBI. |
SparkJobDefinition |
Una definición de trabajo de Spark. |
Warehouse |
Un almacén. |
MLModel
Objeto de modelo de Machine Learning.
Nombre | Tipo | Description |
---|---|---|
description |
string |
Descripción del elemento. |
displayName |
string |
Nombre para mostrar del elemento. |
id |
string uuid |
Identificador del elemento. |
type |
Tipo de elemento. |
|
workspaceId |
string uuid |
Identificador del área de trabajo. |