# 外部系统注册服务 - AddTestHubService
#### 功能介绍
此接口用于外部系统注册服务(创建执行方式) 同页面 设置 -\> 测试设置 -\> 执行方式设置 -\> 新建执行方式
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v4/testhub/services
#### 请求参数
表1请求Body参数 
| 参数           | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| service_name | 是    | String  | 服务名                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| server_host  | 是    | String  | 服务域名                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| server_type  | 否    | Integer | **参数解释**: 服务类型 **约束限制**: 不涉及 **取值范围**: - 0，普通TestHub。   - 1，对接八爪鱼TestHub。    **默认取值**: 不涉及 |
   
#### 响应参数
**状态码：201**
表2响应Body参数 
| 参数             | 参数类型                                                                           | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| status         | String                                                                         | **参数解释**: 调用此接口的响应状态。 **取值范围**: - success，表示接口调用成功。   - error，表示接口调用失败。    |
| error          | [ApiError] object                       | 错误信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| request_id     | String                                                                         | 由接口调用方传入，建议使用UUID保证请求的唯一性。                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| server_address | String                                                                         | 本次请求的受理的服务地址                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| result         | [OprTestHubServiceVo] object | 请求结果                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   
 表3ApiError 
| 参数     | 参数类型   | 描述                                                                                                                                               |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
 表4OprTestHubServiceVo 
| 参数           | 参数类型    | 描述   |
|:---|:---|:---|
| service_name | String  | 服务名  |
| service_id   | Integer | 服务id |
   
#### 请求示例
```
post https://{endpoint}/v4/testhub/services
{
  "service_name" : "name",
  "server_host" : "host",
  "server_type" : 0
}
```
#### 响应示例
**状态码：201**
OK
```
{
  "result" : {
    "service_name" : "某个新服务名称",
    "service_id" : 164
  }
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 201 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。