Items - Update Warehouse Snapshot

Layanan:

WarehouseSnapshot

Versi API:

v1

Memperbarui properti rekam jepret Gudang yang ditentukan.

Hak akses

Pemanggil harus memiliki izin baca dan tulis untuk rekam jepret gudang.

Cakupan yang Didelegasikan yang Diperlukan

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

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/warehousesnapshots/{warehouseSnapshotId}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
warehouseSnapshotId	path	True	string (uuid)	ID rekam jepret Gudang.
workspaceId	path	True	string (uuid)	ID ruangkerja.

Isi Permintaan

Nama	Jenis	Deskripsi
description	string	Deskripsi rekam jepret Gudang. Panjang maksimum adalah 256 karakter.
displayName	string	Nama tampilan rekam jepret Gudang. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.
properties	WarehouseSnapshotUpdateProperties	Payload properti pembaruan rekam jepret Gudang.

Respons

Nama	Jenis	Deskripsi
200 OK	WarehouseSnapshot	Permintaan berhasil diselesaikan.
Other Status Codes	ErrorResponse	Kode kesalahan umum: ItemNotFound - Item yang diminta tidak ditemukan. InvalidRequest - Permintaan pembaruan tidak valid.

Contoh

Update a Warehouse snapshot example

Permintaan sampel

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/warehousesnapshots/5b218778-e7a5-4d73-8187-f10824047715

{
  "displayName": "WarehouseSnapshot's New name",
  "description": "WarehouseSnapshot's New description",
  "properties": {
    "snapshotDateTime": "2024-10-10T15:20:15Z"
  }
}

Respon sampel

Kode status:

200

{
  "displayName": "WarehouseSnapshot's New name",
  "description": "WarehouseSnapshot's New description",
  "type": "WarehouseSnapshot",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "properties": {
    "connectionString": "qvrmbuxie7we7glrekxgy6npqu-6xgyei3x2xiejip4iime6knh5m.datawarehouse.fabric.microsoft.com",
    "parentWarehouseId": "7332259c-fb34-4975-99db-85818fb8664f",
    "snapshotDateTime": "2024-10-10T15:20:15Z"
  }
}

Definisi

Nama	Deskripsi
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
ItemTag	Mewakili tag yang diterapkan pada item.
ItemType	Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.
UpdateWarehouseSnapshotRequest	Perbarui permintaan rekam jepret Gudang.
WarehouseSnapshot	Objek rekam jepret Gudang.
WarehouseSnapshotProperties	Properti rekam jepret Gudang.
WarehouseSnapshotUpdateProperties	Payload properti pembaruan rekam jepret Gudang.

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

ItemTag

Objek

Mewakili tag yang diterapkan pada item.

Nama	Jenis	Deskripsi
displayName	string	Nama dari tag.
id	string (uuid)	ID tag.

ItemType

Enumeration

Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
ApacheAirflowJob	An ApacheAirflowJob.
CopyJob	Pekerjaan Penyalinan.
Dashboard	Dasbor PowerBI.
DataPipeline	Alur data.
Dataflow	Aliran Data.
Datamart	Datamart PowerBI.
DigitalTwinBuilder	Sebuah DigitalTwinBuilder.
DigitalTwinBuilderFlow	Alur Pembangun Kembar Digital.
Environment	Lingkungan.
Eventhouse	Sebuah rumah acara.
Eventstream	Eventstream.
GraphQLApi	API untuk item GraphQL.
KQLDashboard	Dasbor KQL.
KQLDatabase	Database KQL.
KQLQueryset	Set kueri KQL.
Lakehouse	Sebuah lakehouse.
MLExperiment	Eksperimen pembelajaran mesin.
MLModel	Model pembelajaran mesin.
MirroredAzureDatabricksCatalog	Katalog azure databricks cermin.
MirroredDatabase	Database cermin.
MirroredWarehouse	Sebuah gudang cermin.
MountedDataFactory	A MountedDataFactory.
Notebook	Buku catatan.
PaginatedReport	Laporan paginasi PowerBI.
Reflex	Sebuah Refleks.
Report	Laporan PowerBI.
SQLDatabase	Sebuah SQLDatabase.
SQLEndpoint	Titik akhir SQL.
SemanticModel	Model semantik PowerBI.
SparkJobDefinition	Definisi pekerjaan spark.
VariableLibrary	VariabelLibrary.
Warehouse	Sebuah gudang.
WarehouseSnapshot	Rekam jepret gudang.

UpdateWarehouseSnapshotRequest

Objek

Perbarui permintaan rekam jepret Gudang.

Nama	Jenis	Deskripsi
description	string	Deskripsi rekam jepret Gudang. Panjang maksimum adalah 256 karakter.
displayName	string	Nama tampilan rekam jepret Gudang. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.
properties	WarehouseSnapshotUpdateProperties	Payload properti pembaruan rekam jepret Gudang.

WarehouseSnapshot

Objek

Objek rekam jepret Gudang.

Nama	Jenis	Deskripsi
description	string	Deskripsi item.
displayName	string	Nama tampilan item.
folderId	string (uuid)	ID folder.
id	string (uuid)	ID item.
properties	WarehouseSnapshotProperties	Properti rekam jepret Gudang.
tags	ItemTag[]	Daftar tag yang diterapkan.
type	ItemType	Jenis item.
workspaceId	string (uuid)	ID ruangkerja.

WarehouseSnapshotProperties

Objek

Properti rekam jepret Gudang.

Nama	Jenis	Deskripsi
connectionString	string	String koneksi SQL yang terhubung ke ruang kerja yang berisi gudang ini.
parentWarehouseId	string	ID Gudang induk.
snapshotDateTime	string (date-time)	Tanggal dan waktu rekam jepret gudang saat ini dalam UTC, menggunakan format YYYY-MM-DDTHH:mm:ssZ.

WarehouseSnapshotUpdateProperties

Objek

Payload properti pembaruan rekam jepret Gudang.

Nama	Jenis	Deskripsi
snapshotDateTime	string (date-time)	Tanggal dan waktu yang digunakan untuk rekam jepret Gudang, jika tidak disediakan tanggal dan waktu saat ini akan diambil. Jika diberikan harus dalam UTC, menggunakan format YYYY-MM-DDTHH:mm:ssZ.