Bagikan melalui

Git - Update My Git Credentials

Layanan:
Core
Versi API:
v1

Memperbarui detail konfigurasi kredensial Git pengguna.
Setiap pengguna di ruang kerja memiliki kredensial Git yang dikonfigurasi sendiri. Anda dapat menggunakan Get My Git Credentials API untuk mendapatkan konfigurasi kredensial Git.

Untuk mendapatkan ID koneksi, lihat Mengotomatiskan integrasi Git.

Hak akses

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

Untuk kredensial Git koneksi yang dikonfigurasi, pemanggil harus memiliki izin untuk koneksi.

Cakupan yang Didelegasikan yang Diperlukan

Workspace.ReadWrite.All

Keterbatasan

Saat menggunakan sumber kredensial otomatis, API ini diblokir untuk penyedia GitHub dan untuk Perwakilan Layanan.

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 Didukung hanya ketika sumber DikonfigurasiKonfigurasiKonfigurasi atau Tidak Ada

Antarmuka

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/myGitCredentials

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
workspaceId
 path True

string (uuid)

ID ruangkerja.

Isi Permintaan

Isi permintaan dapat berupa salah satu hal berikut:

Nama Deskripsi
UpdateGitCredentialsToAutomaticRequest

Berisi data permintaan untuk memperbarui kredensial Git ke otomatis.
UpdateGitCredentialsToConfiguredConnectionRequest

Berisi data permintaan untuk memperbarui kredensial Git ke koneksi yang dikonfigurasi.
UpdateGitCredentialsToNoneRequest

Berisi data permintaan untuk memperbarui kredensial Git menjadi tidak ada.

UpdateGitCredentialsToAutomaticRequest

Berisi data permintaan untuk memperbarui kredensial Git ke otomatis.

Nama Diperlukan Jenis Deskripsi
source True string:

Automatic

Sumber kredensial Git.

UpdateGitCredentialsToConfiguredConnectionRequest

Berisi data permintaan untuk memperbarui kredensial Git ke koneksi yang dikonfigurasi.

Nama Diperlukan Jenis Deskripsi
connectionId True

string (uuid)

ID objek koneksi.
source True string:

ConfiguredConnection

Sumber kredensial Git.

UpdateGitCredentialsToNoneRequest

Berisi data permintaan untuk memperbarui kredensial Git menjadi tidak ada.

Nama Diperlukan Jenis Deskripsi
source True string:

None

Sumber kredensial Git.

Respons

Nama Jenis Deskripsi
200 OK GitCredentialsConfigurationResponse:

Permintaan berhasil diselesaikan.
Other Status Codes

ErrorResponse

Kode kesalahan umum:

  • UnknownError - Terjadi kesalahan.

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

  • WorkspaceNotConnectedToGit - Ruang kerja tidak tersambung ke git.

  • ConnectionNotFound - Koneksi yang ditentukan tidak ditemukan.

  • ConnectionMismatch - Koneksi tidak cocok dengan detail penyedia Git.

  • PrincipalTypeNotSupported - Jenis identitas pemanggil tidak didukung.

Contoh

Update user's Git credentials to Automatic example
Update user's Git credentials to ConfiguredConnection example
Update user's Git credentials to None example

Update user's Git credentials to Automatic example

Permintaan sampel

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

{
  "source": "Automatic"
}

Respon sampel

Kode status:
200 
{
  "source": "Automatic"
}

Update user's Git credentials to ConfiguredConnection example

Permintaan sampel

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

{
  "source": "ConfiguredConnection",
  "connectionId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301"
}

Respon sampel

Kode status:
200 
{
  "source": "ConfiguredConnection",
  "connectionId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301"
}

Update user's Git credentials to None example

Permintaan sampel

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

{
  "source": "None"
}

Respon sampel

Kode status:
200 
{
  "source": "None"
}

Definisi

Nama Deskripsi
AutomaticGitCredentialsResponse

Kredensial Git otomatis.
ConfiguredConnectionGitCredentialsResponse

Kredensial Git koneksi yang dikonfigurasi.
ErrorRelatedResource

Objek detail sumber daya terkait kesalahan.
ErrorResponse

Respons kesalahan.
ErrorResponseDetails

Detail respons kesalahan.
GitCredentialsSource

Sumber kredensial Git. Sumber kredensial Git tambahan dapat ditambahkan dari waktu ke waktu.
NoneGitCredentialsResponse

Kredensial Git tidak dikonfigurasi.
UpdateGitCredentialsToAutomaticRequest

Berisi data permintaan untuk memperbarui kredensial Git ke otomatis.
UpdateGitCredentialsToConfiguredConnectionRequest

Berisi data permintaan untuk memperbarui kredensial Git ke koneksi yang dikonfigurasi.
UpdateGitCredentialsToNoneRequest

Berisi data permintaan untuk memperbarui kredensial Git menjadi tidak ada.

AutomaticGitCredentialsResponse

Objek

Kredensial Git otomatis.

Nama Jenis Deskripsi
source string:

Automatic

Sumber kredensial Git.

ConfiguredConnectionGitCredentialsResponse

Objek

Kredensial Git koneksi yang dikonfigurasi.

Nama Jenis Deskripsi
connectionId

string (uuid)

ID objek koneksi.
source string:

ConfiguredConnection

Sumber kredensial Git.

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.

GitCredentialsSource

Enumeration

Sumber kredensial Git. Sumber kredensial Git tambahan dapat ditambahkan dari waktu ke waktu.

Nilai Deskripsi
ConfiguredConnection

Info masuk Git diperoleh melalui koneksi yang dikonfigurasi.
Automatic

Kredensial Git secara otomatis diperoleh oleh sistem, menggunakan kredensial default jika tersedia.
None

Kredensial Git tidak dikonfigurasi.

NoneGitCredentialsResponse

Objek

Kredensial Git tidak dikonfigurasi.

Nama Jenis Deskripsi
source string:

None

Sumber kredensial Git.

UpdateGitCredentialsToAutomaticRequest

Objek

Berisi data permintaan untuk memperbarui kredensial Git ke otomatis.

Nama Jenis Deskripsi
source string:

Automatic

Sumber kredensial Git.

UpdateGitCredentialsToConfiguredConnectionRequest

Objek

Berisi data permintaan untuk memperbarui kredensial Git ke koneksi yang dikonfigurasi.

Nama Jenis Deskripsi
connectionId

string (uuid)

ID objek koneksi.
source string:

ConfiguredConnection

Sumber kredensial Git.

UpdateGitCredentialsToNoneRequest

Objek

Berisi data permintaan untuk memperbarui kredensial Git menjadi tidak ada.

Nama Jenis Deskripsi
source string:

None

Sumber kredensial Git.