Partager via


Repositories - Update

Mises à jour le dépôt Git avec un nouveau nom de dépôt ou un nouveau branche par défaut.

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

Paramètres URI

Nom Dans Obligatoire Type Description
organization
path True

string

Nom de l’organisation Azure DevOps.

repositoryId
path True

string

uuid

Nom ou ID du dépôt.

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 « 5.0 » pour utiliser cette version de l’API.

Corps de la demande

Nom Type Description
_links

ReferenceLinks

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

defaultBranch

string

id

string

isFork

boolean

True si le dépôt a été créé en tant que duplication

name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

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

remoteUrl

string

size

integer

Taille compressée (octets) du dépôt.

sshUrl

string

url

string

validRemoteUrls

string[]

Réponses

Nom Type Description
200 OK

GitRepository

opération réussie

Sécurité

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

Nom Description
vso.code_manage Permet de lire, de mettre à jour et de supprimer le code source, d’accéder aux métadonnées relatives aux commits, aux ensembles de modifications, aux branches et à d’autres artefacts de contrôle de version. Permet également 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

Sample Request

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

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

Définitions

Nom Description
GitRepository
GitRepositoryRef
ProjectState

État du projet.

ProjectVisibility

Visibilité du projet.

ReferenceLinks

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

TeamProjectCollectionReference

Objet de référence pour un TeamProjectCollection.

TeamProjectReference

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

GitRepository

Nom Type Description
_links

ReferenceLinks

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

defaultBranch

string

id

string

isFork

boolean

True si le dépôt a été créé en tant que duplication

name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

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

remoteUrl

string

size

integer

Taille compressée (octets) du dépôt.

sshUrl

string

url

string

validRemoteUrls

string[]

GitRepositoryRef

Nom Type Description
collection

TeamProjectCollectionReference

Collection de projets d’équipe où réside cette duplication

id

string

isFork

boolean

True si le dépôt a été créé en tant que duplication

name

string

project

TeamProjectReference

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

remoteUrl

string

sshUrl

string

url

string

ProjectState

État du projet.

Nom Type Description
all

string

Tous les projets, quel que soit leur état.

createPending

string

Project a été mis en file d’attente pour la création, mais le processus n’a pas encore démarré.

deleted

string

Le projet a été supprimé.

deleting

string

Project est en cours de suppression.

new

string

Project est en cours de création.

unchanged

string

Le projet n’a pas été modifié.

wellFormed

string

Le projet est entièrement créé et prêt à être utilisé.

ProjectVisibility

Visibilité du projet.

Nom Type Description
private

string

Le projet n’est visible que par les utilisateurs disposant d’un accès explicite.

public

string

Le projet est visible par tous.

Classe pour 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 référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

TeamProjectCollectionReference

Objet de référence pour un TeamProjectCollection.

Nom Type Description
id

string

ID de collection.

name

string

Nom de la collection.

url

string

URL REST de la collection.

TeamProjectReference

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

Nom Type Description
abbreviation

string

Abréviation de 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

Identificateur de projet.

name

string

Nom du projet.

revision

integer

Révision du projet.

state

ProjectState

État du projet.

url

string

Url de la version complète de l’objet.

visibility

ProjectVisibility

Visibilité du projet.