{"base_path":"/","components":null,"consumes":"","definitions":{"DeviceData":{"description":"设备信息与协议参数。","properties":{"auxProtocol":{"$ref":"#/definitions/DeviceProtocol","description":"辅助协议。","type":"object"},"instance":{"additionalProperties":{"type":"object"},"description":"设备信息。支持添加服务器、服务器机框、路由器、防火墙、交换机和负均衡器设备,请参考《资源北向模型》,获取资源类型的属性列表。Map的key为资源的属性名,value为属性值,可参考请求示例。","type":"object"},"mainProtocol":{"$ref":"#/definitions/DeviceProtocol","description":"设备对接协议。服务器支持SNMP协议和Redfish+SNMP协议;网络设备支持SNMP协议。请参考《资源北向模型》,获取协议模型的属性列表。","type":"object"}}},"DeviceProtocol":{"description":"设备协议参数","properties":{"protocol":{"additionalProperties":{"type":"object"},"description":"协议信息。请参考《资源北向模型》,获取协议模型的属性列表。","type":"object"},"protocolType":{"description":"协议类型。","type":"string"}}},"ResourceReturnId":{"description":"资源实例ID","properties":{"id":{"description":"资源实例ID","type":"string"},"resId":{"description":"实例ID","type":"string"}}},"ResourceReturnIdList":{"description":"实例批量操作的返回结果","properties":{"idList":{"description":"资源实例ID列表","items":{"$ref":"#/definitions/ResourceReturnId"},"type":"array"}}}},"description":null,"group_id":"a58bba086da947389167b8c3715f7155","host":"hcs.cn-north-4.myhuaweicloud.com","id":"f73d16b36cd240fc85e1ccd0ba131854","info_version":"v1","method":"post","name":"CreateDevice","parameters":{},"paths":{"/rest/cmdb/v1/devices/{className}":{"post":{"consumes":["application/json"],"description":"添加物理设备,单次最多添加10条设备实例数据。\n\n**接口SLA:**\n\n|SLA项|定义|\n|-----|-----|\n|请求成功率| ≥ 99%|\n|可用性|Tier1|\n|数据一致性|最终一致,不一致时长<1分钟|\n|吞吐量|10 tps|\n|TP50请求时延|1000 ms|\n|TP99.9请求时延|2000 ms|","operationId":"CreateDevice","parameters":[{"description":"IAM_OP token、SSO token。","in":"header","name":"x-auth-token","required":true,"type":"string"},{"description":"资源类型名称","in":"path","name":"className","required":true,"type":"string"},{"description":"资源信息和资源对接协议","in":"body","name":"data","required":true,"schema":{"items":{"$ref":"#/definitions/DeviceData"},"type":"array"},"x-maxLength":100}],"produces":["application/json"],"responses":{"200":{"description":"创建资源实例成功。","examples":{"application/json":{"idList":[{"id":"97D998D842423F68B83C7B86FD667B91","resId":"97D998D842423F68B83C7B86FD667B91"}]}},"schema":{"$ref":"#/definitions/ResourceReturnIdList"}},"400":{"description":"参数错误。"},"403":{"description":"URL鉴权失败。"},"404":{"description":"rest接口未找到。"},"500":{"description":"默认ServiceException异常码,应用内部错误。"},"502":{"description":"网关错误。"},"503":{"description":"服务不可用。"},"504":{"description":"表示时间超时,总线超时时间300s。"},"888":{"description":"服务摘机,不提供服务。"}},"summary":"添加物理设备","tags":["资源管理"],"x-precautions":"使用前请参考《资源北向模型》,获取系统支持的资源类型、关系类型、请求body体、资源分类及属性列表。资源实例数据放在请求的body参数中。支持批量创建,数据格式为List<Map>形式,Map的key为资源的属性名,value为属性值,可参考请求示例。调用该接口需要“创建资源实例”权限,归属权限组:运维中心>资源实例管理。\n错误码:当请求不成功时,响应体内的错误码信息请参见“ManageOne 运维面API参考 > 错误码说明 > 资源管理特性”章节。\n","x-request-examples-1":[{"auxProtocol":{"protocol":{"authProtocol":"HMAC_SHA256","port":161,"privProtocol":"AES_256","protocolVersion":"V3","restPort":443,"retryTimes":3,"timeout":15},"protocolType":"SYS_SNMPProtocol"},"instance":{"deviceType":"rack","encCard":true,"ipAddress":"127.0.0.1","logicalRegionId":"88D998D842423F68B83C7B86FD667B66","name":"nbtest","sn":"sn1"},"mainProtocol":{"protocol":{"password":"xxxxx","restPort":443,"userName":"xxxx"},"protocolType":"SYS_RedfishProtocol"}}],"x-request-examples-description-1":"","x-request-examples-url-1":"POST https://{endpoint}/rest/cmdb/v1/devices/SYS_Switch","x-support-sdk":"N"}}},"product_short":"ManageOneOCHCS","region_id":"cn-north-4","schemes":["HTTPS"],"security_definitions":null,"summary":"添加物理设备","tags":"资源管理","uri":null,"version":"2.0"}