创建新的设备

调试

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

请求参数

名称 类型 是否必选 示例值 描述
DeviceFormId String form-u4ilnhu64h026lrf

设备形态ID

PhysicalSpaceId String space-ez6zd3w68ma4fsd4

物理空间ID

HostName String HZYT_USG6620_A

主机名

Ip String 10.17.101.1

设备IP

Sn String 210235951910K7000016

设备SN

Mac String b8:27:eb:34:3b:a2

设备MAC地址

Vendor String Huawei

设备厂商

Model String USG6620

设备型号

ServiceStatus String online

设备状态

SecurityDomain String IT

设备安全域

LoginType String SSH,TELNET

登录类型

LoginUsername String admin

登录账号

LoginPassword String 123456

登录密码

SnmpAccountVersion String v3

SNMP 版本号

SnmpCommunity String 123456

SNMP Community

SnmpAccountType String get

SNMP 账号类型

SnmpSecurityLevel String AUTH_PRIV

SNMP 安全级别

SnmpUsername String admin

SNMP 用户名

SnmpAuthPassphrase String 123456

SNMP Auth PassPhrase

SnmpAuthProtocol String MD5

SNMP Auth Protocol

SnmpPrivacyPassphase String 123456

SNMP Privacy Passphase

SnmpPrivacyProtocol String DES

SNMP Privacy Protocol

ExtAttributes String {"role":"ASW"}

设备额外属性

ClientToken String 9388616d-2d78-48c9-87b7-3d1083c91a79

幂等校验 token

返回数据

名称 类型 示例值 描述
RequestId String fdb2af01-bd56-4034-812b-f257f73b4690

Id of the request

DeviceId String device-evve560juend5owh

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

示例

请求示例

http(s)://[Endpoint]/?SnmpCommunity=123456
&SnmpAccountVersion=v3
&SnmpUsername=admin
&LoginUsername=admin
&Ip=10.17.101.1
&Vendor=Huawei
&Mac=b8:27:eb:34:3b:a2
&SnmpSecurityLevel=AUTH_PRIV
&ExtAttributes={"role":"ASW"}
&SecurityDomain=IT
&SnmpAuthPassphrase=123456
&SnmpAuthProtocol=MD5
&SnmpPrivacyProtocol=DES
&DeviceFormId=form-u4ilnhu64h026lrf
&SnmpAccountType=get
&SnmpPrivacyPassphase=123456
&ServiceStatus=online
&Model=USG6620
&PhysicalSpaceId=space-ez6zd3w68ma4fsd4
&Sn=210235951910K7000016
&LoginType=SSH,TELNET
&ClientToken=9388616d-2d78-48c9-87b7-3d1083c91a79
&HostName=HZYT_USG6620_A
&LoginPassword=123456
&公共请求参数

正常返回示例

XML格式

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

<RequestId>fdb2af01-bd56-4034-812b-f257f73b4690</RequestId>
<DeviceId>device-evve560juend5owh</DeviceId>

JSON格式

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

{
  "RequestId" : "fdb2af01-bd56-4034-812b-f257f73b4690",
  "DeviceId" : "device-evve560juend5owh"
}

错误码

HttpCode 错误码 错误信息 描述
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. 找不到对应资源

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

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