Items - Create ML Model

Služba:

MLModel

Verze rozhraní API:

v1

Vytvoří model strojového učení v zadaném pracovním prostoru.
Toto rozhraní API podporuje dlouhotrvajících operací (LRO).

Toto rozhraní API nepodporuje vytvoření modelu strojového učení s definicí.

Dovolení

Volající musí mít roli přispěvatele nebo vyšší.

Požadované delegovaná rozsahy

MLModel.ReadWrite.All nebo Item.ReadWrite.All

Omezení

• Pokud chcete vytvořit model strojového učení, musí být pracovní prostor v podporované kapacitě Fabric. Další informace naleznete v tématu: typy licencí Microsoft Fabric.

Podporované identity Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita	Podpora
Uživatel	Ano
instančního objektu a spravované identity	Ne

Rozhraní

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
workspaceId	path	True	string uuid	ID pracovního prostoru.

Text požadavku

Name	Vyžadováno	Typ	Description
displayName	True	string	Zobrazovaný název modelu strojového učení Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.
description		string	Popis modelu strojového učení Maximální délka je 256 znaků.

Odpovědi

Name	Typ	Description
201 Created	MLModel	Úspěšně vytvořeno
202 Accepted		Žádost byla přijata a probíhá zřizování modelů strojového učení. Hlavičky Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Běžné kódy chyb: InvalidItemType – Typ položky je neplatný. ItemDisplayNameAlreadyInUse – Zobrazovaný název položky je již použit. Poškozená částPayload – zadanou datovou část je poškozena.

Příklady

Create a machine learning model example

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kó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"
}

Stavový kó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

Definice

Name	Description
CreateMLModelRequest	Vytvořte datovou část žádosti o model strojového učení.
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.
ItemType	Typ položky. V průběhu času je možné přidat další typy položek.
MLModel	Objekt modelu strojového učení.

CreateMLModelRequest

Objekt

Vytvořte datovou část žádosti o model strojového učení.

Name	Typ	Description
description	string	Popis modelu strojového učení Maximální délka je 256 znaků.
displayName	string	Zobrazovaný název modelu strojového učení Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou

ItemType

Výčet

Typ položky. V průběhu času je možné přidat další typy položek.

Hodnota	Description
Dashboard	Řídicí panel PowerBI
DataPipeline	Datový kanál.
Datamart	Datový diagram PowerBI
Environment	Prostředí.
Eventhouse	Eventhouse.
Eventstream	Eventstream.
GraphQLApi	Rozhraní API pro položku GraphQL
KQLDashboard	Řídicí panel KQL.
KQLDatabase	Databáze KQL.
KQLQueryset	Sada dotazů KQL.
Lakehouse	Jezero.
MLExperiment	Experiment strojového učení.
MLModel	Model strojového učení.
MirroredDatabase	Zrcadlené databáze.
MirroredWarehouse	Zrcadlený sklad.
MountedDataFactory	A MountedDataFactory.
Notebook	Poznámkový blok.
PaginatedReport	Stránkovaná sestava PowerBI
Reflex	A Reflex.
Report	Sestava PowerBI
SQLDatabase	Databáze SQLDatabase.
SQLEndpoint	Koncový bod SQL.
SemanticModel	Sémantický model PowerBI
SparkJobDefinition	Definice úlohy Sparku.
Warehouse	Sklad.

MLModel

Objekt

Objekt modelu strojového učení.

Name	Typ	Description
description	string	Popis položky.
displayName	string	Zobrazovaný název položky.
id	string uuid	ID položky.
type	ItemType	Typ položky.
workspaceId	string uuid	ID pracovního prostoru.