Definitions - Get Release Definition History

Referência

Service:: Release

API Version:: 7.1-preview.1

Obter o histórico de revisão para uma definição de versão

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
definitionId	path	True	integer int32	ID da definição.
organization	path	True	string	O nome da organização do Azure DevOps.
project	path	True	string	ID do projeto ou nome do projeto
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1-preview.1' para usar essa versão da API.

Respostas

Nome	Tipo	Description
200 OK	ReleaseDefinitionRevision[]	operação bem-sucedida

Segurança

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

Nome	Description
vso.release	Concede a capacidade de ler artefatos de versão, incluindo pastas, versões, definições de versão e ambiente de versão.

Exemplos

Sample Request

HTTP

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

Sample Response

Status code:: 200

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

Definições

Nome	Description
AuditAction	Obtém o tipo de alteração.
IdentityRef
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
ReleaseDefinitionRevision

AuditAction

Obtém o tipo de alteração.

Nome	Tipo	Description
add	string	Indica a adição de auditoria.
delete	string	Indica a exclusão de auditoria.
undelete	string	Indica que a auditoria não foi reexeculada.
update	string	Indica a atualização de auditoria.

IdentityRef

Nome	Tipo	Description
_links	ReferenceLinks	Esse campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
descriptor	string	O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto do grafo entre contas e organizações.
directoryAlias	string	Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário "_links" identityRef
displayName	string	Este é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
id	string
imageUrl	string	Preterido - Disponível na entrada "avatar" do dicionário "_links" IdentityRef
inactive	boolean	Preterido – pode ser recuperado consultando o estado de associação do Graph referenciado na entrada "membershipState" do dicionário "_links" do GraphUser
isAadIdentity	boolean	Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Preterido – não em uso na maioria das implementações preexistidas de ToIdentityRef
uniqueName	string	Preterido – use Domain+PrincipalName
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

ReleaseDefinitionRevision

Nome	Tipo	Description
apiVersion	string	Obtém a versão da API para o objeto de revisão.
changeType	AuditAction	Obtém o tipo de alteração.
changedBy	IdentityRef	Obtém a identidade que mudou.
changedDate	string	Obtém a data em que ReleaseDefinition foi alterado.
comment	string	Obtém comentários para revisão.
definitionId	integer	Obtenha a ID da definição.
definitionUrl	string	Obtém a URL de definição.
revision	integer	Obter o número de revisão da definição.

Partilhar via