华为云用户手册

MPC系统权限 默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 新建的IAM用户如果需要使用MPC服务控制台，必须至少具备如下5个服务的策略权限： BILLINGFullAccessPolicy：CBC服务策略 IAMFullAccessPolicy：IAM服务策略 MPCFullAccessPolicy：MPC服务策略 OBSFullAccessPolicy：OBS服务策略 SMNFullAccessPolicy：SMN服务策略 MPC部署时通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域（如华北-北京四）对应的项目（cn-north-4）中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问MPC时，需要先切换至授权区域。 目前MPC系统角色只有“MPC Administrator”，具有媒体处理服务里的所有操作权限。 若您需要对除MPC之外的其它服务授权，IAM支持服务的所有权限请参见系统权限。

套餐包抵扣顺序 抵扣顺序原则 当购买了多个相同属性的套餐包，会按照套餐包过期时间顺序进行抵扣，优先抵扣过期时间近的套餐包。 示例 场景 某客户分别购买了两个“华北-北京四”区域的转码包。 套餐包A：规格10万分钟的H.264标准转码包，2022年10月1日生效，购买时长1年，即2023年10月1日过期。 套餐包B：规格50万分钟的H.264标准转码包，2022年10月10日生效，购买时长1年，即2023年10月10日过期。 抵扣顺序 2022年10月1日~10月9日 只有套餐包A生效。 使用套餐包A抵扣，超出10万分钟的部分按需计费。 2022年10月10日~2023年9月30日 套餐包A、B同时生效，叠加使用。 优先使用套餐包A抵扣，超出10万分钟的部分使用套餐包B抵扣，超出50万分钟的部分按需计费。 2023年10月1日~10月9日 套餐包A过期，只有套餐包B生效。 使用套餐包B抵扣，超出50万分钟的部分按需计费。 2023年10月10日及以后 套餐包A、B均已过期，此时为按需计费。

套餐包说明 媒体处理服务为按需计费，您也可以通过预付费套餐包的方式，提前购买使用额度，获取更多的优惠。套餐包的有效期为1年，超出套餐包的部分自动转按需计费。如何购买套餐包？ 媒体处理服务暂不支持退订套餐包，建议您在购买套餐包前提前规划资源的使用额度。 套餐包仅支持实名认证用户购买，且限本账号使用。 套餐包购买后生效时间为北京时间当日零点，有效期为1年。 购买的套餐包只能在绑定的区域使用。如果您购买“华北-北京四”区域的转码套餐包，那么在“亚太-新加坡”区域使用视频转码功能时，无法通过该套餐包抵扣转码费用。 计费时优先使用套餐包中的额度，该额度使用完后，自动转为从余额扣费。 套餐包超过有效期自动失效，失效后剩余资源将作废，自动转为从余额扣费。 支持购买多个套餐包，可叠加使用，有效期不叠加，实际抵扣时按最早过期时间依次抵扣。 套餐包中的时长为LD转码时长，FHD，HD和SD转码将按对应的比例折算，FHD/HD/SD转码时长比例为3:1.5:1。即1倍的FHD转码时长折算成3倍的SD转码时长；1倍的HD转码时长折算成1.5倍的SD转码时长。 若使用媒体处理服务进行音频转码，产生的转码时长将先按（5/22）的比例折算成“视频H.264，LD (640 x 480) 及以下”规格的时长，然后再计费。 媒体处理服务提供的套餐包如表1所示，各套餐包在不同规格下的具体价格，请参见产品价格详情。您可以通过媒体处理提供的价格计算器，根据您的业务诉求，快速计算出购买媒体处理的参考价格。 表1 套餐包说明 套餐包 作用 使用限制 转码套餐包 H.264标准转码包：用于抵扣H.264 SD标准转码，未开启高清低码产生的转码时长费用。 H.264高清低码包：用于抵扣H.264 SD标准转码，且开启了高清低码产生的转码时长费用。 H.265标准转码包：用于抵扣H.265 SD标准转码，未开启高清低码产生的转码时长费用。 H.265高清低码包：用于抵扣H.265 SD标准转码，且开启了高清低码产生的转码时长费用。 说明： 4K/2K转码暂只支持按需计费。 只能用于套餐包所属区域。

