Definitions - Get Release Definition History
Get revision history for a release definition
GET https://vsrm.dev.azure.com/{organization}/{project}/_apis/Release/definitions/{definitionId}/revisions?api-version=7.1-preview.1
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
definition
|
path | True |
integer int32 |
Id of the definition. |
organization
|
path | True |
string |
The name of the Azure DevOps organization. |
project
|
path | True |
string |
Project ID or project name |
api-version
|
query | True |
string |
Version of the API to use. This should be set to '7.1-preview.1' to use this version of the api. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
successful operation |
Security
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
Name | Description |
---|---|
vso.release | Grants the ability to read release artifacts, including folders, releases, release definitions and release environment. |
Examples
Sample request
GET https://vsrm.dev.azure.com/fabrikam/{project}/_apis/Release/definitions/{definitionId}/revisions?api-version=7.1-preview.1
Sample response
{
"count": 2,
"value": [
{
"definitionId": 10,
"revision": 1,
"changedDate": "2017-06-13T09:54:52.457Z",
"changeType": "add",
"definitionUrl": "https://vsrm.dev.azure.com/fabrikam/MyFirstProject/_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://vsrm.dev.azure.com/fabrikam/MyFirstProject/_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"
}
}
]
}
Definitions
Name | Description |
---|---|
Audit |
Gets type of change. |
Identity |
|
Reference |
The class to represent a collection of REST reference links. |
Release |
AuditAction
Gets type of change.
Name | Type | Description |
---|---|---|
add |
string |
Indicates the audit add. |
delete |
string |
Indicates the audit delete. |
undelete |
string |
Indicates the audit undelete. |
update |
string |
Indicates the audit update. |
IdentityRef
Name | Type | Description |
---|---|---|
_links |
This field contains zero or more interesting links about the graph subject. These links may be invoked to obtain additional relationships or more detailed information about this graph subject. |
|
descriptor |
string |
The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations. |
directoryAlias |
string |
Deprecated - Can be retrieved by querying the Graph user referenced in the "self" entry of the IdentityRef "_links" dictionary |
displayName |
string |
This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider. |
id |
string |
|
imageUrl |
string |
Deprecated - Available in the "avatar" entry of the IdentityRef "_links" dictionary |
inactive |
boolean |
Deprecated - Can be retrieved by querying the Graph membership state referenced in the "membershipState" entry of the GraphUser "_links" dictionary |
isAadIdentity |
boolean |
Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
isContainer |
boolean |
Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsGroupType) |
isDeletedInOrigin |
boolean |
|
profileUrl |
string |
Deprecated - not in use in most preexisting implementations of ToIdentityRef |
uniqueName |
string |
Deprecated - use Domain+PrincipalName instead |
url |
string |
This url is the full route to the source resource of this graph subject. |
ReferenceLinks
The class to represent a collection of REST reference links.
Name | Type | Description |
---|---|---|
links |
object |
The readonly view of the links. Because Reference links are readonly, we only want to expose them as read only. |
ReleaseDefinitionRevision
Name | Type | Description |
---|---|---|
apiVersion |
string |
Gets api-version for revision object. |
changeType |
Gets type of change. |
|
changedBy |
Gets the identity who did change. |
|
changedDate |
string |
Gets date on which ReleaseDefinition changed. |
comment |
string |
Gets comments for revision. |
definitionId |
integer |
Get id of the definition. |
definitionUrl |
string |
Gets definition URL. |
revision |
integer |
Get revision number of the definition. |