Sdílet prostřednictvím


Repositories - Create

Vytvořte úložiště Git v týmovém projektu.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
organization
path True

string

Název organizace Azure DevOps.

project
path

string

ID projektu nebo název projektu

api-version
query True

string

Verze rozhraní API, která se má použít. Tato verze rozhraní API by měla být nastavená na 7.1-preview.1.

sourceRef
query

string

[volitelné] Určení zdrojových odkazů, které se mají použít při vytváření úložiště forku

Text požadavku

Name Typ Description
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Představuje mělký odkaz na TeamProject.

Odpovědi

Name Typ Description
201 Created

GitRepository

Vytvořeno

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 Umožňuje číst, aktualizovat a odstraňovat zdrojový kód a přistupovat k metadatům o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Poskytuje také možnost 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 volání služeb.

Příklady

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

Sample Request

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

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

Sample Response

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

Sample Request

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

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

Sample Response

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

Sample Request

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

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

Sample Response

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

Definice

Name Description
GitRepository
GitRepositoryCreateOptions
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 mělký odkaz na TeamProject.

GitRepository

Name Typ Description
_links

ReferenceLinks

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

defaultBranch

string

id

string

isDisabled

boolean

True, pokud je úložiště zakázané. V ostatních případech False

isFork

boolean

Hodnota True, pokud se úložiště vytvořilo jako fork.

isInMaintenance

boolean

Hodnota True, pokud je úložiště v režimu údržby. V ostatních případech False

name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Představuje mělký odkaz na TeamProject.

remoteUrl

string

size

integer

Komprimovaná velikost (bajty) úložiště.

sshUrl

string

url

string

validRemoteUrls

string[]

webUrl

string

GitRepositoryCreateOptions

Name Typ Description
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Představuje mělký odkaz na TeamProject.

GitRepositoryRef

Name Typ Description
collection

TeamProjectCollectionReference

Kolekce týmových projektů, kde se nachází tento fork

id

string

isFork

boolean

Hodnota True, pokud se úložiště vytvořilo jako fork

name

string

project

TeamProjectReference

Představuje mělký odkaz na TeamProject.

remoteUrl

string

sshUrl

string

url

string

ProjectState

Stav projektu.

Name Typ Description
all

string

Všechny projekty bez ohledu na stav s výjimkou Odstraněno.

createPending

string

Projekt byl zařazen do fronty k vytvoření, ale tento 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.

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

Name Typ Description
links

object

Zobrazení odkazů jen pro čtení. Odkazy jsou jen pro čtení, a proto je chceme zveřejnit jen jako odkazy jen pro čtení.

TeamProjectCollectionReference

Referenční objekt pro TeamProjectCollection.

Name Typ Description
avatarUrl

string

Adresa URL avatara kolekce.

id

string

ID kolekce.

name

string

Název kolekce.

url

string

Adresa URL REST kolekce.

TeamProjectReference

Představuje mělký 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.

lastUpdateTime

string

Čas poslední aktualizace projektu.

name

string

Název projektu.

revision

integer

Revize projektu.

state

ProjectState

Stav projektu.

url

string

Adresa URL na plnou verzi objektu.

visibility

ProjectVisibility

Viditelnost projektu.