Clone Operation - Clone Test Suite

リファレンス

サービス:: Test

API バージョン:: 5.0-preview.2

テストスイートを複製する

POST https://dev.azure.com/{organization}/{project}/_apis/test/Plans/{planId}/Suites/{sourceSuiteId}/cloneoperation?api-version=5.0-preview.2

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前です。
planId	path	True	integer int32	複製するスイートが存在するテスト計画の ID
project	path	True	string	プロジェクト ID またはプロジェクト名
sourceSuiteId	path	True	integer int32	複製するテストスイートの ID
api-version	query	True	string	使う API のバージョン。このバージョンの API を使用するには、これを '5.0-preview.2' に設定する必要があります。

要求本文

名前	型	説明
cloneOptions	CloneOptions	テストスイートを複製するためのクローンオプション。
destinationSuiteId	integer	その下にあるスイート ID は、スイートを複製する必要があります。
destinationSuiteProjectName	string	変換先スイートのプロジェクト名。

応答

名前	型	説明
200 OK	CloneOperationInformation	正常な操作

セキュリティ

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_write	テスト計画、ケース、結果、その他のテスト管理関連の成果物を読み取り、作成、更新する機能を付与します。

例

要求のサンプル

HTTP

POST https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/{sourceSuiteId}/cloneoperation?api-version=5.0-preview.2

{
  "destinationSuiteId": 13,
  "destinationSuiteProjectName": "fabrikam-fiber-tfvc2",
  "cloneOptions": {
    "copyAncestorHierarchy": true,
    "overrideParameters": {
      "System.AreaPath": "fabrikam-fiber-tfvc2",
      "System.IterationPath": "fabrikam-fiber-tfvc2"
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "opId": 3,
  "creationDate": "0001-01-01T00:00:00",
  "completionDate": "0001-01-01T00:00:00",
  "state": "queued",
  "message": null,
  "cloneStatistics": null,
  "resultObjectType": "testSuite",
  "destinationObject": {
    "id": "14",
    "name": "simpleCloned",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc2/_apis/test/Plans/13/Suites/14"
  },
  "sourceObject": {
    "id": "1",
    "name": "TestSuite1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/2"
  },
  "destinationPlan": {
    "id": "18",
    "name": "DestinationPlan",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc2/_apis/test/Plans/18"
  },
  "sourcePlan": {
    "id": "1",
    "name": "TestPlan1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "destinationProject": {
    "name": "fabrikam-fiber-tfvc2",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/fabrikam-fiber-tfvc2"
  },
  "sourceProject": {
    "name": "fabrikam-fiber-tfvc",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/fabrikam-fiber-tfvc"
  },
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/cloneOperation/3"
}

定義

名前	説明
CloneOperationInformation	複製操作の詳細。
CloneOperationState	操作の現在の状態。 State が Suceeded または Failed に達すると、操作は完了します
CloneOptions
CloneStatistics
ResultObjectType	Clone 操作の結果として生成されるオブジェクトの型
ShallowReference	他のリソースへの抽象化された参照。このクラスは、リンクを介して簡単に走査できる方法で他のリソースを参照する統一された方法でビルドデータコントラクトを提供するために使用されます。
TestSuiteCloneRequest	テストスイートのクローン要求

CloneOperationInformation

Object

複製操作の詳細。

名前	型	説明
cloneStatistics	CloneStatistics	統計の複製
completionDate	string	操作が完了した場合、完了の DateTime。操作が完了していない場合、これは DateTime.MaxValue です
creationDate	string	操作が開始されたときの DateTime
destinationObject	ShallowReference	宛先の浅い参照
destinationPlan	ShallowReference	宛先の浅い参照
destinationProject	ShallowReference	宛先の浅い参照
message	string	操作が失敗した場合、メッセージには失敗の理由が含まれます。その他の場合は NULL が返されます。
opId	integer	操作の ID
resultObjectType	ResultObjectType	Clone 操作の結果として生成されるオブジェクトの型
sourceObject	ShallowReference	ソースの浅い参照
sourcePlan	ShallowReference	ソースの浅い参照
sourceProject	ShallowReference	ソースの浅い参照
state	CloneOperationState	操作の現在の状態。 State が Suceeded または Failed に達すると、操作は完了します
url	string	クローン情報を取得するための URL

CloneOperationState

列挙

操作の現在の状態。 State が Suceeded または Failed に達すると、操作は完了します

値	説明
failed	失敗状態の値
inProgress	Inprogress 状態の値
queued	キュー状態の値
succeeded	成功状態の値

CloneOptions

Object

名前	型	説明
cloneRequirements	boolean	true に設定されている場合、要件は複製されます
copyAllSuites	boolean	ソースプランからすべてのスイートをコピーする
copyAncestorHierarchy	boolean	copy 先祖 hieracrchy
destinationWorkItemType	string	複製のワークアイテムの種類の名前
overrideParameters	object	キー値が値によってオーバーライドされるキー値のペア。
relatedLinkComment	string	新しい複製テストケースをコメントなしの元の Set null にリンクするリンクにコメントを付ける

CloneStatistics

Object

名前	型	説明
clonedRequirementsCount	integer	これまでに複製された要求の数。
clonedSharedStepsCount	integer	これまでに複製された共有ステップの数。
clonedTestCasesCount	integer	これまでに複製されたテストケースの数
totalRequirementsCount	integer	複製する要件の合計数
totalTestCasesCount	integer	複製するテストケースの合計数

ResultObjectType

列挙

Clone 操作の結果として生成されるオブジェクトの型

値	説明
testPlan	複製の計画
testSuite	Suite Clone

ShallowReference

Object

他のリソースへの抽象化された参照。このクラスは、リンクを介して簡単に走査できる方法で他のリソースを参照する統一された方法でビルドデータコントラクトを提供するために使用されます。

名前	型	説明
id	string	リソースの ID
name	string	リンクされたリソースの名前 (定義名、コントローラー名など)
url	string	リソースへの完全な http リンク

TestSuiteCloneRequest

Object

テストスイートのクローン要求

名前	型	説明
cloneOptions	CloneOptions	テストスイートを複製するためのクローンオプション。
destinationSuiteId	integer	その下にあるスイート ID は、スイートを複製する必要があります。
destinationSuiteProjectName	string	変換先スイートのプロジェクト名。

次の方法で共有

Clone Operation - Clone Test Suite

URI パラメーター

要求本文

応答

セキュリティ

oauth2

スコープ

例

要求のサンプル

応答のサンプル

定義

CloneOperationInformation

CloneOperationState

CloneOptions

CloneStatistics

ResultObjectType

ShallowReference

TestSuiteCloneRequest