计费公式 费用的计算公式为：费用=实际资源使用量*资源单价 按需计费模式下各计费项的具体价格，请参见产品价格详情。你可以通过媒体处理提供的价格计算器，根据您的业务诉求，来快速计算出购买媒体处理的参考价格。 如果需要计算每小时产生的费用，则需要将资源单价转换为以小时计费。如标准存储（单AZ）单价为0.0990元/GB/月，则每小时的单价为：0.0990元/GB/月*(1/24/30)=0.0001375元/GB/小时

套餐包购买 预先购买指定转码套餐包，套餐包生效后，优先扣除套餐包中相应的额度。媒体处理套餐包的详细介绍，请参见套餐包概述，您可以根据实际需求购买MPC套餐包。 登录购买MPC套餐包界面。 根据界面提示进行信息配置。 不同的区域之间套餐包不互通，每个区域需要单独购买。 单击“立即购买”。 确认订单无误后，单击“去支付”。若发现订单有误，也可单击“上一步”修改订单后再继续购买。 根据界面提示进行订单支付。 套餐包支持续订，暂不支持退订。套餐包到期后，不会影响您在媒体处理服务上的使用和数据安全。您只要保证云服务账号上有足够的余额，系统会自动以按需计费的模式进行结算。 套餐包购买完成后，用户可以直接使用媒体处理服务。 系统根据套餐包，自动抵扣计费项，无法抵扣的计费项将按需计费。 父主题： 按需预付费套餐包

什么是区域、可用区？ 区域和可用区用来描述数据中心的位置，您可以在特定的区域、可用区创建资源。 区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。

身份认证 身份凭证及其安全性 MPC支持通过账号和IAM用户两种身份访问，并且均支持通过用户名密码、访问密钥和临时访问密钥进行身份认证。如表1所示，每一种身份凭证，MPC都对其进行安全性设计，目的是保护用户数据，让用户更安全地访问MPC。 表1 表1 MPC身份凭证和安全性设计 访问凭证 安全性简要说明 详细介绍 用户名、密码 按需配置用户密钥字符种类和最小长度，支持配置密码有效期策略和密码最短使用时间策略。 密码策略 访问密钥 华为云通过AK识别访问用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。 访问密钥 临时访问密钥 临时访问密钥除了具备访问密钥特性，还具备时效性，可对有效期进行设置，到期后无法重复使用，只能重新获取。 临时访问密钥 登录保护及登录验证策略 如表2所示，除了要求用户登录出示凭证并验证合法性，MPC还提供登录保护机制，支持登录验证策略，防止用户信息被非法盗用。 表2 表2 登录保护和登录验证策略 登录保护手段 简要说明 详细介绍 登录保护 除了在登录页面输入用户名和密码外（第一次身份验证），用户登录华为云还需要在登录验证页面输入验证码（第二次身份验证）。 验证设备支持手机、邮箱和虚拟MFA设备，详见多因素认证。 登录保护 登录验证策略 MPC支持会话超时策略，超过规定时长未操作界面需重新登录；支持账号锁定策略，登录失败次数过多触发账号锁定；支持账号停用策略，长时间未登录触发账号停用；支持最近登录提示，用户可查看上次登录时间。 登录验证策略

基于视频直播服务的责任共担 视频直播服务使用场景中，如下角色需要共同参与和责任共担。各个角色的安全责任边界说明，如下所示： 华为云租户 负责直播管理，包括如下安全责任： 直播平台与直播APP的应用和数据安全。 直播活动安全运营。 最终用户（主播或观众）安全管理，包括：直播视频内容的安全监管等。 监管机构响应能力。 视频直播服务 Live的安全责任，如下所示： 传输网络的基础设施安全，完成视频内容的安全传输和处理。 租户数据安全配置。 提供相应技术，如：截图、录制等，支撑租户监管视频内容。 监管机构响应能力。 最终用户 主播和观众负责视频生产和消费视频内容的安全。

