Pull Request Statuses - Get
Belirli çekme isteği durumunu kimliğine göre 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=7.1
URI Parametreleri
| Name | İçinde | Gerekli | Tür | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Azure DevOps kuruluşunun adı. |
|
pull
|
path | True |
integer (int32) |
Çekme isteğinin kimliği. |
|
repository
|
path | True |
string |
Çekme isteğinin hedef dalının depo kimliği. |
|
status
|
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 '7.1' olarak ayarlanmalıdır. |
Yanıtlar
| Name | Tür | Description |
|---|---|---|
| 200 OK |
başarılı işlem |
Güvenlik
oauth2
Tür:
oauth2
Akış:
accessCode
Yetkilendirme URL’si:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Belirteç URL'si:
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
Kapsamlar
| 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 olanağı sağlar. Ayrıca hizmet kancaları aracılığıyla kod arama ve sürüm denetimi olayları hakkında bildirim alma olanağı sağlar. |
| vso.code_status | İşleme ve çekme isteği durumunu okuma ve yazma olanağı verir. |
Örnekler
Örnek isteği
GET https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/statuses/{statusId}?api-version=7.1
Örnek yanıt
{
"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 |
|---|---|
|
Git |
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. |
|
Git |
Durumu benzersiz olarak tanımlayan durum bağlamı. |
|
Git |
Durumun durumu. |
|
Identity |
|
|
Properties |
sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik paketini temsil eder.
|
|
Reference |
REST başvuru bağlantıları 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 |
Başvuru bağlantıları. |
|
| context |
Durumun bağlamı. |
|
| createdBy |
Durumu oluşturan kimlik. |
|
| creationDate |
string (date-time) |
Durumun oluşturulma tarihi ve saati. |
| description |
string |
Durum açıklaması. Genellikle durumun geçerli durumunu açıklar. |
| id |
integer (int32) |
Durum tanımlayıcısı. |
| iterationId |
integer (int32) |
Durumu ilişkilendirilecek yinelemenin kimliği. En düşük değer 1'dir. |
| properties |
Durumun özel özellikleri. |
|
| state |
Durumun durumu. |
|
| targetUrl |
string |
Durum ayrıntılarını içeren URL. |
| updatedDate |
string (date-time) |
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.
| Değer | Description |
|---|---|
| error |
Hata içeren durum. |
| failed |
Durum başarısız oldu. |
| notApplicable |
Durum hedef nesne için geçerli değildir. |
| notSet |
Durum durumu ayarlanmadı. Varsayılan durum. |
| pending |
Durum bekleniyor. |
| succeeded |
Durum başarılı oldu. |
IdentityRef
| Name | Tür | Description |
|---|---|---|
| _links |
Bu alan, grafik konusu hakkında sıfır veya daha fazla ilginç bağlantı içerir. Bu bağlantılar, bu grafik konusu hakkında daha fazla ilişki 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 |
Kullanım dışı - IdentityRef "_links" sözlüğündeki "self" girişinde başvuruda bulunılan Graph kullanıcısı sorgulanarak alınabilir |
| 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 |
Kullanım dışı - IdentityRef "_links" sözlüğün "avatar" girişinde kullanılabilir |
| inactive |
boolean |
Kullanım dışı - GraphUser "_links" sözlüğündeki "membershipState" girdisinde başvurulan Graph üyelik durumu sorgulanarak alınabilir |
| isAadIdentity |
boolean |
Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
| isContainer |
boolean |
Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Tanımlayıcı.IsGroupType) |
| isDeletedInOrigin |
boolean |
|
| profileUrl |
string |
Kullanım dışı - ToIdentityRef'in önceden var olan uygulamalarının çoğunda kullanımda değil |
| uniqueName |
string |
Kullanım dışı - bunun yerine Domain+PrincipalName kullanın |
| 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 paketini temsil eder.
DBNull dışındaki tüm ilkel türlerin (TypeCode != TypeCode.Objectolan herhangi bir 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 yeniden dönüştürülür. Byte[] base64 kodlanmış dize olarak bekleniyor.
| Name | Tür | Description |
|---|---|---|
| count |
integer (int32) |
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ı 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. |