Git - Get Connection

Layanan:

Core

Versi API:

v1

Mengembalikan detail koneksi git untuk ruang kerja yang ditentukan.

Hak akses

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

Cakupan yang Didelegasikan yang Diperlukan

Workspace.Read.All atau Workspace.ReadWrite.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	Ya

Antarmuka

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/connection

Parameter URI

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

Respons

Nama	Jenis	Deskripsi
200 OK	GitConnection	Permintaan berhasil diselesaikan.
Other Status Codes	ErrorResponse	Kode kesalahan umum: UnknownError - Terjadi kesalahan. InsufficientPrivileges - Pemanggil tidak memiliki izin ruang kerja yang memadai.

Contoh

Get Git connection details example

Workspace not connected to git example

Get Git connection details example

Permintaan sampel

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/connection

Respon sampel

Kode status:

200

{
  "gitProviderDetails": {
    "organizationName": "Test Organization",
    "projectName": "Test Project",
    "gitProviderType": "AzureDevOps",
    "repositoryName": "Test Repo",
    "branchName": "Test Branch",
    "directoryName": ""
  },
  "gitSyncDetails": {
    "head": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
    "lastSyncTime": "2021-11-20T09:26:43.153"
  },
  "gitConnectionState": "ConnectedAndInitialized"
}

Workspace not connected to git example

Permintaan sampel

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/connection

Respon sampel

Kode status:

200

{
  "gitProviderDetails": null,
  "gitSyncDetails": null,
  "gitConnectionState": "NotConnected"
}

Definisi

Nama	Deskripsi
AzureDevOpsDetails	Detail penyedia Azure DevOps.
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
GitConnection	Berisi detail koneksi Git.
GitConnectionState	Status koneksi Git. Jenis status koneksi tambahan dapat ditambahkan dari waktu ke waktu.
GitHubDetails	Detail penyedia GitHub.
GitProviderType	Jenis penyedia Git. Jenis penyedia tambahan dapat ditambahkan dari waktu ke waktu.
GitSyncDetails	Berisi detail sinkronisasi.

AzureDevOpsDetails

Objek

Detail penyedia Azure DevOps.

Nama	Jenis	Deskripsi
branchName	string maxLength: 250	Nama cabang. Panjang maksimum adalah 250 karakter.
directoryName	string maxLength: 256	Jalur relatif ke direktori. Panjang maksimum adalah 256 karakter.
gitProviderType	string: AzureDevOps	Jenis penyedia Git. Jenis penyedia tambahan dapat ditambahkan dari waktu ke waktu.
organizationName	string maxLength: 100	Nama organisasi. Panjang maksimum adalah 100 karakter.
projectName	string maxLength: 100	Nama proyek. Panjang maksimum adalah 100 karakter.
repositoryName	string maxLength: 128	Nama repositori. Panjang maksimum adalah 128 karakter.

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.

GitConnection

Objek

Berisi detail koneksi Git.

Nama	Jenis	Deskripsi
gitConnectionState	GitConnectionState	Status koneksi Git. Jenis status koneksi tambahan dapat ditambahkan dari waktu ke waktu.
gitProviderDetails	GitProviderDetails: AzureDevOpsDetails GitHubDetails	Detail penyedia Git.
gitSyncDetails	GitSyncDetails	Berisi detail sinkronisasi.

GitConnectionState

Enumeration

Status koneksi Git. Jenis status koneksi tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
NotConnected	Status tidak tersambung.
Connected	Status tersambung.
ConnectedAndInitialized	Status tersambung dan diinisialisasi.

GitHubDetails

Objek

Detail penyedia GitHub.

Nama	Jenis	Deskripsi
branchName	string maxLength: 250	Nama cabang. Panjang maksimum adalah 250 karakter.
directoryName	string maxLength: 256	Jalur relatif ke direktori. Panjang maksimum adalah 256 karakter.
gitProviderType	string: GitHub	Jenis penyedia Git. Jenis penyedia tambahan dapat ditambahkan dari waktu ke waktu.
ownerName	string maxLength: 100	Nama pemilik. Panjang maksimum adalah 100 karakter.
repositoryName	string maxLength: 128	Nama repositori. Panjang maksimum adalah 128 karakter.

GitProviderType

Enumeration

Jenis penyedia Git. Jenis penyedia tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
AzureDevOps	Penyedia Azure DevOps
GitHub	Penyedia GitHub

GitSyncDetails

Objek

Berisi detail sinkronisasi.

Nama	Jenis	Deskripsi
head	string	Algoritma Hash Aman 1 (SHA-1) lengkap dari ID penerapan yang disinkronkan.
lastSyncTime	string (date-time)	Tanggal dan waktu status sinkronisasi terakhir.