Repositories - Create
Erstellen Sie ein Git-Repository in einem Teamprojekt.
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=5.0POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?sourceRef={sourceRef}&api-version=5.0URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Der Name der Azure DevOps-Organisation. |
|
project
|
path |
string |
Projekt-ID oder Projektname |
|
|
api-version
|
query | True |
string |
Version der zu verwendenden API. Dies sollte auf "5.0" festgelegt werden, um diese Version der API zu verwenden. |
|
source
|
query |
string |
[optional] Angeben der Quellrefs, die beim Erstellen eines Fork-Repositorys verwendet werden sollen |
Anforderungstext
| Name | Typ | Beschreibung |
|---|---|---|
| name |
string |
|
| parentRepository | ||
| project |
Stellt einen flachen Verweis auf ein TeamProject dar. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 201 Created |
Erstellt |
Sicherheit
oauth2
Typ:
oauth2
Ablauf:
accessCode
Autorisierungs-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
Bereiche
| 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
Beispielanforderung
POST https://dev.azure.com/fabrikam/_apis/git/repositories?api-version=5.0
{
"name": "AnotherRepository",
"project": {
"id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c"
}
}
Beispiel für eine Antwort
{
"id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
"name": "AnotherRepository",
"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"
},
"remoteUrl": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_git/AnotherRepository"
}Definitionen
| Name | Beschreibung |
|---|---|
|
Git |
|
|
Git |
|
|
Git |
|
|
Project |
Projektstatus. |
|
Project |
Projektsichtbarkeit. |
|
Reference |
Die Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
|
Team |
Referenzobjekt für eine TeamProjectCollection. |
|
Team |
Stellt einen flachen Verweis auf ein TeamProject dar. |
GitRepository
| Name | Typ | Beschreibung |
|---|---|---|
| _links |
Die Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
|
| defaultBranch |
string |
|
| id |
string |
|
| isFork |
boolean |
True, wenn das Repository als Fork erstellt wurde |
| name |
string |
|
| parentRepository | ||
| project |
Stellt einen flachen Verweis auf ein TeamProject dar. |
|
| remoteUrl |
string |
|
| size |
integer |
Komprimierte Größe (Bytes) des Repositorys. |
| sshUrl |
string |
|
| url |
string |
|
| validRemoteUrls |
string[] |
GitRepositoryCreateOptions
| Name | Typ | Beschreibung |
|---|---|---|
| name |
string |
|
| parentRepository | ||
| project |
Stellt einen flachen Verweis auf ein TeamProject dar. |
GitRepositoryRef
| Name | Typ | Beschreibung |
|---|---|---|
| collection |
Team Project Collection, in der sich dieser Fork befindet |
|
| id |
string |
|
| isFork |
boolean |
True, wenn das Repository als Fork erstellt wurde |
| name |
string |
|
| project |
Stellt einen flachen Verweis auf ein TeamProject dar. |
|
| remoteUrl |
string |
|
| sshUrl |
string |
|
| url |
string |
ProjectState
Projektstatus.
| Wert | Beschreibung |
|---|---|
| all |
Alle Projekte unabhängig vom Zustand. |
| createPending |
Project wurde für die Erstellung in die Warteschlange gestellt, aber der Prozess wurde noch nicht gestartet. |
| deleted |
Project wurde gelöscht. |
| deleting |
Project wird gerade gelöscht. |
| new |
Das Projekt wird gerade erstellt. |
| unchanged |
Project wurde nicht geändert. |
| wellFormed |
Project ist vollständig erstellt und einsatzbereit. |
ProjectVisibility
Projektsichtbarkeit.
| Wert | Beschreibung |
|---|---|
| private |
Das Projekt ist nur für Benutzer mit explizitem Zugriff sichtbar. |
| public |
Das Projekt ist für alle sichtbar. |
ReferenceLinks
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 |
|---|---|---|
| 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. |
| name |
string |
Der Projektname. |
| revision |
integer |
Projektrevision. |
| state |
Projektstatus. |
|
| url |
string |
URL zur Vollversion des Objekts. |
| visibility |
Projektsichtbarkeit. |