Items - Create ML Model

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 un ruolo di area di lavoro collaboratore .

Ambiti delegati obbligatori

MLModel.ReadWrite.All o Item.ReadWrite.All

Limitazioni

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

Microsoft Entra identità supportate

Questa API supporta i Microsoft identities elencati in questa sezione.

Identità Appoggiare
Utente Sì
Principale del 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.
folderId

string (uuid)

ID cartella. Se non specificato o null, il modello di Machine Learning viene creato con l'area di lavoro come cartella.
sensitivityLabelSettings

SensitivityLabelSettings

Impostazioni delle etichette di riservatezza per il modello di Machine Learning.

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
429 Too Many Requests

ErrorResponse

È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione Retry-After che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive.

Intestazioni

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.

  • WorkspaceItemsLimitExceeded - Limite di elementi dell'area di lavoro superato.

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",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
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.
EntireTenantPrincipal

Rappresenta un'entità tenant
ErrorRelatedResource

Oggetto dettagli risorsa correlato all'errore.
ErrorResponse

Risposta di errore.
ErrorResponseDetails

Dettagli della risposta di errore.
GroupDetails

Dettagli specifici del gruppo. Applicabile quando il tipo di entità è Group.
GroupPrincipal

Rappresenta un gruppo di sicurezza.
GroupType

Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.
ItemTag

Rappresenta un tag applicato a un elemento.
ItemType

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

Oggetto modello di Machine Learning.
PrincipalType

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.
SensitivityLabel

Rappresenta un'etichetta di riservatezza applicata a un elemento.
SensitivityLabelApplyStrategy

Strategia per l'applicazione dell'etichetta di riservatezza. Il valore predefinito è ApplyOrFail. È possibile aggiungere altri tipi nel tempo.
SensitivityLabelSettings

Impostazioni dell'etichetta di riservatezza.
ServicePrincipalDetails

Dettagli specifici dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipal.
ServicePrincipalPrincipal

Rappresenta un'entità servizio Microsoft Entra.
ServicePrincipalProfileDetails

Dettagli del profilo dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipalProfile.
ServicePrincipalProfilePrincipal

Rappresenta un profilo dell'entità servizio.
UserDetails

Dettagli specifici dell'entità utente. Applicabile quando il tipo di entità è User.
UserPrincipal

Rappresenta un'entità utente Microsoft Entra.

CreateMLModelRequest

Oggetto

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.
folderId

string (uuid)

ID cartella. Se non specificato o null, il modello di Machine Learning viene creato con l'area di lavoro come cartella.
sensitivityLabelSettings

SensitivityLabelSettings

Impostazioni delle etichette di riservatezza per il modello di Machine Learning.

EntireTenantPrincipal

Oggetto

Rappresenta un'entità tenant

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità.
id

string (uuid)

ID dell'entità.
type string:

EntireTenant

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

ErrorRelatedResource

Oggetto

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

Oggetto

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 (uuid)

ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

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.

GroupDetails

Oggetto

Dettagli specifici del gruppo. Applicabile quando il tipo di entità è Group.

Nome Tipo Descrizione
groupType

GroupType

Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.

GroupPrincipal

Oggetto

Rappresenta un gruppo di sicurezza.

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità.
groupDetails

GroupDetails

Dettagli specifici del gruppo. Applicabile quando il tipo di entità è Group.
id

string (uuid)

ID dell'entità.
type string:

Group

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

GroupType

Enumerazione

Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.

Valore Descrizione
Unknown

Il tipo di gruppo principale è sconosciuto.
SecurityGroup

Principal è un gruppo di sicurezza.
DistributionList

Principal è una lista di distribuzione.

ItemTag

Oggetto

Rappresenta un tag applicato a un elemento.

Nome Tipo Descrizione
displayName

string

Nome del tag.
id

string (uuid)

ID tag.

ItemType

Enumerazione

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

Valore Descrizione
Dashboard

Dashboard di Power BI.
Report

Report di Power BI.
SemanticModel

Modello semantico di PowerBI.
PaginatedReport

Report impaginato di Power BI.
Datamart

Datamart di PowerBI.
Lakehouse

Una lakehouse.
Eventhouse

Una casa eventi.
Environment

Un ambiente.
KQLDatabase

Un database KQL.
KQLQueryset

Set di query KQL.
KQLDashboard

Dashboard KQL.
DataPipeline

Una pipeline di dati.
Notebook

Un notebook.
SparkJobDefinition

Definizione di processo Spark.
MLExperiment

Esperimento di Machine Learning.
MLModel

Modello di Machine Learning.
Warehouse

Un magazzino.
Eventstream

Flusso di eventi.
SQLEndpoint

Endpoint SQL.
MirroredWarehouse

