Udostępnij przez

Items - Update Digital Twin Builder

Usługa:
DigitalTwinBuilder
Wersja API:
v1

Aktualizuje właściwości określonego obiektu DigitalTwinBuilder.

Note

Element usługi Digital Twin Builder jest obecnie dostępny w wersji zapoznawczej (dowiedz się więcej).

Permissions

Obiekt wywołujący musi mieć uprawnienia do odczytu i zapisu dla konstruktora cyfrowej reprezentacji bliźniaczej.

Wymagane zakresy delegowane

DigitalTwinBuilder.ReadWrite.All lub Item.ReadWrite.All

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Identity Support
User Yes
Główne usługi i Tożsamości zarządzane No

Interface

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/digitaltwinbuilders/{digitaltwinbuilderId}

Parametry URI

Nazwa W Wymagane Typ Opis
digitaltwinbuilderId
 path True

string (uuid)

Identyfikator digitaltwinbuilder.
workspaceId
 path True

string (uuid)

Identyfikator przestrzeni roboczej.

Ciało żądania

Nazwa Typ Opis
description

string

Opis elementu DigitalTwinBuilder. Maksymalna długość to 256 znaków.
displayName

string

Nazwa wyświetlana elementu DigitalTwinBuilder. Nazwa wyświetlana musi być zgodna z regułami nazewnictwa zgodnie z typem elementu.

Odpowiedzi

Nazwa Typ Opis
200 OK

DigitalTwinBuilder

Żądanie zostało ukończone pomyślnie.
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • ItemNotFound — żądany element nie został znaleziony.

  • InvalidRequest — nieprawidłowe żądanie aktualizacji.

Przykłady

Update a digitaltwinbuilder example

Przykładowa prośba

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

{
  "displayName": "DigitalTwinBuilder_New_Name",
  "description": "A new description for digitaltwinbuilder."
}

Przykładowa odpowiedź

Kod statusu:
200 
{
  "displayName": "DigitalTwinBuilder_New_Name",
  "description": "A new description for digitaltwinbuilder.",
  "type": "DigitalTwinBuilder",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Definicje

Nazwa Opis
DigitalTwinBuilder

Obiekt digitaltwinbuilder.
ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.
ItemTag

Reprezentuje tag zastosowany w elemencie.
ItemType

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.
UpdateDigitalTwinBuilderRequest

Zaktualizuj żądanie DigitalTwinBuilder.

DigitalTwinBuilder

Sprzeciwiać się

Obiekt digitaltwinbuilder.

Nazwa Typ Opis
description

string

Opis elementu.
displayName

string

Nazwa wyświetlana elementu.
folderId

string (uuid)

Identyfikator folderu.
id

string (uuid)

Identyfikator elementu.
tags

ItemTag[]

Lista zastosowanych tagów.
type

ItemType

Typ elementu.
workspaceId

string (uuid)

Identyfikator przestrzeni roboczej.

ErrorRelatedResource

Sprzeciwiać się

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa Typ Opis
resourceId

string

Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType

string

Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Sprzeciwiać się

Odpowiedź na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.
requestId

string

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Sprzeciwiać się

Szczegóły odpowiedzi na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

ItemTag

Sprzeciwiać się

Reprezentuje tag zastosowany w elemencie.

Nazwa Typ Opis
displayName

string

Nazwa znacznika.
id

string (uuid)

Identyfikator tagu.

ItemType

Wyliczenie

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.

Wartość Opis
Dashboard

Pulpit nawigacyjny usługi Power BI.
Report

Raport usługi Power BI.
SemanticModel

Model semantyczny usługi PowerBI.
PaginatedReport

Raport podzielony na strony usługi PowerBI.
Datamart

Datamart usługi Power BI.
Lakehouse

Jezioro.
Eventhouse

Magazyn zdarzeń.
Environment

Środowisko.
KQLDatabase

Baza danych KQL.
KQLQueryset

Zestaw zapytań KQL.
KQLDashboard

Pulpit nawigacyjny KQL.
DataPipeline

Potok danych.
Notebook

Zeszyt.
SparkJobDefinition

Definicja zadania platformy Spark.
MLExperiment

Eksperyment uczenia maszynowego.
MLModel

Model uczenia maszynowego.
Warehouse

Magazyn.
Eventstream

Strumień zdarzeń.
SQLEndpoint

Punkt końcowy SQL.
MirroredWarehouse

Dublowany magazyn.
MirroredDatabase

Dublowana baza danych.
Reflex

Refleks.
GraphQLApi

Interfejs API dla elementu GraphQL.
MountedDataFactory

A MountedDataFactory.
SQLDatabase

Baza danych SQLDatabase.
CopyJob

Zadanie kopiowania.
VariableLibrary

ZmiennaLibrary.
Dataflow

Przepływ danych.
ApacheAirflowJob

Zadanie ApacheAirflowJob.
WarehouseSnapshot

Migawka magazynu.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Przepływ usługi Digital Twin Builder.
MirroredAzureDatabricksCatalog

Dublowany wykaz usługi Azure Databricks.
Map

Mapa.
AnomalyDetector

Wykrywacz anomalii.
UserDataFunction

Funkcja danych użytkownika.
GraphModel

Model programu Graph.
GraphQuerySet

Zestaw zapytań programu Graph.
SnowflakeDatabase

Baza danych Snowflake do przechowywania tabel góry lodowej utworzonych na podstawie konta Snowflake.
OperationsAgent

A OperationsAgent.
CosmosDBDatabase

Baza danych usługi Cosmos DB.
Ontology

Ontologia.
EventSchemaSet

An EventSchemaSet.

UpdateDigitalTwinBuilderRequest

Sprzeciwiać się

Zaktualizuj żądanie DigitalTwinBuilder.

Nazwa Typ Opis
description

string

Opis elementu DigitalTwinBuilder. Maksymalna długość to 256 znaków.
displayName

string

Nazwa wyświetlana elementu DigitalTwinBuilder. Nazwa wyświetlana musi być zgodna z regułami nazewnictwa zgodnie z typem elementu.