Udostępnij przez

Repositories - Update

  • Odwołanie
Usługa:
Git
Wersja interfejsu API:
5.0

Aktualizacje repozytorium Git z nową nazwą repozytorium lub nową gałęzią domyślną.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
 path True

string

Nazwa organizacji usługi Azure DevOps.
repositoryId
 path True

string

uuid

Nazwa lub identyfikator repozytorium.
project
 path

string

Identyfikator projektu lub nazwa projektu
api-version
 query True

string

Wersja interfejsu API do użycia. Należy ustawić wartość "5.0", aby używać tej wersji interfejsu API.

Treść żądania

Nazwa Typ Opis
_links

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.
defaultBranch

string

id

string

isFork

boolean

Prawda, jeśli repozytorium zostało utworzone jako rozwidlenie
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Reprezentuje płytkie odwołanie do projektu TeamProject.
remoteUrl

string

size

integer

Skompresowany rozmiar (bajty) repozytorium.
sshUrl

string

url

string

validRemoteUrls

string[]

Odpowiedzi

Nazwa Typ Opis
200 OK

GitRepository

operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

Nazwa Opis
vso.code_manage Umożliwia odczytywanie, aktualizowanie i usuwanie kodu źródłowego, uzyskiwanie dostępu do metadanych dotyczących zatwierdzeń, zestawów zmian, gałęzi i innych artefaktów kontroli wersji. Umożliwia również tworzenie repozytoriów kodu i zarządzanie nimi, tworzenie żądań ściągnięcia i przeglądów kodu oraz odbieranie powiadomień o zdarzeniach kontroli wersji za pośrednictwem punktów zaczepienia usługi.

Przykłady

Przykładowe żądanie

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

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

Przykładowa odpowiedź

Kod stanu:
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"
}

Definicje

Nazwa Opis
GitRepository
GitRepositoryRef
ProjectState

Stan projektu.
ProjectVisibility

Widoczność projektu.
ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.
TeamProjectCollectionReference

Obiekt referencyjny dla obiektu TeamProjectCollection.
TeamProjectReference

Reprezentuje płytkie odwołanie do projektu TeamProject.

GitRepository

Object
Nazwa Typ Opis
_links

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.
defaultBranch

string

id

string

isFork

boolean

Prawda, jeśli repozytorium zostało utworzone jako rozwidlenie
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Reprezentuje płytkie odwołanie do projektu TeamProject.
remoteUrl

string

size

integer

Skompresowany rozmiar (bajty) repozytorium.
sshUrl

string

url

string

validRemoteUrls

string[]

GitRepositoryRef

Object
Nazwa Typ Opis
collection

TeamProjectCollectionReference

Kolekcja projektów zespołowych, w której znajduje się ten rozwidlenie
id

string

isFork

boolean

Prawda, jeśli repozytorium zostało utworzone jako rozwidlenie
name

string

project

TeamProjectReference

Reprezentuje płytkie odwołanie do projektu TeamProject.
remoteUrl

string

sshUrl

string

url

string

ProjectState

Enumeration

Stan projektu.

Wartość Opis
all

Wszystkie projekty niezależnie od stanu.
createPending

Projekt został jeszcze w kolejce do utworzenia, ale proces nie został jeszcze uruchomiony.
deleted

Projekt został usunięty.
deleting

Projekt jest w trakcie usuwania.
new

Projekt jest w trakcie tworzenia.
unchanged

Projekt nie został zmieniony.
wellFormed

Projekt jest całkowicie tworzony i gotowy do użycia.

ProjectVisibility

Enumeration

Widoczność projektu.

Wartość Opis
private

Projekt jest widoczny tylko dla użytkowników z jawnym dostępem.
public

Projekt jest widoczny dla wszystkich.
Object

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa Typ Opis
links

object

Widok linków w trybie tylko do odczytu. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

TeamProjectCollectionReference

Object

Obiekt referencyjny dla obiektu TeamProjectCollection.

Nazwa Typ Opis
id

string

Identyfikator kolekcji.
name

string

Nazwa kolekcji.
url

string

Adres URL REST kolekcji.

TeamProjectReference

Object

Reprezentuje płytkie odwołanie do projektu TeamProject.

Nazwa Typ Opis
abbreviation

string

Skrót projektu.
defaultTeamImageUrl

string

Adres URL domyślnego obrazu tożsamości zespołu.
description

string

Opis projektu (jeśli istnieje).
id

string

Identyfikator projektu.
name

string

Nazwa projektu.
revision

integer

Poprawka projektu.
state

ProjectState

Stan projektu.
url

string

Adres URL do pełnej wersji obiektu.
visibility

ProjectVisibility

Widoczność projektu.