Repositories - Update

참조

Service:: Git

API Version:: 7.1-preview.1

새 리포지토리 이름 또는 새 기본 분기 사용하여 Git 리포지토리를 업데이트.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
organization	path	True	string	Azure DevOps 조직의 이름입니다.
repositoryId	path	True	string uuid	리포지토리의 ID입니다.
project	path		string	프로젝트 ID 또는 프로젝트 이름
api-version	query	True	string	사용할 API의 버전입니다. 이 버전의 API를 사용하려면 '7.1-preview.1'로 설정해야 합니다.

요청 본문

Name	형식	Description
_links	ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
defaultBranch	string
id	string
isDisabled	boolean	True이면 리포지토리를 사용할 수 없습니다. 그렇지 않으면 false입니다.
isFork	boolean	True이면 리포지토리가 포크로 만들어졌습니다.
isInMaintenance	boolean	True이면 리포지토리가 유지 관리 중입니다. 그렇지 않으면 false입니다.
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	TeamProject에 대한 단순 참조를 나타냅니다.
remoteUrl	string
size	integer	리포지토리의 압축된 크기(바이트)입니다.
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

응답

Name	형식	Description
200 OK	GitRepository	작업에 성공했습니다. 응답에는 업데이트된 리포지토리 정보가 포함됩니다.

보안

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	소스 코드를 읽고, 업데이트하고, 삭제하고, 커밋, 변경 집합, 분기 및 기타 버전 제어 아티팩트에 대한 메타데이터에 액세스하는 기능을 부여합니다. 또한 코드 리포지토리를 만들고 관리하고, 끌어오기 요청 및 코드 검토를 만들고 관리하고, 서비스 후크를 통해 버전 제어 이벤트에 대한 알림을 받을 수 있는 기능도 부여합니다.

Name

Description

vso.code_manage

소스 코드를 읽고, 업데이트하고, 삭제하고, 커밋, 변경 집합, 분기 및 기타 버전 제어 아티팩트에 대한 메타데이터에 액세스하는 기능을 부여합니다. 또한 코드 리포지토리를 만들고 관리하고, 끌어오기 요청 및 코드 검토를 만들고 관리하고, 서비스 후크를 통해 버전 제어 이벤트에 대한 알림을 받을 수 있는 기능도 부여합니다.

예제

Disable repository

Update a respository while specifying the project

Update a respository without specifying the project

Disable repository

Sample Request

HTTP

PATCH https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6?api-version=7.1-preview.1

{
  "isDisabled": true
}

Sample Response

Status code:: 200

{
  "id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
  "name": "RenamedRepository",
  "RenamedRepository": true,
  "isDisabled": true,
  "url": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_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"
}

Update a respository while specifying the project

Sample Request

HTTP

PATCH https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6?api-version=7.1-preview.1

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

Sample Response

Status code:: 200

{
  "id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
  "name": "RenamedRepository",
  "isDisabled": false,
  "url": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_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"
}

Update a respository without specifying the project

Sample Request

HTTP

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

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

Sample Response

Status code:: 200

{
  "id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
  "name": "RenamedRepository",
  "isDisabled": false,
  "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"
}

정의

Name	Description
GitRepository
GitRepositoryRef
ProjectState	프로젝트 상태입니다.
ProjectVisibility	프로젝트 표시 유형입니다.
ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
TeamProjectCollectionReference	TeamProjectCollection에 대한 참조 개체입니다.
TeamProjectReference	TeamProject에 대한 단순 참조를 나타냅니다.

GitRepository

Name	형식	Description
_links	ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
defaultBranch	string
id	string
isDisabled	boolean	True이면 리포지토리를 사용할 수 없습니다. 그렇지 않으면 false입니다.
isFork	boolean	True이면 리포지토리가 포크로 만들어졌습니다.
isInMaintenance	boolean	True이면 리포지토리가 유지 관리 중입니다. 그렇지 않으면 false입니다.
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	TeamProject에 대한 단순 참조를 나타냅니다.
remoteUrl	string
size	integer	리포지토리의 압축된 크기(바이트)입니다.
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

GitRepositoryRef

Name	형식	Description
collection	TeamProjectCollectionReference	이 포크가 있는 팀 프로젝트 컬렉션
id	string
isFork	boolean	True이면 리포지토리가 포크로 만들어졌습니다.
name	string
project	TeamProjectReference	TeamProject에 대한 단순 참조를 나타냅니다.
remoteUrl	string
sshUrl	string
url	string

ProjectState

프로젝트 상태입니다.

Name	형식	Description
all	string	삭제됨을 제외한 모든 프로젝트는 상태에 관계 없이 수행됩니다.
createPending	string	프로젝트를 만들기 위해 큐에 대기했지만 프로세스가 아직 시작되지 않았습니다.
deleted	string	프로젝트가 삭제되었습니다.
deleting	string	프로젝트가 삭제되는 중입니다.
new	string	프로젝트가 만들어지는 중입니다.
unchanged	string	프로젝트가 변경되지 않았습니다.
wellFormed	string	프로젝트가 완전히 만들어지고 사용할 준비가 된 것입니다.

ProjectVisibility

프로젝트 표시 유형입니다.

Name	형식	Description
private	string	프로젝트는 명시적 액세스 권한이 있는 사용자에게만 표시됩니다.
public	string	프로젝트는 모두 볼 수 있습니다.

ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

Name	형식	Description
links	object	링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다.

TeamProjectCollectionReference

TeamProjectCollection에 대한 참조 개체입니다.

Name	형식	Description
avatarUrl	string	컬렉션 아바타 URL입니다.
id	string	컬렉션 ID입니다.
name	string	컬렉션 이름입니다.
url	string	컬렉션 REST URL입니다.

TeamProjectReference

TeamProject에 대한 단순 참조를 나타냅니다.

Name	형식	Description
abbreviation	string	프로젝트 약어입니다.
defaultTeamImageUrl	string	기본 팀 ID 이미지의 URL입니다.
description	string	프로젝트의 설명(있는 경우)입니다.
id	string	프로젝트 식별자입니다.
lastUpdateTime	string	프로젝트 마지막 업데이트 시간입니다.
name	string	프로젝트 이름입니다.
revision	integer	프로젝트 수정 버전입니다.
state	ProjectState	프로젝트 상태입니다.
url	string	개체의 전체 버전에 대한 URL입니다.
visibility	ProjectVisibility	프로젝트 표시 유형입니다.

다음을 통해 공유

Repositories - Update

URI 매개 변수

요청 본문

응답

보안

oauth2

Scopes

예제

Disable repository

Sample Request

Sample Response

Update a respository while specifying the project

Sample Request

Sample Response

Update a respository without specifying the project

Sample Request

Sample Response

정의

GitRepository

GitRepositoryRef

ProjectState

ProjectVisibility

ReferenceLinks

TeamProjectCollectionReference

TeamProjectReference

추가 리소스