-
1、场景说明客户已经有成熟的统一性能监控平台,需要HCS将各类云资源、物理资源等相关性能数据上报完成统一监控管理2、使用流程能监控通过采集监控对象性能指标,帮助运维人员发现潜在风险,并及时通知。ManageOne运维侧支持服务器、存储、网络设备的性能集中监控,系统可以周期的从服务器、虚拟机采集各类性能指标并进行统计分析。ManageOne运维侧还支持对于性能指标还可以设置阈值告警,当指标超过阈值时,系统会产生告警。ManageOne运维侧对外开放性能查询的RESTful接口,第三方可以通过调用这些接口获取所需要的监控指标值。查询性能数据有如下约束:不是所有资源类型都支持性能查询,首先要通过查询监控对象类型来确认资源的类型是否支持。性能查询接口一次只能查询一种类型的性能数据,而且所有的指标必须都属于这个类型。对于每个ManageOne平台,通过北向接口查询获取到的监控对象类型id(obj_type_id),以及每个监控对象类型所支持的监控指标(indicators)和指标Id是固定的,获取到这些Id之后可以存储在本地,不需要再调运维侧接口获取流程如下:具体步骤如下:首先查询监控对象类型,只有在这些类型里面的资源才可以查询性能数据。根据查出的监控类型查询资源数据,获取资源ID。 根据监控类型查询此类型支持的指标,查询结果为指标的ID列表。根据资源ID和指标ID查出该资源的指定指标的具体数值。查询出的结果只显示指标ID,因此还要调用根据指标ID查询指标描述的接口。 组合指标数值和指标描述,得到完整的性能信息。查询最新性能:查询最新性能数据,返回最近60分钟内的一条最新数据(包含第60分钟)。接口详细描述参考《ManageOne 6.5.1 运维面北向API参考》。接口调用约束:l 每次传入的监控对象(obj_ids)数*监控指标(indicator_ids)数不大于100。l 指标ID列表(indicator_ids)必须属于监控类型(obj_type_id)。l 资源ID列表(obj_ids)必须属于监控类型(obj_type_id)。查询步骤: 步骤1: 获取Token后面的步骤都需要在请求的header里面加上X-Auth-Token参数。接口调用示例如下:调用方法:PUT调用URL:https://{运维侧对外访问域名}/rest/plat/smapp/v1/oauth/token请求头:Accept:application/json Content-Type:application/json;charset=UTF-8请求body:{ "grantType": "password", "userName": "XXX", "value": "***"}响应示例:{ "accessSession": "xxxxxxxxxxxxx", "roaRand": "xxxxxxxxxxxxx", "expires": 1800, "additionalInfo": null}accessSession的值即为token值步骤2 获取监控类型列表 此处以CLOUD_VM为例,获取obj_type_id,接口调用示例如下:调用方法:GET调用URL:https://{运维侧对外访问域名}/rest/performance/v1/mgr-svc/obj-types请求头:Accept:application/json Content-Type:application/json;charset=UTF-8 X-Auth-Token:xxxxxxxxxxxxx响应示例(部分示例):{ "status_code": 200, "error_code": 0, "error_msg": "Successful", "data": [ { "obj_type_id": 562958543355904, "parent_obj_type_id": 1407379178520576, "resource_category": "CLOUD_VM", "resource_provider": "ict-resource", "en_us": "Elastic Cloud Server", "zh_cn": "弹性云服务器", "group_en_us": "Cloud Resource", "group_zh_cn": "云资源" }, { "obj_type_id": 562967133290496, "parent_obj_type_id": 0, "resource_category": "CLOUD_VOLUME", "resource_provider": "ict-resource", "en_us": "Elastic Volume", "zh_cn": "云硬盘", "group_en_us": "Cloud Resource", "group_zh_cn": "云资源" } ] }在响应体中找到 resource_category": "CLOUD_VM", 的类型项,查询到CLOUD_VM对应的obj_type_id为562958543355904。步骤3 查询监控类型支持的指标ID列表此处列出了CLOUD_VM所有支持的指标ID,接口调用示例如下:调用方法:GET调用URL:https://{运维侧对外访问域名}/rest/performance/v1/mgr-svc/obj-types/562958543355904/indicators,562958543355904为上一步查询所得的CLOUD_VM的监控类型Id请求头:Accept:application/json Content-Type:application/json;charset=UTF-8 X-Auth-Token:xxxxxxxxxxxxx响应示例:{ "status_code": 200, "error_code": 0, "error_msg": "Successful", "data": { "indicator_ids": [ 562958543421441, 562958543486979, 562958543552537, 562958543552538, 562958543552539, 562958543552550, 562958543618052, 562958543618061, 562958543618062, 562958543618067, 562958543618068, 562958543618071, 562958543618072, 562958543618073, 562958543618074, 562958543618075, 562958543618076, 562958543618077, 562958543618078, 562958543618079, 562958543618080, 562958543618081, 562958543618082 ] } }返回的indicator_ids的值即为CLOUD_VM所有支持的指标ID步骤4 查询指标含义调用方法:POST调用URL:https://{运维侧对外访问域名}/rest/performance/v1/mgr-svc/indicators请求头:Accept:application/json Content-Type:application/json;charset=UTF-8 X-Auth-Token:xxxxxxxxxxxxx请求体:[562958543421441,562958543618075]响应示例:{ "status_code": 200, "error_code": 0, "error_msg": "Successful", "data": { "562958543618075": { "kpi": 0, "data_type": "float", "data_unit": "KB/s", "en_us": "Outband Outgoing Rate", "zh_cn": "带外网络流出速率", "group_en_us": null, "group_zh_cn": null, "tag": "", "alarm_id": null, "alarm_desc_en_us": null, "alarm_desc_zh_cn": null, "indicator_name": "network_outgoing_bytes_aggregate_rate" }, "562958543421441": { "kpi": 1, "data_type": "float", "data_unit": "%", "en_us": "CPU Usage", "zh_cn": "CPU使用率", "group_en_us": null, "group_zh_cn": null, "tag": "CLOUD_VM_USAGE", "alarm_id": null, "alarm_desc_en_us": null, "alarm_desc_zh_cn": null, "indicator_name": "cpuUsage" } }}注:租户资源来源系统基本上都为FSP,物理资源大多为eSight,少数为ZOHO系统,请根据实际环境对接系统过滤性能指标统一模型参考文档中'Source System Type'列,获取支持的指标ID,其中指标ID在ManageOne各版本均为固定值不会随版本变动。步骤5 查询资源列表此处随机查询1台租户虚拟机(类型名称为CLOUD_VM)记录,获取其ID。接口调用示例如下:调用方法:GET调用URL:https://{运维侧对外访问域名}/rest/tenant-resource/v1/instances/CLOUD_VM?pageNo=1&pageSize=1000请求头:Accept:application/json Content-Type:application/json;charset=UTF-8 X-Auth-Token:xxxxxxxxxxxxx响应示例:{ "objList": [ { "ownerType": "compute", "extraSpecs": "{\"ips\":\"@192.168.0.129@\",\"cpuCoreNum\":4}", "azoneName": "az7.dc7", "privateIps": "@192.168.0.129@", "regionName": "Global", "flavorId": "8776AA3F93593999A48DC545CCB03E30", "clusterId": "5B16AC1483F634BAA0F040EB08D708BA", "ownerId": "0D9ECCF86FF337C08E5DB07FA5CFE2C7", "cloudLocationName": "华为", "createdAt": "2019-05-29T09:30:02Z", "powerState": "1", "taskState": "", "tenantName": "", "cloudType": "localcloud", "clusterName": "HostGroup1", "id": "D912DA2B8D0639708A7D5726DD66C4CD", "last_Modified": 1559122262393, "vdcId": "fc9b5ace-5650-481f-9c24-060140e9ca16", "podId": "27A0BDF03E1E3A56A6C6F0775A977553", "bizRegionId": "853FFE094A6D339E97E84AD6BF06A531", "imageId": "AC5AE9DB90A43041B6249711FD7B0DA4", "floatingIp": "", "hostId": "D3711A402B753D23A1D058EF203007B9", "hypervisorType": "kvm", "resId": "D912DA2B8D0639708A7D5726DD66C4CD", "userId": "6354cbc75cd14acab09307a8d78d1622", "resourcePoolName": "OpenStack_sa-fb-1", "tags": "", "class_Name": "CLOUD_VM", "azoneId": "97122CC306D53D6584278F5D04210618", "physicalHostId": "D3711A402B753D23A1D058EF203007B9", "regionId": "C4CA4238A0B933828DCC509A6F75849B", "resourcePoolId": "25216A596C493169B7D106ECB32E83F8", "name": "ecs-5aa6-wp", "tenantId": "", "vdcName": "wp_vdc", "nativeId": "162cf72b-4dab-45cf-84e6-5e4b87ca0783", "launchedAt": "2019-05-29T09:30:12.000000", "cloudLocationId": "85E0C89C436633E48292592CFE55B7BB", "projectId": "e711f3cb1be84d87934123b94f2198e7", "vmState": "active", "bizRegionName": "华南地区", "cpuCoreNum": "4", "status": "active" } ], "totalNum": 47, "pageSize": 1, "totalPageNo": 47, "currentPage": 1 }获取租户虚拟机的资源ID(resId字段)。此处为:"resId": "D912DA2B8D0639708A7D5726DD66C4CD"步骤6 查询性能查询性能数据,根据传入参数中的"range"字段所取的枚举值或从开始到结束时间范围内的查询数据。有汇聚数据情况下,返回结果序列是平均值序列,并包含最大值、最小值以及对应时间戳。接口详细描述参考《ManageOne 6.5.X/8.X 运维面API参考 》。约束:l 每次传入的监控对象(obj_ids)数*监控指标(indicator_ids)数不大于100。l 指标ID列表(indicator_ids)必须属于监控类型(obj_type_id)。l 资源ID列表(obj_ids)必须属于监控类型(obj_type_id)。请求示例:调用方法:POST调用URL:https://{运维侧对外访问域名}/rest/performance/v1/data-svc/history-data/action/query请求头:Accept:application/json Content-Type:application/json;charset=UTF-8 X-Auth-Token:xxxxxxxxxxxxx请求体:(obj_type_id从步骤2获取;indicator_ids从步骤3获取;obj_ids从步骤5获取){ "obj_type_id": "562958543355904", "indicator_ids": ["562958543421441"], "obj_ids": ["D912DA2B8D0639708A7D5726DD66C4CD"], "range": "LAST_1_HOUR", "interval": "MINUTE"}响应体:{ "data": { "D912DA2B8D0639708A7D5726DD66C4CD": { "562958543421441": { "avg": { "1468483570000": "5.97" }, "min": { "1468483570000": "5.72" }, "max": { "1468483630000": "6.509" }, "series": [{ "1468483570000": "5.72" }, { "1468483575000": "5.72" }, { "1468483630000": "6.509" }, { "1468483635000": "6.509" }, { "1468483690000": "5.80" }, { "1468483695000": "5.80" }] } } }, "errorCode": 0, "errorMsg": "Successful.", "statusCode": 200}至此,我们查询得到了对应指标的最新采集值。结合步骤4,可以得知响应体中每个指标的含义。下面对历史性能查询接口中时间范围的取值进行说明,首先我们对其中几个关键参数的含义进行说明,如下表:参数名类型值域参数含义intervalStringMINUTE(分钟)HOUR(小时)DAY(天)WEEK(星期)MONTH(月)代表历史性能数据的采样间隔,该参数需要配合range参数使用,interval的值需要是range中支持的采样间隔,比如:range选择LAST_5MINUTE(最近5分钟),interval就只能是MINUTE(分钟);如果range选择LAST_1_HOUR,interval也只能选择MINUTE,而不能是HOUR等其他参数rangeStringLAST_5_MINUTE(最近5分钟,返回数据粒度为分钟,由于底座和ManageOne的时间可能存在误差,最近5分钟可能查询不到数据,此情况下建议取最近1小时的数据)LAST_1_HOUR(最近1小时,返回数据粒度为分钟)LAST_1_DAY(最近1天,返回数据粒度支持分钟、小时,默认按小时返回)LAST_1_WEEK(最近1星期,返回数据支持分钟、小时、天,默认按天返回)LAST_1_MONTH(最近1个月,返回数据支持分钟、小时、天、星期默认按星期返回)LAST_1_QUARTER(最近一个季度,返回数据支持分钟、小时、天、星期、月,默认按月返回)HALF_1_YEAR(最近半年,返回数据支持分钟、小时、天、星期、月、季度,默认按季度返回)LAST_1_YEAR(最近1年,返回数据支持分钟、小时、天、星期、月、季度、半年,默认按半年返回)BEGIN_END_TIME(自定义时间段)INVALID(无效时间)默认值:INVALID代表历史性能数据的时间范围,支持您查询最近5分钟、1小时到最近1年的数据,返回数据的粒度,最低为1分钟,最大为半年;range参数取值为BEGIN_END_TIME时,支持您自定义时间范围去获取数据,需配合begin_time、end_time两个参数使用。begin_timeint64无,取值为毫秒格式表示的时间查询开始时刻,必须比 end_time 小,仅 range 为 BEGIN_END_TIME 时生效end_timeint64无,取值为毫秒格式表示的时间查询结束时刻,必须比 begin_time大,仅 range 为 BEGIN_END_TIME 时生效补充说明:分钟粒度的性能数据保存7天,小时粒度的性能数据,保存2年下面给出常用的几种查询指定时间段历史性能数据的方式:1、如果您需要定时采集历史性能数据并入库,建议您设置采集周期为1小时,每次采集最近1小时的数据,这样您每次可以获取到指定资源在最近一小时内的数据,每天只需要采集24次,粒度为分钟,示例如下:{ "obj_type_id": "562958543355904", //监控对象类型Id "indicator_ids": ["562958543421441"], //指标Id,支持多个 "range": "LAST_1_HOUR", "interval": "MINUTE", "obj_ids": ["7786B94E1DC7374FBEB4DBDF9D7384F0"]//资源Id,支持多个}2、如果您需要补采指定时间段内的性能数据,您可参考如下方式:{ "obj_type_id": "562958543355904", //监控对象类型Id "indicator_ids": ["562958543421441"], //指标Id,支持多个 "range": "BEGIN_END_TIME", //固定值 "interval":"MINUTE", //根据指定的时间段范围确定,比如,begin_time为2020-02-20 00:00:00,end_time为2020-02-25 00:00:00共5天,那么我们可以设置采样粒度为分钟、小时、天 "begin_time":1582163984000, //采集开始时间,毫秒串格式,必须比begin_time小 "end_time":1582682384000, //采集结束时间,毫秒串格式,必须比begin_time大 "obj_ids": ["7786B94E1DC7374FBEB4DBDF9D7384F0"] //资源Id,支持多个}
-
1、场景说明客户已有统一告警管理平台,需要HCS的告警上报实现统一管理流程 2、使用流程2.1准备工作第三方运维系统需要通过SNMP方式与ManageOne运维面对接时,需要做一些准备工作,才能完成与ManageOne运维面进行对接。2.1.1 获取接口文档接口文档可联系华为工程师从华为官网下载,下载链接参考: cid:link_1 第5章节。请结合现网具体交付的版本下载接口文档,若需要英文版接口文档,点击浏览器右上角切换语言,即可获得。下载得到的华为云Stack解决方案的完整接口文档,我们打开压缩包,提取ManageOne API参考文档包,然后打开该文档包,找出下图红框标注的文档(以6.5.1接口文档接口为例,适用于8.x版本):各文档作用说明如下:《ManageOne-NBI-Alarm-MIB-V1.mib》:运维侧SNMP Trap上报告警的MIB文件,采用SMI(Structure of Management Information)V1描述《ManageOne-NBI-Alarm-MIB-V2.mib》:运维侧SNMP Trap上报告警的MIB文件,采用SMI(Structure of Management Information)V2描述《ManageOne 6.5.1 北向告警SNMP接口开发指南 03.doc》:SNMP Trap对接开发指南,讲述了ManageOne 6.5.1运维侧的SNMP接口能力和OID描述(实时告警的OID描述,参考该文档的3.1章节)说明:《ManageOne-NBI-Alarm-MIB-V1.mib》和《ManageOne-NBI-Alarm-MIB-V2.mib》需要提供给第三方网管系统,以便解析ManageOne 运维侧上报的告警信息,一般提供V2版本即可2.1.2 获取第三方网管系统SNMP配置信息ManageOne 6.5.x/8.x运维侧支持SNMPv1、SNMPv2C、SNMPv3协议,安全起见,建议对接时第三方网管使用SNMPv3版本与ManageOne运维侧进行对接。如果现网需要使用SNMPv1、SNMPv2C,请在征得客户同意后,联系ManageOne维护接口人,修改ManageOne支持的SNMP协议范围。以SNMPv3协议为例,需要第三方网管提供的信息有:配置项示例第三方网管的IP地址192.168.1.1第三方网管SNMP服务监听的端口号162协议版本号SNMPv3安全用户名thirdSnmpServer授权认证密码 数据加密密码 发送告警Trap的编码(第三方网管为接收方)UTF-8鉴权协议SHA加密协议AES-1282.1.3网络预配置为保证运维侧告警能顺利推送给第三方网管,需要确保ManageOne运维侧以下节点IP可以访问第三方网管的SNMP监听端口,访问关系如下:源端(可从LLD中获取以下节点的IP)源端口目的端(第三方网管提供)目的端口(第三方网管提供)ManageOne-Service0127318第三方网管浮动IP,例如:192.168.1.1第三方网管的SNMP服务监听端口,如162ManageOne-Service0227318第三方网管浮动IP,例如:192.168.1.1第三方网管的SNMP服务监听端口,如162正式配置对接前,请联系客户完成网络打通。可参考以下方式获取SNMP上报的源端IP和端口联系华为现场工程师,获取ManageOne运维侧登录地址和账号。登录ManageOne运维面,进入“系统->系统设置->北向接口->基本配置”获取“发送Trap地址”和“发送Trap端口”(没有勾选的地址建议同步打通网络)2.2 对接配置获取到第三方网管系统的SNMP配置信息之后,需要在ManageOne上配置上层网管对接信息,步骤如下:联系华为现场工程师,获取ManageOne运维侧登录地址和账号。登录ManageOne运维面,进入“系统->系统设置->北向接口->第三方系统配置”,点击”创建“,将第2.2章节中获取的第三方网管SNMP配置信息填写到对应的选项中,如下图所示:配置完成后,点击“创建”,完成网管SNMP参数和告警过滤条件的配置(不配置过滤条件默认上报全部告警)。从上图中可以看到,我们可以根据需要配置上报的指定设备类型产生的告警,上报指定级别的告警,并且按照告警分类上报针对第三方网管的一些特殊需求,我们还可以调整SNMP Trap上报告警的时区、时间格式、编码格式等,方法如下:登录ManageOne运维面,进入“系统->系统设置->北向接口->基本配置”,可配置时区、编码格式、鉴权协议、加密协议等参数,如下图:请注意,此处的协议参数配置需要与第三方网管相同(EngineID一般可忽略),否则第三方网管将无法正常解析SNMP报文。在此处勾选需要上报的字段。需要注意,扩展字段默认未勾选,如果有需要的字段,请在此处勾选,否则第三方网管将无法接收到这些字段。扩展字段对应的说明如下:(8.x以上版本)字段描述说明RootAlarm根因告警 AssociateAlarmGroup关联告警组 ArrivedEMSTime告警到达网管时间 GroupID告警分组ID ExtendProductItem5扩展字段5告警所影响的业务名称。ExtendProductItem6扩展字段6告警标识 (字符串类型AlarmID)。ExtendProductItem7扩展字段7告警名称。ExtendProductItem8扩展字段8告警RCA分析结果信息。说明:一般的,SNMP Trap是发送给SNMP 服务端的通知网络状况等的警告消息,而Inform是需要SNMP 服务端确认接收的Trap。与Inform 相比较,Trap通知方式为不可靠传输,因为SNMP 服务端在收到一条Trap通知后无需回复任何确认信息,所以SNMP agent无法知道Trap通知是否已经被snmp管理端正确接收其中:1、CSN(告警的网络流水号)唯一标识一条告警,同一条告警的清除、确认、反确认、变更告警网络流水号相同。2、AlarmID(告警ID)是告警类型的唯一标识符,全量的告警类型列表可通过以下方法获取:OC主页->"集中监控"->“告警管理”->"告警扩展",选择左侧菜单列表的“告警扩展”,选择“告警信息导出”。单击“导出”后,可获得如下excel文件:2.3 示例程序Java语言:(使用任意华为公有云帐号登录即可)cid:link_0Python语言:暂无示例程序,可使用net-snmp、pysnmp 等第三方库进行对接。5 附录5-1 页面告警与OID的对应关系示例:(注:1.下图中x表示"1.3.6.1.4.1.2011.2.15.2.4.3.3"。2. 未标注的字段表示暂无与之对应的OID。3. x.39以键值对格式存放可选拓展字段,示例可参考5-3)5-2 SNMP报文示例(对应5-1的告警,实际上报的Trap中OID末尾会带有“.0”作为该OID的实例。)1.3.6.1.2.1.1.3.0 = 4 days, 7:11:53.701.3.6.1.6.3.1.1.4.1.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.0.11.3.6.1.4.1.2011.2.15.2.4.3.3.1.0 = 171304711.3.6.1.4.1.2011.2.15.2.4.3.3.2.0 = 91.3.6.1.4.1.2011.2.15.2.4.3.3.3.0 = 2022-10-08 00:49:021.3.6.1.4.1.2011.2.15.2.4.3.3.4.0 = 28d5aff847ee411b87241b68183da9bcin011.3.6.1.4.1.2011.2.15.2.4.3.3.5.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.6.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.7.0 = DefaultMedn1.3.6.1.4.1.2011.2.15.2.4.3.3.8.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.9.0 = 50124161.3.6.1.4.1.2011.2.15.2.4.3.3.10.0 = 71.3.6.1.4.1.2011.2.15.2.4.3.3.11.0 = 21.3.6.1.4.1.2011.2.15.2.4.3.3.12.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.13.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.14.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.15.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.16.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.17.0 = 2785615221.3.6.1.4.1.2011.2.15.2.4.3.3.18.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.19.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.20.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.21.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.22.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.23.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.24.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.25.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.26.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.27.0 = Identity=Toggling Alarm, system:DBS:Service:mysqlBackupService,module:startLobBackup,instance:28d5aff847ee411b87241b68183da9bcin011.3.6.1.4.1.2011.2.15.2.4.3.3.28.0 = action=startLobBackup,instanceId=28d5aff847ee411b87241b68183da9bcin01,projectId=063094e04ef94614a74191c15bd02f0d,reason="failed to startLobBackup, cause when change log backup method, failed to access obs service, instanceId=28d5aff847ee411b87241b68183da9b1.3.6.1.4.1.2011.2.15.2.4.3.3.29.0 = Please refer to the alarm help1.3.6.1.4.1.2011.2.15.2.4.3.3.30.0 = 1.The agent is abnormal.2.OBS service is abnormal and incremental backup upload failed.1.3.6.1.4.1.2011.2.15.2.4.3.3.31.0 = 10.10.4.1241.3.6.1.4.1.2011.2.15.2.4.3.3.32.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.33.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.34.0 = 2022-10-08 00:49:021.3.6.1.4.1.2011.2.15.2.4.3.3.35.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.36.0 = 50124161.3.6.1.4.1.2011.2.15.2.4.3.3.37.0 = failed to startLobBackup1.3.6.1.4.1.2011.2.15.2.4.3.3.38.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.39.0 = 7b:22:6d:6f:63:22:3a:22:4e:45:57:44:42:53:22:2c:22:73:70:65:63:69:61:6c:41:6c:61:72:6d:53:74:61:74:75:73:22:3a:30:2c:22:6c:6f:67:69:63:61:6c:52:65:67:69:6f:6e:4e:61:6d:65:22:3a:22:e4:b8:9c:e8:8e:9e:22:2c:22:61:7a:6f:6e:65:4e:61:6d:65:22:3a:6e:75:6c:6c:2c:22:61:64:64:72:65:73:73:22:3a:22:31:30:2e:31:30:2e:34:2e:31:32:34:22:2c:22:6d:65:54:79:70:65:22:3a:6e:75:6c:6c:2c:22:6f:72:69:67:69:6e:53:79:73:74:65:6d:4e:61:6d:65:22:3a:22:52:44:53:5f:73:6f:6c:75:74:69:6f:6e:2d:61:64:76:61:6e:63:65:2d:31:22:2c:22:72:65:73:50:6f:6f:6c:4e:61:6d:65:22:3a:6e:75:6c:6c:2c:22:6f:72:69:67:69:6e:53:79:73:74:65:6d:54:79:70:65:22:3a:22:43:6c:6f:75:64:53:65:72:76:69:63:65:22:2c:22:61:6c:61:72:6d:47:72:6f:75:70:49:64:22:3a:22:32:37:38:35:36:31:35:32:32:22:2c:22:6d:61:74:63:68:4b:65:79:22:3a:22:62:31:38:39:64:61:30:62:2d:63:38:38:38:2d:34:65:34:30:2d:62:31:33:31:2d:63:65:63:36:33:31:63:37:38:37:66:62:22:2c:22:6d:61:6e:75:66:61:63:74:75:72:65:72:22:3a:22:68:75:61:77:65:69:22:2c:22:6c:6f:67:69:63:61:6c:52:65:67:69:6f:6e:49:64:22:3a:22:35:44:45:44:43:36:33:33:43:38:38:39:33:41:43:39:38:46:43:35:45:32:31:42:38:38:35:38:33:41:30:45:22:2c:22:72:65:61:73:6f:6e:49:64:22:3a:30:2c:22:64:63:4e:61:6d:65:22:3a:6e:75:6c:6c:2c:22:64:6f:6d:61:69:6e:22:3a:6e:75:6c:6c:2c:22:72:75:6c:65:4e:61:6d:65:22:3a:22:5b:49:6e:74:65:72:6d:69:74:74:65:6e:74:2f:54:6f:67:67:6c:69:6e:67:20:41:6c:61:72:6d:20:48:61:6e:64:6c:69:6e:67:20:52:75:6c:65:5d:50:72:65:73:65:74:2d:49:6e:74:65:72:6d:69:74:74:65:6e:74:20:6f:72:20:54:6f:67:67:6c:69:6e:67:20:52:75:6c:65:20:66:6f:72:20:41:6c:6c:20:41:6c:61:72:6d:73:2c:20:5b:49:64:65:6e:74:69:66:69:63:61:74:69:6f:6e:20:52:75:6c:65:5d:75:70:67:72:61:64:65:5f:61:6c:61:72:6d:5f:69:64:65:6e:74:69:66:69:63:61:74:69:6f:6e:5f:72:75:6c:65:22:2c:22:63:6f:6d:6d:65:6e:74:22:3a:6e:75:6c:6c:2c:22:76:64:63:4e:61:6d:65:22:3a:6e:75:6c:6c:2c:22:6e:61:74:69:76:65:4d:65:44:6e:22:3a:22:32:38:64:35:61:66:66:38:34:37:65:65:34:31:31:62:38:37:32:34:31:62:36:38:31:38:33:64:61:39:62:63:69:6e:30:31:22:2c:22:69:6e:76:61:6c:69:64:61:74:65:64:22:3a:30:2c:22:76:64:63:49:64:22:3a:6e:75:6c:6c:7d1.3.6.1.4.1.2011.2.15.2.4.3.3.40.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.41.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.42.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.43.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.44.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.45.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.46.0 = 1.3.6.1.4.1.2011.2.15.2.4.3.3.47.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.48.0 = 11.3.6.1.4.1.2011.2.15.2.4.3.3.49.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.50.0 = 01.3.6.1.4.1.2011.2.15.2.4.3.3.51.0 = Toggling time=214, userName=op_svc_appcube_1f48972c3ddf49048a7b9012e5d27dc8_solution-advance-1, instanceName=rds-instance-appcube23ec5a05bb5fc41b2ac8723d462159dff, CloudService=RDS,Service=DBS-MySQL-Server,MicroService=DBS-mysql-backupmanager, NativeMeDn=8.98.132.200;5-3 SNMP报文解码部分告警Trap可能需要解码才能够正常解析,例如5-2中的1.3.6.1.4.1.2011.2.15.2.4.3.3.39.0:解码前:1.3.6.1.4.1.2011.2.15.2.4.3.3.39.0 = 7b:22:6d:6f:63:22:3a:22:43:4c:4f:55:44:5f:52:4f:4d:41:5f:49:4e:53:54:41:4e:43:45:22:2c:22:73:70:65:63:69:61:6c:41:6c:61:72:6d:53:74:61:74:75:73:22:3a:30:2c:22:6c:6f:67:69:63:61:6c:52:65:67:69:6f:6e:4e:61:6d:65:22:3a:22:e4:b8:9c:e8:8e:9e:22:2c:22:61:7a:6f:6e:65:4e:61:6d:65:22:3a:6e:75:6c:6c:2c:22:61:64:64:72:65:73:73:22:3a:22:38:2e:39:38:2e:31:33:32:2e:32:33:31:22:2c:22:6d:65:54:79:70:65:22:3a:6e:75:6c:6c:2c:22:6f:72:69:67:69:6e:53:79:73:74:65:6d:4e:61:6d:65:22:3a:22:52:4f:4d:41:43:6f:6e:6e:65:63:74:5f:73:6f:6c:75:74:69:6f:6e:2d:61:64:76:61:6e:63:65:2d:31:22:2c:22:72:65:73:50:6f:6f:6c:4e:61:6d:65:22:3a:6e:75:6c:6c:2c:22:6f:72:69:67:69:6e:53:79:73:74:65:6d:54:79:70:65:22:3a:22:43:6c:6f:75:64:53:65:72:76:69:63:65:22:2c:22:61:6c:61:72:6d:47:72:6f:75:70:49:64:22:3a:22:32:37:38:35:36:31:35:33:32:22:2c:22:6d:61:74:63:68:4b:65:79:22:3a:22:66:35:31:63:35:38:62:33:2d:63:35:30:31:2d:34:37:33:33:2d:38:61:36:35:2d:65:36:37:63:35:33:63:38:37:62:38:33:22:2c:22:6d:61:6e:75:66:61:63:74:75:72:65:72:22:3a:22:68:75:61:77:65:69:22:2c:22:6c:6f:67:69:63:61:6c:52:65:67:69:6f:6e:49:64:22:3a:22:35:44:45:44:43:36:33:33:43:38:38:39:33:41:43:39:38:46:43:35:45:32:31:42:38:38:35:38:33:41:30:45:22:2c:22:72:65:61:73:6f:6e:49:64:22:3a:30:2c:22:64:63:4e:61:6d:65:22:3a:6e:75:6c:6c:2c:22:64:6f:6d:61:69:6e:22:3a:6e:75:6c:6c:2c:22:72:75:6c:65:4e:61:6d:65:22:3a:22:5b:49:6e:74:65:72:6d:69:74:74:65:6e:74:2f:54:6f:67:67:6c:69:6e:67:20:41:6c:61:72:6d:20:48:61:6e:64:6c:69:6e:67:20:52:75:6c:65:5d:50:72:65:73:65:74:2d:49:6e:74:65:72:6d:69:74:74:65:6e:74:20:6f:72:20:54:6f:67:67:6c:69:6e:67:20:52:75:6c:65:20:66:6f:72:20:41:6c:6c:20:41:6c:61:72:6d:73:2c:20:5b:49:64:65:6e:74:69:66:69:63:61:74:69:6f:6e:20:52:75:6c:65:5d:75:70:67:72:61:64:65:5f:61:6c:61:72:6d:5f:69:64:65:6e:74:69:66:69:63:61:74:69:6f:6e:5f:72:75:6c:65:22:2c:22:63:6f:6d:6d:65:6e:74:22:3a:6e:75:6c:6c:2c:22:76:64:63:4e:61:6d:65:22:3a:6e:75:6c:6c:2c:22:6e:61:74:69:76:65:4d:65:44:6e:22:3a:22:30:36:35:66:38:66:36:65:2d:61:30:32:33:2d:34:63:61:65:2d:62:37:32:64:2d:61:31:34:34:39:39:38:35:62:65:61:38:22:2c:22:69:6e:76:61:6c:69:64:61:74:65:64:22:3a:30:2c:22:76:64:63:49:64:22:3a:6e:75:6c:6c:7d解码后:1.3.6.1.4.1.2011.2.15.2.4.3.3.39.0 = {"moc":"CLOUD_ROMA_INSTANCE","specialAlarmStatus":0,"logicalRegionName":"东莞","azoneName":null,"address":"8.98.132.231","meType":null,"originSystemName":"ROMAConnect_solution-advance-1","resPoolName":null,"originSystemType":"CloudService","alarmGroupId":"278561532","matchKey":"f51c58b3-c501-4733-8a65-e67c53c87b83","manufacturer":"huawei","logicalRegionId":"5DEDC633C8893AC98FC5E21B88583A0E","reasonId":0,"dcName":null,"domain":null,"ruleName":"[Intermittent/Toggling Alarm Handling Rule]Preset-Intermittent or Toggling Rule for All Alarms, [Identification Rule]upgrade_alarm_identification_rule","comment":null,"vdcName":null,"nativeMeDn":"065f8f6e-a023-4cae-b72d-a1449985bea8","invalidated":0,"vdcId":null}解码方式如下(以Java为例):1. 添加以下Maven依赖2. 解码代码:(完整使用场景可参考示例程序)//1.判断报文是否需要解码private boolean isHexString(String hex) { return Pattern.compile("^([a-zA-Z0-9]{2}:)+[a-zA-Z0-9]{2}$").matcher(hex).find();}//2.解码报文(编码需根据配置调整)private String hexStr2Str(String hexStr) { try { if (!StringUtils.isEmpty(hexStr)) { hexStr = hexStr.replace(":", ""); return new String(Hex.decodeHex(hexStr.toCharArray()), StandardCharsets.UTF_8); } } catch (Exception e) { LOGGER.error("hexStr2Str error : {}", e.getMessage()); } return hexStr;}
-
1、场景说明ManageOne运营侧支持新增菜单功能,部分客户需要新增菜单跳转到第三方系统,可以通过调用北向接口实现此功能。 2、使用流程约束条件:ManageOne 8.0.0 及以上版本准备工作:北向接口对接准备工作参考:cid:link_01、获取系统管理员Token,用户名和密码需要环境管理员提供,默认为vdc_adminPOST https://{IAM对外域名}/v3/auth/tokens Accept:application/json Content-Type:application/json;charset=UTF-8 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "vdc_admin", "password": "xxxxxx", "domain": { "name": "op_service" } } } }, "scope": { "domain": { "name": "op_service" } } }}2、调用北向接口新增菜单参数说明:名称说明key区分租户侧和管理侧,租户侧:custom_menu_vdc,管理侧:custom_menu_mgrtype一级菜单值为title,二级下拉菜单传数字,数值表示展示顺序text仅支持string格式,区分中英文菜单名称需传json格式的字符串租户侧新增菜单报文如下,header中需要携带Token:a)新增定制一级菜单注意:一级菜单作为功能分类说明,不能点击跳转,跳转链接功能在二级菜单上实现POST https://{ManageOne运营侧API对外域名}/silvan/rest/v1.0/links Accept:application/json X-Auth-Token:xxxxxxxxxxxxxxxxxxx Content-Type:application/json;charset=UTF-8 { "key": "custom_menu_vdc", "text": "{\"zh-cn\":\"百度\",\"en-us\":\"BaiDu\"}", "iconName": "list", "href": "", "type": "title", "domainType": "SC"}b)新增定制二级下拉菜单POST https://{ManageOne运营侧API对外域名}/silvan/rest/v1.0/links Accept:application/json X-Auth-Token:xxxxxxxxxxxxxxxxxxx Content-Type:application/json;charset=UTF-8 { "key": "custom_menu_vdc", "text": "{\"zh-cn\":\"百度\",\"en-us\":\"BaiDu\"}", "iconName": "list", "href": "https://www.baidu.com", "type": "1", "domainType": "SC"}效果如下: 注意:通常新增菜单后都希望点击能够直接进入第三方系统而不需再次输入用户名和密码登录,可配套单点登录定制能力使用,cid:link_13、调用北向接口删除菜单a)查询已经注册的链接GET https://{ManageOne运营侧API对外域名}/silvan/rest/v1.0/linksAccept:application/json X-Auth-Token:xxxxxxxxxxxxxxxxxxx Content-Type:application/json;charset=UTF-8 响应示例:{ "links": [ { "seqId": 626, "key": "custom_menu_vdc", "text": "{\"zh-cn\":\"百度\",\"en-us\":\"BaiDu\"}", "iconName": "list", "href": "https://www.baidu.com", "type": "1", "domainType": "SC", "regionId": "" } ...... ], "total": 521}b)删除已经注册的链接其中,{seq_id}从上面的响应结果中获取DELETE https://{ManageOne运营侧API对外域名}/silvan/rest/v1.0/links/{seq_id}Accept:application/json X-Auth-Token:xxxxxxxxxxxxxxxxxxxContent-Type:application/json;charset=UTF-8
-
1、场景说明ManageOne对接的各个云服务以离线话单的形式上报计量信息,然后ManageOne按照统一的规则解析得到计量数据,然后根据设置的计量因子单价,汇总计算得到最终的计费信息。第三方计费系统需要获取各云服务的计量信息时,可以通过直接获取离线话单的形式,离线话单为各云服务通过SFTP上传的文件,第三方计费系统获取文件后按照规则解析即可 2、使用流程 约束条件:ManageOne的离线话单文件会定时删除一个月前的数据,第三方需要在此期间内正确获取到全量的话单文件。不同的云服务具体解析规则不同,第三方需要严格按照规则解析文件获取计量数据。通过开发适配程序获取SFTP中离线话单文件,然后根据规则解析出每个云服务的计量数据,最后上报到第三方计费系统。示意图如下: 2.1获取文件所有云服务将话单文件上传到指定的SFTP目录。(/opt/meterfiles/uploads)所有云服务共用一个SFTP账号和密码,内部对接的云服务可以通过接口查询,第三方系统对接需要找管理员获取SFTP服务器IP、SFTP账户和密码信息。方法如下:需获取项获取方式服务器IP联系华为工程师,获取环境LLD导出表(FusionCloud安装工具FCD导出的环境详情),打开“2.1 工具生成的ip参数”工作表,搜索“ManageOne-Tenant-Float-IP”的参数值,即为SFTP服务器的IP地址。账户名称固定为"meteradmin"密码联系华为工程师,在support网站上下载"华为云Stack 8.x 帐户一览表"(与ManageOne版本配套),页签选择"B类(ManageOne)",在其中搜索"meteradmin",即可找到该用户的默认密码。2.2.解析话单从SFTP服务器获取的话单文件为zip格式,解压后最终文件为csv格式。注意:解压zip文件前需要校验文件完整性。话单文件最大为10M,如果超过容量会拆分多个文件。话单文件的名称带有时间戳,根据时间戳确定增量文件。如需查看详细解析规则,请登录后下载附件《华为 ManageOne 6.5.1-8.x 运营侧话单对接定制开发指南》。2.3.实例代码ManageOne提供示例代码供开发参考,该程序完成了以下功能:从SFTP服务器获取指定时间段内的话单文件将话单文件解析为类对象,并提供按各维度(项目id、规格等)筛选和统计的方法通过ManageOne北向接口获取vdc和项目间的关系,将最终的计量结果按vdc和规格的维度输出报表文件。项目地址:cid:link_0项目结构及介绍:输出样例:虚拟机计量报表:vm_meter.xls云硬盘计量报表:volume_meter.xls
-
1、场景说明客户需要合理分配资源给各个不同的业务部门,既要做到各部门自助管理资源,又要管控各部门的使用量,做到合理分配,避免过度使用浪费资源等问题ManageOne通过VDC配额控制各部门可以使用的资源数量,确保各部门对资源的使用不超出预算范围。配额限制了VDC可使用云资源的最大限额,支持限制和不限两种方式,当配额不限时可使用云平台或所属VDC的所有资源。当前云平台支持按照区域、资源池、可用区、SLA四个维度管控配额。 2、使用流程注意:适用于ManageOne 8.1.1及以上版本步骤0:获取管理员token请求URL:https://{IAM对外访问域名}/v3/auth/tokens请求方法:POST请求头:Accept:application/jsonContent-Type:application/json;charset=UTF-8请求体:(注:运营管理员的domain name固定为mo_bss_admin,VDC管理员的domain name为租户名。使用运营管理员账号可管理全部租户的VDC配额,使用VDC管理员账号可管理本级VDC和子级VDC的配额。){ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "domain": { "name": "mo_bss_admin" }, "name": "XXXX", "password": "XXXXXX" } } }, "scope": { "domain": { "name": "mo_bss_admin" } } }}返回的token在响应头中,示例如下:HTTP/1.1 201 CreatedContent-Type: application/json; charset=utf-8Connection: keep-aliveX-Subject-Token: MIIECwYxxxxxxxxxxxxxxxxxxSQ3G2RAj89N+t9GECHGnnGUgkKj7vMesUZ2jEW6EiVYA==X-Subject-Token的值即为我们所需要的token步骤1:查询VDC列表URLGET https://{SC北向接口域名}/rest/vdc/v3.0/vdcs?start=0&limit=1000其中,start为分页查询的起始位置,取值在0-2147483647之间,默认从0开始, 默认值为0。分页查询时,start需要为limit的整数倍;limit限制每页显示的条目数量,取值在1-1000之间,默认值为20。可包含如下查询条件:(下表包含部分查询条件,全部查询条件请参考《ManageOne 运营面API参考.docx》中”查询VDC列表“接口。)参数类型描述namestringVDC名称,长度在0-128之间。upper_vdc_idstring上级VDC id。domain_idstring所属租户id。levelint32VDC级别,取值在1-5之间。sort_keystring排序字段,支持按create_at、name字段排序。默认值:name。sort_dirstring排序方向,取值范围asc,desc。默认值:asc。is_domainstring是否为租户,1代表是,0代表不是。query_namestring过滤字段。取值范围domainName,upperVdcName,extraquery_valuestring过滤字段值。请求头Content-Type:application/json X-Auth-Token:x-xxxxxxxxxxx请求体:无响应体示例{ "total": 4, "vdcs": [ { "id": "d86c3636-c637-4ee6-93ca-16c34b38b5c0", "name": "hzp_vdc", "tag": "vdc", "description": null, "upper_vdc_id": "0", "upper_vdc_name": null, "top_vdc_id": "d86c3636-c637-4ee6-93ca-16c34b38b5c0", "extra": "{\"manager\":\"\",\"phone\":\"\",\"email\":\"\"}", "project_count": 2, "enabled": true, "domain_id": "16ea1a6e341d44e385fb3cb077c3b63f", "level": 1, "create_user_id": "9d30a3d12bac4d879e9e9fb4274b76ed", "create_user_name": "bss_admin", "create_at": 1650350228000, "utc_create_at": "2022-04-19 06:37:08.0", "domain_name": "hzp_vdc", "ldap_id": null, "third_id": null, "idp_name": null, "third_type": "0", "region_id": null, "enterprise_id": null, "az_id": null, "enterprise_project_id": null }, { "id": "bf588c5a-8d05-49bd-a93d-e937286893e5", "name": "hzp_vdc2", "tag": "vdc", "description": "", "upper_vdc_id": "d86c3636-c637-4ee6-93ca-16c34b38b5c0", "upper_vdc_name": "hzp_vdc", "top_vdc_id": "d86c3636-c637-4ee6-93ca-16c34b38b5c0", "extra": "{\"manager\":\"\",\"phone\":\"\",\"email\":\"\"}", "project_count": 1, "enabled": true, "domain_id": "16ea1a6e341d44e385fb3cb077c3b63f", "level": 2, "create_user_id": "d0cc23141778469f82854c5269d3d9ee", "create_user_name": "hzp_admin", "create_at": 1651040610000, "utc_create_at": "2022-04-27 06:23:30.0", "domain_name": "hzp_vdc", "ldap_id": null, "third_id": null, "idp_name": null, "third_type": "0", "region_id": null, "enterprise_id": null, "az_id": null, "enterprise_project_id": null } ]}部分响应体字段说明如下: id:VDC idname:vdc名称level:vdc级别,取值在1-5之间。description:描述domain_id:租户iddomain_name:租户名create_at/utc_create_at:创建时间upper_vdc_id:上级VDC idupper_vdc_name:上级VDC 名称project_count:project数量top_vdc_id:所在的一级VDC id。步骤2:查询VDC配额注:8.1.1及以上版本可使用此接口。URLGET https://{SC北向接口域名}/rest/vdc/v3.2/vdcs/{vdc_id}/quotas?start=0&limit=3其中,start为分页查询的起始位置,默认为0。limit为每页显示的条目数量,最小值:1,最大值:3。分页查询时,start为limit的整数倍,例如:limit取值为3,分页查询时,start取值为0,3,6,9......等。其他查询参数:service_id:服务id,如ecs、evs、vpc等region_id:区域idcloud_infra_id:资源池idaz_id:可用分区id请求头Content-Type:application/jsonX-Auth-Token:x-xxxxxxxxxxx请求体:无响应体示例{ "total": 23, "services": [ { "service_id": "ecs", "service_name": "{\"en_us\":\"Elastic Cloud Server\",\"zh_cn\":\"弹性云服务器\"}", "quotas": [ { "region_id": "solution-advance-1", "region_name": "{\"zh_cn\":\"东莞\",\"en_us\":\"东莞\"}", "cloud_infra_id": "FUSION_CLOUD_solution-advance-1", "cloud_infra_name": "OpenStack_solution-advance-1", "az_id": "az0.dc0", "az_name": "华为技术有限公司", "parent_id": "instances", "resource_id": "instances", "resource_name": "{\"en_us\":\"Instances\",\"zh_cn\":\"实例\"}", "unit": "{\"en_us\":\"\",\"zh_cn\":\"台\"}", "quota_limit": 10000, "quota_allocated": 0, "quota_used": 7.0, "quota_left": 9993 }, { "region_id": "solution-advance-1", "region_name": "{\"zh_cn\":\"东莞\",\"en_us\":\"东莞\"}", "cloud_infra_id": "FUSION_CLOUD_solution-advance-1", "cloud_infra_name": "OpenStack_solution-advance-1", "az_id": "az0.dc0", "az_name": "华为技术有限公司", "parent_id": "cores", "resource_id": "cores", "resource_name": "{\"en_us\":\"vCPU\",\"zh_cn\":\"vCPU\"}", "unit": "{\"en_us\":\"cores\",\"zh_cn\":\"核\"}", "quota_limit": -1, "quota_allocated": 0, "quota_used": 9.0, "quota_left": -1 }, { "region_id": "solution-advance-1", "region_name": "{\"zh_cn\":\"东莞\",\"en_us\":\"东莞\"}", "cloud_infra_id": "FUSION_CLOUD_solution-advance-1", "cloud_infra_name": "OpenStack_solution-advance-1", "az_id": "az0.dc0", "az_name": "华为技术有限公司", "parent_id": "ram", "resource_id": "ram", "resource_name": "{\"en_us\":\"Memory\",\"zh_cn\":\"内存\"}", "unit": "{\"en_us\":\"GB\",\"zh_cn\":\"GB\"}", "quota_limit": -1, "quota_allocated": 0, "quota_used": 18.0, "quota_left": -1 }, { "region_id": "solution-advance-1", "region_name": "{\"zh_cn\":\"东莞\",\"en_us\":\"东莞\"}", "cloud_infra_id": "FUSION_CLOUD_solution-advance-1", "cloud_infra_name": "OpenStack_solution-advance-1", "az_id": "az0.dc0", "az_name": "华为技术有限公司", "parent_id": "instance_snapshot", "resource_id": "instance_snapshot", "resource_name": "{\"en_us\":\"Instance Snapshot\",\"zh_cn\":\"整机快照\"}", "unit": "{\"en_us\":\"\",\"zh_cn\":\"个\"}", "quota_limit": -1, "quota_allocated": 0, "quota_used": 0.0, "quota_left": -1 } ] }, { "service_id": "evs", "service_name": "{\"en_us\":\"Elastic Volume Service\",\"zh_cn\":\"弹性云硬盘\"}", "quotas": [ { "region_id": "solution-advance-1", "region_name": "{\"zh_cn\":\"东莞\",\"en_us\":\"东莞\"}", "cloud_infra_id": "FUSION_CLOUD_solution-advance-1", "cloud_infra_name": "OpenStack_solution-advance-1", "az_id": "az0.dc0", "az_name": "华为技术有限公司", "parent_id": "gigabytes", "resource_id": "SSD", "resource_name": "{\"zh_cn\":\"业务卷1\",\"en_us\":\"业务卷1\"}", "unit": "{\"zh_cn\":\"GB\",\"en_us\":\"GB\"}", "quota_limit": -1, "quota_allocated": 0, "quota_used": 1140.0, "quota_left": -1 }, { "region_id": "solution-advance-1", "region_name": "{\"zh_cn\":\"东莞\",\"en_us\":\"东莞\"}", "cloud_infra_id": "FUSION_CLOUD_solution-advance-1", "cloud_infra_name": "OpenStack_solution-advance-1", "az_id": "az0.dc0", "az_name": "华为技术有限公司", "parent_id": "gigabytes", "resource_id": "gigabytes", "resource_name": "{\"zh_cn\":\"磁盘容量\",\"en_us\":\"Disk Capacity\"}", "unit": "{\"zh_cn\":\"GB\",\"en_us\":\"GB\"}", "quota_limit": -1, "quota_allocated": 0, "quota_used": 1451.0, "quota_left": -1 }, { "region_id": "solution-advance-1", "region_name": "{\"zh_cn\":\"东莞\",\"en_us\":\"东莞\"}", "cloud_infra_id": "FUSION_CLOUD_solution-advance-1", "cloud_infra_name": "OpenStack_solution-advance-1", "az_id": "az0.dc0", "az_name": "华为技术有限公司", "parent_id": "volumes", "resource_id": "volumes", "resource_name": "{\"zh_cn\":\"磁盘数\",\"en_us\":\"Disk\"}", "unit": "{\"zh_cn\":\"个\",\"en_us\":\"\"}", "quota_limit": -1, "quota_allocated": 0, "quota_used": 28.0, "quota_left": -1 } ] } ]}响应体字段说明如下:total:总量。services:配额详情。对象数组。services包含以下字段:service_id:服务ID。service_name:服务名称。quotas:配额详情。对象数组。quotas包含以下字段:region_id:地域ID。region_name:地域名称。cloud_infra_id:资源池标识。cloud_infra_name:资源池名称。az_id:可用区 ID,长度在1-128之间。如果此字段为null,表示该配额挂在资源池下。az_name:可用区名称。parent_id:父配额项ID。当parent_id不等于resource_id时,指标项为SLA配额。resource_id:配额项ID。resource_name:配额项名称。unit:资源单位。quota_limit:配额阈值。取值为-1时,表示不限配额。quota_allocated:配额分配量。quota_used:配额已使用量。quota_left:剩余可用配额。取值为-1时,表示不限配额。步骤3:修改VDC配额注:8.1.1及以上版本可使用此接口。URLPUT https://{SC北向接口域名}/rest/vdc/v3.2/vdcs/{vdc_id}/quotas请求头Content-Type:application/jsonX-Auth-Token:x-xxxxxxxxxxx请求体示例:{ "services": [ { "service_id": "ecs", "quotas": [ { "region_id": "solution-advance-1", "cloud_infra_id": "FUSION_CLOUD_solution-advance-1", "az_id": "az0.dc0", "resource_id": "cores", "quota_limit": 1000, "parent_id": "cores" } ] } ]}其中,service_id为服务id;region_id为区域id;cloudInfraId为资源池id;az_id为可用分区id;resource_id为资源id;parent_id父配额资源 ID,以上参数均从“查询VDC配额”接口获取。quota_limit为配额限量,值为-1时表示不限制。注:当指标为SLA配额时(resource_id不等于parent_id时),所有SLA配额限制之和不能大于父配额限制;若父配额为“不限”,则SLA配额也必须设置为“不限”。例如:“磁盘容量”配额下可能有SAS、SSD等SLA配额,若“磁盘容量”配额限制为100G,则SAS配额+SSD配额不得超过100G。若“磁盘容量”配额为“不限”,则SAS配额和SSD配额也必须设置为“不限”。附录 配额指标清单截止至HCS 8.2.0版本,FUSION_CLOUD资源池下的云资源支持如下配额指标:服务名display单位配额控制范围弹性云服务器实例台可用分区弹性云服务器vCPU核可用分区弹性云服务器内存GB可用分区弹性云服务器NPU个可用分区弹性云服务器GPU个可用分区弹性云服务器vGPU个可用分区弹性云服务器整机快照个可用分区弹性云硬盘磁盘容量GB可用分区弹性云硬盘磁盘数个可用分区裸金属服务器实例台可用分区裸金属服务器CPU核可用分区裸金属服务器内存GB可用分区镜像服务镜像个资源池虚拟私有云VPC个资源池虚拟私有云弹性IP个资源池虚拟私有云弹性负载均衡个资源池虚拟私有云网络ACL个资源池虚拟私有云云专线个资源池虚拟私有云共享带宽个资源池虚拟私有云终端节点个资源池虚拟私有云终端节点服务个资源池弹性文件服务文件系统个资源池弹性文件服务总容量GB资源池应用魔方 AppCube应用魔方套资源池应用魔方 AppCube大屏可视化服务套资源池应用服务网格ASM网格个资源池区块链服务 BCS实例数个资源池云堡垒机实例台资源池云容器引擎CCE集群个资源池数据治理中心数据服务 - 专享版APP(按工作空间区分)个资源池数据治理中心数据服务 - 专享版API个资源池数据治理中心数据开发 - 作业数个资源池数据治理中心数据资产 - 对象数量个资源池数据治理中心数据服务 - 专享版集群个资源池数据治理中心数据服务 - 专享版流控(按工作空间区分)个资源池数据库审计服务代理个资源池分布式缓存服务 DCS实例个资源池分布式缓存服务 DCS内存GB资源池分布式数据库中间件 DDM实例数个资源池分布式数据库中间件 DDM虚拟机数个资源池分布式数据库中间件 DDMRAM容量(GB)GB资源池分布式数据库中间件 DDM核心数个资源池分布式数据库中间件 DDM磁盘数个资源池分布式数据库中间件 DDM磁盘容量(GB)GB资源池文档数据库服务 DDS实例数个资源池文档数据库服务 DDS虚拟机数个资源池文档数据库服务 DDSRAM容量(GB)GB资源池文档数据库服务 DDS核心数个资源池文档数据库服务 DDS磁盘数个资源池文档数据库服务 DDS磁盘容量(GB)GB资源池数据复制服务 DRS虚拟机数个资源池数据复制服务 DRS磁盘容量(GB)GB资源池数据复制服务 DRS弹性ip数量个资源池数据仓库服务节点个数个资源池数据仓库服务vCPU核资源池数据仓库服务集群手动快照个资源池数据仓库服务内存GB资源池数据仓库服务磁盘大小GB资源池云数据库 GaussDB SQL实例数个资源池云数据库 GaussDB SQL虚拟机数个资源池云数据库 GaussDB SQLRAM容量(GB)GB资源池云数据库 GaussDB SQL核心数个资源池云数据库 GaussDB SQL磁盘数个资源池云数据库 GaussDB SQL磁盘容量(GB)GB资源池图引擎服务图个资源池图引擎服务元数据个资源池图引擎服务边万边资源池ModelArts推理cpu核数个资源池ModelArts推理gpu个数个资源池ModelArts推理npu个数个资源池ModelArts训练cpu核数个资源池ModelArts训练gpu个数个资源池ModelArts训练npu个数个资源池MapReduce 服务vCPU核资源池MapReduce 服务内存GB资源池MapReduce 服务纳管集群个资源池云数据库 RDS实例数个资源池云数据库 RDS虚拟机数个资源池云数据库 RDSRAM容量(GB)GB资源池云数据库 RDS核心数个资源池云数据库 RDS磁盘数个资源池云数据库 RDS磁盘容量(GB)GB资源池应用与数据集成平台 ROMA Connect实例数个资源池应用管理与运维平台 ServiceStage微服务引擎个资源池Web应用防火墙独享引擎个资源池
-
1、场景说明如果您公司购买了并部署了华为云Stack产品,您希望通过自动化工具实现云服务资源的自动化发放,从而提高资源申请效率;如果您购买了并部署了华为云Stack产品,公司围绕IT资产的运营运维有一整套流程,您希望已有的流程平台(如ITSM、BOSS等)能够与华为云Stack进行对接,实现现有流程与云服务的整合,在简化服务的申请周期,提高应用上线效率的同时,还能够实现云资源的全流程监控;如果您是云服务提供商,将华为云Stack提供的云服务,按照租户的形式租售给了客户,客户希望实现云服务的自动化发放,需要您提供对接接口;如果您是云服务提供商,希望现有运营平台能够与华为云Stack对接,实现租户的自动化创建,并为每个租户预置指定类型的云资源,租户的日常运维由运维部门通过ManageOne进行运维。 2、使用流程HCS对外开放ManageOne运营面接口和云服务接口,支持通过API对云资源进行管理: 使用订单的方式对云资源进行申请、变更、释放操作,实现对云资源生命周期的管理,订单接口具有以下特点:订单支持关联审批流程(可以关联外部审批系统,详情可参考:链接),用户完成资源配置并提交后,如果审批通过,Manageone会自动完成订单实施;通过订单接口申请、释放云资源时,会同步扣除、恢复租户配额,当租户配额不够时,会导致订单实施失败;(8.1.1版本后,云服务接口亦支持此特性)订单接口只提供部分IaaS资源的申请,延期,变更,释放功能,不提供云服务的查询和操作(如虚拟机查询、开关机等),相关操作需要调用云服务接口。订单接口具体支持的资源操作如下,不在此列表中的云服务,也需要通过云服务接口创建,如高阶服务(CCE等):操作弹性云服务器(ECS)申请、克隆、离线变更、在线变更、重装/切换操作系统、删除、软删除、还原、延期裸金属服务器(BMS)申请、延期、软删除、删除镜像服务(IMS)申请、延期、软删除、删除、还原弹性云硬盘(EVS)申请、延期、软删除、删除、还原、扩容、变更云硬盘快照申请、删除虚拟私有云(VPC)申请、删除、延期弹性IP(EIP)申请、延期、软删除、删除、还原弹性负载均衡(ELB)申请、删除、延期虚拟防火墙/网络ACL(VFW)申请、删除、延期VPN申请、删除、延期弹性文件服务(SFS)申请、变更、软删除
-
1、场景说明本文档用于指导开发者获取租户和用户信息,便于第三方系统同步ManageOne的组织架构以及用户信息(如用户名、电话、email等)。主要场景:①ManageOne运营面作为单点登录服务端时,第三方服务需要获取登录用户的用户信息。了解更多②ManageOne运营面作为单点登录客户端时,客户有自己的统一认证中心,需要将统一认证中心的用户信息和组织架构同步至ManageOne。了解更多③客户有自己的监控平台,需要同步ManageOne的用户信息。 2、执行流程1)准备工作 a、获取管理员token 2)租户/VDC 查询VDC列表 查询VDC详情 3)用户 查询用户列表 查询用户详情 4) Project(资源集/项目) 查询VDC关联的Project 查询用户关联的Project 2.1 获取管理员token请求URL:https://{IAM对外访问域名}/v3/auth/tokens请求方法:POST请求头:Accept:application/jsonContent-Type:application/json;charset=UTF-8请求体:(注:运营管理员的domain name固定为mo_bss_admin,VDC管理员的domain name为租户名。){ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "domain": { "name": "mo_bss_admin" }, "name": "XXXX", "password": "XXXXXX" } } }, "scope": { "domain": { "name": "mo_bss_admin" } } }}返回的token在响应头中,示例如下:HTTP/1.1 201 CreatedContent-Type: application/json; charset=utf-8Connection: keep-aliveX-Subject-Token: MIIECwYxxxxxxxxxxxxxxxxxxSQ3G2RAj89N+t9GECHGnnGUgkKj7vMesUZ2jEW6EiVYA==X-Subject-Token的值即为我们所需要的token2.2 租户/VDC1. 查询VDC列表URLGET https://{SC北向接口域名}/rest/vdc/v3.0/vdcs?start=0&limit=1000其中,start为分页查询的起始位置,取值在0-2147483647之间,默认从0开始, 默认值为0。分页查询时,start需要为limit的整数倍;limit限制每页显示的条目数量,取值在1-1000之间,默认值为20。可包含如下查询条件:(下表包含部分查询条件,全部查询条件请参考《ManageOne 运营面API参考.docx》中”查询VDC列表“接口。)参数类型描述namestringVDC名称,长度在0-128之间。upper_vdc_idstring上级VDC id。domain_idstring所属租户id。levelint32VDC级别,取值在1-5之间。sort_keystring排序字段,支持按create_at、name字段排序。默认值:name。sort_dirstring排序方向,取值范围asc,desc。默认值:asc。is_domainstring是否为租户,1代表是,0代表不是。query_namestring过滤字段。取值范围domainName,upperVdcName,extraquery_valuestring过滤字段值。请求头Content-Type:application/json X-Auth-Token:x-xxxxxxxxxxx请求体:无响应体示例{ "total": 4, "vdcs": [ { "id": "d86c3636-c637-4ee6-93ca-16c34b38b5c0", "name": "hzp_vdc", "tag": "vdc", "description": null, "upper_vdc_id": "0", "upper_vdc_name": null, "top_vdc_id": "d86c3636-c637-4ee6-93ca-16c34b38b5c0", "extra": "{\"manager\":\"\",\"phone\":\"\",\"email\":\"\"}", "project_count": 2, "enabled": true, "domain_id": "16ea1a6e341d44e385fb3cb077c3b63f", "level": 1, "create_user_id": "9d30a3d12bac4d879e9e9fb4274b76ed", "create_user_name": "bss_admin", "create_at": 1650350228000, "utc_create_at": "2022-04-19 06:37:08.0", "domain_name": "hzp_vdc", "ldap_id": null, "third_id": null, "idp_name": null, "third_type": "0", "region_id": null, "enterprise_id": null, "az_id": null, "enterprise_project_id": null }, { "id": "bf588c5a-8d05-49bd-a93d-e937286893e5", "name": "hzp_vdc2", "tag": "vdc", "description": "", "upper_vdc_id": "d86c3636-c637-4ee6-93ca-16c34b38b5c0", "upper_vdc_name": "hzp_vdc", "top_vdc_id": "d86c3636-c637-4ee6-93ca-16c34b38b5c0", "extra": "{\"manager\":\"\",\"phone\":\"\",\"email\":\"\"}", "project_count": 1, "enabled": true, "domain_id": "16ea1a6e341d44e385fb3cb077c3b63f", "level": 2, "create_user_id": "d0cc23141778469f82854c5269d3d9ee", "create_user_name": "hzp_admin", "create_at": 1651040610000, "utc_create_at": "2022-04-27 06:23:30.0", "domain_name": "hzp_vdc", "ldap_id": null, "third_id": null, "idp_name": null, "third_type": "0", "region_id": null, "enterprise_id": null, "az_id": null, "enterprise_project_id": null } ]}响应体字段说明如下:id:VDC idname:vdc名称level:vdc级别,取值在1-5之间。description:描述domain_id:租户iddomain_name:租户名create_at/utc_create_at:创建时间upper_vdc_id:上级VDC idupper_vdc_name:上级VDC 名称project_count:project数量top_vdc_id:所在的一级VDC id。2. 查询VDC详情URLGET https://{SC北向接口域名}/rest/vdc/v3.0/vdcs/{vdc_id}请求头Content-Type:application/json X-Auth-Token:x-xxxxxxxxxxx请求体:无响应体示例{ "vdc": { "id": "d86c3636-c637-4ee6-93ca-16c34b38b5c0", "name": "hzp_vdc", "tag": "vdc", "description": null, "upper_vdc_id": "0", "upper_vdc_name": null, "top_vdc_id": "d86c3636-c637-4ee6-93ca-16c34b38b5c0", "extra": "{\"manager\":\"\",\"phone\":\"\",\"email\":\"\"}", "ecs_used": 0.0, "evs_used": 0.0, "project_count": 0, "enabled": true, "domain_id": "16ea1a6e341d44e385fb3cb077c3b63f", "level": 1, "create_user_id": "9d30a3d12bac4d879e9e9fb4274b76ed", "create_user_name": "bss_admin", "create_at": 1650321428000, "utc_create_at": null, "domain_name": "hzp_vdc", "ldap_id": null, "process_id": null, "regions": [ { "region_id": "solution-advance-1", "region_name": "{\"zh_cn\":\"东莞\",\"en_us\":\"东莞\"}", "region_type": "private_cloud", "cloud_infras": [ { "cloud_infra_id": "FUSION_CLOUD_solution-advance-1", "cloud_infra_name": "OpenStack_solution-advance-1", "cloud_infra_status": "normal", "cloud_infra_type": "FUSION_CLOUD", "azs": [ { "available_zone": "az0.dc0", "az_name": "华为技术有限公司", "az_status": "normal", "extend_param": "{\"cloud_location\":\"localcloud\"}" } ] } ] } ], "third_type": null, "enterprise_id": null, "mfa_status": "0", "enterprise_project_id": null, "cloud_federation_rate": {}, "cloud_federation_status": false }}响应体字段说明如下:id:VDC idname:vdc名称level:vdc级别,取值在1-5之间。description:描述domain_id:租户iddomain_name:租户名create_at/utc_create_at:创建时间upper_vdc_id:上级VDC idupper_vdc_name:上级VDC 名称project_count:project数量top_vdc_id:所在的一级VDC id。region:区域详情。类型:对象数组。region包含以下字段:region_id:区域idregion_name:区域名称region_type:区域类型cloud_infras:资源池详情。对象类型。cloud_infras包含以下字段:cloud_infra_id:资源池idcloud_infra_name:资源池名称cloud_infra_status:资源池状态cloud_infra_type:资源池类型azs:可用分区详情。类型:对象数组。azs包含以下字段:available_zone:可用分区idaz_name:可用分区名称az_status:可用分区状态。extend_param:拓展参数。2.3 用户1. 查询用户列表接口约束:运营管理员token可查询全量用户。VDC管理员仅可查询本VDC以及子级VDC的用户。URLGET https://{SC北向接口域名}/rest/vdc/v3.0/users?limit=100&start=0URL常用参数:(完整参数请参考《ManageOne 运营面API参考》)start:分页查询的起始位置,最小值:0 ,最大值:2147483647 ,默认值:0。可选。limit:限制每页显示的条目数量,最小值:1,最大值:100 ,默认值:10。可选。tenant_id:用户归属的VDC ID。可选。name:按照名称或显示名字段模糊搜索。长度:1到128个字符。可选。exact:是否精确匹配,枚举值:true和false,默认值:false。可选。请求头Content-Type:application/json X-Auth-Token:x-xxxxxxxxxxx响应体示例{ "total": 1, "users": [ { "enabled": "true", "description": "", "email": "", "areacode": "", "phone": "", "vdc_name": "hzp_vdc", "resource_tenant_id": null, "level": null, "roles": [ { "id": "00000000-0000-0000-0000-000000000001", "name": "vdcServiceManager", "display_name": "VDC Admin", "user_role_type": "0" } ], "display_name": "", "vdc_id": "8c3e288e-49a5-4eab-90a0-47916dac8589", "domain_id": "9b01faf18f454c59a6fd157f0c82e556", "domain_name": "hzp_vdc", "user_type": "0", "name": "hzp_admin", "login_at": "2022-04-18 01:24:27.0", "id": "b7f8bc098f4f4891b93eeff5dcdfc6b5", "create_at": "2022-02-23 06:55:53.0" } ]}其中,id为用户Id,name为用户名称,domain_id为租户Id,vdc_id为所属的VDC Id。2. 查询用户详情接口约束:运营管理员token可查询全量用户。VDC管理员仅可查询本VDC以及子级VDC的用户。URLGET https://{SC北向接口域名}/rest/vdc/v3.0/users/{user_id}其中,user_id为用户id。请求头Content-Type:application/json X-Auth-Token:x-xxxxxxxxxxx响应体示例{ "limit_access": "false", "lock_period": null, "login_config": null, "whiteList": null, "user": { "enabled": "true", "description": "", "email": "", "areacode": null, "phone": "", "projects": [], "ldap_id": null, "level": "1", "resource_tenant_id": null, "roles": [ { "id": "00000000-0000-0000-0000-000000000001", "name": "vdcServiceManager", "display_name": "VDC Admin", "user_role_type": null, "description": "role_role_view_para_desc_content_vdcServiceManager_value" } ], "groups": [ { "id": "8afb852688194e408f4edf4bf8c8a690", "name": "SC_289yUXfSpzD", "description": "", "domain_id": "7111b7a59bff48fa983a6309fae3d7f7", "role_name": null, "vdc_name": "SC_289OHFUVQdL", "role_id": null, "vdc_id": "bc0366f0-3b60-486f-a88e-2a38266dd444" }, { "id": "cdafab1cfe2e4c129d4878b13e171333", "name": "admin_bc0366f0-3b60-486f-a88e-2a38266dd444", "description": "Default VDC administrator group, having the permission to manage services in the VDC that the user group belongs to and its lower-level VDCs.", "domain_id": "7111b7a59bff48fa983a6309fae3d7f7", "role_name": "vdcServiceManager", "vdc_name": "SC_289OHFUVQdL", "role_id": "00000000-0000-0000-0000-000000000001", "vdc_id": "bc0366f0-3b60-486f-a88e-2a38266dd444" } ], "display_name": null, "second_verify": "false", "vdc_id": "bc0366f0-3b60-486f-a88e-2a38266dd444", "domain_id": "7111b7a59bff48fa983a6309fae3d7f7", "domain_name": "SC_289OHFUVQdL", "user_type": "0", "name": "SC_289yUXfSpzD", "login_at": null, "id": "b76fc5607bff4ec094891c930cf3b0de", "tag": "vdc", "top_vdc_id": "bc0366f0-3b60-486f-a88e-2a38266dd444", "ldap_name": null }, "federation_regions": []}其中,id为用户Id,name为用户名称,domain_id为租户Id,vdc_id为所属的VDC Id。groups为用户绑定的用户组。2.4 Project(资源集/项目)1. 查询VDC关联的ProjectURLGET https://{SC北向接口域名}/rest/vdc/v3.1/vdcs/{vdc_id}/projects?start=0&limit=100其中,start为分页查询的起始位置,取值在0-2147483647之间,默认从0开始, 默认值为0。分页查询时,start需要为limit的整数倍;limit限制每页显示的条目数量,取值在1-100之间,默认值为10。可包含如下查询条件:(下表包含部分查询条件,全部查询条件请参考《ManageOne 运营面API参考.docx》中”查询指定VDC中资源集集合“接口。)参数类型描述inheritboolean是否查询VDC下所有可见VDC关联的资源集。默认值:falsenamestring模糊搜索所使用的名称字段,长度在1-64之间。sort_dirstring排序方向,取值范围asc,desc。默认值:asc请求头Content-Type:application/json X-Auth-Token:x-xxxxxxxxxxx响应体示例{ "total": 1, "projects": [ { "id": "6aa4d449d6fe4ea68c7cacb1a9803959", "name": "cn-global-205_hzp_project", "description": "", "domain_id": "e1fcb3ba48a64cb2acb5894bcd6d892d", "enabled": true, "tenant_id": "d8e2a487-843b-4309-9d14-e845f593411f", "is_shared": false, "tenant_name": "hzp_vdc", "create_user_id": "b9fd4029af7a4b71a085048b9bbe9072", "create_user_name": "bss_admin", "regions": [ { "region_id": "cn-global-205", "region_name": { "zh_cn": "西安", "en_us": "西安" }, "region_type": null, "region_status": "normal" } ] } ]}其中,id为project Id,name为project名称,domain_id为project所在的租户Id,tenant_id为project所属的VDC Id;tenant_name为project所属的VDC名称;description为project描述;regions为project关联的region信息。2. 查询用户关联的ProjectURLGET https://{SC北向接口域名}/rest/vdc/v3.1/users/{user_id}/projects?start=0&limit=100其中,start为分页查询的起始位置,取值在0-2147483647之间,默认从0开始, 默认值为0。分页查询时,start需要为limit的整数倍;limit限制每页显示的条目数量,取值在1-100之间,默认值为10。可包含如下查询条件:(下表包含部分查询条件,全部查询条件请参考《ManageOne 运营面API参考.docx》中”查询指定VDC中资源集集合“接口。)参数类型描述inheritboolean是否查询VDC下所有可见VDC关联的资源集。默认值:falsenamestring模糊搜索所使用的名称字段,长度在1-64之间。sort_dirstring排序方向,取值范围asc,desc。默认值:asc请求头Content-Type:application/json X-Auth-Token:x-xxxxxxxxxxx响应体示例{ "total": 1, "projects": [ { "regions": [ { "region_id": "cn-global-205", "region_status": "normal", "region_name": { "zh_cn": "西安", "en_us": "西安" } } ], "id": "6aa4d449d6fe4ea68c7cacb1a9803959", "name": "cn-global-205_hzp_project", "iam_project_name": "cn-global-205_hzp_project", "display_name": "cn-global-205_hzp_project", "description": "", "enabled": true, "domain_id": "e1fcb3ba48a64cb2acb5894bcd6d892d", "tenant_id": "d8e2a487-843b-4309-9d14-e845f593411f", "tenant_name": "hzp_vdc", "level": "1", "role_id": null, "role_name": null, "is_shared": "false" } ]}其中,id为project Id,name为project名称,domain_id为project所在的租户Id,tenant_id为project所属的VDC Id;tenant_name为project所属的VDC名称;description为project描述;regions为project关联的region信息。
-
一、VDC模型介绍VDC(Virtual Data Center)是ManageOne运营面进行资源分配的单位,适用于分级运营的场景。例如,对于跨国运营商或跨省公司,包含多个省公司或子公司(一级VDC),省公司或子公司又包含多个下级部门(下级VDC)。在进行资源分配时,每个省公司或子公司使用的所有虚拟资源划分为一个一级VDC进行统一管理,每个下级部门使用的资源可以划分为一个下级VDC。每个VDC可以包含多个下级VDC。目前支持最多划分五级VDC。如果不需要分级运营,则只需创建一个一级VDC,将一级VDC管理员作为全局管理员。VDC租户模型如下图所示 功能描述租户匹配企业或子公司,独立使用云平台资源的边界,不同租户间的数据,操作,网络完全隔离。VDC匹配企业或子公司的部门,最多支持五级满足企业的组织结构。企业项目匹配企业中的项目,云资源配额的载体,具有时效性。资源集云平台管理资源的最小单位,通过资源集可以隔离资源、解决用户授权等复杂性问题。配额可使用云资源的最大限额,支持限制和不限两种方式,当配额不限时可使用云平台或所属VDC的所有资源。用户组具有相同权限的一组用户集合,通过将用户加入用户组,用户组和资源集授权的方式,提高授权便捷性。VDC租户模型描述:1)多级VDC多级VDC组成一个VDC树。VDC是由一个一级VDC为根节点和多个下级VDC组成的具有层次关系的集合;一个VDC中最多可包含五级VDC。一级VDC由运营管理员管理,二级及二级以下VDC由上级VDC管理;二级及二级以下VDC中每一级可以有多个VDC。图中用户1——用户n可以是VDC管理员、VDC业务员或自定义角色的用户。运营管理员可以创建多个VDC,一个VDC中可以包含多个下级VDC、Project、VDC管理员、VDC业务员。每一级VDC中的用户角色除了VDC管理员和VDC业务员,还可以有多个由用户自定的角色。支持代维管理员跨一级VDC代维,便于委托第三方管理运营,代维帐号可以进入被代维的一个或多个一级VDC进行代维。跨一级VDC代维,支持创建、删除、修改代维管理员。代维管理员可以进入被代维的多个一级VDC,代替VDC管理员进行VDC、用户及资源等的管理。代维管理说明如下。代维管理员根据企业组织结构设置各部门,设置各部门资源配额。代维营管理员通过部门切换,为各部门申请资源,并通过线下方式将资源信息通知最终使用者。资源最终使用者并不登录云管平台。代维管理员代维申请的资源,占用申请部门的配额。说明:在ManageOne中,每个租户下有且只有一个一级VDC,可将一级VDC与租户等同看待;VDC是ManageOne运营面进行资源分配的单位,是虚拟的概念,主要作用是在分级运营的场景下,起到控制配额、用户权限的作用;VDC下包含project和用户,project与OpenStack中的project相对应,是资源实体,用户在申请使用各种云资源时,均需要指定到具体的project而非VDC2)企业项目(8.0.3版本新特性)企业项目,云资源配额的载体,具有时效性。提供统一的云资源管理单位,以及企业项目内的配额管理。通过企业项目,可以查看项目概览、管理配额、查看已申请资源、管理授权资源集、查看资源计量信息。创建租户或VDC时默认创建与租户或VDC同名的企业项目。租户或VDC下创建的资源集自动关联默认创建的企业项目。一个企业项目可以关联多个资源集。企业项目共享所属VDC配额。3)资源集(Project/8.0.2及之前版本的项目)Project是对所使用资源的分组,相当于实际中的项目组,各个Project之间资源相互隔离,同一Project中资源共享。一个VDC可以包含多个Project,一个Project只能属于一个VDC。用户在申请资源时,在界面左上角切换到与其关联的某个Project,则用户申请的资源就属于该Project,从而实现资源分组。用户只有和Project关联了同一个用户组,才可以申请或管理对应Project的资源,其中用户申请的资源就属于该Project,从而实现资源分组。例如,用户VDCuser1,在界面左上角切换到与其关联的Project1,并申请ECS1;用户VDCuser2,在界面左上角切换到与其关联的Project2,并申请ECS2;ECS1和ECS2分别属于不同的Project,从而实现了资源的分组。4)配额管理VDC和企业项目的配额均支持限制和不限两种设置方式,配额不限时可使用所属VDC的所有可用配额。属于同一VDC下的企业项目与下级VDC共享此VDC的配额。注:8.0.3版本不支持VDC配额,只支持企业项目配额。8.1.0版本支持通过页面配置VDC配额,但不支持通过API配置。8.0.2及之前版本与8.1.1及之后版本支持通过API配置VDC配额。5)用户组(8.0.3版本新特性)ManageOne通过用户组实现权限管理和授权。基于用户组管理用户权限。提供系统预置用户组和用户自定义用户组的能力。支持以服务为粒度,提供服务相关的角色用于授权。支持基于策略授权,包括系统策略和用户自定义策略。对于VDC管理员,加入用户组后,在该VDC管理员所在的VDC和下级VDC,仍然具备VDC管理权限。系统包含三种预置用户组,分别为:“VDC管理员”、“VDC业务员”、“VDC只读管理员”用户组。但会在每个VDC中预置“VDC管理员”用户组,预置VDC业务员用户组和预置VDC只读管理员用户组需用户手动创建。系统涉及的4种类型用户组权限如下表所示。用户组权限VDC管理员具有所属VDC及下级VDC的管理权限,以及对所有资源具有管理权限。VDC业务员VDC业务员在其关联的资源集内,对所有资源具有管理权限。VDC只读管理员VDC只读管理员对本VDC及其下级VDC中资源、用户、自运维等具有查看权限。自定义权限用户组在自定义时为该用户组赋予相应的操作权限。说明:预置用户组权限不能修改。运营管理员和代维管理员无需关联用户组,创建好即具有相应权限,具体权限如下:运营管理员,具有运营管理类的所有权限。代维管理员,代理一级VDC管理员对本级VDC及下级VDC的管理权限,以及对所有资源具有管理权限。在创建用户时,根据需要选择相应的用户组。运营管理员可以管理所有用户组,VDC管理员或代维管理员只能管理本级和下级VDC的用户组。6)模型实例以XX公司为例,按照VDC租户模型,说明该公司各组织对应的配额、用户组以及资源集情况,如下图所示。案例描述: - 运营管理侧创建了两个企业(租户)分别为成都公司和深圳公司,并为成都公司创建了一级VDC(A产品部)和管理员(VDC_admin_A),为深圳公司创建了一级VDC(B产品部)和管理员(VDC_admin_B)。 - 分配给成都公司A产品部的资源配额为100个CPU和50G内存,为深圳公司B产品部分配的资源配额为200个CPU和100G内存。 - 深圳公司B产品部下设两个部门分别是服务部(二级VDC)和市场部(二级VDC),深圳公司的管理员(VDC_admin_B)为服务部的资源配额为100个CPU和50G内存,同时分配的员工有员工1、员工2和员工3,分配的版本项目有维护项目1和维护项目2,分别关联资源集1和资源集2,用户组为操作员组1;为市场部的资源配额为100CPU和50G内存,同时分配的员工有员工4、员工5和员工6,分配的版本项目有创新项目1和创新项目2,分别关联资源集3和资源集4,用户组为操作员组2。 - 深圳公司B产品部的管理员(VDC_admin_B)可以为各部门的各用户和资源集进行授权。 7)基线规格ManageOne的租户模型存在基线规格限制,如果客户的组织架构规模较大,对接时需考虑横向扩展。序号指标(私有云)数值(个)1最大租户数量10002单租户下VDC的总数量503单租户下用户的数量10004单租户下project的数量10005单租户下的企业项目的数量10006单租户下用户组的数量1507用户组关联的project的数量208用户组关联的用户数100 二、资源池模型资源池模型如下如所示:基本概念:基本概念说明云一种通过Internet以服务的方式提供动态可伸缩的虚拟化的资源的计算模式。区域从物理位置的维度划分资源池。例如:华南Region、华东Region等。资源池指云计算数据中心中所涉及到的各种硬件和软件的集合,根据底层虚拟化技术或者业务使用场景划分资源的集合。ManageOne支持的资源池类型如下,不同使用场景下由于接入资源池的要求和能力不同,将涉及一个或多个不同资源池。私有云:FusionSphere OpenStack资源池、IaaS OpenStack资源池、FusionCompute资源池、FusionManager资源池、VMware资源池、Hyper-V资源池、PowerVM资源池、FusionInsight资源池。说明:FusionSphere OpenStack资源池特指华为云Stack场景下的OpenStack资源池,IaaS OpenStack资源池特指HCS Online场景下的OpenStack资源池。公有云:华为云资源池、华为云Stack Online资源池(云联邦)。两级云:两级云资源池。可用分区不同的可用分区具有独立的风火水电,物理隔离,是最终租户可见的资源池划分,包含可用的计算资源和存储资源。一个可用分区可包含一个或多个主机组。通常可用分区按照计算资源架构划分,如:X86分区、ARM分区、裸金属分区等。主机组(集群)对计算节点进行的逻辑上的划分,是管理员用来根据硬件资源的某一属性来对硬件进行划分的功能。三、常见问题1. 一级VDC与租户的关系在ManageOne的租户模型中,单租户下可划分五级VDC,其中,一级VDC与租户是1对1关系。但需要注意的是,一级VDC并不完全等同于租户,在《ManageOne 运营面API参考.docx》文档中,vdc通常表示为vdc或tenant,而租户表示为domain。2. 接口参数的tenantId表示什么在《ManageOne 运营面API参考.docx》文档中,tenantId表示VDC id。在《ManageOne 云服务Params参数说明.docx》和《华为云Stack API接口参考.chm》文档中,tenantId表示project id(project为Openstack中的租户,这种表示是为了与开源社区保持一致,在8.1.0及以上版本,云服务文档已统一表示为project id)。3. VDC、project、资源池的关联关系VDC与资源池的关系:在创建一级VDC或子级VDC时,会要求选择该VDC可用的区域、资源池和可用分区。因此,VDC与区域、资源池和可用分区是多对多关系,VDC可关联个区域,区域也可关联多个VDC。VDC与project的关系:1个VDC下可以创建多个project,但1个project只能属于1个VDC,因此是一对多关系。project与资源池的关系:同VDC与资源池的关系类似,project可在创建时选择关联的区域(但不能再选择资源池、可用分区,默认全部选择)。因此,project与区域、资源池和可用分区是多对多关系,project可关联个区域,区域也可关联多个project。
-
1、场景说明大型企业采购华为云Stack全站云平台之后,需要匹配内部的组织结构进行分级运营,达到资源隔离,按需分配的目的,此时需要结合ManageOne的VDC模型进行设计,将子公司(或省公司)设置为一级VDC,然后子公司(或省公司)再根据实际划分子级VDC。还有一种常见场景是,运营商采购华为云Stack全站云平台,面向政企客户提供云计算服务,这种情况下,每个政企客户也需要独占一个一级VDC。上述两种场景只涉及初期的组织模型规划,通常,大型企业或者运营商在实际运营过程中,还需要实现现有运营平台(如BSS,CRM等)与华为云Stack的对接,基本的是实现自动开户、快速获取账单的功能,达到自助申请,一键开通,可追溯审计的效果,从而使云计算的运营能够纳入到企业、运营商的日常经营中。本文主要给出如何实现企业、运营商的运营系统与华为云Stack进行对接,实现自动开通租户(即一级VDC)的功能。2、流程介绍本文以开通租户为例,介绍如何通过API创建租户,并完成必要的配置操作,使得用户可以在新创建的租户内申请云资源,流程图如下: 2、流程说明:1. 创建租户/一级VDC2. 为租户/一级VDC分配Region、资源池、可用分区3. 为租户/一级VDC分配外部网络。(不执行此步骤则无法创建VPC、EIP)4. 创建Project(资源集)5. 创建用户,并为用户授权Project。此步骤根据是否需要细粒度授权选择不同接口。除此之外,还有以下可选操作:1. 设置VDC配额(新租户创建完成后默认没有配额限制,如果需要限制配额,可在此步骤限制配额。)2. 创建企业项目、设置企业项目配额(企业项目为8.0.3版本新特性,相关介绍:链接。新租户创建完成后默认自带一个企业项目。如果不需要使用相关特性,直接无视即可,不需要做任何配置。)完成以上操作后,新创建用户可以登录ManageOne并申请资源。
-
ManageOne提供开放能力支持与周边多种系统集成,主要通过产品预集成和定制开发集成两种方式实现全景图如下: 约束条件:上述可定制能力全景图针对ManageOne 8.x 及以上版本,6.5.x不支持⑦、⑪、⑫、⑬,其他更低版本需另行评估 ManageOne定制开发伙伴介绍以下两家合作伙伴与ManageOne有长期的合作,具备承接ManageOne相关集成定制开发能力。光华冠群:cid:link_2光华冠群(N2One):cid:link_0天源迪科(易杰数码):cid:link_3 一、产品预集成A)LDAP/RADIUS:支持对接提供LDAP/RADIUS标准协议的认证系统使用场景:客户已有LDAP或RADIUS系统保存了用户和密码相关信息,希望在ManageOne登录页面上输入原来系统的用户名密码实现登录,此场景仅仅用户名和密码保存在客户系统,登录页面还是ManageOne的原生页面。 B)N2One:合作伙伴光华冠群开发的异构云服务纳管软件,已经和ManageOne做了预集成使用场景:客户有vmware、华三、浪潮等私有云或公有云需要纳管。 C)eSight:eSight为华为解决方案中可选组件使用场景:纳管华为物理设备,包括服务器、交换机、防火墙和存储等。 D)ZOHO:ZOHO为第三方厂商系统,已和ManageOne做了预集成使用场景:纳管客户第三方物理设备,包括服务器、交换机、防火墙和存储等。 二、定制开发集成ManageOne提供多种可定制能力支持二次开发,通常是新开发一个独立安装部署的中间适配程序,目的是实现解耦,ManageOne能够独立升级。可定制能力区分可选定制和必选定制:A)可选定制表示接提供业界标准协议对接,如果外部系统不是标准协议,可以通过定制程序转换为客户私有协议实现对接。B)必须定制表示这类可定制能力为华为制定的规范,因此必须通过二次开发完成对接。 各类二次开发能力视频教程汇总:cid:link_1 以下详细解释每种可定制能力和使用场景:①②:北向接口适配支持系统:运营面使用场景:客户的运营系统需要抽取ManageOne的租户、VDC、订单、计量等数据做综合展示或分析;客户的认证系统希望把用户同步到ManageOne或者把ManageOne的用户上报到客户系统,支撑单点登录认证;开发参考:cid:link_4 ③:北向接口适配支持系统:运维面使用场景:客户综合网管需要抽取ManageOne的资源、性能数据,主要包括物理设备(服务器、交换机、防火墙等)、虚拟资源(虚拟机、云硬盘、镜像等)。开发参考:cid:link_4 ④:告警上报支持系统:运维面使用场景:运维侧支持SNMP协议将告警上报给客户网管,如果告警格式或者协议不满足要求,则可通过定制适配实现。开发参考:cid:link_6 ⑤:单点登录集成(第三方系统作为认证中心)支持系统:运营面、运维面使用场景:客户已经有自己的认证中心,希望登录ManageOne时跳转到客户的认证中心登录,登录完成后直接进入ManageOne使用,这样客户还是保持以前的登录习惯,也不用再记忆一套用户名和密码。开发参考:cid:link_7 ⑥:单点登录集成(ManageOne作为认证中心)支持系统:运营面、运维面使用场景:ManageOne提供标准CAS2.0协议,客户已有一套或者多套系统,希望统一通过ManageOne的用户密码实现登录,登录成功后打开其他系统则不需要再输入用户密码直接登录。开发参考:cid:link_8 ⑦:菜单集成支持系统:运营面使用场景:客户已有系统,希望能够在ManageOne上新增一个菜单,点击这个菜单后可快速跳转到客户自己的系统,通常还会配合单点登录功能实现免登录;另外一种场景为客户可以在外部独立开发几个页面,然后在菜单上加上这些页面的地址,作为扩展ManageOne的功能。开发参考:cid:link_9 ⑧:审批流程对接支持系统:运营面使用场景:客户已有比较成熟的OA系统,各类事件都统一通过OA审批,用户通过ManageOne申请资源时,订单可以发送到OA审批系统,领导直接在熟悉的系统上操作,审批通过后ManageOne再发放资源。开发参考:cid:link_10 ⑨:计量数据对接支持系统:运营面使用场景:客户有功能强大的计费系统,需要ManageOne提供单个资源的详细计量数据,此时可以通过SFTP协议拉取话单文件,然后解析话单得到单个资源的使用详细数据。开发参考:cid:link_5 ⑩⑪⑫:第三方云服务对接支持系统:运营面使用场景:第三方云服务是所有能够被服务化的第三方系统的统称,比如社区Openstack、vmware、各厂商的公有云IAAS资源,可以分解为虚拟机、云硬盘、网络、镜像等云服务;通过购买合作伙伴纳管插件实现功能 ⑬:南向驱动对接支持系统:运维面使用场景:客户有自己的网管或应用监控系统,需要把相关资源、性能和告警数据上报到ManageOne统一监控,此时可以通过开发南向驱动实现数据上报。通过购买合作伙伴纳管插件实现功能 ⑭:日志上报支持系统:运营面、运维面使用场景:客户有审计系统,需要ManageOne提供相关日志,ManageOne已支持syslog主动上报日志,如果客户需要通过其他协议上报,则可通过定制程序实现协议转换并上报数据。 ⑮:短信对接支持系统:运维面使用场景:客户需要通过短**送ManageOne信息(如告警),ManageOne已经支持业界多种短信标准协议,页面直接配置即可,但如果客户需要对接自研的短信网关,则可通过定制程序转换协议实现对接。开发参考:cid:link_11 ⑯:邮箱对接支持系统:运维面使用场景:客户需要通过邮件发送ManageOne信息(如告警),ManageOne已经支持邮件发送标准协议,页面直接配置即可,但如果客户需要对接自研的邮件网关,则可通过定制程序转换协议实现对接。 ⑰:告警转工单对接支持系统:运维面使用场景:客户有专门的工单处理系统,需要ManageOne的告警转发到客户已有工单系统进行处理,可通过定制程序开发实现。
-
在mdc610上进行VENC视频编码,目前初始代码编译报错提示找不到头文件,我想咨询一下大家,MDC610的SDK包包含由该类的头文件吗?自己貌似没找到?如何解决呢?
-
华为云stack部署modelarts服务的话,modelarts创建专属资源池的时候,是否可以选择stack本地计算资源
-
1 ManageOne计量能力介绍ManageOne中支持基本的资源计量、计费能力,具体如下:在ManageOne中,支持设置全局费率(所有租户的费率一样),租户(一级VDC)维度的费率(不同租户下,资源费率不同);资源则按照类别定义费率用户申请云资源之后,云服务会定时上报计量信息给ManageOne,ManageOne会对计量数据分析汇总,会按照租户、VDC(此处特指子级VDC)生成对应的计量汇总数据ManageOne根据计量汇总数据,资源费率计算得到VDC(特指子级VDC),租户的账单ManageOne中支持为租户设置虚拟账户,租户申请资源后,会按照计费周期进行扣费,费用使用完之后,不能再申请资源ManageOne提供开放的REST API给第三方,用于获得租户账单,资源计量汇总清单ManageOne中不支持费率折扣2 约束条件本文适用于ManageOne 8.3.0及以上版本。3 查询资源维度的计量数据离线话单文件是计费结算系统输入、输出的重要依据,文件由话单文件,签名文件压缩组成,系统每隔一段时间(小时)触发采集话单数据并进行压缩,将压缩后的文件上传至话单服务器。计费系统获取话单文件后参考文件规范和规则,计算出资源的使用量再按照业务维度进行汇总统计。涉及接口如下:获取Token查询VDC列表查询云服务话单记录接口具体描述,请参考《ManageOne 8.X 运营面API参考 .docx》。3.1 准备工作1、获得运营管理员账号密码2、正式调用接口前,您需要获取对应的IP、域名,并打通网络,请参考:cid:link_03.2 查询资源维度的计量数据步骤1:获取管理员token请求URL:https://{IAM对外访问域名}/v3/auth/tokens请求方法:POST请求头:Accept:application/jsonContent-Type:application/json;charset=UTF-8请求体:(注:运营管理员的domain name固定为mo_bss_admin,VDC管理员的domain name为租户名。){ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "domain": { "name": "mo_bss_admin" }, "name": "XXXX", "password": "XXXXXX" } } }, "scope": { "domain": { "name": "mo_bss_admin" } } }}返回的token在响应头中,示例如下:HTTP/1.1 201 CreatedContent-Type: application/json; charset=utf-8Connection: keep-aliveX-Subject-Token: MIIECwYxxxxxxxxxxxxxxxxxxSQ3G2RAj89N+t9GECHGnnGUgkKj7vMesUZ2jEW6EiVYA==X-Subject-Token的值即为我们所需要的token步骤2:查询区域列表URLGET https://{SC北向接口域名}/silvan/rest/v1.0/regions请求头Content-Type:application/jsonX-Auth-Token:x-xxxxxxxxxxx请求体:无响应体示例{ "regions": [ { "seqId": 1, "id": "whdevp-env-5", "name": "维护开发环境5", "created": "2024-06-18 21:11:36.0", "lastModified": "2025-04-13 14:46:49.0", "locale": "zh-cn", "active": true, "domainType": "SC", "type": "private", "deployType": null, "authUrl": null, "iamId": null, "globalId": "whdevp-env-5" } ], "total": 1}取id字段为区域Id,如whdevp-env-5。步骤3:查询VDC列表URLGET https://{SC北向接口域名}/rest/vdc/v3.0/vdcs?start=0&limit=1000其中,start为分页查询的起始位置,取值在0-2147483647之间,默认从0开始, 默认值为0。分页查询时,start需要为limit的整数倍;limit限制每页显示的条目数量,取值在1-1000之间,默认值为20。可包含如下查询条件:(下表包含部分查询条件,全部查询条件请参考《ManageOne 运营面API参考.docx》中”查询VDC列表“接口。)参数类型描述namestringVDC名称,长度在0-128之间。upper_vdc_idstring上级VDC id。domain_idstring所属租户id。levelint32VDC级别,取值在1-5之间。sort_keystring排序字段,支持按create_at、name字段排序。默认值:name。sort_dirstring排序方向,取值范围asc,desc。默认值:asc。is_domainstring是否为租户,1代表是,0代表不是。query_namestring过滤字段。取值范围domainName,upperVdcName,extraquery_valuestring过滤字段值。请求头Content-Type:application/json X-Auth-Token:x-xxxxxxxxxxx请求体:无响应体示例{ "total": 1, "vdcs": [ { "id": "eba900c3-1386-422e-a68d-da4f1f0aef18", "name": "yiwa", "tag": "vdc", "description": null, "upper_vdc_id": "0", "upper_vdc_name": null, "top_vdc_id": "eba900c3-1386-422e-a68d-da4f1f0aef18", "extra": "{\"manager\":\"\",\"phone\":\"\",\"email\":\"\"}", "ecs_used": 0.0, "evs_used": 0.0, "project_count": 6, "enabled": true, "domain_id": "293e0d295e0f4110abf1697da9c68787", "level": 1, "create_user_id": "a3c77832e5cb4a4593acb340ab627dc7", "create_user_name": "bss_admin", "create_at": 1719453859000, "utc_create_at": "2024-06-27 02:04:19.0", "domain_name": "yiwa", "ldap_id": null, "third_id": null, "idp_name": null, "third_type": "0", "region_id": null, "enterprise_id": null, "az_id": null, "enterprise_project_id": null } ]}取domain_id字段为租户id,如响应示例的租户id为293e0d295e0f4110abf1697da9c68787。步骤3:查询云服务话单记录URLPOST https://{SC北向接口域名}/rest/metering/v3.0/query-metrics-data其中,start为分页查询的起始位置,取值在0-2147483647之间,默认从0开始, 默认值为0。分页查询时,start需要为limit的整数倍;limit限制每页显示的条目数量,取值在1-1000之间,默认值为20。可包含如下查询条件:(下表包含部分查询条件,全部查询条件请参考《ManageOne 运营面API参考.docx》中”查询VDC列表“接口。)请求头Content-Type:application/json X-Auth-Token:x-xxxxxxxxxxx请求体示例:{ "region_code": "whdevp-env-5", "start_time": "2025-04-01 00:00:00", "end_time": "2025-04-04 23:59:59", "time_zone": "Asia/Shanghai", "period": "daily", "locale": "zh_CN", "domain_id": "293e0d295e0f4110abf1697da9c68787", "resource_type_code": "hws.resource.type.volume", "limit": 1000}参数说明如下:region_code:区域id,必填,从步骤2获取start_time:开始时间,必填end_time:结束时间,必填period:查询周期,取值范围如下: hourly:小时,查询开始时间和结束时间的间隔不能超过一周。只保存最近10天的数据,超出范围则无法查询。 daily:天,查询开始时间和结束时间的间隔不能超过一月。只保存最近1000天的数据,超出范围则无法查询。 monthly:月,查询开始时间和结束时间的间隔不能超过一年。domain_id:租户id,从步骤3获取time_zone:时区,国内填写Asia/Shanghailocale:查询语言,中文:zh_CN,英文:en_US,默认为英文。resource_type_code:云资源类型编码,支持计量的资源清单参考附录,如云硬盘为hws.resource.type.volumelimit:每页显示的条目数量响应体示例{ "metrics": [ { "id": "c9e7dd89-70b1-46a0-8851-f519c07610c4", "record_type": "20", "user_id": "2e1ffdb5060b493d94583ff4bfa8f3b6", "region_code": "whdevp-env-5", "cloud_infra_id": "", "az_code": "az5.dc5", "cloud_service_type_code": "hws.service.type.evs", "resource_type_code": "hws.resource.type.volume", "resource_spec_code": "IPSAN", "resource_id": "4dcfaecc-ec31-424f-9811-32f33c811ce1", "resource_display_name": "xp02-volume-0000", "bss_params": "::xp02-volume-0000", "start_time": "2025-04-01 00:00:00", "end_time": "2025-04-02 00:00:00", "tag": "", "upper_vdc_id": "eba900c3-1386-422e-a68d-da4f1f0aef18", "vdc_id": "eba900c3-1386-422e-a68d-da4f1f0aef18", "enterprise_project_id": "0", "meter_unit_id": "-1", "meter_unit_name": "", "extend_params": "", "meter_ways": "hour", "spec_define_name": "IPSAN(业务卷5)", "price": "4", "usage_duration": 86400, "accumulate_mode": "DURATION", "spec_define_id": "7423ab31-aed9-4805-880f-def7e2c4aa11", "price_unit": "GB", "usage_value": 8 }, { "id": "f38bc16e-db80-437a-9342-83296dc3bbba", "record_type": "20", "user_id": "2e1ffdb5060b493d94583ff4bfa8f3b6", "region_code": "whdevp-env-5", "cloud_infra_id": "", "az_code": "az5.dc5", "cloud_service_type_code": "hws.service.type.evs", "resource_type_code": "hws.resource.type.volume", "resource_spec_code": "IPSAN", "resource_id": "0533b000-3000-46da-bedb-923dea693d9b", "resource_display_name": "ecs03-volume-0000", "bss_params": "::ecs03-volume-0000", "start_time": "2025-04-01 00:00:00", "end_time": "2025-04-02 00:00:00", "tag": "", "upper_vdc_id": "eba900c3-1386-422e-a68d-da4f1f0aef18", "vdc_id": "eba900c3-1386-422e-a68d-da4f1f0aef18", "enterprise_project_id": "0", "meter_unit_id": "-1", "meter_unit_name": "", "extend_params": "", "meter_ways": "hour", "spec_define_name": "IPSAN(业务卷5)", "price": "4", "usage_duration": 86400, "accumulate_mode": "DURATION", "spec_define_id": "7423ab31-aed9-4805-880f-def7e2c4aa11", "price_unit": "GB", "usage_value": 10 }, ......... ], "time_zone": "Asia/Shanghai", "start_time": "2025-04-01 00:00:00", "end_time": "2025-04-04 00:00:00", "total": 117, "marker": ""}响应体关键字段说明:user_id:project/资源空间/资源集idregion_code:区域idaz_code:可用区idcloud_service_type_code:云服务类型编码resource_type_code:云服务类型编码resource_spec_code:资源规格编码resource_id:资源idresource_display_name:资源实例名称start_time:开始时间end_time:结束时间accumulate_mode:累计模式: DURATION: 累计使用时长,举例:申请100G云硬盘1天,累计使用时长为86400秒;USAGE: 累计使用量,使用时长固定1,举例:一天发送短信10条,累计使用量为10条usage_value:使用量,保留6位小数,在统计开始时间 ~ 统计结束时间期间对应的使用量累积值usage_duration:使用时长,单位:秒,在统计开始时间 ~ 统计结束时间期间对应的使用时长累积值price:单价price_unit:单价单位 spec_define_name:计费项名称vdc_id:VDC IDupper_vdc_id:一级VDC ID可参考界面报表: 附录:支持计量的资源清单参考(8.5.0)注:可通过浏览器访问此链接获取当前环境支持的计量资源列表(需登录,非接口请勿调用):https://{运营面console域名}/moserviceaccesswebsite/goku/rest/price/v3.0/price-support-service?locale=zh_CN&type=all服务Id资源类型编码(resource_type_code)资源类型名称eiphws.resource.type.bandwidthflow弹性IP-计量eiphws.resource.type.ip弹性IPevshws.resource.type.snapshot云硬盘-快照vpnhws.resource.type.vpnconnectionVPNvpnhws.resource.type.vpnbandwidthVPN-带宽vpchws.resource.type.natgatewayNAT网关elbhws.resource.type.lbaas弹性负载均衡dlinehws.resource.type.dc云专线eiphws.resource.type.bandwidth弹性IP-带宽evshws.resource.type.volume云硬盘ecshws.resource.type.vm弹性云服务器obsv3hws.resource.type.obsv3对象存储v3cfwhws.resource.type.cfw云防火墙dbashws.resource.type.dbas数据库审计服务wafhws.resource.type.waf.instanceWeb应用防火墙hsshws.resource.type.hss主机安全hsssec.hss.instance趋势主机安全服务cbhhws.resource.type.cbh.ins云堡垒机rdshws.resource.type.rds.obs关系型数据库-备份容量rdshws.resource.type.rds.vm关系型数据库-规格rdshws.resource.type.rds.volume关系型数据库-存储容量rdshws.resource.type.rds.licenseRDS许可证dwshws.resource.type.dws.obs数据仓库集群快照dwshws.resource.type.dws.vm数据仓库节点dcshws.resource.type.dcs3Redis4.0/5.0/6.0dwshws.resource.type.dws.bms数据仓库裸机节点ddshws.resource.type.dds.obs文档数据库服务-备份空间ddshws.resource.type.dds.vm文档数据库服务-虚拟机dcshws.resource.type.dcsRedis实例ccehws.resource.type.cce.cluster云容器引擎daswafsec.daswaf.instanceWEB应用防火墙-安恒dasdbauditorsec.dasdbauditor.instance数据库审计-安恒daswebsec.dasweb.instance网页防篡改-安恒romahws.resource.type.roma.platform应用与数据集成平台dasusmbsec.dasusmb.instance云堡垒机-安恒dasloggersec.daslogger.instance日志审计服务-安恒cdmhws.resource.type.dayu.cdm云数据迁移实例dasrassec.dasras.instance漏洞扫描服务-安恒ddshws.resource.type.dds.volume文档数据库服务-云硬盘kmshws.resource.type.kms密钥管理服务dcshws.resource.type.dcs3Redis4.0/5.0sfshws.resource.type.sfs弹性文件服务-共享dasaigatesec.dasaigate.instance数据安全网关-安恒dschws.resource.type.dsc.obs数据安全中心-对象存储dschws.resource.type.dsc.base数据安全中心-数据底座dschws.resource.type.dsc.db数据安全中心-数据库servicestagehws.resource.type.servicestage应用管理与运维平台servicestagehws.resource.type.servicestage.engine微服务引擎专享版SecMasterhws.resource.type.csb.professional安全云脑专业版SecMasterhws.resource.type.csb.largescreen安全云脑大屏bigdatahws.resource.type.bigdataMapReduce服务虚拟机apmhws.resource.type.apm2.instanceAPM Agents数量geshws.resource.type.ges图实例gaussdbhws.resource.type.opengauss.obsGaussDB备份空间gaussdbhws.resource.type.opengauss.vmGaussDB虚拟机gaussdbhws.resource.type.opengauss.volumeGaussDB云硬盘bcshws.resource.type.bcs区块链服务drshws.resource.type.drs.vm数据迁移服务器drshws.resource.type.drs.flow数据复制服务drshws.resource.type.drs.volume数据复制服务-存储容量bmshws.resource.type.pm裸金属服务器modelartshws.resource.type.modelartsmodelarts虚拟计算实例sfshws.resource.type.sfs_snapshot弹性文件服务-快照dewhws.resource.type.dew数据加密服务edshws.resource.type.eds.connector数据连接器edshws.resource.type.eds.instance数据空间实例ddmhws.resource.type.ddm分布式数据库中间件计算资源servicestagehws.resource.type.cse.gateway应用网关dschws.service.type.dscforhcs1数据安全中心-专业版底座newdschws.resource.type.dsc.base数据安全中心-专业版底座servicestagehws.resource.type.cse.servicecenter微服务注册配置中心servicestagehws.resource.type.servicestage.cse微服务引擎专业版ddmhws.resource.type.ddm.root分布式数据库中间件集群dmshws.resource.type.dms.platinum.rocketmq分布式消息服务RocketMQdmshws.resource.type.dms.platinum.kafka分布式消息服务Kafkagithws.resource.type.aicortex.geoforhcs.pl时空计算服务-室外3D模型重建产线githws.resource.type.aicortex.gitforhcs城市智能中枢githws.resource.type.aicortex.geoforhcs.wf时空计算服务-时空计算流程引擎-vCPUgithws.resource.type.aicortex.iitforhcs工业智能中枢EBShws.resource.type.ebs.service调度服务evshws.resource.type.airgap_protected_group_count保护组副本个数evshws.resource.type.secure_snapshot_capacity安全快照卷容量evshws.resource.type.secure_snapshot_count安全快照个数evshws.resource.type.airgap_protected_group_capacity保护组卷容量AppStagehws.resource.type.appstage.wiseagentAI原生应用引擎githws.resource.type.aicortex.geoforhcs.alg时空计算服务-遥感AI解译产线githws.resource.type.aicortex.geoforhcs.wf.gpu时空计算服务-时空计算流程引擎-GPUgithws.resource.type.aicortex.vaisforhcsAI视频服务githws.resource.type.aicortex.geoforhcs.mag时空计算服务-时空数据管理
-
请问得分大于1696594336分,指的是题目里给出的方式计算出的score吗,这样得分越大是不是就说明曲率越大越好?感觉一般来说这种beautiful都是指更“圆滑”吧,还是说那个分数线是最终结果再经过什么转换?
-
Service OM中报,证书过期预警,证书类型是FusionSphere-KeyStone,请问这个告警有什么影响,到期之后会影响云平台正常业务和使用么,怎么更新这个证书
上滑加载中
推荐直播
-
华为云码道 × 仓颉编程:工程化AI编码探索2026/05/27 周三 19:00-21:00
刘俊杰-华为云仓颉语言专家/李炎-华为云码道技术专家/王智鹏-OpenCangjie开源社区发起人
本场直播围绕华为云仓颉语言与华为云码道的深度结合,展示华为云智能编程从零基础到高效落地的完整生态能力。以华为云码道为引擎,仓颉语言为载体,带给大家日常提效、趣味创新到极速量产的开发体验。
回顾中
热门标签