Skip to main content

/tasks/create/url

POST /tasks/create/url

Bir dosyayı bekleyen görevler listesine ekler. Yeni oluşturulan görevin kimlik bilgilerini döndürür.

Örnek request:

curl -H "Authorization: Bearer S4MPL3" -F url="http://www.malicious.site" http://localhost:8090/tasks/create/url

Python kullanılan örnek request:

import requests

REST_URL = "http://localhost:8090/tasks/create/url"
SAMPLE_URL = "http://example.org/malwr.exe"
HEADERS = {"Authorization": "Bearer S4MPL3"}

data = {"url": SAMPLE_URL}
r = requests.post(REST_URL, headers=HEADERS, data=data)

# Add your code to error checking for r.status_code.

task_id = r.json()["task_id"]

# Add your code to error checking if task_id is None.

Örnek response:

{
    "task_id" : 1
}

Form parametreleri:

  • url (zorunlu) - analiz edilecek URL (multipart kodlu içerik)
  • package (isteğe bağlı) - analiz için kullanılacak paket
  • timeout (isteğe bağlı) (int) - analiz süresi (saniye cinsinden)
  • priority (isteğe bağlı) (int) - göreve atanacak öncelik (1-3)
  • options (isteğe bağlı) - analiz paketine iletilmesi gereken seçenekler
  • machine (isteğe bağlı) - analiz için kullanılacak makinenin etiketi
  • platform (isteğe bağlı) - analiz makinesini seçmek için platform adı (örneğin "windows")
  • tags (isteğe bağlı) - makineyi etiketlere göre başlat. Bu kullanmak için platformun ayarlanmış olması gerekir. Etiketler virgülle ayrılır
  • custom (isteğe bağlı) - analiz ve işleme/bildirme modüllerine iletilmek üzere özel bir dize
  • owner (isteğe bağlı) - aynı cuckoo örneğine birden fazla kullanıcının dosya gönderebileceği durumda görev sahibi
  • memory (isteğe bağlı) - analiz makinesinin tam bellek dökümünün oluşturulmasını etkinleştir
  • enforce_timeout (isteğe bağlı) - yürütmenin tam süre boyunca zorlanmasını etkinleştir
  • clock (isteğe bağlı) - sanal makine saatinin ayarlanması (format %m-%d-%Y %H:%M:%S)

Durum kodları:

  • 200 - hata yok