Freigeben über

Repositories - Update

  • Referenz
Dienst:
Git
API-Version:
7.1

Aktualisiert das Git-Repository entweder mit einem neuen Repositorynamen oder einem neuen Standardverzweigung.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
organization
 path True

string

Der Name der Azure DevOps-Organisation.
repositoryId
 path True

string (uuid)

Die ID des Repositorys.
project
 path

string

Projekt-ID oder Projektname
api-version
 query True

string

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

Anforderungstext

Name Typ Beschreibung
_links

ReferenceLinks

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
defaultBranch

string

id

string (uuid)

isDisabled

boolean

True, wenn das Repository deaktiviert ist. Andernfalls "False".
isFork

boolean

True, wenn das Repository als Verzweigung erstellt wurde.
isInMaintenance

boolean

True, wenn sich das Repository in der Wartung befindet. Andernfalls "False".
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.
remoteUrl

string

size

integer (int64)

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

string

url

string

validRemoteUrls

string[]

webUrl

string

Antworten

Name Typ Beschreibung
200 OK

GitRepository

Der Vorgang war erfolgreich. Die Antwort enthält die aktualisierten Repositoryinformationen.

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 Gewährt die Möglichkeit, Quellcode zu lesen, zu aktualisieren und zu löschen, auf Metadaten zu Commits, Änderungenets, Verzweigungen und anderen Versionssteuerungsartefakten zuzugreifen. Gewährt außerdem die Möglichkeit, Coderepositorys zu erstellen und zu verwalten, Pullanforderungen und Codeüberprüfungen zu erstellen und zu verwalten und Benachrichtigungen über Versionssteuerungsereignisse über Diensthaken zu erhalten.

Beispiele

Disable repository
Update a respository while specifying the project
Update a respository without specifying the project

Disable repository

Beispielanforderung

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

{
  "isDisabled": true
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
  "name": "RenamedRepository",
  "RenamedRepository": true,
  "isDisabled": true,
  "url": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_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"
}

Update a respository while specifying the project

Beispielanforderung

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

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

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
  "name": "RenamedRepository",
  "isDisabled": false,
  "url": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_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"
}

Update a respository without specifying the project

Beispielanforderung

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

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

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
  "name": "RenamedRepository",
  "isDisabled": false,
  "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-Referenzverknüpfungslinks darstellt.
TeamProjectCollectionReference

Reference-Objekt 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-Referenzverknüpfungslinks darstellt.
defaultBranch

string

id

string (uuid)

isDisabled

boolean

True, wenn das Repository deaktiviert ist. Andernfalls "False".
isFork

boolean

True, wenn das Repository als Verzweigung erstellt wurde.
isInMaintenance

boolean

True, wenn sich das Repository in der Wartung befindet. Andernfalls "False".
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.
remoteUrl

string

size

integer (int64)

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

string

url

string

validRemoteUrls

string[]

webUrl

string

GitRepositoryRef

Objekt
Name Typ Beschreibung
collection

TeamProjectCollectionReference

Teamprojektsammlung, in der sich diese Verzweigung befindet
id

string (uuid)

isFork

boolean

True, wenn das Repository als Verzweigung 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 Status außer "Gelöscht".
createPending

Projekt wurde zur Erstellung in die Warteschlange gestellt, aber der Prozess wurde noch nicht gestartet.
deleted

Projekt wurde gelöscht.
deleting

Project wird gerade gelöscht.
new

Projekt wird gerade erstellt.
unchanged

Projekt wurde nicht geändert.
wellFormed

Project wird vollständig erstellt und kann verwendet werden.

ProjectVisibility

Enumeration

Projektsichtbarkeit.

Wert Beschreibung
private

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

Das Projekt ist für alle sichtbar.
Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name Typ Beschreibung
links

object

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

TeamProjectCollectionReference

Objekt

Reference-Objekt für eine TeamProjectCollection.

Name Typ Beschreibung
avatarUrl

string

Sammlung Avatar-URL.
id

string (uuid)

Sammlungs-ID.
name

string

Sammlungsname.
url

string

Rest-URL der Sammlung.

TeamProjectReference

Objekt

Stellt einen flachen Verweis auf ein TeamProject dar.

Name Typ Beschreibung
abbreviation

string

Projektkürzel.
defaultTeamImageUrl

string

Url zum standardmäßigen Teamidentitätsbild.
description

string

Die Beschreibung des Projekts (falls vorhanden).
id

string (uuid)

Projektbezeichner.
lastUpdateTime

string (date-time)

Zeitpunkt der letzten Aktualisierung des Projekts.
name

string

Projektname.
revision

integer (int64)

Projektrevision.
state

ProjectState

Projektstatus.
url

string

Die URL zur Vollversion des Objekts.
visibility

ProjectVisibility

Projektsichtbarkeit.