Freigeben über

Repositories - Update

  • Referenz
Dienst:
Git
API-Version:
5.0

Updates das Git-Repository entweder mit einem neuen Repositorynamen oder einem neuen Standardbranch.

PATCH https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}?api-version=5.0

URI-Parameter

Name In Erforderlich Typ Beschreibung
organization
 path True

string

Der Name der Azure DevOps-Organisation.
repositoryId
 path True

string

uuid

Der Name oder die ID des Repositorys.
project
 path

string

Projekt-ID oder Projektname
api-version
 query True

string

Version der zu verwendenden API. Dies sollte auf "5.0" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

Name Typ Beschreibung
_links

ReferenceLinks

Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
defaultBranch

string

id

string

isFork

boolean

True, wenn das Repository als Fork erstellt wurde
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.
remoteUrl

string

size

integer

Komprimierte Größe (Bytes) des Repositorys.
sshUrl

string

url

string

validRemoteUrls

string[]

Antworten

Name Typ Beschreibung
200 OK

GitRepository

Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token-URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Bereiche

Name Beschreibung
vso.code_manage Ermöglicht das Lesen, Aktualisieren und Löschen von Quellcode sowie den Zugriff auf Metadaten zu Commits, Changesets, Branches und anderen Versionskontrollartefakten. Ermöglicht außerdem das Erstellen und Verwalten von Coderepositorys, das Erstellen und Verwalten von Pull Requests und Code Reviews sowie das Empfangen von Benachrichtigungen zu Versionskontrollereignissen über Diensthaken.

Beispiele

Beispielanforderung

PATCH https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6?api-version=5.0

{
  "name": "RenamedRepository",
  "defaultBranch": "refs/heads/live"
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
  "name": "RenamedRepository",
  "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6",
  "project": {
    "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
    "name": "Fabrikam-Fiber-Git",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
    "state": "wellFormed"
  },
  "defaultBranch": "refs/heads/live",
  "remoteUrl": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_git/RenamedRepository",
  "type": "normal"
}

Definitionen

Name Beschreibung
GitRepository
GitRepositoryRef
ProjectState

Projektstatus.
ProjectVisibility

Projektsichtbarkeit.
ReferenceLinks

Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
TeamProjectCollectionReference

Referenzobjekt für eine TeamProjectCollection.
TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.

GitRepository

Objekt
Name Typ Beschreibung
_links

ReferenceLinks

Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
defaultBranch

string

id

string

isFork

boolean

True, wenn das Repository als Fork erstellt wurde
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.
remoteUrl

string

size

integer

Komprimierte Größe (Bytes) des Repositorys.
sshUrl

string

url

string

validRemoteUrls

string[]

GitRepositoryRef

Objekt
Name Typ Beschreibung
collection

TeamProjectCollectionReference

Team Project Collection, in der sich dieser Fork befindet
id

string

isFork

boolean

True, wenn das Repository als Fork erstellt wurde
name

string

project

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.
remoteUrl

string

sshUrl

string

url

string

ProjectState

Enumeration

Projektstatus.

Wert Beschreibung
all

Alle Projekte unabhängig vom Zustand.
createPending

Project wurde für die Erstellung in die Warteschlange gestellt, aber der Prozess wurde noch nicht gestartet.
deleted

Project wurde gelöscht.
deleting

Project wird gerade gelöscht.
new

Das Projekt wird gerade erstellt.
unchanged

Project wurde nicht geändert.
wellFormed

Project ist vollständig erstellt und einsatzbereit.

ProjectVisibility

Enumeration

Projektsichtbarkeit.

Wert Beschreibung
private

Das Projekt ist nur für Benutzer mit explizitem Zugriff sichtbar.
public

Das Projekt ist für alle sichtbar.
Objekt

Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name Typ Beschreibung
links

object

Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

TeamProjectCollectionReference

Objekt

Referenzobjekt für eine TeamProjectCollection.

Name Typ Beschreibung
id

string

Sammlungs-ID.
name

string

Sammlungsname.
url

string

SAMMLUNGS-REST-URL.

TeamProjectReference

Objekt

Stellt einen flachen Verweis auf ein TeamProject dar.

Name Typ Beschreibung
abbreviation

string

Projektkürzel.
defaultTeamImageUrl

string

URL zum Standardmäßigen Teamidentitätsimage.
description

string

Die Projektbeschreibung (falls vorhanden).
id

string

Projektbezeichner.
name

string

Der Projektname.
revision

integer

Projektrevision.
state

ProjectState

Projektstatus.
url

string

URL zur Vollversion des Objekts.
visibility

ProjectVisibility

Projektsichtbarkeit.