Compartir a través de


Manual Interventions - Get

Obtener la intervención manual para una versión determinada y el identificador de intervención manual.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
manualInterventionId
path True

integer (int32)

Id. de la intervención manual.

organization
path True

string

Nombre de la organización de Azure DevOps.

project
path True

string

Id. de proyecto o nombre del proyecto

releaseId
path True

integer (int32)

Identificador de la versión.

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

ManualIntervention

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.release Concede la capacidad de leer artefactos de versión, incluidas carpetas, versiones, definiciones de versión y entorno de versión.

Ejemplos

Get manual intervention

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
IdentityRef
ManualIntervention
ManualInterventionStatus

Obtiene o establece el estado de la intervención manual.

ProjectReference
ReferenceLinks

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

ReleaseDefinitionShallowReference
ReleaseEnvironmentShallowReference
ReleaseShallowReference

IdentityRef

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.

ManualIntervention

Nombre Tipo Description
approver

IdentityRef

Obtiene o establece la identidad que debe aprobar.

comments

string

Obtiene o establece comentarios para su aprobación.

createdOn

string (date-time)

Obtiene la fecha en la que se creó.

id

integer (int32)

Obtiene el identificador único para la intervención manual.

instructions

string

Obtiene o establece instrucciones para la aprobación.

modifiedOn

string (date-time)

Obtiene la fecha en la que se modificó.

name

string

Obtiene o establece el nombre.

release

ReleaseShallowReference

Obtiene releaseReference para la intervención manual.

releaseDefinition

ReleaseDefinitionShallowReference

Obtiene releaseDefinitionReference para la intervención manual.

releaseEnvironment

ReleaseEnvironmentShallowReference

Obtiene releaseEnvironmentReference para la intervención manual.

status

ManualInterventionStatus

Obtiene o establece el estado de la intervención manual.

taskInstanceId

string (uuid)

Obtiene el identificador de instancia de tarea.

url

string

Obtiene la dirección URL para acceder a la intervención manual.

ManualInterventionStatus

Obtiene o establece el estado de la intervención manual.

Valor Description
approved

Se aprueba la intervención manual.

canceled

Se cancela la intervención manual.

pending

La intervención manual está pendiente.

rejected

Se rechaza la intervención manual.

unknown

La intervención manual no tiene el estado establecido.

ProjectReference

Nombre Tipo Description
id

string (uuid)

Obtiene el identificador único de este campo.

name

string

Obtiene el nombre del proyecto.

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.

ReleaseDefinitionShallowReference

Nombre Tipo Description
_links

ReferenceLinks

Obtiene los vínculos a recursos, API y vistas relacionados para la definición de versión.

id

integer (int32)

Obtiene el identificador único de la definición de versión.

name

string

Obtiene o establece el nombre de la definición de versión.

path

string

Obtiene o establece la ruta de acceso de la definición de versión.

projectReference

ProjectReference

Obtiene o establece la referencia del proyecto.

url

string

Obtiene la dirección URL de la API REST para acceder a la definición de versión.

ReleaseEnvironmentShallowReference

Nombre Tipo Description
_links

ReferenceLinks

Obtiene los vínculos a recursos, API y vistas relacionados para el entorno de versión.

id

integer (int32)

Obtiene el identificador único del entorno de versión.

name

string

Obtiene o establece el nombre del entorno de versión.

url

string

Obtiene la dirección URL de la API REST para acceder al entorno de versión.

ReleaseShallowReference

Nombre Tipo Description
_links

ReferenceLinks

Obtiene los vínculos a recursos, API y vistas relacionados para la versión.

id

integer (int32)

Obtiene el identificador único de la versión.

name

string

Obtiene o establece el nombre de la versión.

url

string

Obtiene la dirección URL de la API REST para acceder a la versión.