Freigeben über


Test Suite Recycle Bin Operations - Get Deleted Test Suites For Plan

Get Deleted Test Suites for a Test Plan.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
organization
path True

string

Der Name der Azure DevOps-Organisation.

planId
path True

integer (int32)

ID des Testplans, für den Suites angefordert werden.

project
path True

string

Projekt-ID oder Projektname

api-version
query True

string

Version der zu verwendenden API. Dies sollte auf "7.2-preview.1" festgelegt werden, um diese Version der API zu verwenden.

asTreeView
query

boolean

Wenn die zurückgegebenen Suites in einer Struktur vorhanden sein sollen.

continuationToken
query

string

Wenn die zurückgegebene Liste der zurückgegebenen Suites nicht abgeschlossen ist, wird ein Fortsetzungstoken zum Abfragen des nächsten Batches von Suites im Antwortheader als "x-ms-continuationtoken" enthalten. Lassen Sie diesen Parameter aus, um den ersten Batch von Testsammlungen abzurufen.

expand
query

SuiteExpand

Fügen Sie die Details der Kindersammlungen und Tester ein.

Antworten

Name Typ Beschreibung
200 OK

TestSuite[]

Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token-URL: 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

Bereiche

Name Beschreibung
vso.test Gewährt die Möglichkeit, Testpläne, Fälle, Ergebnisse und andere artefaktbezogene Testverwaltung zu lesen.

Beispiele

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.

Beispielanforderung

GET https://dev.azure.com/fabrikam/p1/_apis/testplan/recycleBin/TestPlan/12/testsuite?expand=Children, DefaultTesters&api-version=7.2-preview.1

Beispiel für eine Antwort

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": "fabrikamfiber1@microsoft.com",
        "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": "fabrikamfiber1@microsoft.com",
        "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": "fabrikamfiber1@microsoft.com",
        "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.

Beispielanforderung

GET https://dev.azure.com/fabrikam/p1/_apis/testplan/recycleBin/TestPlan/12/testsuite?asTreeView=True&api-version=7.2-preview.1

Beispiel für eine Antwort

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": "fabrikamfiber1@microsoft.com",
        "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": "fabrikamfiber1@microsoft.com",
            "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": "fabrikamfiber1@microsoft.com",
        "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
}

Definitionen

Name Beschreibung
IdentityRef
ProjectState

Projektstatus.

ProjectVisibility

Projektsichtbarkeit.

ReferenceLinks

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

SuiteExpand

Fügen Sie die Details der Kindersammlungen und Tester ein.

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.

TestConfigurationReference

Testkonfigurationsreferenz

TestPlanReference

Die Referenzressource des Testplans.

TestSuite

Testsuite

TestSuiteReference

Die Referenzressource der Testsuite.

TestSuiteType

Test suite type.

IdentityRef

Name Typ Beschreibung
_links

ReferenceLinks

Dieses Feld enthält null oder interessantere Links zum Thema Diagramm. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Diagrammbetreff zu erhalten.

descriptor

string

Der Deskriptor ist die primäre Möglichkeit, auf den Diagrammbetreff zu verweisen, während das System ausgeführt wird. In diesem Feld wird dasselbe Diagrammthema sowohl in Firmen als auch in Organisationen eindeutig identifiziert.

directoryAlias

string

Veraltet – Kann abgerufen werden, indem der Graph-Benutzer abgefragt wird, auf den im "Self"-Eintrag des IdentityRef -Wörterbuchs "_links" verwiesen wird

displayName

string

Dies ist der nicht eindeutige Anzeigename des Diagrammbetreffs. Um dieses Feld zu ändern, müssen Sie den Wert im Quellanbieter ändern.

id

string

imageUrl

string

Veraltet – Verfügbar im "Avatar"-Eintrag des IdentityRef-Wörterbuchs "_links"

inactive

boolean

Veraltet – Kann abgerufen werden, indem der Graph-Mitgliedschaftsstatus abgefragt wird, auf den im Eintrag "membershipState" des GraphUser-Wörterbuchs "_links" verwiesen wird.

isAadIdentity

boolean

