Jaa

Items - Create ML Model

Palvelu:
MLModel
Ohjelmointirajapinnan versio:
v1

Luo koneoppimismallin määritettyyn työtilaan.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Tämä ohjelmointirajapinta ei tue koneoppimismallin luomista määrityksen avulla.

Käyttöoikeudet

Kutsujalla on oltava osallistujan työtilan rooli.

Vaaditut delegoidut vaikutusalueet

MLModel.ReadWrite.All tai Item.ReadWrite.All

Rajoitukset

tuettujen käyttäjätietojen Microsoft Entra

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identiteetti Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Ei

Rajapinta

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

URI-parametrit

Nimi Kohteessa Pakollinen Tyyppi Description
workspaceId
 path True

string (uuid)

Työtilan tunnus.

Pyynnön leipäteksti

Nimi Pakollinen Tyyppi Description
displayName True

string

Koneoppimismallin näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.
description

string

Koneoppimismallin kuvaus. Enimmäispituus on 256 merkkiä.
folderId

string (uuid)

Kansion tunnus. Jos sitä ei määritetä tai se on tyhjäarvo, koneoppimismalli luodaan niin, että työtila on sen kansio.
sensitivityLabelSettings

SensitivityLabelSettings

Koneoppimismallin luottamuksellisuustunnisteasetukset.

Vastaukset

Nimi Tyyppi Description
201 Created

MLModel

Luonti onnistui
202 Accepted

Pyydä hyväksyttyä koneoppimismallin valmistelua.

Otsikot

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään.

Otsikot

Retry-After: integer
Other Status Codes

ErrorResponse

Yleiset virhekoodit:

  • InvalidItemType – Kohdetyyppi on virheellinen.

  • ItemDisplayNameAlreadyInUse – Kohteen näyttönimi on jo käytössä.

  • VioittunutPayload – Annetut tiedot ovat vioittuneet.

  • WorkspaceItemsLimitExceeded – Työtilan kohteen raja ylitetty.

Esimerkit

Create a machine learning model example

Mallipyyntö

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

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

Mallivastaus

