Repositories - Update
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=7.1-preview.1
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
organization
|
path | True |
string |
Nazwa organizacji usługi Azure DevOps. |
repository
|
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. Ta wartość powinna być ustawiona na wartość "7.1-preview.1", aby używać tej wersji interfejsu API. |
Treść żądania
Nazwa | Typ | Opis |
---|---|---|
_links |
Klasa reprezentująca kolekcję linków referencyjnych REST. |
|
defaultBranch |
string |
|
id |
string |
|
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 | ||
project |
Reprezentuje płytkie odwołanie do projektu TeamProject. |
|
remoteUrl |
string |
|
size |
integer |
Skompresowany rozmiar (bajty) repozytorium. |
sshUrl |
string |
|
url |
string |
|
validRemoteUrls |
string[] |
|
webUrl |
string |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Operacja zakończyła się pomyślnie. Odpowiedź zawiera zaktualizowane informacje o repozytorium. |
Zabezpieczenia
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
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
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
{
"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
{
"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
{
"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 |
---|---|
Git |
|
Git |
|
Project |
Stan projektu. |
Project |
Widoczność projektu. |
Reference |
Klasa reprezentująca kolekcję linków referencyjnych REST. |
Team |
Obiekt referencyjny dla obiektu TeamProjectCollection. |
Team |
Reprezentuje płytkie odwołanie do projektu TeamProject. |
GitRepository
Nazwa | Typ | Opis |
---|---|---|
_links |
Klasa reprezentująca kolekcję linków referencyjnych REST. |
|
defaultBranch |
string |
|
id |
string |
|
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 | ||
project |
Reprezentuje płytkie odwołanie do projektu TeamProject. |
|
remoteUrl |
string |
|
size |
integer |
Skompresowany rozmiar (bajty) repozytorium. |
sshUrl |
string |
|
url |
string |
|
validRemoteUrls |
string[] |
|
webUrl |
string |
GitRepositoryRef
Nazwa | Typ | Opis |
---|---|---|
collection |
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 |
Reprezentuje płytkie odwołanie do projektu TeamProject. |
|
remoteUrl |
string |
|
sshUrl |
string |
|
url |
string |
ProjectState
Stan projektu.
Nazwa | Typ | Opis |
---|---|---|
all |
string |
Wszystkie projekty niezależnie od stanu z wyjątkiem usuniętych. |
createPending |
string |
Projekt został jeszcze w kolejce do utworzenia, ale proces nie został jeszcze uruchomiony. |
deleted |
string |
Projekt został usunięty. |
deleting |
string |
Projekt jest w trakcie usuwania. |
new |
string |
Projekt jest w trakcie tworzenia. |
unchanged |
string |
Projekt nie został zmieniony. |
wellFormed |
string |
Projekt jest całkowicie tworzony i gotowy do użycia. |
ProjectVisibility
Widoczność projektu.
Nazwa | Typ | Opis |
---|---|---|
private |
string |
Projekt jest widoczny tylko dla użytkowników z jawnym dostępem. |
public |
string |
Projekt jest widoczny dla wszystkich. |
ReferenceLinks
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
Obiekt referencyjny dla obiektu TeamProjectCollection.
Nazwa | Typ | Opis |
---|---|---|
avatarUrl |
string |
Adres URL awatara kolekcji. |
id |
string |
Identyfikator kolekcji. |
name |
string |
Nazwa kolekcji. |
url |
string |
Adres URL REST kolekcji. |
TeamProjectReference
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. |
lastUpdateTime |
string |
Czas ostatniej aktualizacji projektu. |
name |
string |
Nazwa projektu. |
revision |
integer |
Poprawka projektu. |
state |
Stan projektu. |
|
url |
string |
Adres URL do pełnej wersji obiektu. |
visibility |
Widoczność projektu. |