Configurations - Create

服务:

Test Plan

API 版本:

7.1

创建测试配置。

POST https://dev.azure.com/{organization}/{project}/_apis/testplan/configurations?api-version=7.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
project	path	True	string	项目 ID 或项目名称
api-version	query	True	string	要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。

请求正文

名称	类型	说明
description	string	配置说明
isDefault	boolean	测试计划的配置是否为默认值
name	string	配置的名称
state	TestConfigurationState	配置状态
values	NameValuePair[]	测试变量字典，所选值

响应

名称	类型	说明
200 OK	TestConfiguration	成功作

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 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	授予读取、创建和更新测试计划、事例、结果和其他测试管理相关项目的能力。

示例

Create a new test configuration.

示例请求

HTTP

POST https://dev.azure.com/fabrikam/{project}/_apis/testplan/configurations?api-version=7.1

{
  "name": "SampleTestConfiguration",
  "description": "Sample Test configuration",
  "isDefault": true,
  "values": [
    {
      "name": "Operating System",
      "value": "Windows 8"
    }
  ],
  "state": "active"
}

示例响应

状态代码:

200

{
  "id": 8,
  "project": {
    "id": "eaedf3e5-b163-488b-be43-06d8c2b95d4d",
    "name": "MyProject",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/MyProject",
    "state": "unchanged",
    "visibility": "unchanged"
  },
  "name": "SampleTestConfiguration",
  "description": "Sample Test configuration",
  "isDefault": true,
  "values": [
    {
      "name": "Operating System",
      "value": "Windows 8"
    }
  ],
  "state": "active"
}

定义

名称	说明
NameValuePair	名称值对
ProjectState	项目状态。
ProjectVisibility	项目可见性。
TeamProjectReference	表示对 TeamProject 的浅表引用。
TestConfiguration	测试配置
TestConfigurationCreateUpdateParameters	测试配置创建或更新参数
TestConfigurationState	配置状态

NameValuePair

Object

名称值对

名称	类型	说明
name	string	名字
value	string	价值

ProjectState

枚举

项目状态。

值	说明
all	所有项目，无论状态如何，都已删除。
createPending	项目已排队创建，但该过程尚未启动。
deleted	项目已被删除。
deleting	项目正在删除。
new	正在创建项目。
unchanged	项目尚未更改。
wellFormed	项目已完全创建并可供使用。

ProjectVisibility

枚举

项目可见性。

值	说明
private	只有具有显式访问权限的用户才能看到该项目。
public	项目对所有人可见。

TeamProjectReference

Object

表示对 TeamProject 的浅表引用。

名称	类型	说明
abbreviation	string	项目缩写。
defaultTeamImageUrl	string	指向默认团队标识映像的 URL。
description	string	项目的说明（如果有）。
id	string (uuid)	项目标识符。
lastUpdateTime	string (date-time)	上次更新时间的项目。
name	string	项目名称。
revision	integer (int64)	项目修订。
state	ProjectState	项目状态。
url	string	指向对象完整版本的 URL。
visibility	ProjectVisibility	项目可见性。

TestConfiguration

Object

测试配置

名称	类型	说明
description	string	配置说明
id	integer (int32)	配置的 ID
isDefault	boolean	测试计划的配置是否为默认值
name	string	配置的名称
project	TeamProjectReference	测试配置变量的 ID
state	TestConfigurationState	配置状态
values	NameValuePair[]	测试变量字典，所选值

TestConfigurationCreateUpdateParameters

Object

测试配置创建或更新参数

名称	类型	说明
description	string	配置说明
isDefault	boolean	测试计划的配置是否为默认值
name	string	配置的名称
state	TestConfigurationState	配置状态
values	NameValuePair[]	测试变量字典，所选值

TestConfigurationState

枚举

配置状态

值	说明
active	配置可用于新的测试运行。
inactive	配置已停用，不应用于新的测试运行。