Test Plan Recycle Bin - List

リファレンス

サービス:: Test Plan

API バージョン:: 7.2-preview.1

削除されたテスト計画の一覧を取得する

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 パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前。
project	path	True	string	プロジェクト ID またはプロジェクト名
api-version	query	True	string	使用する API のバージョン。このバージョンの API を使用するには、これを '7.2-preview.1' に設定する必要があります。
continuationToken	query		string	返されるプランの一覧が完全でない場合は、プランの次のバッチを照会する継続トークンが応答ヘッダーに "x-ms-continuationtoken" として含まれます。テスト計画の最初のバッチを取得するには、このパラメーターを省略します。

応答

名前	型	説明
200 OK	TestPlan[]	成功した操作

セキュリティ

oauth2

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL (トークン 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

スコープ

名前	説明
vso.test	テスト計画、ケース、結果、その他のテスト管理関連の成果物を読み取る機能を付与します。

例

Get Deleted Test Plans

要求のサンプル

HTTP

GET https://dev.azure.com/fabrikam/{project}/_apis/testplan/recycleBin/testplan?api-version=7.2-preview.1

応答のサンプル

状態コード:: 200

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
}

定義

名前	説明
BuildDefinitionReference	ビルド定義参照リソース
IdentityRef
ProjectState	プロジェクトの状態。
ProjectVisibility	プロジェクトの可視性。
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
ReleaseEnvironmentDefinitionReference	リリース環境リソースへの参照。
TeamProjectReference	TeamProject への浅い参照を表します。
TestOutcomeSettings	テスト結果の設定
TestPlan	テスト計画リソース。
TestSuiteReference	テストスイート参照リソース。
YamlReleaseReference	yaml リリースリソースへの参照。

BuildDefinitionReference

Object

ビルド定義参照リソース

名前	型	説明
id	integer (int32)	ビルド定義の ID
name	string	ビルド定義の名前

IdentityRef

Object

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する興味深いリンクが 0 個以上含まれています。これらのリンクを呼び出して、このグラフの件名に関する追加のリレーションシップや詳細情報を取得できます。
descriptor	string	記述子は、システムの実行中にグラフの件名を参照する主な方法です。このフィールドは、アカウントと組織の両方で同じグラフの件名を一意に識別します。
directoryAlias	string	非推奨 - IdentityRef "_links" ディクショナリの "自己" エントリで参照されている Graph ユーザーにクエリを実行することで取得できます
displayName	string	これは、グラフの件名の一意でない表示名です。このフィールドを変更するには、ソースプロバイダーでその値を変更する必要があります。
id	string
imageUrl	string	非推奨 - IdentityRef "_links" ディクショナリの "アバター" エントリで使用できます
inactive	boolean	非推奨 - GraphUser "_links" ディクショナリの "membershipState" エントリで参照されている Graph メンバーシップの状態を照会することで取得できます
isAadIdentity	boolean	非推奨 - 記述子のサブジェクト型 (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) から推論できます
isContainer	boolean	非推奨 - 記述子のサブジェクト型 (Descriptor.IsGroupType) から推論できます
isDeletedInOrigin	boolean
profileUrl	string	非推奨 - ToIdentityRef の既存のほとんどの実装では使用されていません
uniqueName	string	非推奨 - 代わりに Domain+PrincipalName を使用する
url	string	この URL は、このグラフの件名のソースリソースへの完全なルートです。

ProjectState

列挙

プロジェクトの状態。

値	説明
all	[削除済み] を除く、状態に関係なく、すべてのプロジェクト。
createPending	プロジェクトは作成のためにキューに登録されていますが、プロセスはまだ開始されていません。
deleted	プロジェクトが削除されました。
deleting	プロジェクトは削除中です。
new	プロジェクトは作成中です。
unchanged	プロジェクトは変更されていません。
wellFormed	プロジェクトが完全に作成され、使用する準備が整いました。

ProjectVisibility