基于华为云的责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的云安全挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。 华为云：负责云服务自身的安全，提供安全的云。华为云的安全责任在于保障其所提供的IaaS、PaaS和SaaS各类各项云服务自身的安全，涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身，也包括运维运营安全，以及更广义的安全合规遵从。 租户：负责云服务内部的安全，安全地使用云。 华为云租户的安全责任在于对使用的IaaS、PaaS和SaaS类各项云服务内部的安全以及对租户定制配置进行安全有效的管理，包括但不限于虚拟网络、虚拟主机和访客虚拟机的操作系统，虚拟防火墙、API网关和高级安全服务，各项云服务，租户数据，以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措施，包括云安全战略、责任共担模型、合规与隐私、安全组织与人员、基础设施安全、租户服务与租户安全、工程安全、运维运营安全、生态安全。 图1 华为云安全责任共担模型

对未成年人的保护 华为非常重视对未成年人个人信息的保护，华为将严格按照国家法律法规要求对未成年人提供服务并对未成年人提供保护。如果您是未成年人，需要您的父母或其他监护人同意您使用开发者应用并同意相关应用的服务条款。父母或其他监护人也应采取适当的预防措施来保护未成年人，包括监督其对开发者应用的使用。 特别地，如果您是儿童（不满十四周岁的未成年人），在您使用开发者应用和华为的服务前，请务必通知您的父母或其他监护人一起仔细阅读开发者应用隐私声明、本声明，并在您的父母或其他监护人同意或指导后，使用开发者应用和华为的服务或向华为提供信息。如果您是儿童的父母或其他监护人，请确保您监护的儿童在您的同意或指导下使用开发者应用和华为的服务以及向华为提供信息。

华为如何收集和使用你的个人信息 华为仅会根据本声明以下所述目的和方式收集和使用您的个人信息，如果华为要将收集的您的个人信息用于本声明未载明的其他目的，华为会以合理的方式自行或通过开发者明确向您告知，并再次获取您的同意或取得其他合法性基础。如果SDK存在扩展功能或收集和使用了可选个人信息，华为会在下文特别说明。 华为云应用性能分析服务数据采集SDK： 用户在其APP中可以调用SDK将其APP日志上报到华为云应用性能分析服务，该SDK可以收集设备型号、设备名称、设备磁盘信息、设备内存信息、设备品牌、设备CPU信息、操作系统名称、操作系统版本、APP版本、APP名称、APP进程信息、APP线程信息、Wi-Fi状态信息，目的是为了便于用户将APP性能相关信息上报到华为云应用性能分析服务。

设备权限调用 当您使用相应功能及服务时，华为会通过开发者应用向系统申请您设备的相应权限。您可以在设备的设置功能或“隐私设置”中查看权限状态，并可自行选择开启或关闭部分或全部权限。 开发者在集成、使用相应开放能力时，将自行决定权限的调用范围，因此开发者应对权限的调用及用途向您进行说明。您根据开发者应用的请求开启任一权限即代表授权华为可以处理相关个人信息来为您提供对应服务；一旦您关闭任一权限即代表您取消了授权，华为将不再基于对应权限继续处理相关个人信息，可能无法继续为您提供该权限所对应的服务。请注意，您关闭权限的决定不会影响此前基于您授权所进行的个人信息处理活动的效力。 权限 权限描述 使用目的 获取网络状态权限 获取网络状态 用于检测当前的网络连接是否有效 获取Wi-Fi状态权限 获取Wi-Fi状态 用于获取当前Wi-Fi接入的状态

