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 |
---|---|---|---|---|
manual
|
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 |
release
|
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 |
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 |
---|---|
Identity |
|
Manual |
|
Manual |
Obtiene o establece el estado de la intervención manual. |
Project |
|
Reference |
Clase que representa una colección de vínculos de referencia rest. |
Release |
|
Release |
|
Release |
IdentityRef
Nombre | Tipo | Description |
---|---|---|
_links |
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 |
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 |
Obtiene releaseReference para la intervención manual. |
|
releaseDefinition |
Obtiene releaseDefinitionReference para la intervención manual. |
|
releaseEnvironment |
Obtiene releaseEnvironmentReference para la intervención manual. |
|
status |
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. |
ReferenceLinks
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 |
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 |
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 |
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 |
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. |