/tasks/create/file

POST /tasks/create/file

Bir dosyayı bekleyen görevler listesine ekler. Yeni oluşturulan görevin kimliğini döndürür.

Örnek request:

curl -H "Authorization: Bearer S4MPL3" -F file=@/path/to/file http://localhost:8090/tasks/create/file

Python kullanılan örnek request:

import requests

REST_URL = "<http://localhost:8090/tasks/create/file>"
SAMPLE_FILE = "/path/to/malwr.exe"
HEADERS = {"Authorization": "Bearer S4MPL3"}

with open(SAMPLE_FILE, "rb") as sample:
    files = {"file": ("temp_file_name", sample)}
    r = requests.post(REST_URL, headers=HEADERS, files=files)

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

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

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

Örnek response:

{
    "task_id" : 1
}

Form parametreleri:

• file (zorunlu) - örnek dosya (multipart kodlu dosya içeriği)
• package (isteğe bağlı) - analiz için kullanılacak analiz paketi
• timeout (isteğe bağlı) (int) - analiz süresi aşımı (saniye cinsinden)
• priority (isteğe bağlı) (int) - göreve atanacak öncelik (1-3)
• options (isteğe bağlı) - analiz paketine iletmek için seçenekler
• machine (isteğe bağlı) - analiz için kullanılacak analiz makinesinin etiketi
• platform (isteğe bağlı) - analiz makinesini seçmek için platform adı (örneğin "windows")
• tags (isteğe bağlı) - makineyi başlatmak için etiketlere göre tanımlama. Bu kullanıldığında
• platformun ayarlanmış olması gerekir. Etiketler virgülle ayrılır
• custom (isteğe bağlı) - analiz ve işleme/bildirme modüllerine geçirilmek üzere özel bir dize
• owner (isteğe bağlı) - birden fazla kullanıcının aynı cuckoo örneğine dosya gönderebileceği durumlarda görev sahibi
• clock (isteğe bağlı) - sanal makine saatinin ayarlanması (biçim %m-%d-%Y %H:%M:%S)
• memory (isteğe bağlı) - analiz makinesinin tam bellek dökümü oluşturmayı etkinleştirme
• unique (isteğe bağlı) - daha önce analiz edilmemiş örnekleri yalnızca gönderme
• enforce_timeout (isteğe bağlı) - tam zaman aşımı değerini zorlamak için etkinleştirme

Durum kodları:

• 200 - hata yok
• 400 - yinelenen dosya tespit edildi (unique seçeneği kullanılıyorsa)