Test Suites - Create

참조

Service:: Test

API Version:: 5.0

테스트 도구 모음을 만듭니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
organization	path	True	string	Azure DevOps 조직의 이름입니다.
planId	path	True	integer int32	제품군을 포함하는 테스트 계획의 ID입니다.
project	path	True	string	프로젝트 ID 또는 프로젝트 이름
suiteId	path	True	integer int32	부모 제품군의 ID입니다.
api-version	query	True	string	사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '5.0'으로 설정해야 합니다.

요청 본문

Name	형식	Description
name	string	테스트 도구 모음의 이름입니다.
queryString	string	쿼리 기반 제품군의 경우 제품군을 정의하는 쿼리 문자열입니다.
requirementIds	integer[]	요구 사항 테스트 도구 모음의 경우 요구 사항의 ID입니다.
suiteType	string	만들 테스트 도구 모음의 유형입니다. DynamicTestSuite, StaticTestSuite 및 RequirementTestSuite의 값을 가질 수 있습니다.

응답

Name	형식	Description
200 OK	TestSuite[]	성공한 작업

보안

oauth2

Type: oauth2
Flow: accessCode
Authorization 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

Scopes

Name	Description
vso.test_write	테스트 계획, 사례, 결과 및 기타 테스트 관리 관련 아티팩트 읽기, 만들기 및 업데이트 기능을 부여합니다.

예제

Based on a query

Based on requirements

Static suite

Based on a query

Sample Request

HTTP

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

{
  "suiteType": "DynamicTestSuite",
  "name": "AllTestCases",
  "queryString": "SELECT [System.Id],[System.WorkItemType],[System.Title],[Microsoft.VSTS.Common.Priority],[System.AssignedTo],[System.AreaPath] FROM WorkItems WHERE [System.WorkItemType] IN GROUP 'Microsoft.TestCaseCategory'"
}

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": 9,
      "name": "AllTestCases",
      "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/9",
      "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"
      },
      "parent": {
        "id": "1",
        "name": "sprint1",
        "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/1"
      },
      "queryString": "SELECT [System.Id],[System.WorkItemType],[System.Title],[Microsoft.VSTS.Common.Priority],[System.AssignedTo],[System.AreaPath] FROM WorkItems WHERE [System.WorkItemType] IN GROUP 'Microsoft.TestCaseCategory'",
      "revision": 1,
      "testCaseCount": 2,
      "suiteType": "DynamicTestSuite",
      "testCasesUrl": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/9/testcases",
      "inheritDefaultConfigurations": true,
      "lastPopulatedDate": "2014-05-04T11:33:28.497Z",
      "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-04T11:33:28.497Z"
    }
  ],
  "count": 1
}

Based on requirements

Sample Request

HTTP

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

{
  "suiteType": "RequirementTestSuite",
  "requirementIds": [
    2
  ]
}

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": 13,
      "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/13",
      "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"
      },
      "parent": {
        "id": "1",
        "name": "sprint1",
        "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/1"
      },
      "name": "2 : BestFeatureEver",
      "requirementId": 2,
      "revision": 1,
      "testCaseCount": 0,
      "suiteType": "RequirementTestSuite",
      "testCasesUrl": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/13/testcases",
      "inheritDefaultConfigurations": true,
      "defaultConfigurations": [],
      "lastPopulatedDate": "2014-05-04T11:33:25.857Z",
      "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-04T11:33:25.857Z",
      "areaUri": "vstfs:///Classification/Node/13a29f1c-46be-4883-9153-b36900f1b70c"
    }
  ],
  "count": 1
}

Static suite

Sample Request

HTTP

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

{
  "suiteType": "StaticTestSuite",
  "name": "NewTestSuite"
}

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": 8,
      "name": "NewTestSuite",
      "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/8",
      "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"
      },
      "parent": {
        "id": "1",
        "name": "sprint1",
        "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/1"
      },
      "revision": 1,
      "testCaseCount": 0,
      "suiteType": "StaticTestSuite",
      "testCasesUrl": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/8/testcases",
      "inheritDefaultConfigurations": true,
      "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-04T11:33:25.857Z"
    }
  ],
  "count": 1
}

정의

Name	Description
IdentityRef
ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
ShallowReference	다른 리소스에 대한 추상화된 참조입니다. 이 클래스는 링크를 통해 쉽게 트래버스할 수 있는 방식으로 다른 리소스를 참조하는 균일한 방법으로 빌드 데이터 계약을 제공하는 데 사용됩니다.
SuiteCreateModel	Suite 모델 만들기
TestSuite	테스트 도구 모음