Magazzino con mirroring.
MirroredDatabase

Database con mirroring.
Reflex

Un riflesso.
GraphQLApi

API per l'elemento GraphQL.
MountedDataFactory

Oggetto MountedDataFactory.
SQLDatabase

A SQLDatabase.
CopyJob

Processo di copia.
VariableLibrary

VariabileLibrary.
Dataflow

Flusso di dati.
ApacheAirflowJob

An ApacheAirflowJob.
WarehouseSnapshot

Uno snapshot del warehouse.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Flusso di Generatore di gemelli digitali.
MirroredAzureDatabricksCatalog

Catalogo di Azure databricks con mirroring.
Map

Una mappa.
AnomalyDetector

Rilevamento anomalie.
UserDataFunction

Funzione dati utente.
GraphModel

A GraphModel.
GraphQuerySet

Oggetto Graph QuerySet.
SnowflakeDatabase

Un database Snowflake per archiviare le tabelle Iceberg create dall'account Snowflake.
OperationsAgent

Oggetto OperationsAgent.
CosmosDBDatabase

Un database Cosmos DB.
Ontology

Ontologia.
EventSchemaSet

An EventSchemaSet.
DataAgent

Oggetto DataAgent.

MLModel

Oggetto

Oggetto modello di Machine Learning.

Nome Tipo Descrizione
defaultIdentity Principal:

Identità predefinita dell'elemento.
description

string

Descrizione dell'elemento.
displayName

string

Nome visualizzato dell'elemento.
folderId

string (uuid)

ID cartella.
id

string (uuid)

ID elemento.
sensitivityLabel

SensitivityLabel

Etichetta di riservatezza dell'elemento.
tags

ItemTag[]

Elenco di tag applicati.
type

ItemType

Tipo di elemento.
workspaceId

string (uuid)

ID dell'area di lavoro.

PrincipalType

Enumerazione

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

Valore Descrizione
User

Principal è un'entità utente Microsoft Entra.
ServicePrincipal

Principal è un'entità servizio Microsoft Entra.
Group

Principal è un gruppo di sicurezza.
ServicePrincipalProfile

Principal è un profilo dell'entità servizio.
EntireTenant

Principal rappresenta tutti gli utenti tenant.

SensitivityLabel

Oggetto

Rappresenta un'etichetta di riservatezza applicata a un elemento.

Nome Tipo Descrizione
id

string (uuid)

ID etichetta di riservatezza.

SensitivityLabelApplyStrategy

Enumerazione

Strategia per l'applicazione dell'etichetta di riservatezza. Il valore predefinito è ApplyOrFail. È possibile aggiungere altri tipi nel tempo.

Valore Descrizione
ApplyOrFail

Applicare l'etichetta di riservatezza o non eseguire l'operazione se non può essere applicata.
Ignore

Ignorare l'etichetta di riservatezza se non può essere applicata e procedere con l'operazione senza applicare l'etichetta.

SensitivityLabelSettings

Oggetto

Impostazioni dell'etichetta di riservatezza.

Nome Tipo Descrizione
labelId

string (uuid)

ID etichetta di riservatezza.
sensitivityLabelApplyStrategy

SensitivityLabelApplyStrategy

Strategia per l'applicazione dell'etichetta di riservatezza.

ServicePrincipalDetails

Oggetto

Dettagli specifici dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipal.

Nome Tipo Descrizione
aadAppId

string (uuid)

L'entità servizio Microsoft Entra AppId.

ServicePrincipalPrincipal

Oggetto

Rappresenta un'entità servizio Microsoft Entra.

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità.
id

string (uuid)

ID dell'entità.
servicePrincipalDetails

ServicePrincipalDetails

Dettagli specifici dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipal.
type string:

ServicePrincipal

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

ServicePrincipalProfileDetails

Oggetto

Dettagli del profilo dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipalProfile.

Nome Tipo Descrizione
parentPrincipal Principal:

Entità padre del profilo dell'entità servizio.

ServicePrincipalProfilePrincipal

Oggetto

Rappresenta un profilo dell'entità servizio.

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità.
id

string (uuid)

ID dell'entità.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Dettagli del profilo dell'entità servizio. Applicabile quando il tipo di entità è ServicePrincipalProfile.
type string:

ServicePrincipalProfile

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

UserDetails

Oggetto

Dettagli specifici dell'entità utente. Applicabile quando il tipo di entità è User.

Nome Tipo Descrizione
userPrincipalName

string

Nome principale utente.

UserPrincipal

Oggetto

Rappresenta un'entità utente Microsoft Entra.

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità.
id

string (uuid)

ID dell'entità.
type string:

User

Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.
userDetails

UserDetails

Dettagli specifici dell'entità utente. Applicabile quando il tipo di entità è User.