如何联系华为 华为设立了个人信息保护专职部门，您可以通过访问个人行使权利的申请受理页面与其取得联系，华为会尽快回复。 公司注册地址：贵州省贵安新区黔中大道交兴功路华为云数据中心。 如果您对华为的回复不满意，特别是当华为的个人信息处理行为损害了您的合法权益时，您还可以通过向有管辖权的人民法院提起诉讼、向行业自律协会或政府相关管理机构投诉等外部途径进行解决。您也可以向华为了解可能适用的相关投诉途径的信息。 华为将始终遵照华为的隐私政策来收集和使用您的信息。有关华为的隐私政策，可参阅华为云隐私政策声明。

管理您的个人信息 华为非常尊重您对个人信息的关注，华为将遵照相关法律法规的要求，协调、支持并保障您行使访问、复制、更正、删除等个人信息主体权利。 由于您是通过开发者应用使用【华为云应用性能分析服务数据采集SDK】和服务，如果您希望访问、复制或更正与【华为云应用性能分析服务数据采集SDK】和服务相关的个人信息，您应通过开发者应用提供的路径实现您的个人信息主体权利。 为保障您访问、复制、更正和删除个人信息的权利实现，华为在与开发者的协议中，明确要求开发者承诺根据法律法规要求向您提供便捷的权利实现方式。【同时，华为的开放能力也向开发者提供了相关的接口，支持开发者通过接口调用方式来执行您关于个人信息的访问、复制、更正和删除的权利请求。】您也可以通过本声明“如何联系华为”章节中所述联系方式与华为取得联系，华为将尽力协调、支持并保障您的上述权利实现。 当您直接向华为提出个人信息主体权利时，为了保障您的数据安全和其他合法权益，华为可能会对您的身份进行验证并要求您提供验证身份所必要的个人信息，同时华为也可能会向开发者提供收集的身份验证信息以核实您的身份。在验证确认您的身份后，华为会根据法律法规要求及时响应您的相关请求。 如您对您的数据主体权利有进一步要求或存在任何疑问、意见或建议，可通过本声明中“如何联系华为”章节中所述方式与华为取得联系，并行使您的相关权利。

