Items - Update Mirrored Database Definition

Hizmet:

MirroredDatabase

API Sürümü:

v1

Belirtilen yansıtılmış veritabanı için tanımı geçersiz kılar.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

İzinler

Çağıranın, yansıtılan veritabanı için okuma ve yazma izinlerine sahip olması gerekir.

Gerekli Temsilci Kapsamları

MirroredDatabase.ReadWrite.All veya Item.ReadWrite.All

Microsoft Entra destekli kimlikler

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

Kimlik	Destek
Kullanıcı	Evet
Hizmet sorumlusu ve yönetilen kimlikler	Evet

Arayüz

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabases/{mirroredDatabaseId}/updateDefinition

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
mirroredDatabaseId	path	True	string (uuid)	Yansıtılmış veritabanı kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.

İstek Gövdesi

Name	Gerekli	Tür	Description
definition	True	MirroredDatabaseDefinition	Yansıtılmış veritabanı ortak tanım nesnesi. Yansıtılmış veritabanı tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.

Yanıtlar

Name	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 mirrored database definition example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/mirroredDatabases/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2/updateDefinition

{
  "definition": {
    "parts": [
      {
        "path": "mirroring.json",
        "payload": "eyAicHJvcGVydGllcy..WJsZSIgfSB9IH0gXSB9IH0",
        "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/0000aaaa-11bb-cccc-dd22-eeeeee333333
x-ms-operation-id: 0000aaaa-11bb-cccc-dd22-eeeeee333333
Retry-After: 30

Tanımlar

Name	Description
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
MirroredDatabaseDefinition	Yansıtılmış veritabanı ortak tanım nesnesi. Yansıtılmış veritabanı tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.
MirroredDatabaseDefinitionPart	Yansıtılmış veritabanı 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.
UpdateMirroredDatabaseDefinitionRequest	Yansıtılmış veritabanı genel tanımı istek yükünü güncelleştirin.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

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

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

Name	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.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

MirroredDatabaseDefinition

Nesne

Yansıtılmış veritabanı ortak tanım nesnesi. Yansıtılmış veritabanı tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.

Name	Tür	Description
format	string	Yansıtılmış veritabanı tanımının biçimi.
parts	MirroredDatabaseDefinitionPart[]	Tanım bölümlerinin listesi.

MirroredDatabaseDefinitionPart

Nesne

Yansıtılmış veritabanı tanımı parça nesnesi.

Name	Tür	Description
path	string	Yansıtılmış veritabanı parça yolu.
payload	string	Yansıtılmış veritabanı 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.

UpdateMirroredDatabaseDefinitionRequest

Nesne

Yansıtılmış veritabanı genel tanımı istek yükünü güncelleştirin.

Name	Tür	Description
definition	MirroredDatabaseDefinition	Yansıtılmış veritabanı ortak tanım nesnesi. Yansıtılmış veritabanı tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.