Query a Notification

Function

Calling Method

For details, see Calling APIs.

URI

GET /v3/jobs/notice/{job_id}/query

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
job_id	Yes	String	Indicates the ID of the build task. The value is a string of 32 characters consisting of digits and letters at the end of the browser URL when you edit the build task file.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. Obtain the value by calling the IAM service interface. (value of X-Subject-Token in the response header). Global tenant tokens are not supported. Use a region-level token whose scope is project.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
result	Array of QueryJobNoticeItems objects	Template query result
error	String	An error message is returned.
status	String	Returned status information.

**Table 4** QueryJobNoticeItems
Parameter	Type	Description
notice_type	String	Notification Type
enable_map	Map<String,Boolean>	Table for notifying breed opening details.
param_config	String	Parameter configuration

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_code	String	Error Codes
error_msg	String	Description

Status code: 401

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Error Codes
error_msg	String	Description

Status code: 403

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error Codes
error_msg	String	Description

Status code: 404

**Table 8** Response body parameters
Parameter	Type	Description
error_code	String	Error Codes
error_msg	String	Description

Status code: 500

**Table 9** Response body parameters
Parameter	Type	Description
error_code	String	Error Codes
error_msg	String	Description

Example Requests

GET https://{endpoint}/v3/jobs/notice/48c66c6002964721be537cdc6ce0297b/query

Example Responses

Status code: 200

{
  "result" : [ {
    "notice_type" : "DING_TALK",
    "enable_map" : {
      "buildJobFail" : false,
      "updateConfigJob" : false,
      "buildJobSuccess" : false,
      "deleteJob" : false,
      "forbiddenJob" : false
    },
    "param_config" : null
  }, {
    "notice_type" : "MAIL",
    "enable_map" : {
      "buildJobFail" : true,
      "updateConfigJob" : false,
      "buildJobSuccess" : false,
      "deleteJob" : false,
      "forbiddenJob" : false
    },
    "param_config" : null
  }, {
    "notice_type" : "MESSAGE",
    "enable_map" : {
      "buildJobFail" : false,
      "updateConfigJob" : false,
      "buildJobSuccess" : false,
      "deleteJob" : false,
      "forbiddenJob" : false
    },
    "param_config" : null
  } ],
  "error" : null,
  "status" : "success"
}