声明SDK处理的个人信息 在您接入、使用【华为云应用性能分析服务数据采集SDK】服务前，华为要求您在隐私政策中向用户告知华为SDK的名称、SDK提供方名称、收集个人信息类型、使用目的、隐私政策链接，并获取用户的同意或取得其他合法性基础。您可以参考如下方式提供条款内容： 以文字方式向用户告知 第三方SDK名称：华为云应用性能分析服务数据采集SDK（iOS/Android/HarmonyOS/web/微信小程序/百度小程序/钉钉小程序/支付宝小程序/快应用） 第三方公司名称：华为云计算技术有限公司 收集个人信息类型：收集设备型号、设备名称、设备磁盘信息、设备内存信息、设备品牌、设备CPU信息、操作系统名称、操作系统版本、APP版本、APP名称、APP进程信息、APP线程信息、Wi-Fi状态信息。 使用目的：帮助用户采集APP性能分析相关数据，并上报到华为云应用性能分析服务。 隐私政策链接：隐私与敏感信息保护声明 以表格方式向用户告知 第三方SDK名称 第三方公司名称 收集个人信息类型 使用目的 隐私政策链接 华为云应用性能分析服务数据采集SDK（iOS/Android/HarmonyOS/web/微信小程序/百度小程序/钉钉小程序/支付宝小程序/快应用） 华为云计算技术有限公司 收集设备型号、设备名称、设备磁盘信息、设备内存信息、设备品牌、设备CPU信息、操作系统名称、操作系统版本、APP版本、APP名称、APP进程信息、APP线程信息、Wi-Fi状态信息。 帮助用户采集APP性能分析相关数据，并上报到华为云应用性能分析服务。 隐私与敏感信息保护声明

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 alarm_data_list Array of AlarmDataVO objects 告警列表。 total_count Integer 消息总数。 表4 AlarmDataVO 参数 参数类型 描述 id Long 告警通知id。 gmt_create String 创建时间。 region_alarm_event_id Long region中事件的id。 business_name String 应用名称。 app_name String 组件名称。 version_number Integer 版本。 alarm_rule_type String 告警规则类别。 gmt_modify String 修改时间。 process_unit String 处理单元。 region String 区域名称。 instance_id Long 实例id。 ip_address String 实例ip地址。 instance_name String 实例名称。 env_id Long 环境id。 business_id Long 应用id。 template_id Long 模板id。 alarm_rule_id Long 告警规则id。 monitor_item_id Long 监控项id。 collector_id Integer 采集器id。 collector_name String 采集器名称。 alarm_rule_name String 告警规则名称。 alarm_rule_expression String 告警表达式。 alarm_first_time String 开始报警时间。 alarm_last_time String 最后一次报警时间。 alarm_level String 告警级别。 restrain_key String 唯一告警标识符。 status String 告警状态。

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 x-business-id 是 Long 应用id。 X-Auth-Token 是 String 从IAM服务获取的用户Token。 表2 请求Body参数 参数 是否必选 参数类型 描述 page 否 Integer 页码。 page_size 否 Integer 每页数量。 region 否 String region英文名称。 app_name 否 String 组件环境名称。 business_id 是 Long 应用id。 monitor_item_id 否 Long 监控项id。 status 否 String 告警状态 RECOVER：已恢复 ABNORMAL：异常 ALERT：告警中。 alarm_level 否 String 告警级别 COMMON：轻微 CRITICAL：严重。 keyword 否 String 关键字。 alarm_start_time 否 String 告警开始时间。 alarm_end_time 否 String 告警结束时间。 collector_id 否 Integer 采集器id。 ip_address 否 String 实例ip地址。 env_list 否 Array of integers 环境集合。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 front_alarm_notify_results Array of FrontAlarmNotifyResult objects 告警通知列表。 total_count Integer 消息总数。 表4 FrontAlarmNotifyResult 参数 参数类型 描述 id Long 告警通知id。 gmt_create String 创建时间。 notify_type String 通知类型。 alarm_rule_id Long 告警规则id。 template_id Long 模板id。 alarm_data_event_id Long 关联事件id。 notify_status Boolean 通知结果。 alarm_content String 通知内容。

响应示例 状态码： 200 OK，请求响应成功。 { "front_alarm_notify_results" : [ { "id" : 1741, "gmt_create" : "2022-10-09 22:58:27", "notify_type" : "RECOVER", "alarm_rule_id" : 3, "template_id" : 2, "alarm_data_event_id" : 42, "notify_status" : false, "alarm_content" : "CPU0.017使用率为0.017" }, { "id" : 1735, "gmt_create" : "2022-10-09 22:58:26", "notify_type" : "RECOVER", "alarm_rule_id" : 3, "template_id" : 2, "alarm_data_event_id" : 42, "notify_status" : false, "alarm_content" : "CPU0.017使用率为0.017" }, { "id" : 682, "gmt_create" : "2022-10-09 21:20:11", "notify_type" : "RECOVER", "alarm_rule_id" : 3, "template_id" : 2, "alarm_data_event_id" : 42, "notify_status" : false, "alarm_content" : "CPU0.017使用率为0.017" }, { "id" : 639, "gmt_create" : "2022-10-09 21:16:04", "notify_type" : "ALARM", "alarm_rule_id" : 3, "template_id" : 2, "alarm_data_event_id" : 42, "notify_status" : false, "alarm_content" : "CPU0.021使用率为0.021" } ], "total_count" : 4 }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。 x-business-id 是 Long 应用id，用于鉴权。 表2 请求Body参数 参数 是否必选 参数类型 描述 page 否 Integer 页码。 page_size 否 Integer 每页数量。 alarm_data_id 是 Integer 告警事件id。 region 是 String region英文名称。

