Cherry Picks - Get Cherry Pick

Servicio:

Git

Versión de la API:

7.1

Recupere información sobre una operación de selección de cerezas por identificador de selección de cereza.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/cherryPicks/{cherryPickId}?api-version=7.1

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
cherryPickId	path	True	integer (int32)	Id. de la selección de cereza.
organization	path	True	string	Nombre de la organización de Azure DevOps.
project	path	True	string	Id. de proyecto o nombre del proyecto
repositoryId	path	True	string	Identificador del repositorio.
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1" para usar esta versión de la API.

Respuestas

Nombre	Tipo	Description
200 OK	GitCherryPick	operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: 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

Ámbitos

Nombre	Description
vso.code	Concede la capacidad de leer código fuente y metadatos sobre confirmaciones, conjuntos de cambios, ramas y otros artefactos de control de versiones. También concede la capacidad de buscar código y recibir notificaciones sobre eventos de control de versiones a través de enlaces de servicio.

Definiciones

Nombre	Description
ChangeCountDictionary
GitAsyncOperationStatus
GitAsyncRefOperationDetail	Información sobre el progreso de una operación de selección o reversión de cerezas.
GitAsyncRefOperationFailureStatus	Proporciona un código de estado que indica el motivo por el que se produjo un error en la selección de cereza o la reversión.
GitAsyncRefOperationParameters	Parámetros que se proporcionan en el cuerpo de la solicitud al solicitar la selección o reversión de cherry.
GitAsyncRefOperationSource	GitAsyncRefOperationSource especifica la solicitud de incorporación de cambios o la lista de confirmaciones que se usarán al realizar una solicitud de operación de selección y reversión. Solo se debe proporcionar una.
GitChange
GitCherryPick	Este objeto se devuelve de las operaciones Cherry Pick y proporciona el identificador y el estado de la operación.
GitCommitRef	Proporciona propiedades que describen una confirmación de Git y metadatos asociados.
GitPushRef
GitRepository
GitRepositoryRef
GitStatus	Esta clase contiene los metadatos de un servicio o extensión que publica un estado.
GitStatusContext	Contexto de estado que identifica de forma única el estado.
GitStatusState	Estado del estado.
GitTemplate
GitUserDate	Información del usuario y fecha de las operaciones de Git.
IdentityRef
ItemContent
ItemContentType
ProjectState	Estado del proyecto.
ProjectVisibility	Visibilidad del proyecto.
ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
ResourceRef
TeamProjectCollectionReference	Objeto reference de teamProjectCollection.
TeamProjectReference	Representa una referencia superficial a un TeamProject.
VersionControlChangeType	Tipo de cambio realizado en el elemento.

ChangeCountDictionary

Object

GitAsyncOperationStatus

Enumeración

Valor	Description
abandoned	Se ha abandonado la operación.
completed	La operación se ha completado.
failed	Error en la operación. Busque un mensaje de error.
inProgress	La operación está actualmente en curso.
queued	La operación está esperando en una cola y aún no se ha iniciado.

GitAsyncRefOperationDetail

Object

Información sobre el progreso de una operación de selección o reversión de cerezas.

Nombre	Tipo	Description
conflict	boolean	Indica si se generó un conflicto al intentar seleccionar o revertir los cambios.
currentCommitId	string	Confirmación actual de la lista de confirmaciones que se seleccionan o revierten.
failureMessage	string	Información detallada sobre por qué la selección de cereza o la reversión no se pudieron completar.
progress	number (double)	Número comprendido entre 0 y 1 que indica el porcentaje completado de la operación.
status	GitAsyncRefOperationFailureStatus	Proporciona un código de estado que indica el motivo por el que se produjo un error en la selección de cereza o la reversión.
timedout	boolean	Indica si la operación ha superado el tiempo máximo permitido para una operación de selección o reversión.

GitAsyncRefOperationFailureStatus

Enumeración

Proporciona un código de estado que indica el motivo por el que se produjo un error en la selección de cereza o la reversión.

Valor	Description
asyncOperationNotFound	No se encontró la operación asincrónica
createBranchPermissionRequired	No se pudo completar la solicitud de actualización de referencia porque el usuario carece del permiso para crear una rama.
emptyCommitterSignature	El iniciador de la operación asincrónica tiene firma con nombre vacío o correo electrónico
gitObjectTooLarge	El objeto Git es demasiado grande para materializar en la memoria
invalidRefName	Indica que no se pudo completar la solicitud de actualización ref porque el nombre ref presentado en la solicitud no era válido.
none	Sin estado
operationIndentityNotFound	Identidad que autorizó la operación no se encontró
other	Error inesperado
refNameConflict	No se pudo completar la actualización ref porque, en modo que no distingue mayúsculas de minúsculas, el nombre ref entra en conflicto con un nombre ref existente y con mayúsculas y minúsculas.
targetBranchDeleted	La rama de destino se eliminó después de iniciar la operación asincrónica de Git
writePermissionRequired	No se pudo completar la solicitud de actualización de referencia porque el usuario carece de permisos de escritura necesarios para escribir esta referencia

