Pull Request Statuses - List
Получение всех состояний, связанных с запросом на вытягивание.
GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/statuses?api-version=7.1-preview.1
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
organization
|
path | True |
string |
Название организации Azure DevOps. |
pull
|
path | True |
integer int32 |
Идентификатор запроса на вытягивание. |
repository
|
path | True |
string |
Идентификатор репозитория целевой ветви запроса на вытягивание. |
project
|
path |
string |
Идентификатор проекта или имя проекта |
|
api-version
|
query | True |
string |
Используемая версия API. Для использования этой версии API необходимо задать значение 7.1-preview.1. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
успешная операция |
Безопасность
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
Имя | Описание |
---|---|
vso.code | Предоставляет возможность чтения исходного кода и метаданных о фиксациях, наборах изменений, ветвях и других артефактах управления версиями. Также предоставляет возможность поиска кода и получения уведомлений о событиях управления версиями с помощью перехватчиков служб. |
vso.code_status | Предоставляет возможность чтения и записи состояния фиксации и запроса на вытягивание. |
Примеры
Sample Request
GET https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/statuses?api-version=7.1-preview.1
Sample Response
transfer-Encoding: chunked
{
"value": [
{
"id": 1,
"state": "succeeded",
"description": "Sample status succeeded",
"context": {
"name": "sample-status-2",
"genre": "vsts-samples"
},
"creationDate": "2017-09-19T14:50:27.064405Z",
"updatedDate": "2017-09-19T14:50:27.064405Z",
"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"
},
{
"id": 2,
"state": "succeeded",
"description": "Sample status succeeded",
"context": {
"name": "sample-status-4",
"genre": "vsts-samples"
},
"creationDate": "2017-09-19T14:50:27.0894136Z",
"updatedDate": "2017-09-19T14:50:27.0894136Z",
"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"
}
],
"count": 2
}
Определения
Имя | Описание |
---|---|
Git |
Этот класс содержит метаданные службы или расширения, публикующей состояние запроса на вытягивание. Состояние может быть связано с запросом на вытягивание или итерацией. |
Git |
Контекст состояния, однозначно определяющий состояние. |
Git |
Состояние состояния. |
Identity |
|
Properties |
Класс представляет контейнер свойств в виде коллекции пар "ключ-значение". Принимаются значения всех примитивных типов (любого типа с |
Reference |
Класс, представляющий коллекцию ссылок REST. |
GitPullRequestStatus
Этот класс содержит метаданные службы или расширения, публикующей состояние запроса на вытягивание. Состояние может быть связано с запросом на вытягивание или итерацией.
Имя | Тип | Описание |
---|---|---|
_links |
Ссылки на справочные материалы. |
|
context |
Контекст состояния. |
|
createdBy |
Удостоверение, создающее состояние. |
|
creationDate |
string |
Дата и время создания состояния. |
description |
string |
Описание состояния. Обычно описывает текущее состояние состояния. |
id |
integer |
Идентификатор состояния. |
iterationId |
integer |
Идентификатор итерации, с которым нужно связать состояние. Минимальное значение — 1. |
properties |
Пользовательские свойства состояния. |
|
state |
Состояние состояния. |
|
targetUrl |
string |
URL-адрес со сведениями о состоянии. |
updatedDate |
string |
Дата и время последнего обновления состояния. |
GitStatusContext
Контекст состояния, однозначно определяющий состояние.
Имя | Тип | Описание |
---|---|---|
genre |
string |
Жанр состояния. Как правило, имя службы или средства, создающего состояние, может быть пустым. |
name |
string |
Идентификатор имени состояния, не может быть пустым или пустым. |
GitStatusState
Состояние состояния.
Имя | Тип | Описание |
---|---|---|
error |
string |
Состояние с ошибкой. |
failed |
string |
Сбой состояния. |
notApplicable |
string |
Состояние неприменимо к целевому объекту. |
notSet |
string |
Состояние состояния не задано. Состояние по умолчанию. |
pending |
string |
Состояние ожидания. |
succeeded |
string |
Состояние выполнено успешно. |
IdentityRef
Имя | Тип | Описание |
---|---|---|
_links |
Это поле содержит ноль или более интересных ссылок на тему графа. Эти ссылки можно вызвать для получения дополнительных связей или более подробных сведений об этой теме графа. |
|
descriptor |
string |
Дескриптор является основным способом ссылки на субъект графа во время работы системы. Это поле однозначно идентифицирует одну и ту же тему графа как в учетных записях, так и в организациях. |
directoryAlias |
string |
Нерекомендуемый — можно получить, запросив пользователя Graph, на который ссылается запись self словаря IdentityRef _links. |
displayName |
string |
Это неуникальное отображаемое имя субъекта графа. Чтобы изменить это поле, необходимо изменить его значение в поставщике источника. |
id |
string |
|
imageUrl |
string |
Не рекомендуется — доступно в записи "аватар" словаря IdentityRef "_links" |
inactive |
boolean |
Не рекомендуется — можно получить, запросив состояние членства Graph, указанное в записи membershipState словаря GraphUser _links. |
isAadIdentity |
boolean |
Не рекомендуется — может выводиться из типа субъекта дескриптора (descriptor.IsAadUserType/descriptor.IsAadGroupType). |
isContainer |
boolean |
Не рекомендуется — может выводиться из типа субъекта дескриптора (Descriptor.IsGroupType). |
isDeletedInOrigin |
boolean |
|
profileUrl |
string |
Нерекомендуемый — не используется в большинстве уже существовающих реализаций ToIdentityRef. |
uniqueName |
string |
Нерекомендуемый — используйте вместо этого домен+имя_субъекта |
url |
string |
Этот URL-адрес является полным маршрутом к исходному ресурсу этого субъекта графа. |
PropertiesCollection
Класс представляет контейнер свойств в виде коллекции пар "ключ-значение". Принимаются значения всех примитивных типов (любого типа с TypeCode != TypeCode.Object
), кроме DBNull
. Значения типа Byte[], Int32, Double, DateType и String сохраняют свой тип, другие примитивы перенастраиваются как String. Byte[] — строка в кодировке Base64.
Имя | Тип | Описание |
---|---|---|
count |
integer |
Количество свойств в коллекции. |
item |
object |
|
keys |
string[] |
Набор ключей в коллекции. |
values |
string[] |
Набор значений в коллекции. |
ReferenceLinks
Класс, представляющий коллекцию ссылок REST.
Имя | Тип | Описание |
---|---|---|
links |
object |
Представление ссылок только для чтения. Так как ссылочные ссылки доступны только для чтения, мы хотим предоставить их только для чтения. |
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по