执行任务

POST https://sandbox.cn-sh-01.sensecoreapi.cn/studio/sandbox/v1/workspaces/{workspace_id}/sandboxGroups/{sandbox_group_id}:execute

请求头（Request Header）

请参考API 使用指南

请求参数（Request Parameters）

名称	类型	必须	位置	描述
workspace_id	string	是	path	工作空间id，获取方式可以参考快速开始
sandbox_group_id	string	是	path	沙盒组id
execute_content	object	是	body	执行内容

其中execute_content的参数如下：

名称	类型	必须	位置	描述
sandbox_id	string	否	body	沙盒实例id，若不传入，系统将从沙盒组中任选一个沙盒实例进行任务执行
code	string	是	body	待执行代码
language	string	是	body	编程语言,当前仅支持python
execution_timeout	integer	否	body	代码执行超时时间，单位为秒，可设置范围为(0,300]，默认值为60秒。该参数仅设置接口中代码执行部分的超时，整体接口超时时间为10分钟，包含数据上传下载以及代码执行。
stdin	string	否	body	标准输入
upload_files	object	否	body	上传文件内容，key：value形式，其中key中需要填写文件在沙盒中的存放路径，value为文件base64内容
fetch_files	array	否	body	任务执行后需要获取的文件路径

请求示例（Request Example）

curl -L -X POST 'https://sandbox.cn-sh-01.sensecoreapi.cn/studio/sandbox/v1/workspaces/01993ca4-edfa-7382-8161-43a4919681ab/sandboxGroups/c8e381e5-491c-47cf-842b-aacf914a8c35:execute' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw  '{
    "execute_content":{
        "code":"print('\''Hello World!'\'')",
        "language":"python"
    }
}'

响应（Response）

异常情况请参考异常响应说明

字段	类型	描述
sandbox_id	string	执行任务所用的sandbox_id
result	object	执行结果
files	object	下载的文件内容，key:value形式，key中为文件路径，value中为文件内容base64编码，若为空，则不返回该字段

其中，result的参数如下：

字段	类型	描述
exit_code	int32	退出码
stdout	string	标准输出
stderr	string	标准错误
execution_time	int64	执行耗时（毫秒）

响应示例（Response Example）

• 正常响应

{
    "result": {
        "stdout": "Hello World!\n",
        "sandbox_id": "1456826b-5f89-41fd-90b0-77b2b464d5ba"
    },
    "sandbox_id": "1456826b-5f89-41fd-90b0-77b2b464d5ba"
}