Freigeben über

Repositories - Update

  • Referenz
Service:
Git
API Version:
7.1-preview.1

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=7.1-preview.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-preview.1" 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

isDisabled

boolean

True, wenn das Repository deaktiviert ist. Andernfalls FALSE.
isFork

boolean

True, wenn das Repository als Fork erstellt wurde.
isInMaintenance

boolean

True, wenn sich das Repository in Wartung befindet. Andernfalls FALSE.
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[]

webUrl

string

Antworten

Name Typ Beschreibung
200 OK

GitRepository

Der Vorgang wurde erfolgreich ausgeführt. Die Antwort enthält die aktualisierten Repositoryinformationen.

Sicherheit

oauth2

Type: oauth2
Flow: accessCode
Authorization 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

Scopes

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

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

Disable repository

Sample Request

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

{
  "isDisabled": true
}

Sample Response

Status code:
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

Sample Request

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

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

Sample Response

Status code:
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

Sample Request

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

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

Sample Response

Status code:
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-Verweislinks darstellt.
TeamProjectCollectionReference

Referenzobjekt für eine TeamProjectCollection.
TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.

GitRepository

Name Typ Beschreibung
_links

ReferenceLinks

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

string

id

string

isDisabled

boolean

True, wenn das Repository deaktiviert ist. Andernfalls FALSE.
isFork

boolean

True, wenn das Repository als Fork erstellt wurde.
isInMaintenance

boolean

True, wenn sich das Repository in Wartung befindet. Andernfalls FALSE.
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[]

webUrl

string

GitRepositoryRef

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

Projektstatus.

Name Typ Beschreibung
all

string

Alle Projekte unabhängig vom Zustand außer Gelöscht.
createPending

string

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

string

Project wurde gelöscht.
deleting

string

Project wird gerade gelöscht.
new

string

Das Projekt wird gerade erstellt.
unchanged

string

Project wurde nicht geändert.
wellFormed

string

Project ist vollständig erstellt und einsatzbereit.

ProjectVisibility

Projektsichtbarkeit.

Name Typ Beschreibung
private

string

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

string

Das Projekt ist für alle sichtbar.

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

Referenzobjekt für eine TeamProjectCollection.

Name Typ Beschreibung
avatarUrl

string

Sammlungs-Avatar-URL.
id

string

Sammlungs-ID.
name

string

Sammlungsname.
url

string

SAMMLUNGS-REST-URL.

TeamProjectReference

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.
lastUpdateTime

string

Zeitpunkt der letzten Aktualisierung des Projekts.
name

string

Der Projektname.
revision

integer

Projektrevision.
state

ProjectState

Projektstatus.
url

string

URL zur Vollversion des Objekts.
visibility

ProjectVisibility

Projektsichtbarkeit.