Git - Update Connection Settings

Service:
Core
API-versie:
v1

Note

Deze API maakt deel uit van een preview-versie en is alleen beschikbaar voor evaluatie- en ontwikkelingsdoeleinden. Het kan veranderen op basis van feedback en wordt niet aanbevolen voor productiegebruik. Meer informatie.

Hiermee worden de verbindingsinstellingen voor een met Git verbonden werkruimte bijgewerkt. Alleen eigenschappen die zijn opgenomen in de aanvraagbody worden bijgewerkt; weggelaten eigenschappen blijven ongewijzigd.

Permissions

De beller moet een beheerdersrol hebben voor de werkruimte.

Vereiste gedelegeerde bevoegdheden

Workspace.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft-identiteiten die in deze sectie worden vermeld.

Identity Support
User Yes
serviceprincipal en beheerde identiteiten Yes

Interface

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

URI-parameters

Naam In Vereist Type Description
workspaceId
 path True

string (uuid)

De werkruimte-ID.

Aanvraagbody

Naam Type Description
additionalRolesAuthorizedToChangeBranch

GitAdditionalBranchChangingRoles

De extra werkruimterollen buiten de beheerder die de verbonden Git-vertakking mogen wijzigen.

Antwoorden

Naam Type Description
200 OK

GitConnectionSettings

De aanvraag is voltooid.
429 Too Many Requests

ErrorResponse

De servicesnelheidslimiet is overschreden. De server retourneert een Retry-After header die in seconden aangeeft hoe lang de client moet wachten voordat extra aanvragen worden verzonden.

Kopteksten

Retry-After: integer
Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

  • UnknownError: er is een fout opgetreden.

  • InsufficientPrivileges : de beller heeft geen beheerdersrol voor de werkruimte.

  • WorkspaceNotConnectedToGit - Werkruimte is niet verbonden met Git.

Voorbeelden

Update connection settings example

Voorbeeldaanvraag

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

{
  "additionalRolesAuthorizedToChangeBranch": "MemberAndContributor"
}

Voorbeeldrespons

Statuscode:
200 
{
  "additionalRolesAuthorizedToChangeBranch": "MemberAndContributor"
}

Definities

Naam Description
ErrorParameter

Een gestructureerde parameter die extra machineleesbare context biedt over een fout.
ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.
ErrorResponse

De foutreactie.
ErrorResponseDetails

De details van het foutbericht.
GitAdditionalBranchChangingRoles

De extra werkruimterollen buiten de beheerder die de verbonden Git-vertakking mogen wijzigen. Er kunnen in de loop van de tijd extra waarden worden toegevoegd.
GitConnectionSettings

Bevat de Git-verbindingsinstellingen.
UpdateGitConnectionSettingsRequest

Bevat de aanvraaggegevens voor het bijwerken van de Git-verbindingsinstellingen.

ErrorParameter

Object

Een gestructureerde parameter die extra machineleesbare context biedt over een fout.

Naam Type Description
message

string

Een door mensen leesbare beschrijving van de betekenis van de parameter.
name

string

De parameter-id.
value

string

De waarde van de parameter.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Naam Type Description
resourceId

string

De resource-ID die betrokken is bij het probleem.
resourceType

string

Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

De foutreactie.

Naam Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
isRetriable

boolean

Wanneer waar, kan de aanvraag opnieuw worden geprobeerd. Gebruik de Retry-After antwoordheader om de vertraging te bepalen, indien beschikbaar.
message

string

Een leesbare weergave van de fout.
moreDetails

ErrorResponseDetails[]

Lijst met aanvullende foutdetails.
parameters

ErrorParameter[]

Gestructureerde parameters die extra machineleesbare context bieden over de fout.
relatedResource

ErrorRelatedResource

Details van de foutgerelateerde resource.
requestId

string (uuid)

Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Naam Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
parameters

ErrorParameter[]

Gestructureerde parameters die extra machineleesbare context bieden over de fout.
relatedResource

ErrorRelatedResource

Details van de foutgerelateerde resource.

GitAdditionalBranchChangingRoles

Opsomming

De extra werkruimterollen buiten de beheerder die de verbonden Git-vertakking mogen wijzigen. Er kunnen in de loop van de tijd extra waarden worden toegevoegd.

Waarde Description
None

Geen extra rollen buiten de beheerder kunnen vertakkingen wijzigen. Dit is de standaardwaarde.
MemberAndContributor

Leden en inzenders kunnen naast beheerders ook vertakkingen wijzigen.

GitConnectionSettings

Object

Bevat de Git-verbindingsinstellingen.

Naam Type Description
additionalRolesAuthorizedToChangeBranch

GitAdditionalBranchChangingRoles

De extra werkruimterollen buiten de beheerder die de verbonden Git-vertakking mogen wijzigen.

UpdateGitConnectionSettingsRequest

Object

Bevat de aanvraaggegevens voor het bijwerken van de Git-verbindingsinstellingen.

Naam Type Description
additionalRolesAuthorizedToChangeBranch

GitAdditionalBranchChangingRoles

De extra werkruimterollen buiten de beheerder die de verbonden Git-vertakking mogen wijzigen.