Approvals - Update

Référence

Service:: Approvals And Checks

Version d'API:: 7.1

Mettre à jour les approbations.

PATCH https://dev.azure.com/{organization}/{project}/_apis/pipelines/approvals?api-version=7.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 » 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
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom	Description
vso.build_execute	Accorde la possibilité d’accéder aux artefacts de build, notamment 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 génération via des hooks de service.
vso.pipelineresources_use	Accorde la possibilité d’approuver la demande d’un pipeline pour utiliser une ressource protégée : pool d’agents, environnement, file d’attente, référentiel, fichiers sécurisés, connexion de service et groupe de variables

Exemples

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
        }
      }
    }
  ]
}

Définitions

Nom	Description
Approval
ApprovalExecutionOrder	Ordre dans lequel les approbateurs seront actionnables.
ApprovalPermissions	Autorisations utilisateur actuelles pour l’objet d’approbation.
ApprovalStatus	État global de l’approbation.
ApprovalStep	Données pour une seule étape d’approbation.
ApprovalStepHistory	Données pour 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 à représenter une collection de liens de référence REST.

Approval

Object

Nom	Type	Description
_links	ReferenceLinks	Obtient les liens pour accéder à l’objet d’approbation.
blockedApprovers	IdentityRef[]	Identités qui ne sont pas autorisées à approuver.
createdOn	string (date-time)	Date à laquelle l’approbation a été créée.
executionOrder	ApprovalExecutionOrder	Ordre dans lequel les approbateurs seront actionnables.
id	string (uuid)	Identificateur unique de l’approbation.
instructions	string	Instructions pour les approbateurs.
lastModifiedOn	string (date-time)	Date de dernière modification de l’approbation.
minRequiredApprovers	integer (int32)	Nombre minimal d’approbateurs qui doivent approuver l’ensemble de l’approbation pour être considérés comme approuvés.
permissions	ApprovalPermissions	Autorisations utilisateur actuelles pour l’objet d’approbation.
status	ApprovalStatus	État global de l’approbation.
steps	ApprovalStep[]	Liste des étapes associées à l’approbation.

ApprovalExecutionOrder

Énumération

Ordre dans lequel les approbateurs seront actionnables.

Valeur	Description
anyOrder	Indique que les approbateurs peuvent approuver dans n’importe quel ordre.
inSequence	Indique que les approbateurs ne peuvent approuver qu’dans un ordre séquentiel (Ordre dans lequel ils ont été attribués).

ApprovalPermissions

Énumération

Autorisations utilisateur actuelles pour l’objet d’approbation.

Valeur	Description
none
queueBuild
reassign
resourceAdmin
update
view

ApprovalStatus

Énumération

État global de l’approbation.

Valeur	Description
all
approved	Indique que l’approbation est approuvée.
canceled	Indique que l’approbation est annulée.
completed
failed
pending	Indique que l’approbation est en attente.
rejected	Indique que l’approbation est rejetée.
skipped	Indique que l’approbation est ignorée.
timedOut	Indique que l’approbation est expirée.
undefined
uninitiated	Indique que l’approbation n’est pas approuvée. Utilisé dans le cas d’une séquence d’exécution où l’approbateur donné n’est pas encore actionnable.

ApprovalStep

Object

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

Nom	Type	Description
actualApprover	IdentityRef	Identité approuvée.
assignedApprover	IdentityRef	Identité qui doit approuver.
comment	string	Commentaire associé à cette étape.
history	ApprovalStepHistory[]	Historique de l’étape d’approbation
initiatedOn	string (date-time)	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 (date-time)	Horodatage auquel cette étape a été modifiée pour la dernière fois.
order	integer (int32)	Ordre dans lequel les approbateurs sont autorisés à approuver.
permissions	ApprovalPermissions	Autorisations utilisateur actuelles pour l’étape.
status	ApprovalStatus	État actuel de cette étape.

ApprovalStepHistory

Object

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

Nom	Type	Description
assignedTo	IdentityRef	Identité qui a été affectée à cette approbation
comment	string	Commentaire associé à cet historique d’étapes.
createdBy	IdentityRef	Identité par laquelle l’historique des étapes a été créé.
createdOn	string (date-time)	Horodatage auquel l’historique des étapes a été créé.

ApprovalUpdateParameters

Object

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

Nom	Type	Description
approvalId	string (uuid)	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 l’état.

IdentityRef

Object

Nom	Type	Description
_links	ReferenceLinks	Ce champ contient zéro ou plus de liens intéressants sur le sujet du graphe. 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 sur 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 « auto » du dictionnaire IdentityRef « _links »
displayName	string	Il s’agit du nom complet 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éconseillé - 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éconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Déconseillé : 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é : utiliser Domain+PrincipalName à la place
url	string	Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphe.

ReferenceLinks

Object

Classe à 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 de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

Partager via

Approvals - Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

oauth2

Étendues

Exemples

Exemple de requête

Exemple de réponse

Définitions

Approval

ApprovalExecutionOrder

ApprovalPermissions

ApprovalStatus

ApprovalStep

ApprovalStepHistory

ApprovalUpdateParameters

IdentityRef

ReferenceLinks