Test Suites - Get Test Suite By Id

Servizio:

Test

Versione API:

5.0

Ottenere il gruppo di test in base all'ID della suite.

GET https://dev.azure.com/{organization}/{project}/_apis/test/Plans/{planId}/suites/{suiteId}?api-version=5.0

Con parametri facoltativi:

GET https://dev.azure.com/{organization}/{project}/_apis/test/Plans/{planId}/suites/{suiteId}?$expand={$expand}&api-version=5.0

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 che contiene i gruppi.
project	path	True	string	ID progetto o nome del progetto
suiteId	path	True	integer int32	ID della suite da ottenere.
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '5.0' per usare questa versione dell'API.
$expand	query		integer int32	Includere i dettagli dei pacchetti 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

Esempio di richiesta

HTTP

GET https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/suites/1?api-version=5.0

Risposta di esempio

Codice di stato:

200

{
  "id": 1,
  "name": "sprint1",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/1",
  "project": {
    "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
    "name": "Fabrikam-Fiber-TFVC",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
  },
  "plan": {
    "id": "1",
    "name": "sprint1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "revision": 40,
  "testCaseCount": 2,
  "suiteType": "StaticTestSuite",
  "testCasesUrl": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/1/testcases",
  "inheritDefaultConfigurations": false,
  "defaultConfigurations": [
    {
      "id": "2",
      "name": "Windows 8"
    }
  ],
  "state": "InProgress",
  "lastUpdatedBy": {
    "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "displayName": "Fabrikam Fiber",
    "uniqueName": "fabrikamfiber1@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
  },
  "lastUpdatedDate": "2014-05-06T14:53:56.483Z"
}

Definizioni

Nome	Descrizione
IdentityRef
ReferenceLinks	Classe per rappresentare una raccolta di collegamenti di riferimento REST.
ShallowReference	Riferimento astratto ad altre risorse. Questa classe viene usata per fornire ai contratti dati di compilazione un modo uniforme per fare riferimento ad altre risorse in modo da semplificare l'attraversamento dei collegamenti.
TestSuite	Gruppo di test

IdentityRef

Object

Nome	Tipo	Descrizione
_links	ReferenceLinks	Questo campo contiene zero o più collegamenti interessanti sull'oggetto del grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate su questo 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 oggetto grafico in account e organizzazioni.
directoryAlias	string
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
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Questo URL è la route completa alla risorsa di origine di questo oggetto grafico.

ReferenceLinks

Object

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.

ShallowReference

Object

Riferimento astratto ad altre risorse. Questa classe viene usata per fornire ai contratti dati di compilazione un modo uniforme per fare riferimento ad altre risorse in modo da semplificare l'attraversamento dei collegamenti.

Nome	Tipo	Descrizione
id	string	ID della risorsa
name	string	Nome della risorsa collegata (nome della definizione, nome del controller e così via)
url	string	Collegamento HTTP completo alla risorsa

TestSuite

Object

Gruppo di test

Nome	Tipo	Descrizione
areaUri	string	URI dell'area del gruppo di test.
children	TestSuite[]	Gruppi di test figlio del gruppo di test corrente.
defaultConfigurations	ShallowReference[]	Configurazione predefinita del gruppo di test.
defaultTesters	ShallowReference[]	Tester predefiniti del gruppo di test.
id	integer	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	Data ultima popolata.
lastUpdatedBy	IdentityRef	IdentityRef dell'utente che ha aggiornato di recente il gruppo di test.
lastUpdatedDate	string	Data dell'ultimo aggiornamento.
name	string	Nome del gruppo di test.
parent	ShallowReference	Riferimento superficiale padre del gruppo di test.
plan	ShallowReference	Piano di test a cui appartiene il gruppo di test.
project	ShallowReference	Riferimento superficiale al progetto del gruppo di test.
queryString	string	Stringa di query del gruppo di test per i gruppi dinamici.
requirementId	integer	ID requisito del gruppo di test.
revision	integer	Revisione del gruppo di test.
state	string	Stato del gruppo di test.
suiteType	string	Tipo di gruppo di test.
suites	ShallowReference[]	Elenco di riferimenti superficiali di suite.
testCaseCount	integer	Conteggio dei test case.
testCasesUrl	string	URL del test case.
text	string	Usato nella visualizzazione struttura ad albero. Se il gruppo di test è root suite, è il nome del piano altrimenti il titolo della suite.
url	string	URL del gruppo di test.