Veraltet – Kann vom Betrefftyp des Deskriptors abgeleitet werden (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Veraltet – Kann vom Betrefftyp des Deskriptors abgeleitet werden (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

Veraltet – nicht in den meisten bereits vorhandenen Implementierungen von ToIdentityRef verwendet

uniqueName

string

Veraltet – Verwenden Sie stattdessen "Domain+PrincipalName".

url

string

Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs.

ProjectState

Projektstatus.

Wert Beschreibung
all

Alle Projekte unabhängig vom Status außer "Gelöscht".

createPending

Projekt wurde zur Erstellung in die Warteschlange gestellt, aber der Prozess wurde noch nicht gestartet.

deleted

Projekt wurde gelöscht.

deleting

Project wird gerade gelöscht.

new

Projekt wird gerade erstellt.

unchanged

Projekt wurde nicht geändert.

wellFormed

Project wird vollständig erstellt und kann verwendet werden.

ProjectVisibility

Projektsichtbarkeit.

Wert Beschreibung
private

Das Projekt ist nur für Benutzer mit expliziten Zugriff sichtbar.

public

Das Projekt ist für alle sichtbar.

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name Typ Beschreibung
links

object

Die schreibgeschützte Ansicht der Links. Da Referenzlinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

SuiteExpand

Fügen Sie die Details der Kindersammlungen und Tester ein.

Wert Beschreibung
children

Fügen Sie untergeordnete Elemente als Antwort hinzu.

defaultTesters

Fügen Sie standardmäßige Tester als Antwort hinzu.

none

Schließen Sie keine der Erweiterungen in die Ausgabe ein.

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.

Name Typ Beschreibung
abbreviation

string

Projektkürzel.

defaultTeamImageUrl

string

Url zum standardmäßigen Teamidentitätsbild.

description

string

Die Beschreibung des Projekts (falls vorhanden).

id

string (uuid)

Projektbezeichner.

lastUpdateTime

string (date-time)

Zeitpunkt der letzten Aktualisierung des Projekts.

name

string

Projektname.

revision

integer (int64)

Projektrevision.

state

ProjectState

Projektstatus.

url

string

Die URL zur Vollversion des Objekts.

visibility

ProjectVisibility

Projektsichtbarkeit.

TestConfigurationReference

Testkonfigurationsreferenz

Name Typ Beschreibung
id

integer (int32)

ID der Konfiguration

name

string

Name der Konfiguration

TestPlanReference

Die Referenzressource des Testplans.

Name Typ Beschreibung
id

integer (int32)

ID des Testplans.

name

string

Name des Testplans.

TestSuite

Testsuite

Name Typ Beschreibung
_links

ReferenceLinks

Links: selbst, testPoints, testCases, parent

children

TestSuite[]

Kindertestsuiten der aktuellen Testsuite.

defaultConfigurations

TestConfigurationReference[]

Testen Sie standardkonfigurationen der Suite.

defaultTesters

IdentityRef[]

Test suite default testers.

hasChildren

boolean

Boolescher Wert, der diktieren soll, wenn Untergeordnete Testsuiten vorhanden sind

id

integer (int32)

ID der Testsuite.

inheritDefaultConfigurations

boolean

Die Standardkonfiguration wurde geerbt oder nicht.

lastError

string

Letzter Fehler für Testsuite.

lastPopulatedDate

string (date-time)

Datum der letzten Auffüllung.

lastUpdatedBy

IdentityRef

IdentityRef des Benutzers, der die Testsuite kürzlich aktualisiert hat.

lastUpdatedDate

string (date-time)

Datum der letzten Aktualisierung.

name

string

Name der Testsuite.

parentSuite

TestSuiteReference

Test suite parent shallow reference.

plan

TestPlanReference

Testplan, zu dem die Testsuite gehört.

project

TeamProjectReference

Flacher Verweis auf Testsuiteprojekt.

queryString

string

Test suite query string, for dynamic suites.

requirementId

integer (int32)

Test suite anforderungs-ID.

revision

integer (int32)

Test suite revision.

suiteType

TestSuiteType

Test suite type.

TestSuiteReference

Die Referenzressource der Testsuite.

Name Typ Beschreibung
id

integer (int32)

ID der Testsuite.

name

string

Name der Testsuite.

TestSuiteType

Test suite type.

Wert Beschreibung
dynamicTestSuite

Abfragebasierte Testsuite

none

Standardsuitetyp

requirementTestSuite

Anforderungsbasierte Testsuite

staticTestSuite

Static Test Suite