Test Plan Recycle Bin - List
Obtener una lista de los planes de prueba eliminados
GET https://dev.azure.com/{organization}/{project}/_apis/testplan/recycleBin/testplan?api-version=7.2-preview.1
GET https://dev.azure.com/{organization}/{project}/_apis/testplan/recycleBin/testplan?continuationToken={continuationToken}&api-version=7.2-preview.1
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Nombre de la organización de Azure DevOps. |
|
project
|
path | True |
string |
Id. de proyecto o nombre del proyecto |
|
api-version
|
query | True |
string |
Versión de la API que se va a usar. Debe establecerse en "7.2-preview.1" para usar esta versión de la API. |
|
continuation
|
query |
string |
Si la lista de planes devueltos no está completa, se incluye un token de continuación para consultar el siguiente lote de planes en el encabezado de respuesta como "x-ms-continuationtoken". Omita este parámetro para obtener el primer lote de planes de prueba. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
Test |
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.test | Concede la capacidad de leer planes de prueba, casos, resultados y otros artefactos relacionados con la administración de pruebas. |
Ejemplos
Get Deleted Test Plans
Solicitud de ejemplo
GET https://dev.azure.com/fabrikam/{project}/_apis/testplan/recycleBin/testplan?api-version=7.2-preview.1
Respuesta de muestra
transfer-Encoding: chunked
{
"value": [
{
"id": 5,
"project": {
"id": "afb62ab2-bd74-41c2-991e-40bbb9c8ca91",
"name": "sampleProject",
"state": "unchanged",
"visibility": "unchanged",
"lastUpdateTime": "0001-01-01T00:00:00"
},
"updatedDate": "2024-08-14T13:27:55.213Z",
"updatedBy": {
"displayName": "Fabrikam Fiber",
"url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
"_links": {
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
}
},
"id": "9c694866-b1b9-6531-98e8-7a05990c5154",
"uniqueName": "fabrikamfiber1@microsoft.com",
"imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
"descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
},
"rootSuite": {
"id": 6,
"name": "Plan 1"
},
"_links": {
"_self": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/5"
},
"clientUrl": {
"href": "mtms://fabrikam.visualstudio.com:443/p:sampleProject/Testing/testplan/connect?id=5"
},
"rootSuite": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/5/Suites/6"
},
"build": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/build/Builds/3"
}
},
"revision": 0,
"name": "Plan 1",
"areaPath": "sampleProject\\Team1",
"startDate": "2024-08-14T13:01:38.143Z",
"endDate": "2024-08-21T13:01:38.143Z",
"iteration": "p1",
"owner": {
"displayName": "Fabrikam Fiber",
"url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
"_links": {
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
}
},
"id": "9c694866-b1b9-6531-98e8-7a05990c5154",
"uniqueName": "fabrikamfiber1@microsoft.com",
"imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
"descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
},
"state": "Active",
"testOutcomeSettings": {
"syncOutcomeAcrossSuites": false
}
},
{
"id": 9,
"project": {
"id": "afb62ab2-bd74-41c2-991e-40bbb9c8ca91",
"name": "sampleProject",
"state": "unchanged",
"visibility": "unchanged",
"lastUpdateTime": "0001-01-01T00:00:00"
},
"updatedDate": "2024-08-14T13:27:55.213Z",
"updatedBy": {
"displayName": "Fabrikam Fiber",
"url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
"_links": {
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
}
},
"id": "9c694866-b1b9-6531-98e8-7a05990c5154",
"uniqueName": "fabrikamfiber1@microsoft.com",
"imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
"descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
},
"rootSuite": {
"id": 10,
"name": "Plan 2"
},
"_links": {
"_self": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/9"
},
"clientUrl": {
"href": "mtms://fabrikam.visualstudio.com:443/p:sampleProject/Testing/testplan/connect?id=9"
},
"rootSuite": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/9/Suites/10"
},
"build": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/build/Builds/3"
}
},
"revision": 0,
"name": "Plan 2",
"areaPath": "sampleProject\\Team1",
"startDate": "2024-08-14T13:01:38.143Z",
"endDate": "2024-08-21T13:01:38.143Z",
"iteration": "p1",
"owner": {
"displayName": "Fabrikam Fiber",
"url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
"_links": {
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
}
},
"id": "9c694866-b1b9-6531-98e8-7a05990c5154",
"uniqueName": "fabrikamfiber1@microsoft.com",
"imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
"descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
},
"state": "Active",
"testOutcomeSettings": {
"syncOutcomeAcrossSuites": false
}
}
],
"count": 2
}
Definiciones
| Nombre | Description |
|---|---|
|
Build |
Recurso de referencia de definición de compilación |
|
Identity |
|
|
Project |
Estado del proyecto. |
|
Project |
Visibilidad del proyecto. |
|
Reference |
Clase que representa una colección de vínculos de referencia rest. |
|
Release |
Referencia al recurso del entorno de versión. |
|
Team |
Representa una referencia superficial a un TeamProject. |
|
Test |
Configuración del resultado de la prueba |
|
Test |
Recurso del plan de prueba. |
|
Test |
Recurso de referencia del conjunto de pruebas. |
|
Yaml |
Referencia al recurso de versión de yaml. |
BuildDefinitionReference
Recurso de referencia de definición de compilación
| Nombre | Tipo | Description |
|---|---|---|
| id |
integer (int32) |
Identificador de la definición de compilación |
| name |
string |
Nombre de la definición de compilación |
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. |
ProjectState
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
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
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. |
ReleaseEnvironmentDefinitionReference
Referencia al recurso del entorno de versión.
| Nombre | Tipo | Description |
|---|---|---|
| definitionId |
integer (int32) |
Identificador de la definición de versión que contiene la definición del entorno de versión. |
| environmentDefinitionId |
integer (int32) |
Identificador de la definición del entorno de versión. |
TeamProjectReference
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 |
Estado del proyecto. |
|
| url |
string |
Dirección URL a la versión completa del objeto. |
| visibility |
Visibilidad del proyecto. |
TestOutcomeSettings
Configuración del resultado de la prueba
| Nombre | Tipo | Description |
|---|---|---|
| syncOutcomeAcrossSuites |
boolean |
Valor para configurar cómo se muestran los resultados de las pruebas para las mismas pruebas entre conjuntos |
TestPlan
Recurso del plan de prueba.
| Nombre | Tipo | Description |
|---|---|---|
| _links |
Vínculos pertinentes |
|
| areaPath |
string |
Área del plan de prueba. |
| buildDefinition |
Definición de compilación que genera una compilación asociada a este plan de prueba. |
|
| buildId |
integer (int32) |
Compilación que se va a probar. |
| description |
string |
Descripción del plan de prueba. |
| endDate |
string (date-time) |
Fecha de finalización del plan de prueba. |
| id |
integer (int32) |
Identificador del plan de prueba. |
| iteration |
string |
Ruta de acceso de iteración del plan de prueba. |
| name |
string |
Nombre del plan de prueba. |
| owner |
Propietario del plan de prueba. |
|
| previousBuildId |
integer (int32) |
Identificador de compilación anterior asociado al plan de prueba |
| project |
Proyecto que contiene el plan de prueba. |
|
| releaseEnvironmentDefinition |
Entorno de versión que se usará para implementar la compilación y ejecutar pruebas automatizadas desde este plan de prueba. |
|
| revision |
integer (int32) |
Revisión del plan de prueba. |
| rootSuite |
Conjunto de pruebas raíz del plan de pruebas. |
|
| startDate |
string (date-time) |
Fecha de inicio del plan de prueba. |
| state |
string |
Estado del plan de prueba. |
| testOutcomeSettings |
Valor para configurar cómo deben comportarse las mismas pruebas entre conjuntos de pruebas en un plan de prueba |
|
| updatedBy |
Referencia de identidad para la última actualización del plan de prueba |
|
| updatedDate |
string (date-time) |
Fecha actualizada del plan de prueba |
| yamlReleaseReference |
Referencia de versión de Yaml asociada a este plan de prueba. |
TestSuiteReference
Recurso de referencia del conjunto de pruebas.
| Nombre | Tipo | Description |
|---|---|---|
| id |
integer (int32) |
Id. del conjunto de pruebas. |
| name |
string |
Nombre del conjunto de pruebas. |
YamlReleaseReference
Referencia al recurso de versión de yaml.
| Nombre | Tipo | Description |
|---|---|---|
| definitionId |
integer (int32) |
Identificador de la definición de versión de yaml |
| stagesToSkip |
string |
Fases que se omitirán durante la puesta en cola de la versión de yaml. |