Approvals - Update

Ссылка

Служба:: Approvals And Checks

Версия API:: 7.1

Обновление утверждений.

PATCH https://dev.azure.com/{organization}/{project}/_apis/pipelines/approvals?api-version=7.1

Параметры URI

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

Текст запроса

Имя	Тип	Описание
body	ApprovalUpdateParameters[]

Ответы

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

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

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

Области

Имя	Описание
vso.build_execute	Предоставляет возможность доступа к артефактам сборки, включая результаты сборки, определения и запросы, а также возможность очереди сборки, обновления свойств сборки и возможность получать уведомления о событиях сборки с помощью перехватчиков служб.
vso.pipelineresources_use	Предоставляет возможность утвердить запрос конвейера на использование защищенного ресурса: пул агентов, среда, очередь, репозиторий, безопасные файлы, подключение к службе и группа переменных

Имя

Описание

vso.build_execute

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

vso.pipelineresources_use

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

Примеры

Образец запроса

HTTP

PATCH https://dev.azure.com/{organization}/{project}/_apis/pipelines/approvals?api-version=7.1

[
  {
    "approvalId": "aab27959-a5be-4ee3-97ca-f19b3602cd2f",
    "comment": "Approving",
    "status": "approved"
  }
]

Пример ответа

Код состояния:: 200

request-Context: appId=cid-v1:a892bfef-0287-4640-9f5e-cffc90fbcf94
access-Control-Expose-Headers: Request-Context

{
  "count": 1,
  "value": [
    {
      "id": "aab27959-a5be-4ee3-97ca-f19b3602cd2f",
      "steps": [
        {
          "assignedApprover": {
            "displayName": "User Name",
            "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
            "uniqueName": "uniqueName",
            "descriptor": "Descriptor"
          },
          "actualApprover": {
            "displayName": "User Name",
            "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
            "uniqueName": "uniqueName",
            "descriptor": "Descriptor"
          },
          "status": "approved",
          "comment": "Approving",
          "lastModifiedOn": "2020-11-19T09:57:54.252505Z",
          "order": 1,
          "lastModifiedBy": {
            "displayName": "User Name",
            "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
            "uniqueName": "uniqueName",
            "descriptor": "Descriptor"
          },
          "initiatedOn": "2020-11-19T09:51:16.7045043Z",
          "history": []
        }
      ],
      "status": "approved",
      "createdOn": "2020-11-19T09:51:16.703Z",
      "lastModifiedOn": "2020-11-19T09:57:54.252505Z",
      "executionOrder": "anyOrder",
      "minRequiredApprovers": 1,
      "blockedApprovers": [],
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/approvals/aab27959-a5be-4ee3-97ca-f19b3602cd2f"
        }
      }
    }
  ]
}

Определения

Имя	Описание
Approval
ApprovalExecutionOrder	Порядок, в котором утверждающие будут действовать.
ApprovalPermissions	Текущие разрешения пользователя для объекта утверждения.
ApprovalStatus	Общее состояние утверждения.
ApprovalStep	Данные для одного шага утверждения.
ApprovalStepHistory	Данные для одного журнала шагов утверждения.
ApprovalUpdateParameters	Данные для обновления объекта утверждения или отдельного шага.
IdentityRef
ReferenceLinks	Класс, представляющий коллекцию ссылок REST.

Approval

Object

Имя	Тип	Описание
_links	ReferenceLinks	Получает ссылки для доступа к объекту утверждения.
blockedApprovers	IdentityRef[]	Удостоверения, которые не допускаются для утверждения.
createdOn	string (date-time)	Дата создания утверждения.
executionOrder	ApprovalExecutionOrder	Порядок, в котором утверждающие будут действовать.
id	string (uuid)	Уникальный идентификатор утверждения.
instructions	string	Инструкции для утверждающих.
lastModifiedOn	string (date-time)	Дата последнего изменения утверждения.
minRequiredApprovers	integer (int32)	Минимальное число утверждающих, которые должны утверждаться для всего утверждения, которое будет считаться утвержденным.
permissions	ApprovalPermissions	Текущие разрешения пользователя для объекта утверждения.
status	ApprovalStatus	Общее состояние утверждения.
steps	ApprovalStep[]	Список шагов, связанных с утверждением.

