startCommandExecutionOnEndpoint — endpoint дээр команд ажиллуулах

Энэ method-оор endpoint дээр командыг алсаас ажиллуулж, гарсан үр дүнг лог файл болгон GravityZone-ийн төвлөрсөн хадгалалтад байршуулна.

API URL: CONTROL_CENTER_APIs_ACCESS_URL/v1.0/jsonrpc/investigation.

Parameters

• targetId — Заавал; төрөл: String. Команд ажиллуулах endpoint-ийн ID. Таны компани доторх BEST-ээр хамгаалагдсан endpoint-ийн хүчинтэй ID байх ёстой бөгөөд яг 24 арван зургаатын (hexadecimal) тэмдэгт агуулна.
• command — Заавал; төрөл: String. Endpoint дээр ажиллуулах shell команд. Дээд урт: 10,000 тэмдэгт.

General parameters

Эдгээр нь public API-ийн бүх method-д нийтлэг хэрэглэгддэг параметрүүд юм:

• id — Заавал; төрөл: String. Хүсэлтэд танигч нэмж, түүнийг хариутай холбоно. Хүлээн авагч хариунд ижил утгыг буцаадаг тул дуудлагыг хялбар мөрдөнө. Нэмэлт шаардлага байхгүй. Жишээ: "id": "ad12cb61-52b3-4209-a87a-93a8530d91cb"
• method — Заавал; төрөл: String. Хүсэлт илгээхэд ашиглаж буй method-ийн нэр. Хүчинтэй method-ийн нэр байх ёстой. Жишээ: "method": "methodName"
• jsonrpc — Заавал; төрөл: String. Хүсэлт болон хариуны ашигладаг JSON-RPC-ийн хувилбар. Цорын ганц боломжит утга нь 2.0. Жишээ: "jsonrpc": "2.0"
• params — Заавал; төрөл: Object. Хүсэлтийн тохиргоог агуулсан объект. Нэмэлт шаардлага байхгүй. Жишээ: "params": {...}

Return value

• result — төрөл: String. API нь үүсгэсэн даалгаврын ID-г буцаана.

> Зөвлөмж: Даалгавар дууссаны дараа командын гаралтын лог агуулсан архивын татах URL-ийг авахын тулд энэ утгыг `getInvestigationFileUrl`-ийн activityId параметрт ашиглана. Лог файлыг GravityZone Control Center-ээс шууд татаж болно: Network хэсгээс endpoint-ийн дэлгэрэнгүйг нээж, Investigation таб руу орно.

Example

Request:

{
    "jsonrpc": "2.0",
    "method": "startCommandExecutionOnEndpoint",
    "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
    "params": {
        "targetId": "559bd17ab1a43d241b7b23c6",
        "command": "ping -n 5 127.0.0.1"
    }
}

Response:

{
    "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
    "jsonrpc": "2.0",
    "result": "559bd17ab1a43d241b7b23d7"
}