Endpoint - Update ML Model Endpoint

Layanan:: MLModel

Versi API:: v1

Memperbarui versi default model yang ditentukan.

Permissions

Pemanggil harus memiliki izin tulis pada MLModel.

Cakupan yang Didelegasikan yang Diperlukan

MLModel.ReadWrite.All atau Item.ReadWrite.All

Identitas yang didukung oleh Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identity	Support
User	Yes
Prinsipal Layanan dan Identitas Terkelola	Yes

Interface

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mlmodels/{modelId}/endpoint

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
modelId	path	True	string (uuid)	ID model pembelajaran mesin.
workspaceId	path	True	string (uuid)	ID ruangkerja.

Isi Permintaan

Nama	Jenis	Deskripsi
defaultVersionAssignmentBehavior	EndpointDefaultVersionConfigurationPolicy	Perilaku penetapan versi default dari titik akhir model pembelajaran mesin tertentu. Jenis EndpointDefaultVersionConfigurationPolicy tambahan dapat ditambahkan dari waktu ke waktu.
defaultVersionName	string	Nama versi titik akhir model pembelajaran mesin default.

Respons

Nama Jenis Deskripsi

200 OK

Nama	Jenis	Deskripsi
200 OK	MLModelEndpoint	Titik akhir diperbarui.
429 Too Many Requests	ErrorResponse	Batas tarif layanan terlampaui. Server mengembalikan header yang `Retry-After` menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan. Header Retry-After: integer
Other Status Codes	ErrorResponse	Kode kesalahan umum: NotFound - Versi tidak ditemukan. UnknownError - Terjadi kesalahan. Konflik - Operasi sudah menjadi proress. BadInput - Input Pengguna tidak valid.

MLModelEndpoint

Titik akhir diperbarui.

429 Too Many Requests

ErrorResponse

Batas tarif layanan terlampaui. Server mengembalikan header yang Retry-After menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan.

Header

Retry-After: integer

Other Status Codes

ErrorResponse

Kode kesalahan umum:

NotFound - Versi tidak ditemukan.
UnknownError - Terjadi kesalahan.
Konflik - Operasi sudah menjadi proress.
BadInput - Input Pengguna tidak valid.

Contoh

Example of Update ML Model Endpoint

Example of Update ML Model Endpoint with an Activation Failure

Example of Update ML Model Endpoint

Permintaan sampel

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/cf5fef71-f7f3-43f3-ae7f-3c427922bef1/mlmodels/7e92a6fc-3ef5-40bf-96df-ddae3fcde313/endpoint

{
  "defaultVersionAssignmentBehavior": "StaticallyConfigured",
  "defaultVersionName": "1"
}

Respon sampel

Kode status:: 200

{
  "defaultVersionAssignmentBehavior": "StaticallyConfigured",
  "defaultVersionName": "1",
  "defaultVersionInfo": {
    "versionName": "1",
    "status": "Running",
    "inputSignature": [
      {
        "type": "double",
        "name": "age",
        "required": true
      },
      {
        "type": "double",
        "name": "sex",
        "required": true
      },
      {
        "type": "double",
        "name": "bmi",
        "required": true
      },
      {
        "type": "double",
        "name": "bp",
        "required": true
      },
      {
        "type": "double",
        "name": "s1",
        "required": true
      },
      {
        "type": "double",
        "name": "s2",
        "required": true
      },
      {
        "type": "double",
        "name": "s3",
        "required": true
      },
      {
        "type": "double",
        "name": "s4",
        "required": true
      },
      {
        "type": "double",
        "name": "s5",
        "required": true
      },
      {
        "type": "double",
        "name": "s6",
        "required": true
      }
    ],
    "outputSignature": [
      {
        "type": "double",
        "name": "target",
        "required": true
      }
    ],
    "scaleRule": "AlwaysOn"
  }
}

Example of Update ML Model Endpoint with an Activation Failure

Permintaan sampel

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/cf5fef71-f7f3-43f3-ae7f-3c427922bef1/mlmodels/7e92a6fc-3ef5-40bf-96df-ddae3fcde313/endpoint

{
  "defaultVersionAssignmentBehavior": "StaticallyConfigured",
  "defaultVersionName": "1"
}

Respon sampel

Kode status:: 200

{
  "defaultVersionAssignmentBehavior": "StaticallyConfigured",
  "defaultVersionName": "1",
  "defaultVersionInfo": {
    "versionName": "1",
    "status": "Failed",
    "failureDetails": {
      "errorCode": "InvalidInput",
      "message": "Tensor-based models are not supported yet."
    }
  }
}

Definisi

