Partager via


Approvals - Update

Mettre à jour les approbations.

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

Paramètres URI

Nom Dans Obligatoire Type Description
organization
path True

string

Nom de l’organisation Azure DevOps.

project
path True

string

ID de projet ou nom du projet

api-version
query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.1 » pour utiliser cette version de l’API.

Corps de la demande

Nom Type Description
body

ApprovalUpdateParameters[]

Réponses

Nom Type Description
200 OK

Approval[]

opération réussie

Sécurité

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

Nom Description
vso.build_execute Accorde la possibilité d’accéder aux artefacts de build, y compris les résultats de build, les définitions et les demandes, ainsi que la possibilité de mettre en file d’attente une build, de mettre à jour les propriétés de build et de recevoir des notifications sur les événements de build via des hooks de service.
vso.pipelineresources_use Accorde la possibilité d’approuver la demande d’utilisation d’une ressource protégée d’un pipeline : pool d’agents, environnement, file d’attente, dépôt, fichiers sécurisés, connexion de service et groupe de variables

Exemples

Sample Request

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

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

Sample Response

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

Définitions

Nom Description
Approval
ApprovalExecutionOrder

Ordre dans lequel les approbateurs peuvent être actionnables.

ApprovalPermissions

Autorisations utilisateur actuelles pour l’objet d’approbation.

ApprovalStatus

Status global de l’approbation.

ApprovalStep

Données pour une seule étape d’approbation.

ApprovalStepHistory

Données d’un historique d’étape d’approbation unique.

ApprovalUpdateParameters

Données permettant de mettre à jour un objet d’approbation ou son étape individuelle.

IdentityRef
ReferenceLinks

Classe pour représenter une collection de liens de référence REST.

Approval

Nom Type Description
_links

ReferenceLinks

Obtient les liens permettant d’accéder à l’objet d’approbation.

blockedApprovers

IdentityRef[]

Identités qui ne sont pas autorisées à approuver.

createdOn

string

Date à laquelle l’approbation a été créée.

executionOrder

ApprovalExecutionOrder

Ordre dans lequel les approbateurs peuvent être actionnables.

id

string

Identificateur unique de l’approbation.

instructions

string

Instructions pour les approbateurs.

lastModifiedOn

string

Date de la dernière modification de l’approbation.

minRequiredApprovers

integer

Nombre minimal d’approbateurs qui doivent approuver pour que l’approbation entière soit considérée comme approuvée.

permissions

ApprovalPermissions

Autorisations utilisateur actuelles pour l’objet d’approbation.

status

ApprovalStatus

Status global de l’approbation.

steps

ApprovalStep[]

Liste des étapes associées à l’approbation.

ApprovalExecutionOrder

Ordre dans lequel les approbateurs peuvent être actionnables.

Nom Type Description
anyOrder

string

Indique que les approbateurs peuvent approuver dans n’importe quel ordre.

inSequence

string

Indique que les approbateurs peuvent approuver uniquement dans un ordre séquentiel (ordre dans lequel ils ont été attribués).

ApprovalPermissions

Autorisations utilisateur actuelles pour l’objet d’approbation.

Nom Type Description
none

string

queueBuild

string

reassign

string

resourceAdmin

string

update

string

view

string

ApprovalStatus

Status global de l’approbation.

Nom Type Description
all

string

approved

string

Indique que l’approbation est Approuvée.

canceled

string

Indique que l’approbation est Annulée.

completed

string

failed

string

pending

string

Indique que l’approbation est en attente.

rejected

string

Indique que l’approbation est Rejetée.

skipped

string

Indique que l’approbation est ignorée.

timedOut

string

Indique que l’approbation a expiré.

undefined

string

uninitiated

string

Indique que l’approbation est Non initié. Utilisé dans le cas de dans l’ordre séquentiel d’exécution où l’approbateur donné n’est pas encore actionnable.

ApprovalStep

Données pour une seule étape d’approbation.

Nom Type Description
actualApprover

IdentityRef

Identité qui a approuvé.

assignedApprover

IdentityRef

Identité qui doit approuver.

comment

string

Commentaire associé à cette étape.

history

ApprovalStepHistory[]

Historique de l’étape d’approbation

initiatedOn

string

Horodatage auquel cette étape a été lancée.

lastModifiedBy

IdentityRef

Identité par laquelle cette étape a été modifiée pour la dernière fois.

lastModifiedOn

string

Horodatage auquel cette étape a été modifiée pour la dernière fois.

order

integer

Ordre dans lequel les approbateurs sont autorisés à approuver.

permissions

ApprovalPermissions

Autorisations utilisateur actuelles pour l’étape.

status

ApprovalStatus

Status actuelle de cette étape.

ApprovalStepHistory

Données d’un historique d’étape d’approbation unique.

Nom Type Description
assignedTo

IdentityRef

Identité à qui cette approbation a été attribuée

comment

string

Commentaire associé à cet historique d’étape.

createdBy

IdentityRef

Identité par laquelle cet historique d’étape a été créé.

createdOn

string

Horodatage auquel cet historique d’étape a été créé.

ApprovalUpdateParameters

Données permettant de mettre à jour un objet d’approbation ou son étape individuelle.

Nom Type Description
approvalId

string

ID de l’approbation à mettre à jour.

assignedApprover

IdentityRef

Approbateur actuel.

comment

string

Obtient ou définit un commentaire.

reassignTo

IdentityRef

Approbateur réaffecté.

status

ApprovalStatus

Obtient ou définit status.

IdentityRef

Nom Type Description
_links

ReferenceLinks

Ce champ contient zéro ou plus de liens intéressants sur l’objet du graphique. Ces liens peuvent être appelés pour obtenir des relations supplémentaires ou des informations plus détaillées sur ce sujet de graphique.

descriptor

string

Le descripteur est le principal moyen de référencer l’objet du graphique pendant l’exécution du système. Ce champ identifie de manière unique le même sujet de graphique dans les comptes et les organisations.

directoryAlias

string

Déconseillé : peut être récupéré en interrogeant l’utilisateur Graph référencé dans l’entrée « self » du dictionnaire IdentityRef « _links »

displayName

string

Il s’agit du nom d’affichage non unique de l’objet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source.

id

string

imageUrl

string

Déprécié : disponible dans l’entrée « avatar » du dictionnaire IdentityRef « _links »

inactive

boolean

Déconseillé : peut être récupéré en interrogeant l’état d’appartenance Graph référencé dans l’entrée « membershipState » du dictionnaire GraphUser « _links »

isAadIdentity

boolean

Déprécié : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Déprécié : peut être déduit du type d’objet du descripteur (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

Déconseillé : non utilisé dans la plupart des implémentations préexistantes de ToIdentityRef

uniqueName

string

Déconseillé : utilisez à la place Domain+PrincipalName

url

string

Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphique.

Classe pour représenter une collection de liens de référence REST.

Nom Type Description
links

object

Vue en lecture seule des liens. Étant donné que les liens référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.