更新时间:2025-12-27 GMT+08:00
分享

发送消息通知 - SendEmail

功能介绍

根据请求参数发送消息通知

调用方法

请参见如何调用API

URI

POST /v1/{project_id}/notice_config/notice

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

约束限制:

不涉及

取值范围:

项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必传。

取值范围:

字符串长度不少于1,不超过10万。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

SendEmailRequestBody

String

任务执行结果

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

code

String

参数解释

错误码

error

CommonResponseErrorString object

参数解释

统一错误返回

reason

String

参数解释

失败原因

result

String

参数解释

结果

status

String

参数解释

响应状态

  • success,请求成功

  • error,请求报错

表5 CommonResponseErrorString

参数

参数类型

描述

code

String

参数解释

错误码

reason

String

参数解释

错误原因

状态码:201

Created

状态码:401

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

12-18个字符组成的字符串

error_msg

String

参数解释

接口调用失败错误信息

取值范围

3-1000个字符组成的字符串

状态码:403

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

12-18个字符组成的字符串

error_msg

String

参数解释

接口调用失败错误信息

取值范围

3-1000个字符组成的字符串

状态码:404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

12-18个字符组成的字符串

error_msg

String

参数解释

接口调用失败错误信息

取值范围

3-1000个字符组成的字符串

请求示例

post https://{endpoint}/v1/8946a0e4757243cc886a307916aab90b/notice_config/notice?source_type=1

"{ 
  "type": "1",
  "testId": "",
  "taskId": "",
  "hostUrl": "https://alpha.devcloud.inhuawei.com",
  "result": "成功",
  "userId": "",
  "userName": "",
  "testName": "",
  "projectId": "9a4a7abcc91b4092bef1eee6eb56a8de"
}"

响应示例

状态码:200

OK

{
  "status" : "success",
  "result" : "ok",
  "reason" : null,
  "error" : null,
  "code" : null
}

状态码

状态码

描述

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码

相关文档