Git - Get Connection

Tjeneste:

Core

API-versjon:

v1

Returnerer git-tilkoblingsdetaljer for det angitte arbeidsområdet.

Tillatelser

Innringeren må ha en bidragsyter eller høyere arbeidsområderolle.

Nødvendige delegerte omfang

Workspace.Read.All eller Workspace.ReadWrite.All

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identitet	Støtte
Bruker	Ja
tjenestekontohaver og administrerte identiteter	Ja

Grensesnitt

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

URI-parametere

Navn	I	Obligatorisk	Type	Beskrivelse
workspaceId	path	True	string (uuid)	Arbeidsområde-ID-en.

Svar

Navn	Type	Beskrivelse
200 OK	GitConnection	Forespørselen er fullført.
Other Status Codes	ErrorResponse	Vanlige feilkoder: UnknownError - Det oppstod en feil. InsufficientPrivileges – Innringeren har ikke tilstrekkelige arbeidsområdetillatelser.

Eksempler

Get Git connection details example

Workspace not connected to git example

Get Git connection details example

Eksempelforespørsel

HTTP

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

Eksempelsvar

Statuskode:

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

Eksempelforespørsel

HTTP

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

Eksempelsvar

Statuskode:

200

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

Definisjoner

Navn	Beskrivelse
AzureDevOpsDetails	Leverandørdetaljer for Azure DevOps.
ErrorRelatedResource	Objektet for feilrelaterte ressursdetaljer.
ErrorResponse	Feilsvaret.
ErrorResponseDetails	Feilsvardetaljene.
GitConnection	Inneholder git-tilkoblingsdetaljene.
GitConnectionState	Git-tilkoblingstilstand. Flere tilkoblingstilstandstyper kan legges til over tid.
GitHubDetails	GitHub-leverandørdetaljer.
GitProviderType	En Git-leverandørtype. Flere leverandørtyper kan legges til over tid.
GitSyncDetails	Inneholder synkroniseringsdetaljene.

AzureDevOpsDetails

Object

Leverandørdetaljer for Azure DevOps.

Navn	Type	Beskrivelse
branchName	string maxLength: 250	Grennavnet. Maksimal lengde er 250 tegn.
directoryName	string maxLength: 256	Den relative banen til katalogen. Maksimal lengde er 256 tegn.
gitProviderType	string: AzureDevOps	En Git-leverandørtype. Flere leverandørtyper kan legges til over tid.
organizationName	string maxLength: 100	Organisasjonsnavnet. Maksimal lengde er 100 tegn.
projectName	string maxLength: 100	Prosjektnavnet. Maksimal lengde er 100 tegn.
repositoryName	string maxLength: 128	Repositoriumnavnet. Maksimal lengde er 128 tegn.

ErrorRelatedResource

Object

Objektet for feilrelaterte ressursdetaljer.

Navn	Type	Beskrivelse
resourceId	string	Ressurs-ID-en som er involvert i feilen.
resourceType	string	Typen ressurs som er involvert i feilen.

ErrorResponse

Object

Feilsvaret.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
moreDetails	ErrorResponseDetails[]	Liste over flere feildetaljer.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.
requestId	string	ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Object

Feilsvardetaljene.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.

GitConnection

Object

Inneholder git-tilkoblingsdetaljene.

Navn	Type	Beskrivelse
gitConnectionState	GitConnectionState	Git-tilkoblingstilstand. Flere tilkoblingstilstandstyper kan legges til over tid.
gitProviderDetails	GitProviderDetails: AzureDevOpsDetails GitHubDetails	Git-leverandørdetaljene.
gitSyncDetails	GitSyncDetails	Inneholder synkroniseringsdetaljene.

GitConnectionState

Opplisting

Git-tilkoblingstilstand. Flere tilkoblingstilstandstyper kan legges til over tid.

Verdi	Beskrivelse
NotConnected	Ikke tilkoblet tilstand.
Connected	Tilkoblet tilstand.
ConnectedAndInitialized	Tilkoblet og initialisert tilstand.

GitHubDetails

Object

GitHub-leverandørdetaljer.

Navn	Type	Beskrivelse
branchName	string maxLength: 250	Grennavnet. Maksimal lengde er 250 tegn.
directoryName	string maxLength: 256	Den relative banen til katalogen. Maksimal lengde er 256 tegn.
gitProviderType	string: GitHub	En Git-leverandørtype. Flere leverandørtyper kan legges til over tid.
ownerName	string maxLength: 100	Eiernavnet. Maksimal lengde er 100 tegn.
repositoryName	string maxLength: 128	Repositoriumnavnet. Maksimal lengde er 128 tegn.

GitProviderType

Opplisting

En Git-leverandørtype. Flere leverandørtyper kan legges til over tid.

Verdi	Beskrivelse
AzureDevOps	Azure DevOps-leverandør
GitHub	GitHub-leverandør

GitSyncDetails

Object

Inneholder synkroniseringsdetaljene.

Navn	Type	Beskrivelse
head	string	Den fullstendige sikre hash-algoritmen 1 (SHA-1) for den synkroniserte utførings-ID-en.
lastSyncTime	string (date-time)	Dato og klokkeslett for siste synkroniseringstilstand.