IdentityRef

Name	형식	Description
_links	ReferenceLinks	이 필드에는 그래프 제목에 대한 0개 이상의 흥미로운 링크가 포함되어 있습니다. 이러한 링크를 호출하여 이 그래프 제목에 대한 추가 관계 또는 자세한 정보를 얻을 수 있습니다.
descriptor	string	설명자는 시스템이 실행되는 동안 그래프 제목을 참조하는 기본 방법입니다. 이 필드는 계정과 조직 모두에서 동일한 그래프 제목을 고유하게 식별합니다.
directoryAlias	string
displayName	string	그래프 주체의 고유하지 않은 표시 이름입니다. 이 필드를 변경하려면 원본 공급자에서 해당 값을 변경해야 합니다.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	이 URL은 이 그래프 주체의 원본 리소스에 대한 전체 경로입니다.

ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

Name	형식	Description
links	object	링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다.

ShallowReference

다른 리소스에 대한 추상화된 참조입니다. 이 클래스는 링크를 통해 쉽게 트래버스할 수 있는 방식으로 다른 리소스를 참조하는 균일한 방법으로 빌드 데이터 계약을 제공하는 데 사용됩니다.

Name	형식	Description
id	string	리소스의 ID
name	string	연결된 리소스의 이름(정의 이름, 컨트롤러 이름 등)
url	string	리소스에 대한 전체 http 링크

SuiteCreateModel

Suite 모델 만들기

Name	형식	Description
name	string	테스트 도구 모음의 이름입니다.
queryString	string	쿼리 기반 제품군의 경우 제품군을 정의하는 쿼리 문자열입니다.
requirementIds	integer[]	요구 사항 테스트 도구 모음의 경우 요구 사항의 ID입니다.
suiteType	string	만들 테스트 도구 모음의 유형입니다. DynamicTestSuite, StaticTestSuite 및 RequirementTestSuite의 값을 가질 수 있습니다.

TestSuite

테스트 도구 모음

Name	형식	Description
areaUri	string	테스트 도구 모음의 영역 URI입니다.
children	TestSuite[]	현재 테스트 도구 모음의 자식 테스트 도구 모음입니다.
defaultConfigurations	ShallowReference[]	테스트 도구 모음 기본 구성.
defaultTesters	ShallowReference[]	테스트 도구 모음 기본 테스터.
id	integer	테스트 도구 모음의 ID입니다.
inheritDefaultConfigurations	boolean	기본 구성이 상속되었는지 여부입니다.
lastError	string	테스트 도구 모음의 마지막 오류입니다.
lastPopulatedDate	string	마지막으로 채워진 날짜입니다.
lastUpdatedBy	IdentityRef	최근에 테스트 도구 모음을 업데이트한 사용자의 IdentityRef입니다.
lastUpdatedDate	string	마지막 업데이트 날짜입니다.
name	string	테스트 도구 모음의 이름입니다.
parent	ShallowReference	테스트 도구 모음 부모 단순 참조입니다.
plan	ShallowReference	테스트 도구 모음이 속한 테스트 계획입니다.
project	ShallowReference	테스트 도구 모음 프로젝트 단순 참조입니다.
queryString	string	동적 도구 모음에 대한 테스트 도구 모음 쿼리 문자열입니다.
requirementId	integer	테스트 도구 모음 요구 사항 ID입니다.
revision	integer	테스트 도구 모음 수정 버전입니다.
state	string	테스트 도구 모음의 상태입니다.
suiteType	string	테스트 도구 모음 유형입니다.
suites	ShallowReference[]	제품군의 단순 참조 목록입니다.
testCaseCount	integer	테스트 사례 수입니다.
testCasesUrl	string	테스트 사례 URL입니다.
text	string	트리 뷰에 사용됩니다. 테스트 도구 모음이 루트 도구 모음인 경우 계획의 이름이고, 그렇지 않으면 제품군의 제목입니다.
url	string	테스트 도구 모음의 URL입니다.

다음을 통해 공유

Test Suites - Create

URI 매개 변수

요청 본문

응답

보안

oauth2

Scopes

예제

Based on a query

Sample Request

Sample Response

Based on requirements

Sample Request

Sample Response

Static suite

Sample Request

Sample Response

정의

IdentityRef

ReferenceLinks

ShallowReference

SuiteCreateModel

TestSuite

추가 리소스