Obtaining the Status of a CFW Task¶

Function¶

This API is used to obtain the status of a CFW task.

URI¶

GET /v3/{project_id}/jobs/{job_id}

**Table 1** Path Parameters¶
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID, which can be obtained by calling an API or from the console. For details, see Obtaining a Project ID.
job_id	Yes	String	Task ID returned when a pay-per-use firewall is created. You can obtain the task ID by calling the API for creating a firewall. Its value is obtained from job_id in the return value.

Request Parameters¶

**Table 2** Request header parameters¶
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. You can obtain the token by referring to Obtaining a User Token.
Content-Type	Yes	String	Content type. It can only be set to application/json.

Response Parameters¶

Status code: 200

**Table 3** Response body parameters¶
Parameter	Type	Description
data	GetCreateFirewallJobResponseData object	Data returned for creating a pay-per-use firewall.

**Table 4** GetCreateFirewallJobResponseData¶
Parameter	Type	Description
id	String	ID of the task for creating a pay-per-use firewall.
status	String	Task execution status, which indicates whether a firewall is successfully created. Enumeration values: Running Success Failed
begin_time	String	Creation time in the "yyyy-mm-ddThh:mm:ssZ" format. T is the separator between the calendar and the hourly notation of time. Z indicates the time zone offset. For example, in the Beijing time zone, the time zone offset is shown as +0800.
end_time	String	End time in the "yyyy-mm-ddThh:mm:ssZ" format. T is the separator between the calendar and the hourly notation of time. Z indicates the time zone offset. For example, in the Beijing time zone, the time zone offset is shown as +0800.

Example Requests¶

Obtain information about the f588ce71-e26c-400d-8981-f854355f6849 task for creating a pay-per-use firewall in project 09bb24e6fe80d23d2fa2c010b53b418c.

https://{Endpoint}/v3/09bb24e6fe80d23d2fa2c010b53b418c/jobs/f588ce71-e26c-400d-8981-f854355f6849

Example Responses¶

Status code: 200

Return value of the API for obtaining the information about a pay-per-use firewall creation task.

{
  "data" : {
    "begin_time" : 1641370501000,
    "end_time" : 1641370515000,
    "id" : "f588ce71-e26c-400d-8981-f854355f6849",
    "status" : "Success"
  }
}

Status Codes¶

Status Code	Description
200	Return value of the API for obtaining the information about a pay-per-use firewall creation task.

Error Codes¶

See Error Codes.

last updated: 2025-01-21 13:19 UTC - commit: abe94c6df6d30c3b44340c2119ffd81f9990504a