响应示例 状态码： 200 OK，请求响应成功。 { "node_list" : [ { "node_id" : 11, "node_name" : "apm-pu-task:xxx-roma-2", "hint" : null } ], "line_list" : [ { "start_node_id" : null, "end_node_id" : 11, "span_id" : "1", "client_info" : null, "server_info" : { "start_time" : 1666684411910, "time_used" : 1, "argument" : "(GET)(/apm2/health/v1/health-check)(200)", "event_id" : "1" }, "hint" : "(1)((GET)(/apm2/health/v1/health-check)(200))", "id" : "1+1" } ], "global_trace_id" : null }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 global_trace_id String 全局traceId。 line_list Array of TraceTopologyLine objects 组件之间调用指向线列表。 node_list Array of TraceTopologyNode objects 组件节点列表。 表4 TraceTopologyLine 参数 参数类型 描述 start_node_id Long 开始节点id。 end_node_id Long 结束节点id。 span_id String 调用跨度id。 client_info TraceTopologyLineInfo object 客户端看到的信息。 server_info TraceTopologyLineInfo object 服务端信息。 id String id。 hint String 获取一条线的提示信息。 表5 TraceTopologyLineInfo 参数 参数类型 描述 start_time Long 开始时间。 time_used Long 耗时。 argument String 参数信息，比如调用的url信息等。 event_id String event的id。 表6 TraceTopologyNode 参数 参数类型 描述 node_id Long 节点id。 node_name String 节点名称。 hint String 节点提示字段。

响应示例 状态码： 200 OK，请求响应成功。 { "env_tags" : [ { "name" : "xxx-roma-2", "businessId" : 162, "uuid" : "e9c8f632*********cbfcfa148c0", "descp" : null, "creatorId" : null, "envIdList" : null, "id" : 72, "gmt_create" : "2022-10-25T02:18:44.000+00:00", "gmt_modify" : "2022-10-25T02:18:44.000+00:00" } ], "total_count" : 1 }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。 x-business-id 是 Long 应用id。 表2 请求Body参数 参数 是否必选 参数类型 描述 business_id 是 Long 应用id。 keyword 否 String 关键字。 page_enable 否 Boolean 是否分页。 page_number 否 Integer 每页容量。 page_size 否 Integer 当前页码。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 env_tags Array of CmdbTagEntity objects 环境标签数据列表。 total_count Integer 总条数。 表4 CmdbTagEntity 参数 参数类型 描述 name String 环境标签名称。 business_id Long 应用id。 uuid String UUID。 descp String 描述信息。 creator_id Long 创建者id。 env_id_list Array of integers 环境id列表。 id Long 环境标签id。 gmt_create String 创建时间。 gmt_modify String 修改时间。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 topology_tree TopologyTree object 拓扑树信息。 表4 TopologyTree 参数 参数类型 描述 tree Array of TreeNode objects 拓扑树节点。 表5 TreeNode 参数 参数类型 描述 id String 拓扑树节点id。 parent String 拓扑树节点的父节点。 real_id Long 拓扑树节点的实际id。 name String 拓扑树节点名称。 display_name String 拓扑树节点展示名称。 app_name String 组件名称。 app_id Long 组件id。 is_admin Boolean 是否是管理节点。 is_root Boolean 是否是根节点。 business_id Long 应用id。 node_type String 节点类型。 枚举值： BUSINESS SUB_BUSINESS APPLICATION ENVIRONMENT region String 区域。 is_default Boolean 是否是默认的节点。

