创建计算实例

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateComputeInstance

系统规定参数。取值:CreateComputeInstance

InstanceName String 这是一个任务

实例名称

PicType String 已废弃

已废弃

PicTopic String 已废弃

已废弃

AlgorithmType String PICTURE

算法类型

  • REALTIME_STREAM:实时码流(视频)
  • PICTURE:图片
AcuUsed Long 废弃

已废弃

StorageUsed String 已废弃

已废弃

ProjectId String 2

项目ID

Devices Array

设备列表

RegionId String huadong

设备所属地域

DeviceId String 1

设备id

BitRate String 4Mbps

码率

CodingFormat String H264

编码格式H264/H265

ResolvingPower String 1080p

分辨率 1080p/720p等

StartStream Boolean true

是否启动拉流

  • true:启动拉流
  • false:不启动拉流
Algorithms Array

算子列表

AlgorithmId String 1

算子id

AlgorithmName String 人脸算法

算子名称

ScheduleDay String 1

每天=1,每周=7,每月=30

ScheduleDaySize String 已废弃

已废弃

ScheduleType String EVERYDAY

调度类型,取值范围:

  • EVERYDAY:每天定时执行,
  • ONCE:仅执行一次,EVERY_WEEK:周计划,
  • EVERY_MONTH:月计划 EVERYDAY
ScheduleCycleDate String 1,4,6

ScheduleType为EVERY_WEEK、EVERY_MONTH时需填。

  • EVERY_MONTH:可填0~31,每个数字代表月内某一天。比如想设置每月1日、20日、25日、28日的执行任务,则填写"1,20,25,28"
  • EVERY_WEEK: 可填1~7,每个数字代表周内某一天。比如想设置每周周一、周四、周六,则填写"1,4,6"
ScheduleTimes String [{"StartTime":"10:00:00","EndTime":"11:00:00"}]

调度执行时间段(scheduleType为EVERYDAY、EVERY_WEEK、EVERY_MONTH时需填)要有时段重合校验。需以JSON格式填写StartTime和EndTime,格式为时分秒(HH:mm:ss)

IsPolling Boolean true

是否启用轮询分析(计划任务)

  • true:启用
  • false:不启用
SliceExecutionTime String 60

启用轮询分析后必填。每次分析n秒钟视频

OverallExecutionTime String 10

启用轮询分析后必填。间隔n分钟分析一次

PollingConfigs String 已废弃

已废弃

DatasourceType String REALTIME_STREAM

数据类型,取值范围:

  • REALTIME_STREAM:实时码流(视频)
  • PICTURE:图片
  • VIRTUAL_VIDEO: 虚拟视频
ComputePictureType String spf

抽帧频率单位 spf 。默认:spf

ComputePictureValue String 1

抽帧值

IsFrameExtraction String 0

是否启用图片分析 0启用,1不启用

返回数据

名称 类型 示例值 描述
Message String SUCCESS

错误信息

RequestId String D001BEB9-A281-4BF0-B595-512A5CBDC122

RequestID

Data Object

返回数据

AcuUsed Long 1

acu用量

InstanceId String 123

实例id

Code String 0

返回code码

Success Boolean true

是否请求成功

示例

请求示例

http(s)://[Endpoint]/?Action=CreateComputeInstance
&InstanceName=这是一个任务
&PicType=已废弃
&PicTopic=已废弃
&AlgorithmType=PICTURE
&StorageUsed=已废弃
&ProjectId=2
&Devices=[{"RegionId":"huadong","DeviceId":"1","BitRate":"4Mbps","CodingFormat":"H264","ResolvingPower":"1080p","StartStream":true}]
&Algorithms=[{"AlgorithmId":"1","AlgorithmName":"人脸算法"}]
&ScheduleDay=1
&ScheduleDaySize=已废弃
&ScheduleType=EVERYDAY
&ScheduleCycleDate=EVERY_WEEK
&ScheduleTimes=[{"StartTime":"10:00:00","EndTime":"11:00:00"}]
&IsPolling=true
&SliceExecutionTime=60
&OverallExecutionTime=10
&PollingConfigs=已废弃
&DatasourceType=REALTIME_STREAM
&ComputePictureType=spf
&ComputePictureValue=1
&IsFrameExtraction=0
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateComputeInstanceResponse>
    <Message>SUCCESS</Message>
    <RequestId>D001BEB9-A281-4BF0-B595-512A5CBDC122</RequestId>
    <Data>
        <AcuUsed>1</AcuUsed>
        <InstanceId>123</InstanceId>
    </Data>
    <Code>0</Code>
    <Success>true</Success>
</CreateComputeInstanceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Message" : "SUCCESS",
  "RequestId" : "D001BEB9-A281-4BF0-B595-512A5CBDC122",
  "Data" : {
    "AcuUsed" : 1,
    "InstanceId" : "123"
  },
  "Code" : "0",
  "Success" : true
}

错误码

访问错误中心查看更多错误码。