Bagikan melalui

Git - Update From Git

Layanan:
Core
Versi API:
v1

Memperbarui ruang kerja dengan penerapan yang didorong ke cabang yang tersambung.
API ini mendukung operasi jangka panjang (LRO).

Untuk menggunakan API ini, kredensial Git penelepon harus dikonfigurasi menggunakan Update My Git Credentials API. Anda dapat menggunakan Get My Git Credentials API untuk memeriksa konfigurasi kredensial Git.

Pembaruan hanya memengaruhi item di ruang kerja yang diubah dalam penerapan tersebut. Jika dipanggil setelah API Sambungkan dan Inisialisasi Koneksi , api akan melakukan pembaruan penuh dari seluruh ruang kerja.

Hak akses

Pemanggil harus memiliki kontributor atau peran ruang kerja yang lebih tinggi.

Cakupan yang Didelegasikan yang Diperlukan

Workspace.GitUpdate.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 Hanya didukung ketika semua item yang terlibat dalam operasi mendukung perwakilan layanan

Antarmuka

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/updateFromGit

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
workspaceId
 path True

string (uuid)

ID ruangkerja.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
remoteCommitHash True

string

Hash penerapan SHA penuh jarak jauh.
conflictResolution

WorkspaceConflictResolution

Resolusi konflik yang akan digunakan dalam pembaruan dari operasi Git. Jika item berkonflik dan resolusi konflik tidak ditentukan, operasi pembaruan tidak akan dimulai.
options

UpdateOptions

Opsi yang akan digunakan dalam pembaruan dari operasi Git
workspaceHead

string

Hash SHA penuh tempat ruang kerja disinkronkan. Nilai ini mungkin null hanya setelah Inisialisasi Koneksi. Dalam kasus lain, sistem akan memvalidasi bahwa nilai yang diberikan selaras dengan kepala yang diketahui oleh sistem.

Respons

Nama Jenis Deskripsi
200 OK

Permintaan berhasil diselesaikan.
202 Accepted

Permintaan diterima, perbarui dari Git yang sedang berlangsung.

Header

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Kode kesalahan umum:

  • WorkspaceNotConnectedToGit - Ruang kerja tidak tersambung ke git.

  • WorkspaceHasNoCapacityAssigned - Tidak ada kapasitas yang ditetapkan ke ruang kerja.

  • WorkspaceHeadMismatch - Kepala dalam permintaan tidak cocok dengan kepala dalam sistem.

  • WorkspacePreviousOperationInProgress - Operasi sebelumnya masih berlangsung.

  • MissingDependency - Dependensi hilang dalam operasi pembaruan.

  • PotensiDuplicateDisplayNameAndType - Operasi pembaruan akan membuat nama dan jenis tampilan duplikat.

  • DependencyDeletionFailed - Operasi pembaruan akan menghapus dependensi keras.

  • InsufficientPrivileges - Pemanggil tidak memiliki izin ruang kerja yang memadai.

  • PrincipalTypeNotSupported - Jenis identitas pemanggil tidak didukung.

Contoh

Update a workspace using data from a Git example

Permintaan sampel

POST https://api.fabric.microsoft.com/v1/workspaces/1565e6a3-c020-4c0c-dda7-92bafe99eec5/git/updateFromGit

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "conflictResolution": {
    "conflictResolutionType": "Workspace",
    "conflictResolutionPolicy": "PreferWorkspace"
  },
  "options": {
    "allowOverrideItems": true
  }
}

Respon sampel

Kode status:
200
Kode status:
202 
Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30

Definisi

Nama Deskripsi
ConflictResolutionPolicy

Kebijakan resolusi konflik. Kebijakan penyelesaian konflik tambahan dapat ditambahkan dari waktu ke waktu.
ConflictResolutionType

Jenis resolusi konflik. Jenis resolusi konflik tambahan dapat ditambahkan dari waktu ke waktu.
ErrorRelatedResource

Objek detail sumber daya terkait kesalahan.
ErrorResponse

Respons kesalahan.
ErrorResponseDetails

Detail respons kesalahan.
UpdateFromGitRequest

Berisi pembaruan dari data permintaan Git.
UpdateOptions

Berisi opsi yang diaktifkan untuk pembaruan dari Git.
WorkspaceConflictResolution

Data resolusi konflik dasar.

ConflictResolutionPolicy

Enumeration

Kebijakan resolusi konflik. Kebijakan penyelesaian konflik tambahan dapat ditambahkan dari waktu ke waktu.

Nilai Deskripsi
PreferRemote

Lebih suka konten sisi Git jarak jauh.
PreferWorkspace

Lebih suka konten sisi ruang kerja.

ConflictResolutionType

Enumeration

Jenis resolusi konflik. Jenis resolusi konflik tambahan dapat ditambahkan dari waktu ke waktu.

Nilai Deskripsi
Workspace

Resolusi konflik yang mewakili tingkat ruang kerja.

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.

UpdateFromGitRequest

Objek

Berisi pembaruan dari data permintaan Git.

Nama Jenis Deskripsi
conflictResolution

WorkspaceConflictResolution

Resolusi konflik yang akan digunakan dalam pembaruan dari operasi Git. Jika item berkonflik dan resolusi konflik tidak ditentukan, operasi pembaruan tidak akan dimulai.
options

UpdateOptions

Opsi yang akan digunakan dalam pembaruan dari operasi Git
remoteCommitHash

string

Hash penerapan SHA penuh jarak jauh.
workspaceHead

string

Hash SHA penuh tempat ruang kerja disinkronkan. Nilai ini mungkin null hanya setelah Inisialisasi Koneksi. Dalam kasus lain, sistem akan memvalidasi bahwa nilai yang diberikan selaras dengan kepala yang diketahui oleh sistem.

UpdateOptions

Objek

Berisi opsi yang diaktifkan untuk pembaruan dari Git.

Nama Jenis Deskripsi
allowOverrideItems

boolean

Persetujuan pengguna untuk mengambil alih item masuk selama pembaruan dari proses Git. Saat item masuk ada dan item izinkan penimpaan tidak ditentukan atau disediakan sebagai false, operasi pembaruan tidak akan dimulai. Nilai defaultnya adalah false.

WorkspaceConflictResolution

Objek

Data resolusi konflik dasar.

Nama Jenis Deskripsi
conflictResolutionPolicy

ConflictResolutionPolicy

Kebijakan resolusi konflik. Kebijakan penyelesaian konflik tambahan dapat ditambahkan dari waktu ke waktu.
conflictResolutionType

ConflictResolutionType

Jenis resolusi konflik. Jenis resolusi konflik tambahan dapat ditambahkan dari waktu ke waktu.