Dela via

Items - Create ML Model

  • Referens
Tjänst:
MLModel
API-version:
v1

Skapar en maskininlärningsmodell på den angivna arbetsytan.
Det här API:et stöder tidskrävande åtgärder (LRO).

Det här API:et stöder inte att skapa en maskininlärningsmodell med definition.

Behörigheter

Anroparen måste ha deltagare eller högre arbetsyteroll.

Obligatoriska delegerade omfång

MLModel.ReadWrite.All eller Item.ReadWrite.All

Begränsningar

  • Om du vill skapa en maskininlärningsmodell måste arbetsytan ha en infrastrukturkapacitet som stöds. Mer information finns i: Microsoft Fabric-licenstyper.

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet Stöd
Användare Ja
Tjänstens huvudnamn och hanterade identiteter Nej

Gränssnitt

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

URI-parametrar

Name I Obligatorisk Typ Description
workspaceId
 path True

string

uuid

Arbetsytans ID.

Begärandetext

Name Obligatorisk Typ Description
displayName True

string

Visningsnamnet för maskininlärningsmodellen. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.
description

string

Beskrivning av maskininlärningsmodellen. Maximal längd är 256 tecken.

Svar

Name Typ Description
201 Created

MLModel

Har skapats
202 Accepted

Begäran accepterad, etablering av maskininlärningsmodeller pågår.

Sidhuvuden

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

ErrorResponse

Vanliga felkoder:

  • InvalidItemType – Objekttypen är ogiltig.

  • ItemDisplayNameAlreadyInUse – Objektets visningsnamn används redan.

  • CorruptedPayload – den angivna nyttolasten är skadad.

Exempel

Create a machine learning model example

Exempelbegäran

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

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

Exempelsvar

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

Definitioner

Name Description
CreateMLModelRequest

Skapa nyttolasten för maskininlärningsmodellbegäran.
ErrorRelatedResource

Det felrelaterade resursinformationsobjektet.
ErrorResponse

Felsvaret.
ErrorResponseDetails

Information om felsvar.
ItemType

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.
MLModel

Ett maskininlärningsmodellobjekt.

CreateMLModelRequest

Objekt

Skapa nyttolasten för maskininlärningsmodellbegäran.

Name Typ Description
description

string

Beskrivning av maskininlärningsmodellen. Maximal längd är 256 tecken.
displayName

string

Visningsnamnet för maskininlärningsmodellen. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name Typ Description
resourceId

string

Det resurs-ID som ingår i felet.
resourceType

string

Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
moreDetails

ErrorResponseDetails[]

Lista över ytterligare felinformation.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.
requestId

string

ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.

ItemType

Uppräkning

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

Värde Description
Dashboard

PowerBI-instrumentpanel.
DataPipeline

En datapipeline.
Datamart

PowerBI-datamart.
Environment

En miljö.
Eventhouse

Ett eventhouse.
Eventstream

En händelseström.
GraphQLApi

Ett API för GraphQL-objekt.
KQLDashboard

En KQL-instrumentpanel.
KQLDatabase

En KQL-databas.
KQLQueryset

En KQL-frågeuppsättning.
Lakehouse

Ett sjöhus.
MLExperiment

Ett maskininlärningsexperiment.
MLModel

En maskininlärningsmodell.
MirroredDatabase

En speglad databas.
MirroredWarehouse

Ett speglat lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notebook-fil.
PaginatedReport

Sidnumrerad PowerBI-rapport.
Reflex

En reflex.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

En SQL-slutpunkt.
SemanticModel

PowerBI-semantisk modell.
SparkJobDefinition

En definition för Spark-jobb.
Warehouse

Ett lager.

MLModel

Objekt

Ett maskininlärningsmodellobjekt.

Name Typ Description
description

string

Objektbeskrivningen.
displayName

string

Objektets visningsnamn.
id

string

uuid

Objekt-ID:t.
type

ItemType

Objekttypen.
workspaceId

string

uuid

Arbetsytans ID.