Test Plan Recycle Bin - List
Abrufen einer Liste gelöschter Testpläne
GET https://dev.azure.com/{organization}/{project}/_apis/testplan/recycleBin/testplan?api-version=7.2-preview.1
GET https://dev.azure.com/{organization}/{project}/_apis/testplan/recycleBin/testplan?continuationToken={continuationToken}&api-version=7.2-preview.1
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Der Name der Azure DevOps-Organisation. |
|
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. |
|
continuation
|
query |
string |
Wenn die Liste der zurückgegebenen Pläne nicht abgeschlossen ist, wird ein Fortsetzungstoken zum Abfragen des nächsten Plans im Antwortheader als "x-ms-continuationtoken" enthalten. Lassen Sie diesen Parameter weg, um den ersten Batch von Testplänen abzurufen. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Test |
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 Deleted Test Plans
Beispielanforderung
GET https://dev.azure.com/fabrikam/{project}/_apis/testplan/recycleBin/testplan?api-version=7.2-preview.1
Beispiel für eine Antwort
transfer-Encoding: chunked
{
"value": [
{
"id": 5,
"project": {
"id": "afb62ab2-bd74-41c2-991e-40bbb9c8ca91",
"name": "sampleProject",
"state": "unchanged",
"visibility": "unchanged",
"lastUpdateTime": "0001-01-01T00:00:00"
},
"updatedDate": "2024-08-14T13:27:55.213Z",
"updatedBy": {
"displayName": "Fabrikam Fiber",
"url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
"_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"
},
"rootSuite": {
"id": 6,
"name": "Plan 1"
},
"_links": {
"_self": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/5"
},
"clientUrl": {
"href": "mtms://fabrikam.visualstudio.com:443/p:sampleProject/Testing/testplan/connect?id=5"
},
"rootSuite": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/5/Suites/6"
},
"build": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/build/Builds/3"
}
},
"revision": 0,
"name": "Plan 1",
"areaPath": "sampleProject\\Team1",
"startDate": "2024-08-14T13:01:38.143Z",
"endDate": "2024-08-21T13:01:38.143Z",
"iteration": "p1",
"owner": {
"displayName": "Fabrikam Fiber",
"url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
"_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"
},
"state": "Active",
"testOutcomeSettings": {
"syncOutcomeAcrossSuites": false
}
},
{
"id": 9,
"project": {
"id": "afb62ab2-bd74-41c2-991e-40bbb9c8ca91",
"name": "sampleProject",
"state": "unchanged",
"visibility": "unchanged",
"lastUpdateTime": "0001-01-01T00:00:00"
},
"updatedDate": "2024-08-14T13:27:55.213Z",
"updatedBy": {
"displayName": "Fabrikam Fiber",
"url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
"_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"
},
"rootSuite": {
"id": 10,
"name": "Plan 2"
},
"_links": {
"_self": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/9"
},
"clientUrl": {
"href": "mtms://fabrikam.visualstudio.com:443/p:sampleProject/Testing/testplan/connect?id=9"
},
"rootSuite": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/9/Suites/10"
},
"build": {
"href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/build/Builds/3"
}
},
"revision": 0,
"name": "Plan 2",
"areaPath": "sampleProject\\Team1",
"startDate": "2024-08-14T13:01:38.143Z",
"endDate": "2024-08-21T13:01:38.143Z",
"iteration": "p1",
"owner": {
"displayName": "Fabrikam Fiber",
"url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
"_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"
},
"state": "Active",
"testOutcomeSettings": {
"syncOutcomeAcrossSuites": false
}
}
],
"count": 2
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Build |
Die Builddefinitionsreferenzressource |
|
Identity |
|
|
Project |
Projektstatus. |
|
Project |
Projektsichtbarkeit. |
|
Reference |
Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt. |
|
Release |
Verweis auf die Freigabeumgebungsressource. |
|
Team |
Stellt einen flachen Verweis auf ein TeamProject dar. |
|
Test |
Testen der Ergebniseinstellungen |
|
Test |
Die Testplanressource. |
|
Test |
Die Referenzressource der Testsuite. |
|
Yaml |
Verweis auf yaml-Freigaberessource. |
BuildDefinitionReference
Die Builddefinitionsreferenzressource
| Name | Typ | Beschreibung |
|---|---|---|
| id |
integer (int32) |
ID der Builddefinition |
| name |
string |
Name der Builddefinition |
IdentityRef
| Name | Typ | Beschreibung |
|---|---|---|
| _links |
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. |
ReferenceLinks
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. |
ReleaseEnvironmentDefinitionReference
Verweis auf die Freigabeumgebungsressource.
| Name | Typ | Beschreibung |
|---|---|---|
| definitionId |
integer (int32) |
ID der Releasedefinition, die die Releaseumgebungsdefinition enthält. |
| environmentDefinitionId |
integer (int32) |
ID der Releaseumgebungsdefinition. |
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 |
Projektstatus. |
|
| url |
string |
Die URL zur Vollversion des Objekts. |
| visibility |
Projektsichtbarkeit. |
TestOutcomeSettings
Testen der Ergebniseinstellungen
| Name | Typ | Beschreibung |
|---|---|---|
| syncOutcomeAcrossSuites |
boolean |
Wert, der konfiguriert, wie Testergebnisse für dieselben Tests in allen Suites angezeigt werden |
TestPlan
Die Testplanressource.
| Name | Typ | Beschreibung |
|---|---|---|
| _links |
Relevante Links |
|
| areaPath |
string |
Bereich des Testplans. |
| buildDefinition |
Die Builddefinition, die einen Build generiert, der diesem Testplan zugeordnet ist. |
|
| buildId |
integer (int32) |
Zu testende Build. |
| description |
string |
Beschreibung des Testplans. |
| endDate |
string (date-time) |
Enddatum für den Testplan. |
| id |
integer (int32) |
ID des Testplans. |
| iteration |
string |
Iterationspfad des Testplans. |
| name |
string |
Name des Testplans. |
| owner |
Besitzer des Testplans. |
|
| previousBuildId |
integer (int32) |
Vorherige Build-ID, die dem Testplan zugeordnet ist |
| project |
Projekt, das den Testplan enthält. |
|
| releaseEnvironmentDefinition |
Release-Umgebung, die verwendet werden soll, um den Build bereitzustellen und automatisierte Tests aus diesem Testplan auszuführen. |
|
| revision |
integer (int32) |
Überarbeitung des Testplans. |
| rootSuite |
Stammtestsuite des Testplans. |
|
| startDate |
string (date-time) |
Startdatum für den Testplan. |
| state |
string |
Status des Testplans. |
| testOutcomeSettings |
Wert, um zu konfigurieren, wie sich dieselben Tests in Testsuiten unter einem Testplan verhalten müssen |
|
| updatedBy |
Identitätsreferenz für die letzte Aktualisierung des Testplans |
|
| updatedDate |
string (date-time) |
Aktualisierungsdatum des Testplans |
| yamlReleaseReference |
Die Yaml-Versionsreferenz, die diesem Testplan zugeordnet ist. |
TestSuiteReference
Die Referenzressource der Testsuite.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
integer (int32) |
ID der Testsuite. |
| name |
string |
Name der Testsuite. |
YamlReleaseReference
Verweis auf yaml-Freigaberessource.
| Name | Typ | Beschreibung |
|---|---|---|
| definitionId |
integer (int32) |
ID der Yaml-Releasedefinition |
| stagesToSkip |
string |
Phasen, die beim Warteschlangen-Yaml-Release übersprungen werden sollen. |