Megosztás a következőn keresztül:

Items - Create ML Model

  • Referencia
Szolgáltatás:
MLModel
API-verzió:
v1

Létrehoz egy gépi tanulási modellt a megadott munkaterületen.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

Ez az API nem támogatja a definícióval rendelkező gépi tanulási modell létrehozását.

Engedélyek

A hívónak közreműködői vagy magasabb munkaterületi szerepkört kell tartalmaznia.

Kötelező delegált hatókörök

MLModel.ReadWrite.All vagy Item.ReadWrite.All

Korlátozások

  • Gépi tanulási modell létrehozásához a munkaterületnek támogatott hálókapacitáson kell lennie. További információ: Microsoft Fabric-licenctípusok.

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság Támogat
Felhasználó Igen
szolgáltatásnév és felügyelt identitások Nem

Interfész

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

URI-paraméterek

Name In Kötelező Típus Description
workspaceId
 path True

string

uuid

A munkaterület azonosítója.

Kérelem törzse

Name Kötelező Típus Description
displayName True

string

A gépi tanulási modell megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.
description

string

A gépi tanulási modell leírása. A maximális hossz 256 karakter.

Válaszok

Name Típus Description
201 Created

MLModel

Sikeresen létrehozva
202 Accepted

A kérelem elfogadott, a gépi tanulási modell kiépítése folyamatban van.

Fejlécek

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

ErrorResponse

Gyakori hibakódok:

  • InvalidItemType – Az elem típusa érvénytelen.

  • ItemDisplayNameAlreadyInUse – Az elem megjelenítendő neve már használatban van.

  • CorruptedPayload – A megadott hasznos adatok sérültek.

Példák

Create a machine learning model example

Mintakérelem

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

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

Mintaválasz

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

Definíciók

Name Description
CreateMLModelRequest

Gépi tanulási modell kérésének hasznos adatainak létrehozása.
ErrorRelatedResource

A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse

A hibaválasz.
ErrorResponseDetails

A hibaválasz részletei.
ItemType

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
MLModel

Gépi tanulási modell objektum.

CreateMLModelRequest

Objektum

Gépi tanulási modell kérésének hasznos adatainak létrehozása.

Name Típus Description
description

string

A gépi tanulási modell leírása. A maximális hossz 256 karakter.
displayName

string

A gépi tanulási modell megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name Típus Description
resourceId

string

A hibában érintett erőforrás-azonosító.
resourceType

string

A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
moreDetails

ErrorResponseDetails[]

További hibaadatok listája.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.
requestId

string

A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.

ItemType

Enumerálás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték Description
Dashboard

PowerBI-irányítópult.
DataPipeline

Egy adatfolyam.
Datamart

PowerBI datamart.
Environment

Egy környezet.
Eventhouse

Egy rendezvényház.
Eventstream

Eseménystream.
GraphQLApi

Api a GraphQL-elemhez.
KQLDashboard

KQL-irányítópult.
KQLDatabase

KQL-adatbázis.
KQLQueryset

KQL-lekérdezéskészlet.
Lakehouse

Egy tóház.
MLExperiment

Gépi tanulási kísérlet.
MLModel

Gépi tanulási modell.
MirroredDatabase

Tükrözött adatbázis.
MirroredWarehouse

Egy tükrözött raktár.
MountedDataFactory

A MountedDataFactory.
Notebook

Egy jegyzetfüzet.
PaginatedReport

Többoldalas PowerBI-jelentés.
Reflex

Egy reflex.
Report

PowerBI-jelentés.
SQLDatabase

A SQLDatabase.
SQLEndpoint

EGY SQL-végpont.
SemanticModel

PowerBI szemantikai modell.
SparkJobDefinition

Spark-feladat definíciója.
Warehouse

Egy raktár.

MLModel

Objektum

Gépi tanulási modell objektum.

Name Típus Description
description

string

Az elem leírása.
displayName

string

Az elem megjelenítendő neve.
id

string

uuid

Az elem azonosítója.
type

ItemType

Az elem típusa.
workspaceId

string

uuid

A munkaterület azonosítója.