Items - Create ML Model

Hizmet:

MLModel

API Sürümü:

v1

Belirtilen çalışma alanında bir makine öğrenmesi modeli oluşturur.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

Bu API, tanımı olan bir makine öğrenmesi modeli oluşturmayı desteklemez.

İzinler

Çağıranın katkıda bulunan veya daha yüksek çalışma alanı rolü olmalıdır.

Gerekli Temsilci Kapsamları

MLModel.ReadWrite.All veya Item.ReadWrite.All

Sınırlama

• Makine öğrenmesi modeli oluşturmak için çalışma alanının desteklenen bir Doku kapasitesinde olması gerekir. Daha fazla bilgi için bkz. Microsoft Fabric lisans türleri.

Microsoft Entra tarafından desteklenen kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik	Destek
Kullanıcı	Evet
Hizmet sorumlusu ve yönetilen kimlikler	Hayır

Arayüz

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
workspaceId	path	True	string uuid	Çalışma alanı kimliği.

İstek Gövdesi

Name	Gerekli	Tür	Description
displayName	True	string	Makine öğrenmesi modelinin görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.
description		string	Makine öğrenmesi modeli açıklaması. Uzunluk üst sınırı 256 karakterdir.

Yanıtlar

Name	Tür	Description
201 Created	MLModel	Başarıyla oluşturuldu
202 Accepted		İstek kabul edildi, makine öğrenmesi modeli sağlama devam ediyor. Üst Bilgiler Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: InvalidItemType - Öğe türü geçersiz. ItemDisplayNameAlreadyInUse - Öğe görünen adı zaten kullanılıyor. BozukPayload - Sağlanan yük bozuk.

Örnekler

Create a machine learning model example

Örnek isteği

HTTP

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

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

Örnek yanıt

Durum kodu:

201

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

Durum kodu:

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

Tanımlar

Name	Description
CreateMLModelRequest	Makine öğrenmesi modeli istek yükü oluşturma.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
ItemType	Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.
MLModel	Makine öğrenmesi modeli nesnesi.

CreateMLModelRequest

Object

Makine öğrenmesi modeli istek yükü oluşturma.

Name	Tür	Description
description	string	Makine öğrenmesi modeli açıklaması. Uzunluk üst sınırı 256 karakterdir.
displayName	string	Makine öğrenmesi modelinin görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.

ErrorRelatedResource

Object

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Object

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Object

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

ItemType

Listeleme

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

Değer	Description
Dashboard	PowerBI panosu.
DataPipeline	Veri işlem hattı.
Datamart	PowerBI datamart.
Environment	Bir ortam.
Eventhouse	Bir olay evi.
Eventstream	Bir olay akışı.
GraphQLApi	GraphQL öğesi için bir API.
KQLDashboard	KQL panosu.
KQLDatabase	KQL veritabanı.
KQLQueryset	KQL sorgu kümesi.
Lakehouse	Göl evi.
MLExperiment	Makine öğrenmesi denemesi.
MLModel	Makine öğrenmesi modeli.
MirroredDatabase	Yansıtılmış veritabanı.
MirroredWarehouse	Aynalı bir depo.
MountedDataFactory	Bir MountedDataFactory.
Notebook	Bir not defteri.
PaginatedReport	PowerBI sayfalandırılmış raporu.
Reflex	Bir refleks.
Report	PowerBI raporu.
SQLDatabase	A SQLDatabase.
SQLEndpoint	Bir SQL uç noktası.
SemanticModel	PowerBI anlam modeli.
SparkJobDefinition	Spark iş tanımı.
Warehouse	Bir depo.

MLModel

Object

Makine öğrenmesi modeli nesnesi.

Name	Tür	Description
description	string	Öğe açıklaması.
displayName	string	Öğenin görünen adı.
id	string uuid	Öğe kimliği.
type	ItemType	Öğe türü.
workspaceId	string uuid	Çalışma alanı kimliği.