Condividi tramite


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.

planId
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.

asTreeView
query

boolean

Se le suite restituite devono trovarsi in una struttura ad albero.

continuationToken
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

SuiteExpand

Includere i dettagli delle suite per bambini e dei tester.

Risposte

Nome Tipo Descrizione
200 OK

TestSuite[]

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
IdentityRef
ProjectState

Stato del progetto.

ProjectVisibility

Visibilità del progetto.

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

SuiteExpand

Includere i dettagli delle suite per bambini e dei tester.

TeamProjectReference

Rappresenta un riferimento superficiale a un oggetto TeamProject.

TestConfigurationReference

Informazioni di riferimento sulla configurazione dei test

TestPlanReference

Risorsa di riferimento del piano di test.

TestSuite

Gruppo di test

TestSuiteReference

Risorsa di riferimento del gruppo di test.

TestSuiteType

Tipo di gruppo di test.

IdentityRef

Nome Tipo Descrizione
_links

ReferenceLinks

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.

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

ProjectState

Stato del progetto.

url

string

URL della versione completa dell'oggetto.

visibility

ProjectVisibility

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

ReferenceLinks

Collegamenti: self, testPoints, testCases, parent

children

TestSuite[]

Gruppi di test figlio del gruppo di test corrente.

defaultConfigurations

TestConfigurationReference[]

Testare le configurazioni predefinite del gruppo di test.

defaultTesters

IdentityRef[]

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

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

TestSuiteReference

Riferimento padre del gruppo di test.

plan

TestPlanReference

Piano di test a cui appartiene il gruppo di test.

project

TeamProjectReference

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

TestSuiteType

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