创建新的设备属性
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
DeviceFormId | String | 是 | form-u4ilnhu64h026lrf |
设备形态ID |
PropertyName | String | 是 | 厂商型号 |
属性名称 |
PropertyKey | String | 是 | device_model |
属性主键 |
PropertyFormat | String | 是 | JSON |
属性格式 |
PropertyContent | String | 是 | { "H3C": [ "H3C S6800", "S6850-56HF" ], "Huawei": [ "CE6851-48S6Q" ] } |
属性内容 |
ClientToken | String | 是 | a611d038-2047-4e5b-91f2-f184c295df45 |
幂等校验 token |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DevicePropertyId | String | property-z50wex75a1lkx7vx |
资源实例ID,如ECS实例的创建接口CreateInstance应返回InstanceId。 |
RequestId | String | 1f598491-db6d-4276-a83a-3b5f57d4a4e1 |
Id of the request |
示例
请求示例
http(s)://[Endpoint]/?DeviceFormId=form-u4ilnhu64h026lrf
&PropertyName=厂商型号
&PropertyFormat=JSON
&PropertyContent={ "H3C": [ "H3C S6800", "S6850-56HF" ], "Huawei": [ "CE6851-48S6Q" ] }
&ClientToken=a611d038-2047-4e5b-91f2-f184c295df45
&PropertyKey=device_model
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DevicePropertyId>property-z50wex75a1lkx7vx</DevicePropertyId>
<RequestId>1f598491-db6d-4276-a83a-3b5f57d4a4e1</RequestId>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DevicePropertyId" : "property-z50wex75a1lkx7vx",
"RequestId" : "1f598491-db6d-4276-a83a-3b5f57d4a4e1"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Duplicate%s%s | The %s %s value is already occupied. | 资源属性值已经被占用 |
400 | InvalidParameter%s | The specified parameter %s is invalid. | 参数无效,请检查参数 |
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 不一样。 |
404 | Invalid%s.NotFound | The specified resource %s does not exist. | 找不到对应资源 |
访问错误中心查看更多错误码。
访问错误中心查看更多错误码。