Set cron task settings

Description

PATCH https://rest.netim.com/1.0/webhosting/{id}/cron-task/

Update a cron task.

• 
  Parameters
• 
  Responses

URL Parameters

• {id}
  Hosting’s id.

Headers

• Authorization
  string

  The Autorization header must start with « Bearer  » followed by the session ID.
  Example: »Autorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26″

• Content-type
  string

  Content type of the request

  Only « application/json » is accepted

Body

REQUIRED

---

• action
  string
  Set to « SetValues ».
• params
  array

  {“idCronTask”: Cron task ID,

  “path”: Path to the cron script,

  “returnMethod”: “LOG” / “MAIL” / “NONE,

  “returnTarget”:
  When returnMethod is “LOG” then a path of a log file starting from the vhost’s directory;
  When returnMethod is “MAIL” then an email address,

  “mm”: Minutes (00-59) ,

  “hh”: Hours (00-23),

  “jj”: Day (01-31),

  “mmm”: Month (01-12),

  “jjj”: Day in the week (1-7)}

JSON example

{
    "action":"SetValues",
    "params":{"idCronTask":"201", "path": "/cron.php", "returnMethod": "LOG", "returnTarget": "/log.txt", "mm": "5", "hh": "*", "jj": "*", "mmm": "*", "jjj": "*"},
}

• 200OK
  The request is processed and the result is returned in the body.

  Body

  Objectapplication/json

  An object of type StructOperationResponse

• 4XX

  Learn more about the possible error codes

Common language examples

• 
  PHP
• 
  JAVA
• 
  PYTHON
• 
  SHELL / CURL

<?php
 
    $ch = curl_init();
 
    $id = "NW1024";
 
    $body = array(
        "action" => "SetValues",
        "params" =>  array("idCronTask" =>"201", "path" => "/cron.php", "returnMethod" => "LOG", "returnTarget" => "/log.txt", "mm" => "5", "hh" => "*", "jj" => "*", "mmm" => "*", "jjj" => "*"),
    );
 
    curl_setopt($ch, CURLOPT_URL, "https://rest.netim.com/1.0/webhosting/$id/cron-task/");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PATCH");
    curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $sessionID", "Content-type: application/json"]);
    curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
    curl_setopt($ch, CURlOPT_POSTFIELDS, json_encode($body));
 
 
    $result = json_decode(curl_exec ($ch), true);
    $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close ($ch);
 

import java.util.Base64;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class Example {
 
    public static void main(String args[]) throws Exception {
        String sessionID = "12345678";
 
        String id = "NW1024";
 
        String body = "{"action":"SetValues","params":{"idCronTask":"201", "path": "/cron.php", "returnMethod": "LOG", "returnTarget": "/log.txt", "mm": "5", "hh": "*", "jj": "*", "mmm": "*", "jjj": "*"},}";
 
 
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://rest.netim.com/1.0/webhosting/" + id + "/cron-task/"))
            .method("PATCH", HttpRequest.BodyPublishers.ofString(body))
            .header("Content-Type", "application/json")
            .header("Accept-Language", "EN")
            .header("Authorization", "Bearer " + sessionID)
            .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
 
        String result = response.body().toString();
    }
}

#!/usr/bin/python3
 
import json
import requests
 
 
id = "NW1024"
url = "https://rest.netim.com/1.0/webhosting/" + id + "/cron-task/"
 
sessionId = "1234567"
 
headers = {"Authorization": "Bearer " + sessionId, "Content-Type": "application/json"}
 
 
data = {
    "action":"SetValues",
    "params":{"idCronTask":"201", "path": "/cron.php", "returnMethod": "LOG", "returnTarget": "/log.txt", "mm": "5", "hh": "*", "jj": "*", "mmm": "*", "jjj": "*"},
}
 
response = requests.patch(url, headers=headers, data=json.dumps(data))

curl -X PATCH https://rest.netim.com/1.0/webhosting/NW1024/cron-task/ 
-H 'Authorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26=' 
-H 'Content-type: application/json' 
-d '{"action":"SetValues","params":{"idCronTask":"201", "path": "/cron.php", "returnMethod": "LOG", "returnTarget": "/log.txt", "mm": "5", "hh": "*", "jj": "*", "mmm": "*", "jjj": "*"},}'

Need an API client ?
Speed up your integration by using our API client for REST