Manual Interventions - Get

Service:

Release

Version d'API:

7.1

Obtenez une intervention manuelle pour une version donnée et l’ID d’intervention manuelle.

GET https://vsrm.dev.azure.com/{organization}/{project}/_apis/Release/releases/{releaseId}/manualinterventions/{manualInterventionId}?api-version=7.1

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
manualInterventionId	path	True	integer (int32)	ID de l’intervention manuelle.
organization	path	True	string	Nom de l’organisation Azure DevOps.
project	path	True	string	ID de projet ou nom du projet
releaseId	path	True	integer (int32)	ID de la version.
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.

Réponses

Nom	Type	Description
200 OK	ManualIntervention	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.release	Accorde la possibilité de lire les artefacts de mise en production, notamment les dossiers, les versions, les définitions de mise en production et l’environnement de mise en production.

Exemples

Get manual intervention

Exemple de requête

HTTP

GET https://vsrm.dev.azure.com/fabrikam/A13d3daac-03b8-4a23-9cc4-2c3de65dab63/_apis/Release/releases/{releaseId}/manualinterventions/{manualInterventionId}?api-version=7.1

Exemple de réponse

Code d’état:

200

{
  "id": 1,
  "status": "pending",
  "taskInstanceId": "c6500104-7b44-4188-9e1c-8a0a0714152e",
  "comments": null,
  "instructions": "",
  "createdOn": "2017-08-28T13:11:10.007Z",
  "modifiedOn": "2017-08-28T13:11:10.007Z",
  "release": {
    "id": 37,
    "name": "Release-1",
    "_links": {}
  },
  "releaseDefinition": {
    "id": 29,
    "name": "Fabrikam-web-with-MI",
    "_links": {}
  },
  "releaseEnvironment": {
    "id": 100,
    "name": "PROD",
    "_links": {}
  },
  "name": "Manual Intervention"
}

Définitions

Nom	Description
IdentityRef
ManualIntervention
ManualInterventionStatus	Obtient ou définit l’état de l’intervention manuelle.
ProjectReference
ReferenceLinks	Classe à représenter une collection de liens de référence REST.
ReleaseDefinitionShallowReference
ReleaseEnvironmentShallowReference
ReleaseShallowReference

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.

ManualIntervention

Object

Nom	Type	Description
approver	IdentityRef	Obtient ou définit l’identité qui doit approuver.
comments	string	Obtient ou définit des commentaires pour approbation.
createdOn	string (date-time)	Obtient la date à laquelle elle a été créée.
id	integer (int32)	Obtient l’identificateur unique pour l’intervention manuelle.
instructions	string	Obtient ou définit des instructions pour l’approbation.
modifiedOn	string (date-time)	Obtient la date à laquelle elle a été modifiée.
name	string	Obtient ou définit le nom.
release	ReleaseShallowReference	Obtient releaseReference pour une intervention manuelle.
releaseDefinition	ReleaseDefinitionShallowReference	Obtient releaseDefinitionReference pour une intervention manuelle.
releaseEnvironment	ReleaseEnvironmentShallowReference	Obtient releaseEnvironmentReference pour une intervention manuelle.
status	ManualInterventionStatus	Obtient ou définit l’état de l’intervention manuelle.
taskInstanceId	string (uuid)	Obtenir l’identificateur d’instance de tâche.
url	string	Obtient l’URL pour accéder à l’intervention manuelle.

ManualInterventionStatus

Énumération

Obtient ou définit l’état de l’intervention manuelle.

Valeur	Description
approved	L’intervention manuelle est approuvée.
canceled	L’intervention manuelle est annulée.
pending	L’intervention manuelle est en attente.
rejected	L’intervention manuelle est rejetée.
unknown	L’intervention manuelle n’a pas l’état défini.

ProjectReference

Object

Nom	Type	Description
id	string (uuid)	Obtient l’identificateur unique de ce champ.
name	string	Obtient le nom du projet.

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.

ReleaseDefinitionShallowReference

Object

Nom	Type	Description
_links	ReferenceLinks	Obtient les liens vers les ressources, LES API et les vues associées pour la définition de mise en production.
id	integer (int32)	Obtient l’identificateur unique de la définition de mise en production.
name	string	Obtient ou définit le nom de la définition de mise en production.
path	string	Obtient ou définit le chemin d’accès de la définition de mise en production.
projectReference	ProjectReference	Obtient ou définit la référence du projet.
url	string	Obtient l’URL de l’API REST pour accéder à la définition de mise en production.

ReleaseEnvironmentShallowReference

Object

Nom	Type	Description
_links	ReferenceLinks	Obtient les liens vers les ressources, LES API et les vues associées pour l’environnement de mise en production.
id	integer (int32)	Obtient l’identificateur unique de l’environnement de mise en production.
name	string	Obtient ou définit le nom de l’environnement de mise en production.
url	string	Obtient l’URL de l’API REST pour accéder à l’environnement de mise en production.

ReleaseShallowReference

Object

Nom	Type	Description
_links	ReferenceLinks	Obtient les liens vers les ressources, LES API et les vues associées pour la version.
id	integer (int32)	Obtient l’identificateur unique de mise en production.
name	string	Obtient ou définit le nom de la version.
url	string	Obtient l’URL de l’API REST pour accéder à la version.