Repositories - Update

Reference

Service:: Git

API Version:: 5.0

Aktualizace úložiště Git s novým názvem úložiště nebo novou výchozí větví.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
repositoryId	path	True	string uuid	Název nebo ID úložiště.
project	path		string	ID projektu nebo název projektu
api-version	query	True	string	Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavena na hodnotu 5.0.

Text požadavku

Name	Typ	Description
_links	ReferenceLinks	Třída představující kolekci odkazů REST.
defaultBranch	string
id	string
isFork	boolean	True, pokud se úložiště vytvořilo jako fork
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Představuje povrchní odkaz na TeamProject.
remoteUrl	string
size	integer	Komprimovaná velikost (bajty) úložiště.
sshUrl	string
url	string
validRemoteUrls	string[]

Odpovědi

Name	Typ	Description
200 OK	GitRepository	úspěšná operace

Zabezpečení

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	Description
vso.code_manage	Uděluje možnost číst, aktualizovat a odstraňovat zdrojový kód, přistupovat k metadatům o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Umožňuje také vytvářet a spravovat úložiště kódu, vytvářet a spravovat žádosti o přijetí změn a revize kódu a přijímat oznámení o událostech správy verzí prostřednictvím služeb.

Příklady

Sample Request

HTTP

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

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

Sample Response

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

Definice

Name	Description
GitRepository
GitRepositoryRef
ProjectState	Stav projektu.
ProjectVisibility	Viditelnost projektu.
ReferenceLinks	Třída představující kolekci odkazů REST.
TeamProjectCollectionReference	Referenční objekt pro TeamProjectCollection.
TeamProjectReference	Představuje povrchní odkaz na TeamProject.

GitRepository

Name	Typ	Description
_links	ReferenceLinks	Třída představující kolekci odkazů REST.
defaultBranch	string
id	string
isFork	boolean	True, pokud se úložiště vytvořilo jako fork
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Představuje povrchní odkaz na TeamProject.
remoteUrl	string
size	integer	Komprimovaná velikost (bajty) úložiště.
sshUrl	string
url	string
validRemoteUrls	string[]

GitRepositoryRef

Name	Typ	Description
collection	TeamProjectCollectionReference	Kolekce týmových projektů, kde se nachází tento fork
id	string
isFork	boolean	True, pokud se úložiště vytvořilo jako fork
name	string
project	TeamProjectReference	Představuje povrchní odkaz na TeamProject.
remoteUrl	string
sshUrl	string
url	string

ProjectState

Stav projektu.

Name	Typ	Description
all	string	Všechny projekty bez ohledu na stav.
createPending	string	Projekt byl zařazen do fronty pro vytvoření, ale proces ještě nebyl zahájen.
deleted	string	Projekt byl odstraněn.
deleting	string	Projekt se právě odstraňuje.
new	string	Projekt se právě vytváří.
unchanged	string	Projekt nebyl změněn.
wellFormed	string	Projekt je zcela vytvořený a připravený k použití.

ProjectVisibility

Viditelnost projektu.

Name	Typ	Description
private	string	Projekt je viditelný pouze uživatelům s explicitním přístupem.
public	string	Projekt je viditelný pro všechny.

ReferenceLinks

Třída představující kolekci odkazů REST.

Name	Typ	Description
links	object	Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako jen pro čtení.

TeamProjectCollectionReference

Referenční objekt pro TeamProjectCollection.

Name	Typ	Description
id	string	ID kolekce.
name	string	Název kolekce.
url	string	Adresa URL REST kolekce.

TeamProjectReference

Představuje povrchní odkaz na TeamProject.

Name	Typ	Description
abbreviation	string	Zkratka projektu.
defaultTeamImageUrl	string	Adresa URL výchozího obrázku týmové identity
description	string	Popis projektu (pokud existuje).
id	string	Identifikátor projektu.
name	string	Název projektu.
revision	integer	Revize projektu.
state	ProjectState	Stav projektu.
url	string	Adresa URL pro úplnou verzi objektu.
visibility	ProjectVisibility	Viditelnost projektu.

Sdílet prostřednictvím