响应示例 状态码： 200 OK，请求响应成功。 { "topology_tree" : { "tree" : [ { "id" : "162-55-11", "parent" : "162-55", "real_id" : 11, "name" : "apm-pu-task", "display_name" : "apm-pu-task", "app_name" : null, "app_id" : null, "is_admin" : false, "is_root" : false, "business_id" : 162, "node_type" : "APPLICATION", "is_default" : false, "region" : null }, { "id" : "162-55", "parent" : "162", "real_id" : 55, "name" : "App", "display_name" : "App", "app_name" : null, "app_id" : null, "is_admin" : false, "is_root" : false, "business_id" : 162, "node_type" : "SUB_BUSINESS", "is_default" : false, "region" : null }, { "id" : "162", "parent" : null, "real_id" : 162, "name" : "LubanApm", "display_name" : "LubanApm", "app_name" : null, "app_id" : null, "is_admin" : false, "is_root" : true, "business_id" : 162, "node_type" : "BUSINESS", "is_default" : false, "region" : null }, { "id" : "162-55-11-11", "parent" : "162-55-11", "real_id" : 11, "name" : "xxx-roma-2", "display_name" : "xxx-roma-2", "app_name" : "apm-pu-task", "app_id" : 11, "is_admin" : false, "is_root" : false, "business_id" : 162, "node_type" : "ENVIRONMENT", "is_default" : false, "region" : "xxx-roma-2" } ] } }

修订记录 发布日期 修订记录 2024-04-30 新增接口TRACING。 2024-03-04 新增接口PROFILING。 2024-01-17 新增接口获取一个监控项的详情。 2023-08-30 新增状态码以及相关描述，“400 Bad Request，语义或参数有误。” 2023-08-08 接口请求实例描述优化。 2022-12-30 新增以下接口： 查询应用下所有探针 更改实例的采集状态 删除agent 根据组件id删除指定的组件 查询单个应用的详情 查询子应用详情 查询告警列表 查询告警消息列表 查询应用全局拓扑图 查询组件环境拓扑图 查询URL跟踪配置列表 查询URL跟踪Region环境列表 查询URL跟踪视图列表 查询URL跟踪视图详情 2022-11-10 新增23个API接口： 对指定区域下的组件和环境及其探针情况进行搜索 保存监控项 查询监控项列表 查询开通的region 查询所有的支持的region 获取应用树 查询环境标签 获取组件列表 获取组件下的环境列表 查询监控项配置信息 调用链拓扑图 获取event的详情 查询span数据 获取一个trace的所有调用链数据 获取趋势图 获取汇总表格数据 获取原始数据表格 获取原始数据详情 获取实例信息列表 获取监控项信息 创建aksk 查询租户的aksk 删除aksk 2021-12-10 新增以下接口： 查询master地址 获取ak/sk 2021-11-26 第一次正式发布。

响应示例 状态码： 200 OK，请求响应成功。 { "instance_info_list" : [ { "instance_id" : 15, "business_name" : null, "business_id" : null, "app_name" : null, "host_name" : "apm2-apm-pu-task-6b5bbfc84d-rxlhr", "instance_name" : "default", "ip_address" : "*.*.*.*", "env_id" : null, "agent_version" : "2.2.8", "last_heartbeat" : 1666682386000, "register_time" : 1666664387000, "last_modify_user_id" : null, "instance_status" : 0, "last_modify_user_name" : null, "last_modify_time" : 0 }, { "instance_id" : 16, "business_name" : null, "business_id" : null, "app_name" : null, "host_name" : "apm2-apm-pu-task-6b5bbfc84d-gtrrs", "instance_name" : "default", "ip_address" : "*.*.*.*", "env_id" : null, "agent_version" : "2.2.8", "last_heartbeat" : 1666682377000, "register_time" : 1666664436000, "last_modify_user_id" : null, "instance_status" : 0, "last_modify_user_name" : null, "last_modify_time" : 0 } ], "total_count" : 2, "online_count" : 0, "offline_count" : 0, "disable_count" : 0 }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。 x-business-id 是 Long 应用id。 表2 请求Body参数 参数 是否必选 参数类型 描述 env_id 是 Long 环境id。 page 是 Integer 当前页码。 page_size 否 Integer 每页数据容量。 keyword 否 String 关键字。 status 否 Integer 实例状态。 return_count 否 Boolean 是否返回计数结果。