Udostępnij przez

Repositories - Update

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

Aktualizuje repozytorium Git przy użyciu nowej nazwy repozytorium lub nowej gałęzi domyślnej.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
 path True

string

Nazwa organizacji usługi Azure DevOps.
repositoryId
 path True

string (uuid)

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ść "7.1", 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 (uuid)

isDisabled

boolean

Wartość true, jeśli repozytorium jest wyłączone. W przeciwnym razie wartość false.
isFork

boolean

Wartość true, jeśli repozytorium zostało utworzone jako rozwidlenie.
isInMaintenance

boolean

Wartość true, jeśli repozytorium jest w konserwacji. W przeciwnym razie wartość false.
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

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

string

size

integer (int64)

Skompresowany rozmiar (bajty) repozytorium.
sshUrl

string

url

string

validRemoteUrls

string[]

webUrl

string

Odpowiedzi

Nazwa Typ Opis
200 OK

GitRepository

Operacja zakończyła się pomyślnie. Odpowiedź zawiera zaktualizowane informacje o repozytorium.

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

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

Disable repository

Przykładowe żądanie

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

{
  "isDisabled": true
}

Przykładowa odpowiedź

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

Przykładowe żądanie

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"
}

Przykładowa odpowiedź

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

Przykładowe żądanie

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

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
GitRepository
GitRepositoryRef
ProjectState

Stan projektu.
ProjectVisibility

Widoczność projektu.
ReferenceLinks

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

Obiekt odwołania dla obiektu TeamProjectCollection.
TeamProjectReference

Reprezentuje płytkie odwołanie do projektu TeamProject.

GitRepository

Objekt
Nazwa Typ Opis
_links

ReferenceLinks

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

string

id

string (uuid)

isDisabled

boolean

Wartość true, jeśli repozytorium jest wyłączone. W przeciwnym razie wartość false.
isFork

boolean

Wartość true, jeśli repozytorium zostało utworzone jako rozwidlenie.
isInMaintenance

boolean

Wartość true, jeśli repozytorium jest w konserwacji. W przeciwnym razie wartość false.
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

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

string

size

integer (int64)

Skompresowany rozmiar (bajty) repozytorium.
sshUrl

string

url

string

validRemoteUrls

string[]

webUrl

string

GitRepositoryRef

Objekt
Nazwa Typ Opis
collection

TeamProjectCollectionReference

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

string (uuid)

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

Wyliczanie

Stan projektu.

Wartość Opis
all

Wszystkie projekty niezależnie od stanu z wyjątkiem usuniętych.
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

Wyliczanie

Widoczność projektu.

Wartość Opis
private

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

Projekt jest widoczny dla wszystkich.
Objekt

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

Nazwa Typ Opis
links

object

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

TeamProjectCollectionReference

Objekt

Obiekt odwołania dla obiektu TeamProjectCollection.

Nazwa Typ Opis
avatarUrl

string

Adres URL awatara kolekcji.
id

string (uuid)

Identyfikator kolekcji.
name

string

Nazwa kolekcji.
url

string

Adres URL REST kolekcji.

TeamProjectReference

Objekt

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 (uuid)

Identyfikator projektu.
lastUpdateTime

string (date-time)

Czas ostatniej aktualizacji projektu.
name

string

Nazwa projektu.
revision

integer (int64)

Poprawka projektu.
state

ProjectState

Stan projektu.
url

string

Adres URL do pełnej wersji obiektu.
visibility

ProjectVisibility

Widoczność projektu.