创建计算实例。

调试

您可以在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：月计划
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
}

错误码

HttpCode 错误码 错误信息 描述
200 0 SUCCESS 请求成功
500 RequestFailed Request failed: %s 请求错误

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