GitAsyncRefOperationParameters

Object

Parámetros que se proporcionan en el cuerpo de la solicitud al solicitar la selección o reversión de cherry.

Nombre	Tipo	Description
generatedRefName	string	Nombre de rama de destino propuesto para la operación de selección o reversión de cherry.
ontoRefName	string	Rama de destino para la operación de selección o reversión de cherry.
repository	GitRepository	Repositorio git para la operación de selección o reversión de cherry.
source	GitAsyncRefOperationSource	Detalles sobre el origen de la operación de selección o reversión (por ejemplo, una solicitud de incorporación de cambios o una confirmación específica).

GitAsyncRefOperationSource

Object

GitAsyncRefOperationSource especifica la solicitud de incorporación de cambios o la lista de confirmaciones que se usarán al realizar una solicitud de operación de selección y reversión. Solo se debe proporcionar una.

Nombre	Tipo	Description
commitList	GitCommitRef[]	Una lista de confirmaciones para seleccionar o revertir
pullRequestId	integer (int32)	Identificador de la solicitud de incorporación de cambios para seleccionar o revertir

GitChange

Object

Nombre	Tipo	Description
changeId	integer (int32)	Identificador del cambio dentro del grupo de cambios.
changeType	VersionControlChangeType	Tipo de cambio realizado en el elemento.
item	string (T)	Versión actual.
newContent	ItemContent	Contenido del elemento después del cambio.
newContentTemplate	GitTemplate	Nueva plantilla de contenido que se va a usar al insertar nuevos cambios.
originalPath	string	Ruta de acceso original del elemento si es diferente de la ruta de acceso actual.
sourceServerItem	string	Ruta de acceso del elemento en el servidor.
url	string	Dirección URL para recuperar el elemento.

GitCherryPick

Object

Este objeto se devuelve de las operaciones Cherry Pick y proporciona el identificador y el estado de la operación.

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
cherryPickId	integer (int32)
detailedStatus	GitAsyncRefOperationDetail	Información sobre el progreso de una operación de selección o reversión de cerezas.
parameters	GitAsyncRefOperationParameters	Parámetros que se proporcionan en el cuerpo de la solicitud al solicitar la selección o reversión de cherry.
status	GitAsyncOperationStatus
url	string	Dirección URL que se puede usar para realizar más solicitudes de estado sobre la operación

GitCommitRef

Object

Proporciona propiedades que describen una confirmación de Git y metadatos asociados.

Nombre	Tipo	Description
_links	ReferenceLinks	Colección de vínculos de referencia rest relacionados.
author	GitUserDate	Autor de la confirmación.
changeCounts	ChangeCountDictionary	Recuentos de los tipos de cambios (ediciones, eliminaciones, etc.) incluidos con la confirmación.
changes	GitChange[]	Enumeración de los cambios incluidos con la confirmación.
comment	string	Comentario o mensaje de la confirmación.
commentTruncated	boolean	Indica si el comentario se trunca desde el mensaje de comentario de confirmación de Git completo.
commitId	string	Id. (SHA-1) de la confirmación.
commitTooManyChanges	boolean	Indica que la confirmación contiene demasiados cambios que se mostrarán.
committer	GitUserDate	Committer de la confirmación.
parents	string[]	Enumeración de los identificadores de confirmación primarios para esta confirmación.
push	GitPushRef	Inserción asociada a esta confirmación.
remoteUrl	string	Ruta de acceso de dirección URL remota a la confirmación.
statuses	GitStatus[]	Lista de metadatos de estado de servicios y extensiones que pueden asociar información adicional a la confirmación.
url	string	Dirección URL de REST para este recurso.
workItems	ResourceRef[]	Lista de elementos de trabajo asociados a esta confirmación.

GitPushRef

Object

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
date	string (date-time)
pushId	integer (int32)
pushedBy	IdentityRef
url	string

GitRepository

Object

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
defaultBranch	string
id	string (uuid)
isDisabled	boolean	True si el repositorio está deshabilitado. False en caso contrario.
isFork	boolean	True si el repositorio se creó como bifurcación.
isInMaintenance	boolean	True si el repositorio está en mantenimiento. False en caso contrario.
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Representa una referencia superficial a un TeamProject.
remoteUrl	string
size	integer (int64)	Tamaño comprimido (bytes) del repositorio.
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

GitRepositoryRef

Object

Nombre	Tipo	Description
collection	TeamProjectCollectionReference	Colección de proyectos de equipo donde reside esta bifurcación
id	string (uuid)
isFork	boolean	True si el repositorio se creó como bifurcación
name	string
project	TeamProjectReference	Representa una referencia superficial a un TeamProject.
remoteUrl	string
sshUrl	string
url	string

GitStatus

Object

Esta clase contiene los metadatos de un servicio o extensión que publica un estado.

