Test Suite Recycle Bin Operations - Get Deleted Test Suites For Plan
Ottenere gruppi di test eliminati per un piano di test.
GET https://dev.azure.com/{organization}/{project}/_apis/testplan/recycleBin/TestPlan/{planId}/testsuite?api-version=7.2-preview.1
GET https://dev.azure.com/{organization}/{project}/_apis/testplan/recycleBin/TestPlan/{planId}/testsuite?expand={expand}&continuationToken={continuationToken}&asTreeView={asTreeView}&api-version=7.2-preview.1
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
organization
|
path | True |
string |
Nome dell'organizzazione di Azure DevOps. |
plan
|
path | True |
integer (int32) |
ID del piano di test per cui sono richiesti i gruppi. |
project
|
path | True |
string |
ID progetto o nome progetto |
api-version
|
query | True |
string |
Versione dell'API da usare. Deve essere impostato su '7.2-preview.1' per usare questa versione dell'API. |
as
|
query |
boolean |
Se le suite restituite devono trovarsi in una struttura ad albero. |
|
continuation
|
query |
string |
Se l'elenco dei pacchetti restituiti non è completo, un token di continuazione per eseguire una query sul batch successivo di pacchetti viene incluso nell'intestazione della risposta come "x-ms-continuationtoken". Omettere questo parametro per ottenere il primo batch di gruppi di test. |
|
expand
|
query |
Includere i dettagli delle suite per bambini e dei tester. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
operazione riuscita |
Sicurezza
oauth2
Tipo:
oauth2
Flow:
accessCode
URL di autorizzazione:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL 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
Ambiti
Nome | Descrizione |
---|---|
vso.test | Concede la possibilità di leggere piani di test, case, risultati e altri artefatti correlati alla gestione dei test. |
Esempio
Get all Deleted Test Suites for a Test Plan. |
Get Deleted Test Suites of a Test Plan in Tree View. |
Get all Deleted Test Suites for a Test Plan.
Esempio di richiesta
GET https://dev.azure.com/fabrikam/p1/_apis/testplan/recycleBin/TestPlan/12/testsuite?expand=Children, DefaultTesters&api-version=7.2-preview.1
Risposta di esempio
transfer-Encoding: chunked
persistent-Auth: true
lfs-Authenticate: NTLM
wwW-Authenticate: Negotiate oRswGaADCgEAoxIEEAEAAAB/yMsAtyjkcQAAAAA=
{
"value": [
{
"id": 14,
"revision": 2,
"project": {
"id": "9aa0d72c-e93a-4456-9870-9c5169074a96",
"name": "p1",
"url": "https://dev.azure.com/fabrikam/_apis/projects/p1",
"state": "unchanged",
"visibility": "unchanged",
"lastUpdateTime": "0001-01-01T00:00:00"
},
"lastUpdatedBy": {
"displayName": "Fabrikam Fiber",
"url": "https://vssps.dev.azure.com/fabrikam/Aea08ebc7-105f-4bb2-a36b-f92e0e9de65a/_apis/Identities/0fdbdad8-6afb-6149-9af9-c0a216137d1d",
"_links": {
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
}
},
"id": "9c694866-b1b9-6531-98e8-7a05990c5154",
"uniqueName": "[email protected]",
"imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
"descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
},
"lastUpdatedDate": "2024-09-02T13:14:27.78Z",
"plan": {
"id": 12,
"name": "tp2"
},
"_links": {
"_self": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/14"
},
"testCases": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/14/TestCase"
},
"testPoints": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/14/TestPoint"
}
},
"suiteType": "staticTestSuite",
"name": "s2.1",
"parentSuite": {
"id": 13,
"name": "tp2"
},
"inheritDefaultConfigurations": true
},
{
"id": 15,
"revision": 3,
"project": {
"id": "9aa0d72c-e93a-4456-9870-9c5169074a96",
"name": "p1",
"url": "https://dev.azure.com/fabrikam/_apis/projects/p1",
"state": "unchanged",
"visibility": "unchanged",
"lastUpdateTime": "0001-01-01T00:00:00"
},
"lastUpdatedBy": {
"displayName": "Fabrikam Fiber",
"url": "https://vssps.dev.azure.com/fabrikam/Aea08ebc7-105f-4bb2-a36b-f92e0e9de65a/_apis/Identities/0fdbdad8-6afb-6149-9af9-c0a216137d1d",
"_links": {
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
}
},
"id": "9c694866-b1b9-6531-98e8-7a05990c5154",
"uniqueName": "[email protected]",
"imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
"descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
},
"lastUpdatedDate": "2024-09-02T11:11:51.193Z",
"plan": {
"id": 12,
"name": "tp2"
},
"children": [
{
"id": 16,
"name": "s2.2.1"
}
],
"hasChildren": true,
"_links": {
"_self": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/15"
},
"testCases": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/15/TestCase"
},
"testPoints": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/15/TestPoint"
}
},
"suiteType": "staticTestSuite",
"name": "s2.2",
"parentSuite": {
"id": 13,
"name": "tp2"
},
"inheritDefaultConfigurations": true
},
{
"id": 16,
"revision": 2,
"project": {
"id": "9aa0d72c-e93a-4456-9870-9c5169074a96",
"name": "p1",
"url": "https://dev.azure.com/fabrikam/_apis/projects/p1",
"state": "unchanged",
"visibility": "unchanged",
"lastUpdateTime": "0001-01-01T00:00:00"
},
"lastUpdatedBy": {
"displayName": "Fabrikam Fiber",
"url": "https://vssps.dev.azure.com/fabrikam/Aea08ebc7-105f-4bb2-a36b-f92e0e9de65a/_apis/Identities/0fdbdad8-6afb-6149-9af9-c0a216137d1d",
"_links": {
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
}
},
"id": "9c694866-b1b9-6531-98e8-7a05990c5154",
"uniqueName": "[email protected]",
"imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
"descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
},
"lastUpdatedDate": "2024-09-02T11:11:51.193Z",
"plan": {
"id": 12,
"name": "tp2"
},
"_links": {
"_self": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/16"
},
"testCases": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/16/TestCase"
},
"testPoints": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/16/TestPoint"
}
},
"suiteType": "staticTestSuite",
"name": "s2.2.1",
"parentSuite": {
"id": 15,
"name": "s2.2"
},
"inheritDefaultConfigurations": true
}
],
"count": 3
}
Get Deleted Test Suites of a Test Plan in Tree View.
Esempio di richiesta
GET https://dev.azure.com/fabrikam/p1/_apis/testplan/recycleBin/TestPlan/12/testsuite?asTreeView=True&api-version=7.2-preview.1
Risposta di esempio
transfer-Encoding: chunked
persistent-Auth: true
lfs-Authenticate: NTLM
wwW-Authenticate: Negotiate oRswGaADCgEAoxIEEAEAAAB/yMsAtyjkcQAAAAA=
{
"value": [
{
"id": 15,
"revision": 3,
"project": {
"id": "9aa0d72c-e93a-4456-9870-9c5169074a96",
"name": "p1",
"url": "https://dev.azure.com/fabrikam/_apis/projects/p1",
"state": "unchanged",
"visibility": "unchanged",
"lastUpdateTime": "0001-01-01T00:00:00"
},
"lastUpdatedBy": {
"displayName": "Fabrikam Fiber",
"url": "https://vssps.dev.azure.com/fabrikam/Aea08ebc7-105f-4bb2-a36b-f92e0e9de65a/_apis/Identities/0fdbdad8-6afb-6149-9af9-c0a216137d1d",
"_links": {
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
}
},
"id": "9c694866-b1b9-6531-98e8-7a05990c5154",
"uniqueName": "[email protected]",
"imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
"descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
},
"lastUpdatedDate": "2024-09-02T11:11:51.193Z",
"plan": {
"areaPath": "p1",
"iteration": "p1",
"startDate": "2024-09-02T11:10:42.917Z",
"endDate": "2024-09-09T11:10:42.917Z",
"rootSuiteId": 13,
"id": 12,
"name": "tp2"
},
"children": [
{
"id": 16,
"revision": 2,
"project": {
"id": "9aa0d72c-e93a-4456-9870-9c5169074a96",
"name": "p1",
"url": "https://dev.azure.com/fabrikam/_apis/projects/p1",
"state": "unchanged",
"visibility": "unchanged",
"lastUpdateTime": "0001-01-01T00:00:00"
},
"lastUpdatedBy": {
"displayName": "Fabrikam Fiber",
"url": "https://vssps.dev.azure.com/fabrikam/Aea08ebc7-105f-4bb2-a36b-f92e0e9de65a/_apis/Identities/0fdbdad8-6afb-6149-9af9-c0a216137d1d",
"_links": {
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
}
},
"id": "9c694866-b1b9-6531-98e8-7a05990c5154",
"uniqueName": "[email protected]",
"imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
"descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
},
"lastUpdatedDate": "2024-09-02T11:11:51.193Z",
"plan": {
"id": 12,
"name": "tp2"
},
"_links": {
"_self": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/16"
},
"testCases": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/16/TestCase"
},
"testPoints": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/16/TestPoint"
}
},
"suiteType": "staticTestSuite",
"name": "s2.2.1",
"parentSuite": {
"id": 15,
"name": "s2.2"
},
"inheritDefaultConfigurations": true
}
],
"hasChildren": true,
"_links": {
"_self": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/15"
},
"testCases": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/15/TestCase"
},
"testPoints": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/15/TestPoint"
}
},
"suiteType": "staticTestSuite",
"name": "s2.2",
"parentSuite": {
"id": 13,
"name": "tp2"
},
"inheritDefaultConfigurations": true
},
{
"id": 14,
"revision": 2,
"project": {
"id": "9aa0d72c-e93a-4456-9870-9c5169074a96",
"name": "p1",
"url": "https://dev.azure.com/fabrikam/_apis/projects/p1",
"state": "unchanged",
"visibility": "unchanged",
"lastUpdateTime": "0001-01-01T00:00:00"
},
"lastUpdatedBy": {
"displayName": "Fabrikam Fiber",
"url": "https://vssps.dev.azure.com/fabrikam/Aea08ebc7-105f-4bb2-a36b-f92e0e9de65a/_apis/Identities/0fdbdad8-6afb-6149-9af9-c0a216137d1d",
"_links": {
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
}
},
"id": "9c694866-b1b9-6531-98e8-7a05990c5154",
"uniqueName": "[email protected]",
"imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
"descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
},
"lastUpdatedDate": "2024-09-02T13:14:27.78Z",
"plan": {
"areaPath": "p1",
"iteration": "p1",
"startDate": "2024-09-02T11:10:42.917Z",
"endDate": "2024-09-09T11:10:42.917Z",
"rootSuiteId": 13,
"id": 12,
"name": "tp2"
},
"_links": {
"_self": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/14"
},
"testCases": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/14/TestCase"
},
"testPoints": {
"href": "https://dev.azure.com/fabrikam/p1/_apis/testplan/Plans/12/Suites/14/TestPoint"
}
},
"suiteType": "staticTestSuite",
"name": "s2.1",
"parentSuite": {
"id": 13,
"name": "tp2"
},
"inheritDefaultConfigurations": true
}
],
"count": 2
}
Definizioni
Nome | Descrizione |
---|---|
Identity |
|
Project |
Stato del progetto. |
Project |
Visibilità del progetto. |
Reference |
Classe per rappresentare una raccolta di collegamenti di riferimento REST. |
Suite |
Includere i dettagli delle suite per bambini e dei tester. |
Team |
Rappresenta un riferimento superficiale a un oggetto TeamProject. |
Test |
Informazioni di riferimento sulla configurazione dei test |
Test |
Risorsa di riferimento del piano di test. |
Test |
Gruppo di test |
Test |
Risorsa di riferimento del gruppo di test. |
Test |
Tipo di gruppo di test. |
IdentityRef
Nome | Tipo | Descrizione |
---|---|---|
_links |
Questo campo contiene zero o più collegamenti interessanti sull'oggetto grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate sull'oggetto grafico. |
|
descriptor |
string |
Il descrittore è il modo principale per fare riferimento all'oggetto del grafo mentre il sistema è in esecuzione. Questo campo identificherà in modo univoco lo stesso soggetto del grafico in account e organizzazioni. |
directoryAlias |
string |
Deprecato: può essere recuperato eseguendo una query sull'utente graph a cui si fa riferimento nella voce "self" del dizionario IdentityRef "_links" |
displayName |
string |
Si tratta del nome visualizzato non univoco dell'oggetto del grafico. Per modificare questo campo, è necessario modificarne il valore nel provider di origine. |
id |
string |
|
imageUrl |
string |
Deprecato : disponibile nella voce "avatar" del dizionario IdentityRef "_links" |
inactive |
boolean |
Deprecato: può essere recuperato eseguendo una query sullo stato di appartenenza graph a cui si fa riferimento nella voce "membershipState" del dizionario "_links" GraphUser |
isAadIdentity |
boolean |
Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
isContainer |
boolean |
Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsGroupType) |
isDeletedInOrigin |
boolean |
|
profileUrl |
string |
Deprecato: non in uso nella maggior parte delle implementazioni preesistenti di ToIdentityRef |
uniqueName |
string |
Deprecato: usare invece Domain+PrincipalName |
url |
string |
Questo URL è la route completa alla risorsa di origine di questo oggetto grafico. |
ProjectState
Stato del progetto.
Valore | Descrizione |
---|---|
all |
Tutti i progetti indipendentemente dallo stato tranne Deleted. |
createPending |
Il progetto è stato accodato per la creazione, ma il processo non è ancora stato avviato. |
deleted |
Il progetto è stato eliminato. |
deleting |
Il progetto è in corso di eliminazione. |
new |
Il progetto è in fase di creazione. |
unchanged |
Il progetto non è stato modificato. |
wellFormed |
Il progetto è completamente creato e pronto per l'uso. |
ProjectVisibility
Visibilità del progetto.
Valore | Descrizione |
---|---|
private |
Il progetto è visibile solo agli utenti con accesso esplicito. |
public |
Il progetto è visibile a tutti. |
ReferenceLinks
Classe per rappresentare una raccolta di collegamenti di riferimento REST.
Nome | Tipo | Descrizione |
---|---|---|
links |
object |
Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura. |
SuiteExpand
Includere i dettagli delle suite per bambini e dei tester.
Valore | Descrizione |
---|---|
children |
Includere elementi figlio in risposta. |
defaultTesters |
Includere i tester predefiniti in risposta. |
none |
Non includere alcuna espansione nell'output. |
TeamProjectReference
Rappresenta un riferimento superficiale a un oggetto TeamProject.
Nome | Tipo | Descrizione |
---|---|---|
abbreviation |
string |
Abbreviazione del progetto. |
defaultTeamImageUrl |
string |
URL dell'immagine di identità del team predefinita. |
description |
string |
Descrizione del progetto (se presente). |
id |
string (uuid) |
Identificatore del progetto. |
lastUpdateTime |
string (date-time) |
Ora dell'ultimo aggiornamento del progetto. |
name |
string |
Nome progetto. |
revision |
integer (int64) |
Revisione del progetto. |
state |
Stato del progetto. |
|
url |
string |
URL della versione completa dell'oggetto. |
visibility |
Visibilità del progetto. |
TestConfigurationReference
Informazioni di riferimento sulla configurazione dei test
Nome | Tipo | Descrizione |
---|---|---|
id |
integer (int32) |
ID della configurazione |
name |
string |
Nome della configurazione |
TestPlanReference
Risorsa di riferimento del piano di test.
Nome | Tipo | Descrizione |
---|---|---|
id |
integer (int32) |
ID del piano di test. |
name |
string |
Nome del piano di test. |
TestSuite
Gruppo di test
Nome | Tipo | Descrizione |
---|---|---|
_links |
Collegamenti: self, testPoints, testCases, parent |
|
children |
Gruppi di test figlio del gruppo di test corrente. |
|
defaultConfigurations |
Testare le configurazioni predefinite del gruppo di test. |
|
defaultTesters |
Tester predefiniti del gruppo di test. |
|
hasChildren |
boolean |
Valore booleano che indica se sono presenti gruppi di test figlio |
id |
integer (int32) |
ID del gruppo di test. |
inheritDefaultConfigurations |
boolean |
La configurazione predefinita è stata ereditata o meno. |
lastError |
string |
Ultimo errore per il gruppo di test. |
lastPopulatedDate |
string (date-time) |
Data dell'ultimo popolamento. |
lastUpdatedBy |
IdentityRef dell'utente che ha aggiornato di recente il gruppo di test. |
|
lastUpdatedDate |
string (date-time) |
Data ultimo aggiornamento. |
name |
string |
Nome del gruppo di test. |
parentSuite |
Riferimento padre del gruppo di test. |
|
plan |
Piano di test a cui appartiene il gruppo di test. |
|
project |
Riferimento superficiale al progetto del gruppo di test. |
|
queryString |
string |
Stringa di query del gruppo di test per gruppi dinamici. |
requirementId |
integer (int32) |
ID requisito del gruppo di test. |
revision |
integer (int32) |
Revisione del gruppo di test. |
suiteType |
Tipo di gruppo di test. |
TestSuiteReference
Risorsa di riferimento del gruppo di test.
Nome | Tipo | Descrizione |
---|---|---|
id |
integer (int32) |
ID del gruppo di test. |
name |
string |
Nome del gruppo di test. |
TestSuiteType
Tipo di gruppo di test.
Valore | Descrizione |
---|---|
dynamicTestSuite |
Gruppo di test basato su query |
none |
Tipo di suite predefinito |
requirementTestSuite |
Gruppo di test basato sui requisiti |
staticTestSuite |
Gruppo di test statici |