Tilakoodi:
201 
{
  "displayName": "MLModel_1",
  "description": "A machine learning model description.",
  "type": "MLModel",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
Tilakoodi:
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

Määritelmät

Nimi Description
CreateMLModelRequest

Luo koneoppimismallin pyyntökuormitusta.
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen tiedot.
ItemTag

Edustaa kohteelle käytettyä tunnistetta.
ItemType

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.
MLModel

Koneoppimismallin objekti.
SensitivityLabel

Edustaa kohteelle käytettyä luottamuksellisuustunnistetta.
SensitivityLabelApplyStrategy

Tämä on luottamuksellisuustunnisteen käyttöön tarkoitettu strategia. Oletusarvo on ApplyOrFail. Muita tyyppejä voidaan lisätä ajan mittaan.
SensitivityLabelSettings

Luottamuksellisuustunnisteen asetukset.

CreateMLModelRequest

Kohde

Luo koneoppimismallin pyyntökuormitusta.

Nimi Tyyppi Description
description

string

Koneoppimismallin kuvaus. Enimmäispituus on 256 merkkiä.
displayName

string

Koneoppimismallin näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.
folderId

string (uuid)

Kansion tunnus. Jos sitä ei määritetä tai se on tyhjäarvo, koneoppimismalli luodaan niin, että työtila on sen kansio.
sensitivityLabelSettings

SensitivityLabelSettings

Koneoppimismallin luottamuksellisuustunnisteasetukset.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.
resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
moreDetails

ErrorResponseDetails[]

Luettelo virheiden lisätiedoista.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.
requestId

string (uuid)

Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.

ItemTag

Kohde

Edustaa kohteelle käytettyä tunnistetta.

Nimi Tyyppi Description
displayName

string

Tunnisteen nimi.
id

string (uuid)

Tunnisteen tunnus.

ItemType

Luettelointi

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.

Arvo Description
Dashboard

Power BI -koontinäyttö.
Report

PowerBI -raportti.
SemanticModel

PowerBI:n semanttinen malli.
PaginatedReport

PowerBI:n sivutettu raportti.
Datamart

PowerBI -tietomarssi.
Lakehouse

Tämä on lakehouse.
Eventhouse

Tapahtumatalo.
Environment

Ympäristö.
KQLDatabase

KQL-tietokanta.
KQLQueryset

KQL-kyselyjoukko.
KQLDashboard

KQL-koontinäyttö.
DataPipeline

Tietoputki.
Notebook

Muistikirja.
SparkJobDefinition

Spark-työn määritelmä.
MLExperiment

Koneoppimisen kokeilu.
MLModel

Koneoppimismalli.
Warehouse

Varasto.
Eventstream

Tapahtumavirta.
SQLEndpoint

SQL-päätepiste.
MirroredWarehouse

Peilattu varasto.
MirroredDatabase

Peilattu tietokanta.
Reflex

Refleksi.
GraphQLApi

Ohjelmointirajapinta GraphQL-kohteelle.
MountedDataFactory

A MountedDataFactory.
SQLDatabase

A SQLDatabase.
CopyJob

Kopiotyö.
VariableLibrary

MuuttujaLibrary.
Dataflow

Tietovuo.
ApacheAirflowJob

An ApacheAirflowJob.
WarehouseSnapshot

Varastotilannevedos.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Digital Twin Builder -työnkulku.
MirroredAzureDatabricksCatalog

Peilattu Azure Databricks -luettelo.
Map

Kartta.
AnomalyDetector

Poikkeamien tunnistaminen.
UserDataFunction

Käyttäjätietofunktio.
GraphModel

A GraphModel.
GraphQuerySet

A Graph QuerySet.
SnowflakeDatabase

Snowflake-tietokannalla tallennetaan Snowflake-tililtä luodut Iceberg-taulukot.
OperationsAgent

A OperationsAgent.
CosmosDBDatabase

Cosmos DB -tietokanta.
Ontology

Ontologia.
EventSchemaSet

An EventSchemaSet.
DataAgent

A DataAgent.

MLModel

Kohde

Koneoppimismallin objekti.

Nimi Tyyppi Description
description

string

Kohteen kuvaus.
displayName

string

Kohteen näyttönimi.
folderId

string (uuid)

Kansion tunnus.
id

string (uuid)

Kohdetunnus.
sensitivityLabel

SensitivityLabel

Kohteen luottamuksellisuustunniste.
tags

ItemTag[]

Luettelo käytössä olevista tunnisteista.
type

ItemType

Kohdetyyppi.
workspaceId

string (uuid)

Työtilan tunnus.

SensitivityLabel

Kohde

Edustaa kohteelle käytettyä luottamuksellisuustunnistetta.

Nimi Tyyppi Description
id

string (uuid)

Tämä on luottamuksellisuustunnisteen tunnus.

SensitivityLabelApplyStrategy

Luettelointi

Tämä on luottamuksellisuustunnisteen käyttöön tarkoitettu strategia. Oletusarvo on ApplyOrFail. Muita tyyppejä voidaan lisätä ajan mittaan.

Arvo Description
ApplyOrFail

Käytä luottamuksellisuustunnistetta tai epäonnistu toiminto, jos sitä ei voi käyttää.
Ignore

Ohita luottamuksellisuustunniste, jos sitä ei voi käyttää, ja jatka toiminnolla ilman tunnisteen käyttämistä.

SensitivityLabelSettings

Kohde

Luottamuksellisuustunnisteen asetukset.

Nimi Tyyppi Description
labelId

string (uuid)

Tämä on luottamuksellisuustunnisteen tunnus.
sensitivityLabelApplyStrategy

SensitivityLabelApplyStrategy

Tämä on luottamuksellisuustunnisteen käyttöön tarkoitettu strategia.