Pull Request Statuses - List

Ссылка

Service:: Git

API Version:: 4.1-preview.1

Получение всех состояний, связанных с запросом на вытягивание.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Название организации Azure DevOps.
pullRequestId	path	True	integer int32	Идентификатор запроса на вытягивание.
repositoryId	path	True	string	Идентификатор репозитория целевой ветви запроса на вытягивание.
project	path		string	Идентификатор проекта или имя проекта
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 4.1-preview.1.

Ответы

Имя	Тип	Описание
200 OK	GitPullRequestStatus[]	успешная операция

Безопасность

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	Предоставляет возможность чтения и записи состояния фиксации и запроса на вытягивание.

Имя

Описание

vso.code

Предоставляет возможность чтения исходного кода и метаданных о фиксациях, наборах изменений, ветвях и других артефактах управления версиями. Также предоставляет возможность получать уведомления о событиях управления версиями с помощью перехватчиков служб.

vso.code_status

Предоставляет возможность чтения и записи состояния фиксации и запроса на вытягивание.

Примеры

Sample Request

HTTP

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

Sample Response

Status code:: 200

transfer-Encoding: chunked

Response Body

{
  "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
}

Определения

Имя	Описание
GitPullRequestStatus	Этот класс содержит метаданные службы или расширения, публикующей состояние запроса на вытягивание. Состояние может быть связано с запросом на вытягивание или итерацией.
GitStatusContext	Контекст состояния, однозначно определяющий состояние.
GitStatusState	Состояние состояния.
IdentityRef
PropertiesCollection	Класс представляет контейнер свойств в виде коллекции пар "ключ-значение". Принимаются значения всех примитивных типов (любого типа с `TypeCode != TypeCode.Object`), кроме `DBNull` . Значения типа Byte[], Int32, Double, DateType и String сохраняют свой тип, другие примитивы перенастраиваются как String. Byte[] — строка в кодировке Base64.
ReferenceLinks	Класс, представляющий коллекцию ссылок REST.

GitPullRequestStatus

Этот класс содержит метаданные службы или расширения, публикующей состояние запроса на вытягивание. Состояние может быть связано с запросом на вытягивание или итерацией.

Имя	Тип	Описание
_links	ReferenceLinks	Ссылки на справочные материалы.
context	GitStatusContext	Контекст состояния.
createdBy	IdentityRef	Удостоверение, создающее состояние.
creationDate	string	Дата и время создания состояния.
description	string	Описание состояния. Обычно описывает текущее состояние состояния.
id	integer	Идентификатор состояния.
iterationId	integer	Идентификатор итерации, с которым нужно связать состояние. Минимальное значение — 1.
properties	PropertiesCollection	Пользовательские свойства состояния.
state	GitStatusState	Состояние состояния.
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	ReferenceLinks	Это поле содержит ноль или более интересных ссылок на тему графа. Эти ссылки можно вызвать для получения дополнительных связей или более подробных сведений об этой теме графа.
descriptor	string	Дескриптор является основным способом ссылки на субъект графа во время работы системы. Это поле однозначно идентифицирует одну и ту же тему графа как в учетных записях, так и в организациях.
directoryAlias	string
displayName	string	Это неуникальное отображаемое имя субъекта графа. Чтобы изменить это поле, необходимо изменить его значение в поставщике источника.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
profileUrl	string
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	Представление ссылок только для чтения. Так как ссылочные ссылки доступны только для чтения, мы хотим предоставить их только для чтения.