Pushes - Get

참조

서비스:: Git

API 버전:: 7.1

특정 푸시를 검색합니다.

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

선택적 매개 변수:

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pushes/{pushId}?includeCommits={includeCommits}&includeRefUpdates={includeRefUpdates}&api-version=7.1

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
organization	path	True	string	Azure DevOps 조직의 이름입니다.
pushId	path	True	integer (int32)	푸시의 ID입니다.
repositoryId	path	True	string	리포지토리의 이름 또는 ID입니다.
project	path		string	프로젝트 ID 또는 프로젝트 이름
api-version	query	True	string	사용할 API의 버전입니다. 이 버전의 API를 사용하려면 '7.1'로 설정해야 합니다.
includeCommits	query		integer (int32)	결과에 포함할 커밋 수입니다.
includeRefUpdates	query		boolean	true이면 푸시에 의해 업데이트된 참조 목록을 포함합니다.

응답

Name	형식	Description
200 OK	GitPush	성공한 작업

보안

oauth2

형식: oauth2
Flow: accessCode
권한 부여 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
토큰 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

범위

Name	Description
vso.code	커밋, 변경 집합, 분기 및 기타 버전 제어 아티팩트에 대한 소스 코드 및 메타데이터를 읽을 수 있는 기능을 부여합니다. 또한 코드를 검색하고 서비스 후크를 통해 버전 제어 이벤트에 대한 알림을 받을 수 있는 기능을 부여합니다.

예제

Just the push

샘플 요청

HTTP

GET https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23?api-version=7.1

샘플 응답

상태 코드:: 200

{
  "commits": [],
  "pushedBy": {
    "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
    "displayName": "Normal Paulk",
    "uniqueName": "fabrikamfiber16@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
  },
  "pushId": 23,
  "date": "2014-06-30T18:11:18.0929091Z",
  "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23"
    },
    "repository": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249"
    },
    "commits": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23/commits"
    },
    "pusher": {
      "href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
    }
  }
}

정의

Name	Description
ChangeCountDictionary
GitChange
GitCommitRef	Git 커밋 및 연결된 메타데이터를 설명하는 속성을 제공합니다.
GitPush
GitPushRef
GitRefUpdate
GitRepository
GitRepositoryRef
GitStatus	이 클래스에는 상태를 게시하는 서비스/확장의 메타데이터가 포함됩니다.
GitStatusContext	상태를 고유하게 식별하는 상태 컨텍스트입니다.
GitStatusState	상태의 상태입니다.
GitTemplate
GitUserDate	Git 작업의 사용자 정보 및 날짜입니다.
IdentityRef
ItemContent
ItemContentType
ProjectState	프로젝트 상태입니다.
ProjectVisibility	프로젝트 표시 여부입니다.
ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
ResourceRef
TeamProjectCollectionReference	TeamProjectCollection에 대한 참조 개체입니다.
TeamProjectReference	TeamProject에 대한 단순 참조를 나타냅니다.
VersionControlChangeType	항목에 적용된 변경 유형입니다.

ChangeCountDictionary

Object

GitChange

Object

Name	형식	Description
changeId	integer (int32)	변경 그룹 내의 변경 내용 ID입니다.
changeType	VersionControlChangeType	항목에 적용된 변경 유형입니다.
item	string (T)	현재 버전입니다.
newContent	ItemContent	변경 후 항목의 내용입니다.
newContentTemplate	GitTemplate	새 변경 내용을 푸시할 때 사용할 새 콘텐츠 템플릿입니다.
originalPath	string	현재 경로와 다른 경우 항목의 원래 경로입니다.
sourceServerItem	string	서버에 있는 항목의 경로입니다.
url	string	항목을 검색할 URL입니다.

GitCommitRef

Object

Git 커밋 및 연결된 메타데이터를 설명하는 속성을 제공합니다.

Name	형식	Description
_links	ReferenceLinks	관련 REST 참조 링크의 컬렉션입니다.
author	GitUserDate	커밋의 작성자입니다.
changeCounts	ChangeCountDictionary	커밋에 포함된 변경 유형(편집, 삭제 등)의 개수입니다.
changes	GitChange[]	커밋에 포함된 변경 내용의 열거형입니다.
comment	string	커밋의 주석 또는 메시지입니다.
commentTruncated	boolean	주석이 전체 Git 커밋 주석 메시지에서 잘렸는지를 나타냅니다.
commitId	string	커밋의 ID(SHA-1)입니다.
commitTooManyChanges	boolean	커밋에 너무 많은 변경 내용이 표시됨을 나타냅니다.
committer	GitUserDate	커밋의 커밋자입니다.
parents	string[]	이 커밋에 대한 부모 커밋 ID의 열거형입니다.
push	GitPushRef	이 커밋과 연결된 푸시입니다.
remoteUrl	string	커밋에 대한 원격 URL 경로입니다.
statuses	GitStatus[]	추가 정보를 커밋에 연결할 수 있는 서비스 및 확장의 상태 메타데이터 목록입니다.
url	string	이 리소스에 대한 REST URL입니다.
workItems	ResourceRef[]	이 커밋과 연결된 작업 영역 목록입니다.

GitPush

Object

Name	형식	Description
_links	ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
commits	GitCommitRef[]	Git 커밋 및 연결된 메타데이터를 설명하는 속성을 제공합니다.
date	string (date-time)
pushId	integer (int32)
pushedBy	IdentityRef
refUpdates	GitRefUpdate[]
repository	GitRepository
url	string

GitPushRef

Object

