Pull Request Statuses - Get

Başvuru

Service:: Git

API Version:: 4.1-preview.1

Kimliğine göre belirli çekme isteği durumunu alın. Durum kimliği, tüm yinelemelerde çekme isteği içinde benzersizdir.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/statuses/{statusId}?api-version=4.1-preview.1

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
pullRequestId	path	True	integer int32	Çekme isteğinin kimliği.
repositoryId	path	True	string	Çekme isteğinin hedef dalının depo kimliği.
statusId	path	True	integer int32	Çekme isteği durumunun kimliği.
project	path		string	Proje Kimliği veya proje adı
api-version	query	True	string	Kullanılacak API'nin sürümü. Bu, api'nin bu sürümünü kullanmak için '4.1-preview.1' olarak ayarlanmalıdır.

Yanıtlar

Name	Tür	Description
200 OK	GitPullRequestStatus	başarılı işlem

Güvenlik

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	İşlemeler, değişiklik kümeleri, dallar ve diğer sürüm denetimi yapıtları hakkında kaynak kodu ve meta verileri okuma yeteneği verir. Ayrıca hizmet kancaları aracılığıyla sürüm denetimi olayları hakkında bildirim alma olanağı sağlar.
vso.code_status	İşleme ve çekme isteği durumunu okuma ve yazma yeteneği verir.

Örnekler

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/statuses/{statusId}?api-version=4.1-preview.1

Sample Response

Status code:: 200

{
  "id": 1,
  "state": "succeeded",
  "description": "Sample status succeeded",
  "context": {
    "name": "sample-status-1",
    "genre": "vsts-samples"
  },
  "creationDate": "2017-09-19T14:50:27.4949745Z",
  "updatedDate": "2017-09-19T14:50:27.4949745Z",
  "createdBy": {
    "id": "6f168adb-59d4-4fc0-be3b-fb21b939b2a6",
    "displayName": "Normal Paulk",
    "uniqueName": "fabrikamfiber16@hotmail.com",
    "url": "https://dev.azure.com/fabrikam/_apis/Identities/6f168adb-59d4-4fc0-be3b-fb21b939b2a6",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=6f168adb-59d4-4fc0-be3b-fb21b939b2a6"
  },
  "targetUrl": "http://fabrikam-fiber-inc.com/CI/builds/1",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/b92c8408-a0c9-4292-88af-bc005a1b8272/pullRequests/5/statuses/1"
    },
    "repository": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/b92c8408-a0c9-4292-88af-bc005a1b8272"
    }
  }
}

Tanımlar

Name	Description
GitPullRequestStatus	Bu sınıf, bir hizmet/uzantı gönderme çekme isteği durumunun meta verilerini içerir. Durum bir çekme isteği veya yineleme ile ilişkilendirilebilir.
GitStatusContext	Durumu benzersiz olarak tanımlayan durum bağlamı.
GitStatusState	Durumun durumu.
IdentityRef
PropertiesCollection	sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik çantasını temsil eder. Dışındaki `DBNull` tüm ilkel türlerin (ile herhangi bir `TypeCode != TypeCode.Object`türü) değerleri kabul edilir. Byte[], Int32, Double, DateType ve String türündeki değerler türlerini korur, diğer temel öğeler Dize olarak döndürüler. Byte[] base64 kodlanmış dizesi olarak bekleniyor.
ReferenceLinks	REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.

GitPullRequestStatus

Bu sınıf, bir hizmet/uzantı gönderme çekme isteği durumunun meta verilerini içerir. Durum bir çekme isteği veya yineleme ile ilişkilendirilebilir.

Name	Tür	Description
_links	ReferenceLinks	Başvuru bağlantıları.
context	GitStatusContext	Durumun bağlamı.
createdBy	IdentityRef	Durumu oluşturan kimlik.
creationDate	string	Durumun oluşturulma tarihi ve saati.
description	string	Durum açıklaması. Genellikle durumun geçerli durumunu açıklar.
id	integer	Durum tanımlayıcısı.
iterationId	integer	Durumu ilişkilendirilecek yinelemenin kimliği. En düşük değer 1'dir.
properties	PropertiesCollection	Durumun özel özellikleri.
state	GitStatusState	Durumun durumu.
targetUrl	string	Durum ayrıntılarını içeren URL.
updatedDate	string	Durumun son güncelleştirme tarihi ve saati.

GitStatusContext

Durumu benzersiz olarak tanımlayan durum bağlamı.

Name	Tür	Description
genre	string	Durumun türü. Genellikle durumu oluşturan hizmetin/aracın adı boş olabilir.
name	string	Durumun ad tanımlayıcısı null veya boş olamaz.

GitStatusState

Durumun durumu.

Name	Tür	Description
error	string	Hata içeren durum.
failed	string	Durum başarısız oldu.
notApplicable	string	Durum hedef nesne için geçerli değil.
notSet	string	Durum durumu ayarlanmadı. Varsayılan durum.
pending	string	Durum beklemede.
succeeded	string	Durum başarılı oldu.

IdentityRef

Name	Tür	Description
_links	ReferenceLinks	Bu alan, grafik konusuyla ilgili sıfır veya daha fazla ilgi çekici bağlantı içerir. Bu bağlantılar, bu grafik konusu hakkında ek ilişkiler veya daha ayrıntılı bilgi edinmek için çağrılabilir.
descriptor	string	Tanımlayıcı, sistem çalışırken graf konusuna başvurmanın birincil yoludur. Bu alan, hem Hesaplar hem de Kuruluşlar genelinde aynı graf konusunu benzersiz olarak tanımlar.
directoryAlias	string
displayName	string	Bu, grafik konusunun benzersiz olmayan görünen adıdır. Bu alanı değiştirmek için kaynak sağlayıcıdaki değerini değiştirmeniz gerekir.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
profileUrl	string
uniqueName	string
url	string	Bu URL, bu grafik konusunun kaynak kaynağına giden tam yoldur.

PropertiesCollection

sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik çantasını temsil eder. Dışındaki DBNull tüm ilkel türlerin (ile herhangi bir TypeCode != TypeCode.Objecttürü) değerleri kabul edilir. Byte[], Int32, Double, DateType ve String türündeki değerler türlerini korur, diğer temel öğeler Dize olarak döndürüler. Byte[] base64 kodlanmış dizesi olarak bekleniyor.

Name	Tür	Description
count	integer	Koleksiyondaki özelliklerin sayısı.
item	object
keys	string[]	Koleksiyondaki anahtar kümesi.
values	string[]	Koleksiyondaki değer kümesi.

ReferenceLinks

REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.

Name	Tür	Description
links	object	Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak kullanıma açmak istiyoruz.

Aracılığıyla paylaş