Test Suites - Get Test Suite By Id

Usługa:

Test

Wersja interfejsu API:

5.0

Uzyskaj pakiet testowy według identyfikatora pakietu.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
planId	path	True	integer int32	Identyfikator planu testowego, który zawiera zestawy.
project	path	True	string	Identyfikator projektu lub nazwa projektu
suiteId	path	True	integer int32	Identyfikator pakietu do pobrania.
api-version	query	True	string	Wersja interfejsu API do użycia. Powinno to być ustawione na wartość "5.0", aby używać tej wersji interfejsu API.
$expand	query		integer int32	Dołącz szczegóły zestawów dla dzieci i testerów

Odpowiedzi

Nazwa	Typ	Opis
200 OK	TestSuite	operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

Nazwa	Opis
vso.test	Umożliwia odczytywanie planów testów, przypadków, wyników i innych artefaktów związanych z zarządzaniem testami.

Przykłady

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

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"
}

Definicje

Nazwa	Opis
IdentityRef
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji z jednolitym sposobem odwołowania się do innych zasobów w sposób, który zapewnia łatwy przechodzenie za pośrednictwem linków.
TestSuite	Zestaw testów

IdentityRef

Object

Nazwa	Typ	Opis
_links	ReferenceLinks	To pole zawiera zero lub więcej interesujących linków dotyczących tematu grafu. Te linki mogą być wywoływane w celu uzyskania dodatkowych relacji lub bardziej szczegółowych informacji na temat tego tematu grafu.
descriptor	string	Deskryptor jest podstawowym sposobem odwołowania się do tematu grafu podczas działania systemu. To pole będzie jednoznacznie identyfikować ten sam temat grafu zarówno w ramach kont, jak i organizacji.
directoryAlias	string
displayName	string	Jest to unikatowa nazwa wyświetlana tematu grafu. Aby zmienić to pole, musisz zmienić jego wartość u dostawcy źródłowego.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Ten adres URL jest pełną trasą do zasobu źródłowego tego tematu grafu.

ReferenceLinks

Object

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Czytelny widok linków. Ponieważ linki referencyjne są czytelne, chcemy uwidocznić je tylko jako tylko do odczytu.

ShallowReference

Object

Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji z jednolitym sposobem odwołowania się do innych zasobów w sposób, który zapewnia łatwy przechodzenie za pośrednictwem linków.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu
name	string	Nazwa połączonego zasobu (nazwa definicji, nazwa kontrolera itp.)
url	string	Pełny link http do zasobu

TestSuite

Object

Zestaw testów

Nazwa	Typ	Opis
areaUri	string	Identyfikator URI obszaru zestawu testów.
children	TestSuite[]	Podrzędne zestawy testów bieżącego zestawu testów.
defaultConfigurations	ShallowReference[]	Domyślna konfiguracja zestawu testów.
defaultTesters	ShallowReference[]	Testerzy domyślni zestawu testów.
id	integer	Identyfikator zestawu testów.
inheritDefaultConfigurations	boolean	Konfiguracja domyślna została dziedziczona lub nie.
lastError	string	Ostatni błąd dla zestawu testów.
lastPopulatedDate	string	Data ostatniego wypełnienia.
lastUpdatedBy	IdentityRef	IdentityRef użytkownika, który niedawno zaktualizował pakiet testowy.
lastUpdatedDate	string	Data ostatniej aktualizacji.
name	string	Nazwa zestawu testów.
parent	ShallowReference	Odwołanie nadrzędne zestawu testowego.
plan	ShallowReference	Plan testu, do którego należy zestaw testów.
project	ShallowReference	Płytkie odwołanie do projektu zestawu testów.
queryString	string	Ciąg zapytania zestawu testów dla zestawów dynamicznych.
requirementId	integer	Identyfikator wymagań zestawu testów.
revision	integer	Poprawka zestawu testów.
state	string	Stan zestawu testów.
suiteType	string	Typ zestawu testów.
suites	ShallowReference[]	Lista płytkich odwołań do zestawów.
testCaseCount	integer	Liczba przypadków testowych.
testCasesUrl	string	Adres URL przypadku testowego.
text	string	Używane w widoku drzewa. Jeśli pakiet testowy jest pakietem głównym, jest to nazwa planu w przeciwnym razie tytuł pakietu.
url	string	Adres URL zestawu testów.