Repositories - Create

Référence

Service:: Git

Version d'API:: 7.1

Créez un dépôt Git dans un projet d’équipe.

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

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
project	path		string	ID de projet ou nom du projet
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1 » pour utiliser cette version de l’API.
sourceRef	query		string	[facultatif] Spécifier les références sources à utiliser lors de la création d’un dépôt de duplication

Corps de la demande

Nom	Type	Description
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Représente une référence superficielle à un TeamProject.

Réponses

Nom	Type	Description
201 Created	GitRepository	Créé

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom	Description
vso.code_manage	Accorde la possibilité de lire, de mettre à jour et de supprimer du code source, d’accéder aux métadonnées relatives aux validations, aux ensembles de modifications, aux branches et à d’autres artefacts de contrôle de version. Accorde également la possibilité de créer et de gérer des référentiels de code, de créer et de gérer des demandes de tirage et des révisions de code, et de recevoir des notifications sur les événements de contrôle de version via des hooks de service.

Nom

Description

vso.code_manage

Accorde la possibilité de lire, de mettre à jour et de supprimer du code source, d’accéder aux métadonnées relatives aux validations, aux ensembles de modifications, aux branches et à d’autres artefacts de contrôle de version. Accorde également la possibilité de créer et de gérer des référentiels de code, de créer et de gérer des demandes de tirage et des révisions de code, et de recevoir des notifications sur les événements de contrôle de version via des hooks de service.

Exemples

Create a fork of a parent repository

Create a fork of a parent repository syncing only the provided refs

Create a repository

Create a fork of a parent repository

Exemple de requête

HTTP

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

{
  "name": "forkRepository",
  "project": {
    "id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90"
  },
  "parentRepository": {
    "id": "57a09b16-c635-4ec9-bd6b-d501fec4eb7b",
    "project": {
      "id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90"
    }
  }
}

Exemple de réponse

Code d’état:: 201

{
  "id": "76b510af-7910-4a96-9902-b978d6226bee",
  "name": "forkRepository",
  "url": "https://dev.azure.com/fabrikam/MyFirstProject/_apis/git/repositories/76b510af-7910-4a96-9902-b978d6226bee",
  "project": {
    "id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90",
    "name": "MyFirstProject",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/3b046b6a-d070-4cd5-ad59-2eace5d05b90",
    "state": "wellFormed",
    "revision": 11,
    "visibility": "private",
    "defaultTeamImageUrl": null
  },
  "size": 0,
  "remoteUrl": "https://dev.azure.com/fabrikam/MyFirstProject/_git/forkRepository",
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikam/MyFirstProject/forkRepository",
  "isFork": true,
  "_links": {
    "forkSyncOperation": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/76b510af-7910-4a96-9902-b978d6226bee/forkSyncRequests/8"
    }
  }
}

Create a fork of a parent repository syncing only the provided refs

Exemple de requête

HTTP

POST https://dev.azure.com/{organization}/_apis/git/repositories?sourceRef=users/heads/master&api-version=7.1

{
  "name": "forkRepositoryWithOnlySourceRef",
  "project": {
    "id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90"
  },
  "parentRepository": {
    "id": "76b510af-7910-4a96-9902-b978d6226bee",
    "project": {
      "id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90"
    }
  }
}

Exemple de réponse

Code d’état:: 201

{
  "id": "29230c30-9125-459b-a3f6-ffab329053bd",
  "name": "forkRepositoryWithOnlySourceRef",
  "url": "https://dev.azure.com/fabrikam/MyFirstProject/_apis/git/repositories/29230c30-9125-459b-a3f6-ffab329053bd",
  "project": {
    "id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90",
    "name": "MyFirstProject",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/3b046b6a-d070-4cd5-ad59-2eace5d05b90",
    "state": "wellFormed",
    "revision": 12,
    "visibility": "private",
    "defaultTeamImageUrl": null
  },
  "size": 0,
  "remoteUrl": "https://dev.azure.com/fabrikam/MyFirstProject/_git/forkRepositoryWithOnlySourceRef",
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikam/MyFirstProject/forkRepositoryWithOnlySourceRef",
  "isFork": true,
  "_links": {
    "forkSyncOperation": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/29230c30-9125-459b-a3f6-ffab329053bd/forkSyncRequests/7"
    }
  }
}