Nombre	Tipo	Description
_links	ReferenceLinks	Vínculos de referencia.
context	GitStatusContext	Contexto del estado.
createdBy	IdentityRef	Identidad que creó el estado.
creationDate	string (date-time)	Fecha y hora de creación del estado.
description	string	Descripción del estado. Normalmente se describe el estado actual del estado.
id	integer (int32)	Identificador de estado.
state	GitStatusState	Estado del estado.
targetUrl	string	Dirección URL con detalles de estado.
updatedDate	string (date-time)	Fecha y hora de la última actualización del estado.

GitStatusContext

Object

Contexto de estado que identifica de forma única el estado.

Nombre	Tipo	Description
genre	string	Género del estado. Normalmente, el nombre del servicio o herramienta que genera el estado puede estar vacío.
name	string	El identificador de nombre del estado no puede ser nulo ni estar vacío.

GitStatusState

Enumeración

Estado del estado.

Valor	Description
error	Estado con un error.
failed	Error de estado.
notApplicable	El estado no es aplicable al objeto de destino.
notSet	Estado no establecido. Estado predeterminado.
pending	Estado pendiente.
succeeded	Estado correcto.

GitTemplate

Object

Nombre	Tipo	Description
name	string	Nombre de la plantilla
type	string	Tipo de la plantilla

GitUserDate

Object

Información del usuario y fecha de las operaciones de Git.

Nombre	Tipo	Description
date	string (date-time)	Fecha de la operación de Git.
email	string	Dirección de correo electrónico del usuario que realiza la operación de Git.
imageUrl	string	Dirección URL del avatar del usuario.
name	string	Nombre del usuario que realiza la operación de Git.

IdentityRef

Object

Nombre	Tipo	Description
_links	ReferenceLinks	Este campo contiene cero o más vínculos interesantes sobre el tema del grafo. Estos vínculos se pueden invocar para obtener relaciones adicionales o información más detallada sobre este tema del grafo.
descriptor	string	El descriptor es la forma principal de hacer referencia al asunto del grafo mientras se ejecuta el sistema. Este campo identificará de forma única el mismo asunto del grafo en cuentas y organizaciones.
directoryAlias	string	En desuso: se puede recuperar consultando al usuario de Graph al que se hace referencia en la entrada "self" del diccionario identityRef "_links".
displayName	string	Este es el nombre para mostrar no único del asunto del grafo. Para cambiar este campo, debe modificar su valor en el proveedor de origen.
id	string
imageUrl	string	En desuso: disponible en la entrada "avatar" del diccionario "_links" identityRef
inactive	boolean	En desuso: se puede recuperar consultando el estado de pertenencia de Graph al que se hace referencia en la entrada "membershipState" del diccionario "_links" de GraphUser.
isAadIdentity	boolean	En desuso: se puede deducir del tipo de sujeto del descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	En desuso: se puede deducir del tipo de sujeto del descriptor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	En desuso: no en uso en la mayoría de las implementaciones preexistentes de ToIdentityRef
uniqueName	string	En desuso: use Domain+PrincipalName en su lugar.
url	string	Esta dirección URL es la ruta completa al recurso de origen de este tema del grafo.

ItemContent

Object

Nombre	Tipo	Description
content	string
contentType	ItemContentType

ItemContentType

Enumeración

Valor	Description
base64Encoded
rawText

ProjectState

Enumeración

Estado del proyecto.

Valor	Description
all	Todos los proyectos, independientemente del estado, excepto Eliminado.
createPending	Project se ha puesto en cola para su creación, pero el proceso aún no se ha iniciado.
deleted	Se ha eliminado el proyecto.
deleting	Project está en proceso de eliminación.
new	Project está en proceso de creación.
unchanged	El proyecto no se ha cambiado.
wellFormed	Project se crea completamente y está listo para usarse.

ProjectVisibility

Enumeración

Visibilidad del proyecto.

Valor	Description
private	El proyecto solo es visible para los usuarios con acceso explícito.
public	El proyecto es visible para todos.

ReferenceLinks

Object

Clase que representa una colección de vínculos de referencia rest.

Nombre	Tipo	Description
links	object	Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

ResourceRef

Object

Nombre	Tipo	Description
id	string
url	string

TeamProjectCollectionReference

Object

Objeto reference de teamProjectCollection.

Nombre	Tipo	Description
avatarUrl	string	Dirección URL del avatar de la colección.
id	string (uuid)	Id. de colección.
name	string	Nombre de la colección.
url	string	Dirección URL de REST de recopilación.

TeamProjectReference

Object

Representa una referencia superficial a un TeamProject.

Nombre	Tipo	Description
abbreviation	string	Abreviatura del proyecto.
defaultTeamImageUrl	string	Dirección URL a la imagen de identidad del equipo predeterminada.
description	string	Descripción del proyecto (si existe).
id	string (uuid)	Identificador del proyecto.
lastUpdateTime	string (date-time)	Hora de última actualización del proyecto.
name	string	Nombre del proyecto.
revision	integer (int64)	Revisión del proyecto.
state	ProjectState	Estado del proyecto.
url	string	Dirección URL a la versión completa del objeto.
visibility	ProjectVisibility	Visibilidad del proyecto.

VersionControlChangeType

Enumeración

Tipo de cambio realizado en el elemento.

Valor	Description
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete