创建新的设备形态

调试

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

请求参数

名称 类型 是否必选 示例值 描述
DeviceFormName String 网络设备

设备形态名称

ConfigCompare Boolean true

是否支持配置生成

AccountConfig Boolean true

是否需要账号配置

DetailDisplay Boolean true

是否展示设备详情

UniqueKey String SN

设备形态的主键

ClientToken String c6aaac41-8cfa-4952-bb1c-1ad9617ab23f

幂等校验 token

InstanceId String cmn-cn-xxxx

实例ID

返回数据

名称 类型 示例值 描述
DeviceFormId String form-u4ilnhu64h026lrf

资源实例ID,如ECS实例的创建接口CreateInstance应返回InstanceId。

RequestId String 6d439436-ddde-4f26-aaf6-0470099b5c35

Id of the request

示例

请求示例

http(s)://[Endpoint]/?ConfigCompare=true
&DeviceFormName=网络设备
&UniqueKey=SN
&DetailDisplay=true
&ClientToken=c6aaac41-8cfa-4952-bb1c-1ad9617ab23f
&AccountConfig=true
&公共请求参数

正常返回示例

XML格式

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

<DeviceFormId>form-u4ilnhu64h026lrf</DeviceFormId>
<RequestId>6d439436-ddde-4f26-aaf6-0470099b5c35</RequestId>

JSON格式

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

{
  "DeviceFormId" : "form-u4ilnhu64h026lrf",
  "RequestId" : "6d439436-ddde-4f26-aaf6-0470099b5c35"
}

错误码

HttpCode 错误码 错误信息 描述
400 Duplicate%s%s The %s %s value is already occupied. 资源属性值已经被占用
400 Missing%s You must specify the parameter %s. 必填参数没有填。请检查调用时是否填写了此参数,并重试请求。
400 IdempotentParameterMismatch The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. 用了一个已经使用过的 ClientToken,但此次请求内容却又与上一次使用该 Token 的 request 不一样。
400 InvalidParameter%s The specified parameter %s is invalid. 参数无效,请检查参数

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

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