Definitions - Get Release Definition History

Service:

Release

Version d'API:

5.0-preview.1

Obtenir l’historique des révisions pour une définition de mise en production

GET https://vsrm.dev.azure.com/{organization}/{project}/_apis/Release/definitions/{definitionId}/revisions?api-version=5.0-preview.1

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
definitionId	path	True	integer int32	ID de la définition.
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 « 5.0-preview.1 » pour utiliser cette version de l’API.

Réponses

Nom	Type	Description
200 OK	ReleaseDefinitionRevision[]	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, y compris les mises en production, les définitions de mise en production et l’environnement de mise en production.

Exemples

Exemple de requête

HTTP

GET https://vsrm.dev.azure.com/fabrikam/{project}/_apis/Release/definitions/{definitionId}/revisions?api-version=5.0-preview.1

Exemple de réponse

Code d’état:

200

{
  "count": 2,
  "value": [
    {
      "definitionId": 10,
      "revision": 1,
      "changedDate": "2017-06-13T09:54:52.457Z",
      "changeType": "add",
      "definitionUrl": "https://https://vsrm.dev.azure.com/fabrikamMyFirstProject/_apis/Release/definitions/10?Revision=1",
      "changedBy": {
        "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "displayName": "Chuck Reinhart",
        "uniqueName": "fabfiber@outlook.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=4adb1680-0eac-6149-b5ee-fc8b4f6ca227"
      }
    },
    {
      "definitionId": 10,
      "revision": 2,
      "changedDate": "2017-06-13T09:54:53.753Z",
      "changeType": "update",
      "definitionUrl": "https://https://vsrm.dev.azure.com/fabrikamMyFirstProject/_apis/Release/definitions/10?Revision=2",
      "changedBy": {
        "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "displayName": "Chuck Reinhart",
        "uniqueName": "fabfiber@outlook.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=4adb1680-0eac-6149-b5ee-fc8b4f6ca227"
      }
    }
  ]
}

Définitions

Nom	Description
AuditAction	Obtient le type de modification.
IdentityRef
ReferenceLinks	Classe pour représenter une collection de liens de référence REST.
ReleaseDefinitionRevision

AuditAction

Enumeration

Obtient le type de modification.

Valeur	Description
add
delete
undelete
update

IdentityRef

Object

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
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
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphique.

ReferenceLinks

Object

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.

ReleaseDefinitionRevision

Object

Nom	Type	Description
apiVersion	string	Obtient api-version pour l’objet de révision.
changeType	AuditAction	Obtient le type de modification.
changedBy	IdentityRef	Obtient l’identité qui a changé.
changedDate	string	Obtient la date à laquelle il a été modifié.
comment	string	Obtient des commentaires pour la révision.
definitionId	integer	Obtient l’ID de la définition.
definitionUrl	string	Obtient l’URL de définition.
revision	integer	Obtenir le numéro de révision de la définition.