Del via

Items - Create ML Model

  • Reference
Tjeneste:
MLModel
API-version:
v1

Opretter en model til maskinel indlæring i det angivne arbejdsområde.
Denne API understøtter LRO-handlinger (Long Running Operations).

Denne API understøtter ikke oprettelse af en model til maskinel indlæring med definition.

Tilladelser

Den, der ringer op, skal have bidragyder eller en højere rolle i arbejdsområdet.

Påkrævede delegerede områder

MLModel.ReadWrite.All eller Item.ReadWrite.All

Begrænsninger

  • Hvis du vil oprette en model til maskinel indlæring, skal arbejdsområdet være på en understøttet Fabric-kapacitet. Du kan få flere oplysninger under: Microsoft Fabric-licenstyper.

Microsoft Entra-understøttede identiteter

Denne API understøtter de Microsoft -identiteter, der angivet i dette afsnit.

Identitet Støtte
Bruger Ja
tjenesteprincipal og administrerede identiteter Nej

Grænseflade

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

URI-parametre

Name I Påkrævet Type Beskrivelse
workspaceId
 path True

string

uuid

Arbejdsområde-id'et.

Brødtekst for anmodning

Name Påkrævet Type Beskrivelse
displayName True

string

Vist navn på model til maskinel indlæring. Det viste navn skal følge navngivningsreglerne i henhold til elementtypen.
description

string

Beskrivelse af model til maskinel indlæring. Maksimumlængden er 256 tegn.

Svar

Name Type Beskrivelse
201 Created

MLModel

Oprettet
202 Accepted

Anmodning accepteret, klargøring af model til maskinel indlæring er i gang.

Headere

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

ErrorResponse

Almindelige fejlkoder:

  • InvalidItemType – Elementtypen er ugyldig.

  • ItemDisplayNameAlreadyInUse – Det viste navn på elementet bruges allerede.

  • CorruptedPayload – Den angivne nyttedata er beskadiget.

Eksempler

Create a machine learning model example

Eksempelanmodning

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

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

Eksempelsvar

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

Opret nyttedata for modelanmodninger til maskinel indlæring.
ErrorRelatedResource

Objektet med fejlrelaterede ressourceoplysninger.
ErrorResponse

Fejlsvaret.
ErrorResponseDetails

Oplysninger om fejlsvar.
ItemType

Elementets type. Der kan tilføjes flere elementtyper over tid.
MLModel

Et modelobjekt til maskinel indlæring.

CreateMLModelRequest

Object

Opret nyttedata for modelanmodninger til maskinel indlæring.

Name Type Beskrivelse
description

string

Beskrivelse af model til maskinel indlæring. Maksimumlængden er 256 tegn.
displayName

string

Vist navn på model til maskinel indlæring. Det viste navn skal følge navngivningsreglerne i henhold til elementtypen.

ErrorRelatedResource

Object

Objektet med fejlrelaterede ressourceoplysninger.

Name Type Beskrivelse
resourceId

string

Det ressource-id, der er involveret i fejlen.
resourceType

string

Typen af ressource, der er involveret i fejlen.

ErrorResponse

Object

Fejlsvaret.

Name Type Beskrivelse
errorCode

string

Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message

string

En menneskelig læsbar gengivelse af fejlen.
moreDetails

ErrorResponseDetails[]

Liste over yderligere oplysninger om fejl.
relatedResource

ErrorRelatedResource

De fejlrelaterede ressourceoplysninger.
requestId

string

Id'et for den anmodning, der er knyttet til fejlen.

ErrorResponseDetails

Object

Oplysninger om fejlsvar.

Name Type Beskrivelse
errorCode

string

Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message

string

En menneskelig læsbar gengivelse af fejlen.
relatedResource

ErrorRelatedResource

De fejlrelaterede ressourceoplysninger.

ItemType

Optælling

Elementets type. Der kan tilføjes flere elementtyper over tid.

Værdi Beskrivelse
Dashboard

PowerBI-dashboard.
DataPipeline

En datapipeline.
Datamart

PowerBI-datamart.
Environment

Et miljø.
Eventhouse

Et eventhouse.
Eventstream

En hændelsesstream.
GraphQLApi

En API til GraphQL-element.
KQLDashboard

Et KQL-dashboard.
KQLDatabase

En KQL-database.
KQLQueryset

Et KQL-forespørgselssæt.
Lakehouse

Et søhus.
MLExperiment

Et maskinel indlæringseksperiment.
MLModel

En model til maskinel indlæring.
MirroredDatabase

En spejlet database.
MirroredWarehouse

Et spejlvendt lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notesbog.
PaginatedReport

Sideinddelt PowerBI-rapport.
Reflex

En refleks.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

Et SQL-slutpunkt.
SemanticModel

Semantisk PowerBI-model.
SparkJobDefinition

En spark jobdefinition.
Warehouse

Et lager.

MLModel

Object

Et modelobjekt til maskinel indlæring.

Name Type Beskrivelse
description

string

Elementbeskrivelsen.
displayName

string

Det viste elementnavn.
id

string

uuid

Element-id'et.
type

ItemType

Elementtypen.
workspaceId

string

uuid

Arbejdsområde-id'et.