AI云沙箱快速开始 | 大装置帮助中心
跳到主要内容

AI 云沙箱快速开始

本章节将介绍创建和使用 AI 云沙箱的整体流程。

开通AI云沙箱服务

新租户首次使用时,需要由租户管理员开通AI云沙箱服务。

创建AK/SK

用户角色需要先创建AKSK

点击右上角头像下的【AccessKey访问密钥】,进入密钥管理界面

AccessKey访问密钥

点击【创建访问密钥】,即可创建AKSK

创建访问密钥

创建访问密钥

创建快照

用户根据需求,选择对应的镜像,设定沙箱规格,创建沙箱快照。

目前每个租户可创建快照数量不超过10个。

创建快照

生成签名

目前沙箱的创建与使用需要通过 http api 的方式调用,接口调用采用了签名校验方式,需要根据ak/sk生成签名,具体操作方式可以参考API使用指南

调试阶段,可以使用Bearer 令牌方式进行调试,具体操作方式可以参考API使用指南

创建 AI 云沙箱

  1. 创建沙箱时,需要填入沙箱所属的租户工作空间id,目前每个租户仅支持一个工作空间,工作空间 id 可以在控制台,沙箱列表页面右上角获取。 查看工作空间id

  2. 目前 AI 云沙箱的创建仅提供了 http api 的方式,用户可以通过接口调用的方式创建云沙箱。调用示例如下:

注:

  • 目前文件存储仅支持创建沙箱时挂载,若有挂载需求,请在创建沙箱时,传入所需参数,挂载文件存储。
  • 创建云沙箱时,可以通过auto_delete_after设置沙箱存活时长,单位为秒,沙箱将在所设置的存活时长后自动删除
  • 更多 API 参数说明请参考sandbox api #创建沙盒

请求示例如下:


curl -L -X POST 'https://sandbox.cn-sh-01.sensecoreapi.cn/studio/sandbox/v1/workspaces/{workspace_id}/sandboxes'\

-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"name":"lzm-test2",
"snapshot": {
"id":"41c93984-0885-4d42-9807-8901d7808641" #需替换为实际所用的快照id
},
autoDeleteAfter":600
}'

使用云沙箱执行代码

沙箱创建完成后,用户可以使用沙箱进行文件上传下载操作和python代码执行。目前平台仅提供了 http api 的方式使用沙箱进行相关操作。下方为代码执行的调用示例:

更多功能请参考 api 说明

请求示例如下:

curl -L -X POST 'https://sandbox.cn-sh-01.sensecoreapi.cn/studio/sandbox/v1/workspaces/{workspace_id}/sandboxes/{sandbox_id}:execute'\

-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"code": "print(\"hello world\")",
"language": "python",
"execution_timeout": 60
}'

查看沙箱资源使用情况

目前平台根据沙箱的资源使用量进行计费,计费规则可以参考计费说明

具体使用量用户可以在控制台 -> AI 云沙箱 -> 资源统计页面查看。