列挙

プロジェクトの可視性。

値	説明
private	プロジェクトは、明示的なアクセス権を持つユーザーにのみ表示されます。
public	プロジェクトはすべてのユーザーに表示されます。

ReferenceLinks

Object

REST 参照リンクのコレクションを表すクラス。

名前	型	説明
links	object	リンクの読み取りビュー。参照リンクは読み取り専用であるため、読み取り専用として公開する必要があります。

ReleaseEnvironmentDefinitionReference

Object

リリース環境リソースへの参照。

名前	型	説明
definitionId	integer (int32)	リリース環境定義を含むリリース定義の ID。
environmentDefinitionId	integer (int32)	リリース環境定義の ID。

TeamProjectReference

Object

TeamProject への浅い参照を表します。

名前	型	説明
abbreviation	string	プロジェクトの省略形。
defaultTeamImageUrl	string	既定のチーム ID イメージの URL。
description	string	プロジェクトの説明 (ある場合)。
id	string (uuid)	プロジェクト識別子。
lastUpdateTime	string (date-time)	プロジェクトの最終更新時刻。
name	string	プロジェクト名。
revision	integer (int64)	プロジェクトのリビジョン。
state	ProjectState	プロジェクトの状態。
url	string	オブジェクトの完全なバージョンへの URL。
visibility	ProjectVisibility	プロジェクトの可視性。

TestOutcomeSettings

Object

テスト結果の設定

名前	型	説明
syncOutcomeAcrossSuites	boolean	スイート間で同じテストのテスト結果を表示する方法を構成する値

TestPlan

Object

テスト計画リソース。

名前	型	説明
_links	ReferenceLinks	関連するリンク
areaPath	string	テスト計画の領域。
buildDefinition	BuildDefinitionReference	このテスト計画に関連付けられたビルドを生成するビルド定義。
buildId	integer (int32)	テスト対象のビルド。
description	string	テスト計画の説明。
endDate	string (date-time)	テスト計画の終了日。
id	integer (int32)	テスト計画の ID。
iteration	string	テスト計画のイテレーションパス。
name	string	テスト計画の名前。
owner	IdentityRef	テスト計画の所有者。
previousBuildId	integer (int32)	テスト計画に関連付けられている以前のビルド ID
project	TeamProjectReference	テスト計画を含むプロジェクト。
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	ビルドをデプロイし、このテスト計画から自動テストを実行するために使用されるリリース環境。
revision	integer (int32)	テスト計画の改訂。
rootSuite	TestSuiteReference	テスト計画のルートテストスイート。
startDate	string (date-time)	テスト計画の開始日。
state	string	テスト計画の状態。
testOutcomeSettings	TestOutcomeSettings	テスト計画の下でテストスイート間で同じテストを実行する必要がある方法を構成する値
updatedBy	IdentityRef	テスト計画の最後の更新の ID リファレンス
updatedDate	string (date-time)	テスト計画の更新日
yamlReleaseReference	YamlReleaseReference	このテスト計画に関連付けられている Yaml リリースリファレンス。

TestSuiteReference

Object

テストスイート参照リソース。

名前	型	説明
id	integer (int32)	テストスイートの ID。
name	string	テストスイートの名前。

YamlReleaseReference

Object

yaml リリースリソースへの参照。

名前	型	説明
definitionId	integer (int32)	yaml リリース定義の ID
stagesToSkip	string	yaml リリースのキュー中にスキップするステージ。

次の方法で共有

Test Plan Recycle Bin - List

URI パラメーター

応答

セキュリティ

oauth2

スコープ

例

Get Deleted Test Plans

要求のサンプル

応答のサンプル

定義

BuildDefinitionReference

IdentityRef

ProjectState

ProjectVisibility

ReferenceLinks

ReleaseEnvironmentDefinitionReference

TeamProjectReference

TestOutcomeSettings

TestPlan

TestSuiteReference

YamlReleaseReference