Create a repository

Exemple de requête

HTTP

POST https://dev.azure.com/fabrikam/_apis/git/repositories?api-version=7.1

{
  "name": "AnotherRepository",
  "project": {
    "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c"
  }
}

Exemple de réponse

Code d’état:: 201

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

Définitions

Nom	Description
GitRepository
GitRepositoryCreateOptions
GitRepositoryRef
ProjectState	État du projet.
ProjectVisibility	Visibilité du projet.
ReferenceLinks	Classe à représenter une collection de liens de référence REST.
TeamProjectCollectionReference	Objet reference pour un TeamProjectCollection.
TeamProjectReference	Représente une référence superficielle à un TeamProject.

GitRepository

Object

Nom	Type	Description
_links	ReferenceLinks	Classe à représenter une collection de liens de référence REST.
defaultBranch	string
id	string (uuid)
isDisabled	boolean	True si le référentiel est désactivé. False sinon.
isFork	boolean	True si le référentiel a été créé en tant que fourche.
isInMaintenance	boolean	True si le référentiel est en maintenance. False sinon.
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Représente une référence superficielle à un TeamProject.
remoteUrl	string
size	integer (int64)	Taille compressée (octets) du référentiel.
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

GitRepositoryCreateOptions

Object

Nom	Type	Description
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Représente une référence superficielle à un TeamProject.

GitRepositoryRef

Object

Nom	Type	Description
collection	TeamProjectCollectionReference	Collection de projets d’équipe où réside ce fork
id	string (uuid)
isFork	boolean	True si le référentiel a été créé en tant que fork
name	string
project	TeamProjectReference	Représente une référence superficielle à un TeamProject.
remoteUrl	string
sshUrl	string
url	string

ProjectState

Énumération

État du projet.

Valeur	Description
all	Tous les projets, quel que soit l’état, sauf supprimé.
createPending	Project a été mis en file d’attente pour la création, mais le processus n’a pas encore démarré.
deleted	Le projet a été supprimé.
deleting	Le projet est en cours de suppression.
new	Le projet est en cours de création.
unchanged	Le projet n’a pas été modifié.
wellFormed	Le projet est entièrement créé et prêt à être utilisé.

ProjectVisibility

Énumération

Visibilité du projet.

Valeur	Description
private	Le projet n’est visible que par les utilisateurs disposant d’un accès explicite.
public	Le projet est visible pour tous.

ReferenceLinks

Object

Classe à représenter une collection de liens de référence REST.

Nom	Type	Description
links	object	Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

TeamProjectCollectionReference

Object

Objet reference pour un TeamProjectCollection.

Nom	Type	Description
avatarUrl	string	URL de l’avatar de collection.
id	string (uuid)	ID de collection.
name	string	Nom de la collection.
url	string	URL REST de collection.

TeamProjectReference

Object

Représente une référence superficielle à un TeamProject.

Nom	Type	Description
abbreviation	string	Abréviation du projet.
defaultTeamImageUrl	string	URL de l’image d’identité d’équipe par défaut.
description	string	Description du projet (le cas échéant).
id	string (uuid)	Identificateur du projet.
lastUpdateTime	string (date-time)	Heure de la dernière mise à jour du projet.
name	string	Nom du projet.
revision	integer (int64)	Révision du projet.
state	ProjectState	État du projet.
url	string	URL vers la version complète de l’objet.
visibility	ProjectVisibility	Visibilité du projet.

Partager via

Repositories - Create

Paramètres URI

Corps de la demande

Réponses

Sécurité

oauth2

Étendues

Exemples

Create a fork of a parent repository

Exemple de requête

Exemple de réponse

Create a fork of a parent repository syncing only the provided refs

Exemple de requête

Exemple de réponse

Create a repository

Exemple de requête

Exemple de réponse

Définitions

GitRepository

GitRepositoryCreateOptions

GitRepositoryRef

ProjectState

ProjectVisibility

ReferenceLinks

TeamProjectCollectionReference

TeamProjectReference