Approvals - Update

Référence

Service:: Approvals And Checks

API Version:: 7.1-preview.1

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

HTTP

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

Status code:: 200

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

Response Body

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

ReferenceLinks

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.