Name	형식	Description
_links	ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
date	string (date-time)
pushId	integer (int32)
pushedBy	IdentityRef
url	string

GitRefUpdate

Object

Name	형식	Description
isLocked	boolean
name	string
newObjectId	string
oldObjectId	string
repositoryId	string (uuid)

GitRepository

Object

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

GitRepositoryRef

Object

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

GitStatus

Object

이 클래스에는 상태를 게시하는 서비스/확장의 메타데이터가 포함됩니다.

Name	형식	Description
_links	ReferenceLinks	참조 링크입니다.
context	GitStatusContext	상태의 컨텍스트입니다.
createdBy	IdentityRef	상태를 만든 ID입니다.
creationDate	string (date-time)	상태의 생성 날짜 및 시간입니다.
description	string	상태 설명입니다. 일반적으로 상태의 현재 상태를 설명합니다.
id	integer (int32)	상태 식별자입니다.
state	GitStatusState	상태의 상태입니다.
targetUrl	string	상태 세부 정보가 포함된 URL입니다.
updatedDate	string (date-time)	상태의 마지막 업데이트 날짜 및 시간입니다.

GitStatusContext

Object

상태를 고유하게 식별하는 상태 컨텍스트입니다.

Name	형식	Description
genre	string	상태의 장르입니다. 일반적으로 상태를 생성하는 서비스/도구의 이름은 비어 있을 수 있습니다.
name	string	상태의 이름 식별자는 null이거나 비워 둘 수 없습니다.

GitStatusState

열거형

상태의 상태입니다.

값	Description
error	오류가 있는 상태입니다.
failed	상태가 실패했습니다.
notApplicable	상태는 대상 개체에 적용되지 않습니다.
notSet	상태 상태가 설정되지 않았습니다. 기본 상태입니다.
pending	보류 중인 상태입니다.
succeeded	상태가 성공했습니다.

GitTemplate

Object

Name	형식	Description
name	string	템플릿의 이름
type	string	템플릿의 형식

GitUserDate

Object

Git 작업의 사용자 정보 및 날짜입니다.

Name	형식	Description
date	string (date-time)	Git 작업의 날짜입니다.
email	string	Git 작업을 수행하는 사용자의 이메일 주소입니다.
imageUrl	string	사용자의 아바타 URL입니다.
name	string	Git 작업을 수행하는 사용자의 이름입니다.

IdentityRef

Object

Name	형식	Description
_links	ReferenceLinks	이 필드에는 그래프 제목에 대한 0개 이상의 흥미로운 링크가 포함되어 있습니다. 이러한 링크를 호출하여 이 그래프 제목에 대한 추가 관계 또는 자세한 정보를 얻을 수 있습니다.
descriptor	string	설명자는 시스템이 실행되는 동안 그래프 제목을 참조하는 기본 방법입니다. 이 필드는 계정과 조직 모두에서 동일한 그래프 제목을 고유하게 식별합니다.
directoryAlias	string	사용되지 않음 - IdentityRef "_links" 사전의 "자체" 항목에서 참조된 Graph 사용자를 쿼리하여 검색할 수 있습니다.
displayName	string	그래프 주체의 고유하지 않은 표시 이름입니다. 이 필드를 변경하려면 원본 공급자에서 해당 값을 변경해야 합니다.
id	string
imageUrl	string	사용되지 않음 - IdentityRef "_links" 사전의 "아바타" 항목에서 사용할 수 있습니다.
inactive	boolean	사용되지 않음 - GraphUser "_links" 사전의 "membershipState" 항목에서 참조되는 Graph 멤버 자격 상태를 쿼리하여 검색할 수 있습니다.
isAadIdentity	boolean	사용되지 않음 - 설명자의 주체 형식(Descriptor.IsAadUserType/Descriptor.IsAadGroupType)에서 유추할 수 있습니다.
isContainer	boolean	사용되지 않음 - 설명자의 주체 형식에서 유추할 수 있음(Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	사용되지 않음 - ToIdentityRef의 기존 구현에서 사용되지 않음
uniqueName	string	사용되지 않음 - 대신 Domain+PrincipalName 사용
url	string	이 URL은 이 그래프 주체의 원본 리소스에 대한 전체 경로입니다.

ItemContent

Object

Name	형식	Description
content	string
contentType	ItemContentType

ItemContentType

열거형

값	Description
base64Encoded
rawText

ProjectState

열거형

프로젝트 상태입니다.

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

ProjectVisibility

열거형

프로젝트 표시 여부입니다.

값	Description
private	이 프로젝트는 명시적 액세스 권한이 있는 사용자에게만 표시됩니다.
public	모든 사용자에게 프로젝트가 표시됩니다.

ReferenceLinks

Object

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

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

ResourceRef

Object

Name	형식	Description
id	string
url	string

TeamProjectCollectionReference

Object

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

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

TeamProjectReference

Object

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

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

VersionControlChangeType

열거형

항목에 적용된 변경 유형입니다.

값	Description
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete

다음을 통해 공유

Pushes - Get

URI 매개 변수

응답

보안

oauth2

범위

예제

Just the push

샘플 요청

샘플 응답

정의

ChangeCountDictionary

GitChange

GitCommitRef

GitPush

GitPushRef

GitRefUpdate

GitRepository

GitRepositoryRef

GitStatus

GitStatusContext

GitStatusState

GitTemplate

GitUserDate

IdentityRef

ItemContent

ItemContentType

ProjectState

ProjectVisibility

ReferenceLinks

ResourceRef

TeamProjectCollectionReference

TeamProjectReference

VersionControlChangeType

추가 리소스