Items - Update Eventstream Definition

Layanan:: Eventstream

Versi API:: v1

Memperbarui definisi eventstream tertentu. Pembaruan mengambil alih definisi saat ini.
API ini mendukung operasi jangka panjang (LRO).

Memperbarui definisi eventstream, tidak memengaruhi label sensitivitasnya.

Hak akses

Pemanggil harus memiliki izin baca dan tulis untuk eventstream.

Cakupan yang Didelegasikan yang Diperlukan

Eventstream.ReadWrite.All atau Item.ReadWrite.All

Identitas yang didukung oleh Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas	Dukungan
Pengguna	Ya
Prinsipal Layanan dan Identitas Terkelola	Ya

Antarmuka

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/eventstreams/{eventstreamId}/updateDefinition

Dengan parameter opsional:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/eventstreams/{eventstreamId}/updateDefinition?updateMetadata={updateMetadata}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
eventstreamId	path	True	string (uuid)	ID dari eventstream.
workspaceId	path	True	string (uuid)	ID ruangkerja.
updateMetadata	query		boolean	Apakah akan memperbarui metadata item jika disediakan dalam `.platform` file. True - Perbarui metadata jika disediakan dalam `.platform` file sebagai bagian dari definisi, False - Jangan perbarui metadata.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
definition	True	EventstreamDefinition	Objek definisi publik eventstream. Lihat artikel ini untuk detail selengkapnya tentang struktur definisi Eventstream.

Respons

Nama	Jenis	Deskripsi
200 OK		Permintaan berhasil diselesaikan.
202 Accepted		Permintaan diterima. Definisi pembaruan sedang berlangsung. Header Location: string x-ms-operation-id: string Retry-After: integer
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: OperationNotSupportedForItem - Operasi tidak didukung untuk item yang diminta. CorruptedPayload - Payload yang disediakan rusak.

Contoh

Update an eventstream definition example

Permintaan sampel

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventstreams/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "eventstream.json",
        "payload": "SSdkIGxpa2UgdG8gdGVsbCBh..IGpva2UgZm9yIHlvdS4K",
        "payloadType": "InlineBase64"
      },
      {
        "path": "eventstreamProperties.json",
        "payload": "ewogICJyZXRlbnRpb25UaW1l..V2ZWwiOiAiTG93Igp9",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Respon sampel

Kode status:: 200

Kode status:: 202

Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

Definisi

Nama	Deskripsi
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
EventstreamDefinition	Objek definisi publik eventstream. Lihat artikel ini untuk detail selengkapnya tentang struktur definisi Eventstream.
EventstreamDefinitionPart	Objek bagian definisi eventstream.
PayloadType	Jenis payload bagian definisi. Jenis payload tambahan dapat ditambahkan dari waktu ke waktu.
UpdateEventstreamDefinitionRequest	Perbarui payload permintaan definisi publik eventstream.

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.
isRetriable	boolean	Jika benar, permintaan dapat dicoba kembali. `Retry-After` Gunakan header respons untuk menentukan penundaan, jika tersedia.
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.

EventstreamDefinition

Objek

Objek definisi publik eventstream. Lihat artikel ini untuk detail selengkapnya tentang struktur definisi Eventstream.

Nama	Jenis	Deskripsi
format	string	Format definisi eventstream.
parts	EventstreamDefinitionPart[]	Daftar bagian definisi.

EventstreamDefinitionPart

Objek

Objek bagian definisi eventstream.

Nama	Jenis	Deskripsi
path	string	Jalur bagian eventstream.
payload	string	Payload bagian eventstream.
payloadType	PayloadType	Jenis payload.

PayloadType

Enumerasi

Jenis payload bagian definisi. Jenis payload tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
InlineBase64	Dasar Sebaris 64.

UpdateEventstreamDefinitionRequest

Objek

Perbarui payload permintaan definisi publik eventstream.

Nama	Jenis	Deskripsi
definition	EventstreamDefinition	Objek definisi publik eventstream. Lihat artikel ini untuk detail selengkapnya tentang struktur definisi Eventstream.