Git - Initialize Connection

Layanan:

Core

Versi API:

v1

Menginisialisasi koneksi untuk ruang kerja yang tersambung ke Git.
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.

API ini harus dipanggil setelah panggilan berhasil ke Connect API. Untuk menyelesaikan sinkronisasi penuh ruang kerja, gunakan operasi Tindakan yang Diperlukan untuk memanggil operasi sinkronisasi yang relevan, baik Terapkan Ke Git atau Perbarui Dari Git.

Permissions

Pemanggil harus memiliki peran ruang kerja admin .

Cakupan yang Didelegasikan yang Diperlukan

Workspace.ReadWrite.All

Identitas yang didukung oleh Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identity	Support
User	Yes
Prinsipal Layanan dan Identitas Terkelola	Yes

Interface

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
workspaceId	path	True	string (uuid)	ID ruangkerja.

Isi Permintaan

Nama	Jenis	Deskripsi
initializationStrategy	InitializationStrategy	Strategi yang diperlukan untuk proses inisialisasi ketika konten ada di sisi jarak jauh dan sisi ruang kerja. Strategi tambahan dapat ditambahkan dari waktu ke waktu.

Respons

Nama	Jenis	Deskripsi
200 OK	InitializeGitConnectionResponse	Permintaan berhasil diselesaikan.
202 Accepted		Permintaan diterima, inisialisasi koneksi 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. MissingInitializationPolicy - Kebijakan inisialisasi hilang. InsufficientPrivileges - Pemanggil tidak memiliki izin yang memadai di ruang kerja. PrincipalTypeNotSupported - Jenis identitas pemanggil tidak didukung.

Contoh

Initialize the connection of a workspace connected to a Git example

Permintaan sampel

HTTP

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

Respon sampel

Kode status:

200

{
  "requiredAction": "UpdateFromGit",
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705"
}

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
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
InitializationStrategy	Strategi yang diperlukan untuk proses inisialisasi ketika konten ada di sisi jarak jauh dan sisi ruang kerja. Strategi tambahan dapat ditambahkan dari waktu ke waktu.
InitializeGitConnectionRequest	Berisi data permintaan koneksi Git yang diinisialisasi.
InitializeGitConnectionResponse	Berisi data respons koneksi Git yang diinisialisasi.
RequiredAction	Tindakan yang diperlukan setelah proses inisialisasi selesai. Tindakan tambahan dapat ditambahkan dari waktu ke waktu.

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.

InitializationStrategy

Enumeration

Strategi yang diperlukan untuk proses inisialisasi ketika konten ada di sisi jarak jauh dan sisi ruang kerja. Strategi tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
None	Tidak ada strategi yang ditentukan.
PreferRemote	Lebih suka konten sisi Git jarak jauh.
PreferWorkspace	Lebih suka konten sisi ruang kerja.

InitializeGitConnectionRequest

Objek

Berisi data permintaan koneksi Git yang diinisialisasi.

Nama	Jenis	Deskripsi
initializationStrategy	InitializationStrategy	Strategi yang diperlukan untuk proses inisialisasi ketika konten ada di sisi jarak jauh dan sisi ruang kerja. Strategi tambahan dapat ditambahkan dari waktu ke waktu.

InitializeGitConnectionResponse

Objek

Berisi data respons koneksi Git yang diinisialisasi.

Nama	Jenis	Deskripsi
remoteCommitHash	string	Hash penerapan SHA penuh jarak jauh.
requiredAction	RequiredAction	Tindakan yang diperlukan setelah proses inisialisasi selesai. Tindakan tambahan dapat ditambahkan dari waktu ke waktu.
workspaceHead	string	Hash SHA penuh tempat ruang kerja disinkronkan.

RequiredAction

Enumeration

Tindakan yang diperlukan setelah proses inisialisasi selesai. Tindakan tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
None	Tidak diperlukan tindakan.
UpdateFromGit	Pembaruan dari Git diperlukan.
CommitToGit	Penerapan ke Git diperlukan.