Nama	Deskripsi
EndpointDefaultVersionConfigurationPolicy	Perilaku penetapan versi default dari titik akhir model pembelajaran mesin tertentu. Jenis EndpointDefaultVersionConfigurationPolicy tambahan dapat ditambahkan dari waktu ke waktu.
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
FailureDetails	Detail Kegagalan Aktivasi.
MLModelDataSchema	Skema data model pembelajaran mesin.
MLModelEndpoint	Objek titik akhir model pembelajaran mesin.
MLModelEndpointVersionInfo	Informasi versi Titik Akhir Model Pembelajaran Mesin.
ModelEndpointVersionStatus	Status versi titik akhir model pembelajaran mesin tertentu. Jenis ModelEndpointVersionStatus tambahan dapat ditambahkan dari waktu ke waktu.
ScaleRule	Aturan skala titik akhir model pembelajaran mesin. Jenis ScaleRule tambahan dapat ditambahkan dari waktu ke waktu.
UpdateMLModelEndpointRequest	Isi permintaan titik akhir model pembelajaran mesin untuk memperbarui properti Titik Akhir Model.

EndpointDefaultVersionConfigurationPolicy

Enumerasi

Perilaku penetapan versi default dari titik akhir model pembelajaran mesin tertentu. Jenis EndpointDefaultVersionConfigurationPolicy tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
StaticallyConfigured	Versi default dikonfigurasi secara statis.
NotConfigured	Tidak ada versi default yang telah dikonfigurasi.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama	Jenis	Deskripsi
resourceId	string	ID sumber daya yang terlibat dalam kesalahan.
resourceType	string	Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
moreDetails	ErrorResponseDetails[]	Daftar detail kesalahan tambahan.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.
requestId	string (uuid)	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Detail respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.

FailureDetails

Objek

Detail Kegagalan Aktivasi.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.

MLModelDataSchema

Objek

Skema data model pembelajaran mesin.

Nama	Jenis	Deskripsi
name	string	Nama tanda tangan.
required	boolean	Nilai boolean untuk menunjukkan apakah tanda tangan diperlukan atau tidak. Benar - Diperlukan, Salah - Tidak Diperlukan.
type	string	Jenis tanda tangan.

MLModelEndpoint

Objek

Objek titik akhir model pembelajaran mesin.

Nama	Jenis	Deskripsi
defaultVersionAssignmentBehavior	EndpointDefaultVersionConfigurationPolicy	Perilaku penetapan versi default dari titik akhir model pembelajaran mesin tertentu. Jenis EndpointDefaultVersionConfigurationPolicy tambahan dapat ditambahkan dari waktu ke waktu.
defaultVersionInfo	MLModelEndpointVersionInfo	Informasi versi Titik Akhir Model Pembelajaran Mesin.
defaultVersionName	string	Nama versi titik akhir model pembelajaran mesin default.

MLModelEndpointVersionInfo

Objek

Informasi versi Titik Akhir Model Pembelajaran Mesin.

Nama	Jenis	Deskripsi
failureDetails	FailureDetails	Detail Kegagalan Aktivasi.
inputSignature	MLModelDataSchema[]	Tanda tangan input untuk versi model pembelajaran mesin ini.
outputSignature	MLModelDataSchema[]	Tanda tangan output untuk versi model pembelajaran mesin ini.
scaleRule	ScaleRule	Aturan skala titik akhir model pembelajaran mesin. Jenis ScaleRule tambahan dapat ditambahkan dari waktu ke waktu.
status	ModelEndpointVersionStatus	Status versi titik akhir model pembelajaran mesin tertentu. Jenis ModelEndpointVersionStatus tambahan dapat ditambahkan dari waktu ke waktu.
versionName	string	Nama versi model pembelajaran mesin

ModelEndpointVersionStatus

Enumerasi

Status versi titik akhir model pembelajaran mesin tertentu. Jenis ModelEndpointVersionStatus tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Deactivated	Semua sumber daya dinonaktifkan.
Activating	Aktivasi titik akhir model pembelajaran mesin sedang berlangsung.
Deactivating	Pennonaktifkanan titik akhir model pembelajaran mesin sedang berlangsung.
Active	Titik akhir model pembelajaran mesin tersedia untuk melayani permintaan skor.
Failed	Titik akhir model pembelajaran mesin dalam status gagal.

ScaleRule

Enumerasi

Aturan skala titik akhir model pembelajaran mesin. Jenis ScaleRule tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
AlwaysOn	Titik akhir model pembelajaran mesin harus AlwaysOn.
AllowScaleToZero	Titik akhir model pembelajaran mesin dapat diskalakan ke nol setelah periode tidak aktif.

UpdateMLModelEndpointRequest

Objek

Isi permintaan titik akhir model pembelajaran mesin untuk memperbarui properti Titik Akhir Model.

Nama	Jenis	Deskripsi
defaultVersionAssignmentBehavior	EndpointDefaultVersionConfigurationPolicy	Perilaku penetapan versi default dari titik akhir model pembelajaran mesin tertentu. Jenis EndpointDefaultVersionConfigurationPolicy tambahan dapat ditambahkan dari waktu ke waktu.
defaultVersionName	string	Nama versi titik akhir model pembelajaran mesin default.