Items - Update Graph Model Definition

Hizmet:: GraphModel

API Sürümü:: v1

Belirtilen GraphModel için tanımı geçersiz kılar.

Uyarı

GraphModel öğesi şu anda Önizleme aşamasındadır (daha fazla bilgi edinin).

Bu API, uzun süre çalışan işlemleri (LRO)destekler.

GraphModel'in tanımının güncelleştirilmesi, duyarlılık etiketini etkilemez.

Permissions

Çağıranın GraphModel için okuma ve yazma izinlerine sahip olması gerekir.

Gerekli Temsilci Kapsamları

Item.ReadWrite.All

Desteklenen kimlikleri Microsoft Entra

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

Kimlik	Support
User	Yes
Hizmet sorumlusu ve yönetilen kimlikler	Yes

Arayüz

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/graphModels/{graphModelId}/updateDefinition

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Veri Akışı Adı	İçinde	Gerekli	Tür	Description
graphModelId	path	True	string (uuid)	GraphModel Kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.
updateMetadata	query		boolean	True olarak ayarlandığında ve .platform dosyası tanımın bir parçası olarak sağlandığında, öğenin meta verileri .platform dosyasındaki meta veriler kullanılarak güncelleştirilir

İstek Gövdesi

Veri Akışı Adı	Gerekli	Tür	Description
definition	True	GraphModelPublicDefinition	GraphModel genel tanım nesnesi. GraphModel tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.

Yanıtlar

Veri Akışı Adı	Tür	Description
200 OK		İstek başarıyla tamamlandı.
202 Accepted		İstek kabul edildi. Güncelleştirme tanımı devam ediyor. Üst Bilgiler Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: OperationNotSupportedForItem - İstenen öğe için işlem desteklenmiyor. BozukPayload - Sağlanan yük bozuk.

Örnekler

Update a GraphModel public definition example

Örnek isteği

HTTP

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

{
  "definition": {
    "format": "json",
    "parts": [
      {
        "path": "graphType.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "graphDefinition.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "dataSources.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "stylingConfiguration.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Örnek yanıt

Durum kodu:: 200

Durum kodu:: 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

Tanımlar

Veri Akışı Adı	Description
ErrorParameter	Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
GraphModelDefinitionFormat	Grafik modeli tanımının biçimi. Zaman içinde ek `format` türleri eklenebilir.
GraphModelPublicDefinition	GraphModel genel tanım nesnesi. GraphModel tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.
GraphModelPublicDefinitionPart	GraphModel tanımı parça nesnesi.
PayloadType	Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir.
UpdateGraphModelDefinitionRequest	GraphModel genel tanım isteği yükünü güncelleştirin.

ErrorParameter

Nesne

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.

Veri Akışı Adı	Tür	Description
message	string	Parametrenin anlamının insan tarafından okunabilen açıklaması.
name	string	Parametre tanımlayıcısı.
value	string	Parametre değeridir.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Veri Akışı Adı	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Veri Akışı Adı	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ı.
isRetriable	boolean	True olduğunda istek yeniden denenebilir. Varsa gecikmeyi `Retry-After` belirlemek için yanıt üst bilgisini kullanın.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

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

Veri Akışı Adı	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.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

GraphModelDefinitionFormat

Numaralandırma

Grafik modeli tanımının biçimi. Zaman içinde ek format türleri eklenebilir.

Değer	Description
json	GraphModel genel tanımı için JSON biçimi, özellikle Doku'daki CI/CD senaryolarını desteklemek üzere tasarlanmıştır.

GraphModelPublicDefinition

Nesne

GraphModel genel tanım nesnesi. GraphModel tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.

Veri Akışı Adı	Tür	Description
format	GraphModelDefinitionFormat	Grafik modeli tanımının biçimi. Zaman içinde ek `format` türleri eklenebilir.
parts	GraphModelPublicDefinitionPart[]	Tanım bölümlerinin listesi.

GraphModelPublicDefinitionPart

Nesne

GraphModel tanımı parça nesnesi.

Veri Akışı Adı	Tür	Description
path	string	GraphModel genel tanımı parça yolu.
payload	string	GraphModel genel tanımı parça yükü.
payloadType	PayloadType	Yük türü.

PayloadType

Numaralandırma

Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir.

Değer	Description
InlineBase64	Satır içi Temel 64.

UpdateGraphModelDefinitionRequest

Nesne

GraphModel genel tanım isteği yükünü güncelleştirin.

Veri Akışı Adı	Tür	Description
definition	GraphModelPublicDefinition	GraphModel genel tanım nesnesi. GraphModel tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.