Condividi tramite

Items - Create ML Model

  • Riferimento
Servizio:
MLModel
Versione API:
v1

Crea un modello di Machine Learning nell'area di lavoro specificata.
Questa API supporta operazioni con esecuzione prolungata (LRO).

Questa API non supporta la creazione di un modello di Machine Learning con definizione.

Autorizzazioni

Il chiamante deve avere ruolo collaboratore o superiore dell'area di lavoro.

Ambiti delegati obbligatori

MLModel.ReadWrite.All o Item.ReadWrite.All

Limitazioni

  • Per creare un modello di Machine Learning, l'area di lavoro deve trovarsi in una capacità di Infrastruttura supportata. Per altre informazioni, vedere: tipi di licenza di Microsoft Fabric.

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identità Appoggiare
Utente Sì
'entità servizio e identità gestite No

Interfaccia

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
workspaceId
 path True

string

uuid

ID dell'area di lavoro.

Corpo della richiesta

Nome Necessario Tipo Descrizione
displayName True

string

Nome visualizzato del modello di Machine Learning. Il nome visualizzato deve seguire le regole di denominazione in base al tipo di elemento.
description

string

Descrizione del modello di Machine Learning. La lunghezza massima è di 256 caratteri.

Risposte

Nome Tipo Descrizione
201 Created

MLModel

Creazione completata
202 Accepted

Richiesta accettata, provisioning del modello di Machine Learning in corso.

Intestazioni

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Codici di errore comuni:

  • InvalidItemType: il tipo di elemento non è valido.

  • ItemDisplayNameAlreadyInUse: il nome visualizzato dell'elemento è già usato.

  • CorruptedPayload: il payload fornito è danneggiato.

Esempio

Create a machine learning model example

Esempio di richiesta

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/mlModels

{
  "displayName": "MLModel_1",
  "description": "A machine learning model description."
}

Risposta di esempio

Codice di stato:
201 
{
  "displayName": "MLModel_1",
  "description": "A machine learning model description.",
  "type": "MLModel",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Codice di stato:
202 
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

Definizioni

Nome Descrizione
CreateMLModelRequest

Creare il payload della richiesta del modello di Machine Learning.
ErrorRelatedResource

Oggetto dettagli risorsa correlato all'errore.
ErrorResponse

Risposta di errore.
ErrorResponseDetails

Dettagli della risposta di errore.
ItemType

Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.
MLModel

Oggetto modello di Machine Learning.

CreateMLModelRequest

Object

Creare il payload della richiesta del modello di Machine Learning.

Nome Tipo Descrizione
description

string

Descrizione del modello di Machine Learning. La lunghezza massima è di 256 caratteri.
displayName

string

Nome visualizzato del modello di Machine Learning. Il nome visualizzato deve seguire le regole di denominazione in base al tipo di elemento.

ErrorRelatedResource

Object

Oggetto dettagli risorsa correlato all'errore.

Nome Tipo Descrizione
resourceId

string

ID risorsa coinvolto nell'errore.
resourceType

string

Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Object

Risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
moreDetails

ErrorResponseDetails[]

Elenco di dettagli aggiuntivi sull'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.
requestId

string

ID della richiesta associata all'errore.

ErrorResponseDetails

Object

Dettagli della risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.

ItemType

Enumeration

Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.

Valore Descrizione
Dashboard

Dashboard di Power BI.
DataPipeline

Una pipeline di dati.
Datamart

Datamart di PowerBI.
Environment

Un ambiente.
Eventhouse

Una casa eventi.
Eventstream

Flusso di eventi.
GraphQLApi

API per l'elemento GraphQL.
KQLDashboard

Dashboard KQL.
KQLDatabase

Un database KQL.
KQLQueryset

Set di query KQL.
Lakehouse

Una lakehouse.
MLExperiment

Esperimento di Machine Learning.
MLModel

Modello di Machine Learning.
MirroredDatabase

Database con mirroring.
MirroredWarehouse

Magazzino con mirroring.
MountedDataFactory

Oggetto MountedDataFactory.
Notebook

Un notebook.
PaginatedReport

Report impaginato di Power BI.
Reflex

Un riflesso.
Report

Report di Power BI.
SQLDatabase

A SQLDatabase.
SQLEndpoint

Endpoint SQL.
SemanticModel

Modello semantico di PowerBI.
SparkJobDefinition

Definizione di processo Spark.
Warehouse

Un magazzino.

MLModel

Object

Oggetto modello di Machine Learning.

Nome Tipo Descrizione
description

string

Descrizione dell'elemento.
displayName

string

Nome visualizzato dell'elemento.
id

string

uuid

ID elemento.
type

ItemType

Tipo di elemento.
workspaceId

string

uuid

ID dell'area di lavoro.