Sdílet prostřednictvím


Items - Create ML Model

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

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ěď

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

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

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

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

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

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 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.