Items - Create ML Experiment

Szolgáltatás:

MLExperiment

API-verzió:

v1

Gépi tanulási kísérletet hoz létre 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 kísérlet 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

MLExperiment.ReadWrite.All vagy Item.ReadWrite.All

Korlátozások

• Gépi tanulási kísérlet 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}/mlExperiments

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 kísérlet 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 kísérlet leírása. A maximális hossz 256 karakter.

Válaszok

Name	Típus	Description
201 Created	MLExperiment	Sikeresen létrehozva
202 Accepted		A kérelem elfogadva, a gépi tanulási kísérlet 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. WorkspaceItemsLimitExceeded – A munkaterület elemkorlátja túllépve.

Példák

Create a machine learning experiment example

Mintakérelem

HTTP

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

{
  "displayName": "MLExperiment_1",
  "description": "A machine learning experiment description"
}

Mintaválasz

Állapotkód:

201

{
  "displayName": "MLExperiment_1",
  "description": "A machine learning experiment description",
  "type": "MLExperiment",
  "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
CreateMLExperimentRequest	Gépi tanulási kísérletkérés 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.
ItemTag	Egy elemre alkalmazott címkét jelöl.
ItemType	Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
MLExperiment	Gépi tanulási kísérlet objektum.

CreateMLExperimentRequest

Objektum

Gépi tanulási kísérletkérés hasznos adatainak létrehozása.

Name	Típus	Description
description	string	A gépi tanulási kísérlet leírása. A maximális hossz 256 karakter.
displayName	string	A gépi tanulási kísérlet 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.

ItemTag

Objektum

Egy elemre alkalmazott címkét jelöl.

Name	Típus	Description
displayName	string	A címke neve.
id	string (uuid)	A címke azonosítója.

ItemType

Enumerálás

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

Érték	Description
CopyJob	Másolási feladat.
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.
VariableLibrary	Egy VariableLibrary.
Warehouse	Egy raktár.

MLExperiment

Objektum

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

Name	Típus	Description
description	string	Az elem leírása.
displayName	string	Az elem megjelenítendő neve.
folderId	string (uuid)	A mappa azonosítója.
id	string (uuid)	Az elem azonosítója.
tags	ItemTag[]	Az alkalmazott címkék listája.
type	ItemType	Az elem típusa.
workspaceId	string (uuid)	A munkaterület azonosítója.