AI 云沙箱快速开始
本章节将介绍创建和使用 AI 云沙箱的整体流程。
开通AI云沙箱服务
新租户首次使用时,需要由租户管理员开通AI云沙箱服务。
创建AK/SK
用户角色需要先创建AKSK
点击右上角头像下的【AccessKey访问密钥】,进入密钥管理界面
点击【创建访问密钥】,即可创建AKSK
创建快照
用户根据需求,选择对应的镜像,设定沙箱规格,创建沙箱快照。
目前每个租户可创建快照数量不超过10个。
生成签名
目前沙箱的创建与使用需要通过 http api 的方式调用,接口调用采用了签名校验方式,需要根据ak/sk生成签名,具体操作方式可以参考API使用指南。
调试阶段,可以使用Bearer 令牌方式进行调试,具体操作方式可以参考API使用指南
创建 AI 云沙箱
创建沙箱时,需要填入沙箱所属的租户工作空间id,目前每个租户仅支持一个工作空间,工作空间 id 可以在控制台,沙箱列表页面右上角获取。
目前 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 云沙箱 -> 资源统计页面查看。