ApprovalExecutionOrder

Перечисление

Порядок, в котором утверждающие будут действовать.

Значение	Описание
anyOrder	Указывает, что утверждающие могут утверждаться в любом порядке.
inSequence	Указывает, что утверждающие могут утверждать только в последовательном порядке (порядок, в котором они были назначены).

ApprovalPermissions

Перечисление

Текущие разрешения пользователя для объекта утверждения.

Значение	Описание
none
queueBuild
reassign
resourceAdmin
update
view

ApprovalStatus

Перечисление

Общее состояние утверждения.

Значение	Описание
all
approved	Указывает, что утверждение утверждено.
canceled	Указывает, что утверждение отменено.
completed
failed
pending	Указывает, что утверждение ожидается.
rejected	Указывает, что утверждение отклонено.
skipped	Указывает, что утверждение пропущено.
timedOut	Указывает время ожидания утверждения.
undefined
uninitiated	Указывает, что утверждение не указано. Используется в случае последовательности выполнения, где данный утверждающий пока не подходит для действий.

ApprovalStep

Object

Данные для одного шага утверждения.

Имя	Тип	Описание
actualApprover	IdentityRef	Удостоверение, утвержденное.
assignedApprover	IdentityRef	Удостоверение, которому следует утвердить.
comment	string	Комментарий, связанный с этим шагом.
history	ApprovalStepHistory[]	История шага утверждения
initiatedOn	string (date-time)	Метка времени, с которой был инициирован этот шаг.
lastModifiedBy	IdentityRef	Удостоверение, с помощью которого последний шаг был изменен.
lastModifiedOn	string (date-time)	Метка времени последнего изменения этого шага.
order	integer (int32)	Порядок утверждения утверждающих.
permissions	ApprovalPermissions	Текущие разрешения пользователя для шага.
status	ApprovalStatus	Текущее состояние этого шага.

ApprovalStepHistory

Object

Данные для одного журнала шагов утверждения.

Имя	Тип	Описание
assignedTo	IdentityRef	Удостоверение, которому было назначено это утверждение
comment	string	Комментарий, связанный с этим журналом шагов.
createdBy	IdentityRef	Удостоверение, с помощью которого был создан журнал шагов.
createdOn	string (date-time)	Метка времени создания журнала шагов.

ApprovalUpdateParameters

Object

Данные для обновления объекта утверждения или отдельного шага.

Имя	Тип	Описание
approvalId	string (uuid)	Идентификатор обновленного утверждения.
assignedApprover	IdentityRef	Текущий утверждающий.
comment	string	Возвращает или задает комментарий.
reassignTo	IdentityRef	Переназначаемый утверждающий.
status	ApprovalStatus	Возвращает или задает состояние.

IdentityRef

Object

Имя	Тип	Описание
_links	ReferenceLinks	Это поле содержит нулевые или более интересные ссылки на тему графа. Эти ссылки могут вызываться для получения дополнительных связей или более подробных сведений об этой теме графа.
descriptor	string	Дескриптор является основным способом ссылки на тему графа во время выполнения системы. Это поле однозначно определяет одну и ту же тему графа как в учетных записях, так и в организациях.
directoryAlias	string	Нерекомендуемое. Можно получить, запросив пользователя Graph, на который ссылается пользователь 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	Не рекомендуется — вместо этого используйте domain+PrincipalName
url	string	Этот URL-адрес является полным маршрутом к исходному ресурсу данного субъекта графа.

ReferenceLinks

Object

Класс, представляющий коллекцию ссылок REST.

Имя	Тип	Описание
links	object	Режим чтения ссылок. Так как ссылки ссылки доступны только для чтения, мы хотим предоставлять их только как доступные только для чтения.

Поделиться через

Approvals - Update

Параметры URI

Текст запроса

Ответы

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

oauth2

Области

Примеры

Образец запроса

Пример ответа

Определения

Approval

ApprovalExecutionOrder

ApprovalPermissions

ApprovalStatus

ApprovalStep

ApprovalStepHistory

ApprovalUpdateParameters

IdentityRef

ReferenceLinks