功能简介 使用REST服务，传入对应host与port组成的url以及指定的Namespace，通过HTTPS协议，对Namespace进行创建、查询、删除，获取指定Namespace中表的操作。 HBase表以“命名空间:表名”格式进行存储，若在创建表时不指定命名空间，则默认存储在“default”中。其中，“hbase”命名空间为系统表命名空间，请不要对该系统表命名空间进行业务建表或数据读写等操作。

删除Doris表 以Java JDBC方式执行SQl语句删除集群中的dbName.tableName表。 String dropSql = "drop table " + dbName + "." + tableName; public static void execDDL(Connection connection, String sql) throws Exception { try (PreparedStatement statement = connection.prepareStatement(sql)) { statement.execute(); } catch (Exception e) { logger.error("Execute sql {} failed.", sql, e); throw new Exception(e); } } 父主题： Doris JDBC接口调用样例程序

创建Doris表 以Java JDBC方式执行SQL语句在集群中dbName变量对应的数据库下创建tableName对应的表。 String createTableSql = "create table if not exists " + dbName + "." + tableName + " (\n" + "c1 int not null,\n" + "c2 int not null,\n" + "c3 string not null\n" + ") engine=olap\n" + "unique key(c1, c2)\n" + "distributed by hash(c1) buckets 1"; public static void execDDL(Connection connection, String sql) throws Exception { try (PreparedStatement statement = connection.prepareStatement(sql)) { statement.execute(); } catch (Exception e) { logger.error("Execute sql {} failed.", sql, e); throw new Exception(e); } } 父主题： Doris JDBC接口调用样例程序

创建Doris数据库 以Java JDBC方式执行SQL语句在集群中创建dbName变量对应的数据库。 String createDatabaseSql = "create database if not exists " + dbName; public static void execDDL(Connection connection, String sql) throws Exception { try (PreparedStatement statement = connection.prepareStatement(sql)) { statement.execute(); } catch (Exception e) { logger.error("Execute sql {} failed.", sql, e); throw new Exception(e); } } 父主题： Doris JDBC接口调用样例程序

删除Doris表 以Java JDBC方式执行SQl语句删除集群中的dbName.tableName表。 String dropSql = "drop table " + dbName + "." + tableName; public static void execDDL(Connection connection, String sql) throws Exception { try (PreparedStatement statement = connection.prepareStatement(sql)) { statement.execute(); } catch (Exception e) { logger.error("Execute sql {} failed.", sql, e); throw new Exception(e); } } 父主题： Doris JDBC接口调用样例程序

APIG.0308报错处理方法 如果调用API时返回错误信息与错误码："error_msg":"The throttling threshold has been reached: policy user over ratelimit,limit:XX,time:1 second","error_code":"APIG.0308"，是因为每个用户调用不同服务都有并发限制，例如目前该服务并发量最大为1秒钟XX次。 您可以尝试以下两种解决方法： 通过重试机制，在代码里检查返回值，碰到并发错误可以延时一小段时间（如2-5s）重试请求； 后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 如果需要更大并发量请联系我们。 父主题： 接口调用

APIG.0308报错处理方法 如果调用API时返回错误信息与错误码："error_msg":"The throttling threshold has been reached: policy user over ratelimit,limit:XX,time:1 second","error_code":"APIG.0308"，是因为每个用户调用不同服务都有并发限制，例如目前该服务并发量最大为1秒钟XX次。 您可以尝试以下两种解决方法： 通过重试机制，在代码里检查返回值，碰到并发错误可以延时一小段时间（如2-5s）重试请求； 后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 如果需要更大并发量请联系我们。 父主题： 接口调用

URL监控 介绍APM采集的URL监控指标的类别、名称、含义等信息。 表1 URL监控采集参数 参数名 数据类型 应用类型 默认值 Agent支持的起始版本 Agent支持的终止版本 描述 拦截header指定key值 array JAVA - 2.0.0 - 拦截header中指定key值的内容。 拦截url参数指定key值 array JAVA - 2.0.0 - 拦截url参数指定key值的内容。 拦截cookie指定key值 array JAVA - 2.0.0 - 拦截cookie指定key值的内容。 url采集配置 obj_array JAVA - 2.0.0 - url采集配置，将restful风格url按配置进行规整;规整方式包含startwith,endwith,include,regex四种方式。 采集黑名单配置 obj_array JAVA - 2.0.0 - 指定规则匹配的url不采集,匹配方式包含startwith,endwith,include,regex四种方式。 业务code采集长度限制 integer JAVA 0 2.0.0 - 解析业务code需要采集body内容的长度限制。 解析业务code的key array JAVA - 2.0.0 - 解析json格式的body内容的key，获取业务状态码。 业务code的正确值 array JAVA - 2.0.0 - 配置正确的业务状态码的值，业务状态码不在该范围的值定义为错误的调用链。 慢请求阈值定义 integer JAVA 800 2.0.0 - 定义慢请求阈值,超过该阈值的url会定义为慢url，默认提高调用链采样率。 url配置 obj_array JAVA - 2.0.0 - 单独配置每个url的慢请求阈值和采样率;采样方式包含2.百分比采样；3.每分钟固定数量采样；4.自动采样三种采样方式。 错误状态码定义 radio JAVA 500 2.0.0 - 设置统计为错误的状态码范围。 Url自动规整 radio JAVA false 2.3.11 - Url自动规整。 url最大采集行数 integer JAVA 500 2.4.1 - 允许url最大采集行数 表2 URL监控指标说明 指标类别 指标 指标名称 指标说明 单位 数据类型 默认聚合方式 汇总（total ，url接口调用汇总统计数据。） errorCount 错误次数 总错误次数 - INT SUM invokeCount 调用次数 总调用次数 - INT SUM totalTime 总响应时间 总响应时间 ms INT SUM satisfiedCount 满意请求数 满意请求数 - INT SUM toleratingCount 可容忍请求数 可容忍请求数 - INT SUM 状态码（statuscode，以接口返回的状态码维度统计接口调用数据。） code 状态码 状态码 - ENUM LAST count 调用次数 该状态码的发生次数 - INT SUM url 采样url 该状态码在采集周内采样的url - STRING LAST url监控（url，以url维度统计接口调用数据。） url url 请求的url - ENUM LAST method httpmethod 请求的httpmethod - ENUM LAST concurrentMax 最大并发 该url的最大并发 - INT MAX errorCount 错误数 该url的错误数 - INT SUM invokeCount 调用次数 该url的调用次数 - INT SUM lastError 错误信息 该url发生错误时产生的错误信息 - STRING LAST maxTime 最大响应时间 该url在采集周期内最大响应时间 ms INT MAX maxTimeNativeUrl 最慢url 该url在采集周期内最慢url - STRING LAST runningCount 正在执行数 该url在采集时间点正在执行数量 - INT SUM range1 0-10ms 响应时间在0-10ms范围请求数 - INT SUM range2 10-100ms 响应时间在10-100ms范围请求数 - INT SUM range3 100-500ms 响应时间在100-500ms范围请求数 - INT SUM range4 500-1000ms 响应时间在500-1000ms范围请求数 - INT SUM range5 1-10s 响应时间在1-10s范围请求数 - INT SUM range6 10s以上 响应时间在10s以上请求数 - INT SUM totalTime 总响应时间 该url的总响应时间 ms INT SUM isRoot 是否根调用 是否是根调用 - INT SUM satisfiedCount 满意请求数 满意请求数 - INT SUM toleratingCount 可容忍请求数 可容忍请求数 - INT SUM 集群调用（user，以调用方集群id维度统计接口调用数据。） clusterId 集群id 调用方的集群id - ENUM LAST invokeCount 调用次数 该集群的调用次数 - INT SUM total1xxCount 1xx次数 状态码为1xx的调用次数 - INT SUM total2xxCount 2xx次数 状态码为2xx的调用次数 - INT SUM total3xxCount 3xx次数 状态码为3xx的调用次数 - INT SUM total4xxCount 4xx次数 状态码为4xx的调用次数 - INT SUM total5xxCount 5xx次数 状态码为5xx的调用次数 - INT SUM totalTime 总响应时间 该集群调用的总响应时间 ms INT SUM errorCount 错误次数 该集群调用的错误次数 - INT SUM concurrentMax 最大并发 该集群的最大并发 - INT MAX maxTime 最大响应时间 该url在采集周期内最大响应时间 ms INT MAX 父主题： 接口调用

DubboProvider监控 介绍APM采集的dubbo服务端监控指标的类别、名称、含义等信息。 表1 DubboProvider采集参数 参数名 数据类型 应用类型 默认值 Agent支持的起始版本 Agent支持的终止版本 描述 invocationDetail radio JAVA false 2.0.0 - 是否采集调用详情（配置后，会采集参数和返回值，默认不采集） invocationLength integer JAVA 1000 2.0.0 - 调用详情采集长度（默认：1000字节） attachmentDetail radio JAVA false 2.0.0 - 是否采集attachment（默认不采集） attachmentLength integer JAVA 1000 2.0.0 - attachment采集长度（默认：1000字节） attachmentKeys array JAVA - 2.0.0 - attachment采集键值（指定需要从dubbo attachment中采集的键值） fieldFilterKeys array JAVA - 2.0.0 - 域过滤键值（指定需要从dubbo调用参数和返回信息需要过滤敏感信息键值） slowRequestThreshold integer JAVA 800 2.0.0 - 慢调用方法阈值（单位：ms） slowTraceCountStats string JAVA 100,50,10,2 2.0.0 - 系统压力较大时采样率配置（例子：100,50,10,2 分别表示低、中、高CPU负载下的采样率，末位表示最低采样个数） errorTraceCountStats string JAVA 100,50,10,2 2.0.0 - 错误调用采样率配置（例子：100,50,10,2 分别表示低、中、高CPU负载下的采样率，末位表示单个方法最低采样个数） traceCountStats string JAVA 20,10,5,1 2.0.0 - 默认采样率配置（例子：20,10,5,1 分别表示低、中、高CPU负载下的采样率，末位表示单个方法最低采样个数） excludeMethods string JAVA [{"group":"mock"},{"service":"mock*"}] 2.0.0 - 排除方法（指定不需要调用链跟踪的方法） specMethods string JAVA {{"group":"mock"}:{"percentage":10,"periodCount":1000,"sampleType":"4","slowRequestThreshold":800}} 2.0.0 - 方法配置（指定调用链跟踪的方法的灰度规则，只采集规则命中调用信息） DefaultSampleConfig string JAVA {"percentage":10,"periodCount":1000,"sampleType":"4","slowRequestThreshold":800} 2.0.0 - 默认采样配置（指定dubbo调用采样配置，会覆盖apm默认的采样配置） 表2 dubbo服务端监控指标说明 指标类别 指标 指标名称 指标说明 单位 数据类型 默认聚合方式 方法调用（invocation，方法调用指标集。） serviceUniqueName serviceUniqueName 服务唯一标识（group+interface+version） - ENUM LAST method method 方法 - ENUM LAST source source 调用源 - ENUM LAST lastError lastError 错误信息 - STRING LAST slowTraceId slowTraceId 慢调用traceId - STRING LAST errorTraceId errorTraceId 错误traceId - STRING LAST range1 range1 响应时间在0-10ms范围请求数 - INT SUM range2 range2 响应时间在10-100ms范围请求数 - INT SUM range3 range3 响应时间在100-500ms范围请求数 - INT SUM range4 range4 响应时间在500-1000ms范围请求数 - INT SUM range5 range5 响应时间在1-10s范围请求数 - INT SUM range6 range6 响应时间在10s以上请求数 - INT SUM invokeCount invokeCount 调用次数 - INT SUM totalTime 总响应时间 总响应时间 ms INT SUM maxTime 最大响应时间 最大响应时间 ms INT MAX errorCount errorCount 错误数 - INT SUM runningCount runningCount 当前正在执行数量 - INT SUM concurrentMax concurrentMax 最大并发数 - INT MAX 主机汇总（cluster，按照主机汇总指标集） cluster cluster 主机 - ENUM LAST range1 range1 响应时间在0-10ms范围请求数 - INT SUM range2 range2 响应时间在10-100ms范围请求数 - INT SUM range3 range3 响应时间在100-500ms范围请求数 - INT SUM range4 range4 响应时间在500-1000ms范围请求数 - INT SUM range5 range5 响应时间在1-10s范围请求数 - INT SUM range6 range6 响应时间在10s以上请求数 - INT SUM invokeCount invokeCount 调用次数 - INT SUM totalTime 总响应时间 总响应时间 ms INT SUM maxTime 最大响应时间 最大响应时间 ms INT MAX errorCount errorCount 错误数 - INT SUM runningCount runningCount 当前正在执行数量 - INT SUM concurrentMax concurrentMax 最大并发数 - INT MAX 返回码汇总（resultCode，返回码汇总指标集。） code code 返回码 - ENUM LAST count count 调用次数 - INT SUM lastMethod lastMethod 最近异常类型 - STRING LAST 汇总（total，汇总指标集。） lastError lastError 错误信息 - STRING LAST slowTraceId slowTraceId 慢调用traceId - STRING LAST errorTraceId errorTraceId 错误traceId - STRING LAST range1 range1 响应时间在0-10ms范围请求数 - INT SUM range2 range2 响应时间在10-100ms范围请求数 - INT SUM range3 range3 响应时间在100-500ms范围请求数 - INT SUM range4 range4 响应时间在500-1000ms范围请求数 - INT SUM range5 range5 响应时间在1-10s范围请求数 - INT SUM range6 range6 响应时间在10s以上请求数 - INT SUM invokeCount invokeCount 调用次数 - INT SUM totalTime 总响应时间 总响应时间 ms INT SUM maxTime 最大响应时间 最大响应时间 ms INT MAX errorCount errorCount 错误数 - INT SUM runningCount runningCount 当前正在执行数量 - INT SUM concurrentMax concurrentMax 最大并发数 - INT MAX 线程池（threadPool，线程池指标集。） poolId poolId 线程池唯一标示 - ENUM LAST poolType poolType dubbo自定义线程池类型（fixed、cached、limited等） - STRING LAST activeCount activeCount 当前激活个数 - INT SUM corePoolSize corePoolSize 核心线程数 - INT SUM maximumPoolSize maximumPoolSize 最大核心线程数 - INT SUM poolSize poolSize 线程池大小 - INT SUM queueSize queueSize 等待队列大小 - INT SUM taskCount taskCount 任务数 - INT SUM 客户端版本（version，客户端版本指标集。） version version 客户端版本 - STRING LAST 父主题： 接口调用

调用BSS接口状态码返回400 BadRequest 一般出现这种情况有两种可能： 合作伙伴调用接口时传入的请求参数有误。此时可以查看响应消息，一般会说明是哪个请求参数有误，请查看调用时是否遵循《API参考》中该请求参数的定义。 传入的请求消息不是JSON格式。请检查请求消息头参数中是否添加了“Content-Type":"application/json”字段，并确保传入的请求消息是JSON格式。若全是非必填参数，需传入"{}"。 父主题： 接口调用

认证鉴权 ISDP+提供的OpenAPI接口都需要通过认证之后才可以访问。认证方式为：在请求消息头上设置“Authorization”。 Token在计算机系统中代表令牌（临时）的意思，拥有Token代表拥有某种权限。Token认证是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用ISDP+ Token接口获取，请求body，如下所示，其中***********为应用ID，xxxxxxxxxx为应用令牌。 POST https://isdpcloud-beta.sd.huawei.com/oauth2/oauth/rest_token Content-Type: application/json { "client_id": "isdp-saas-openapi", "client_secret": "isdp-saas-openapi", "grant_type": "password", "username": "**********", "password": "xxxxxxxxxx" } 对于获取ISDP+ Token接口，返回的响应消息体中“access_token”和“token_type”就是组成ISDP+ Token的值。 ISDP+ Token=“token_type access_token”（注意两个字段之间有空格）。 获取Token后，再调用其他接口时，您需要在请求消息头中添加“Authorization”，其值即为Token，如下所示。 POST https://isdpcloud-beta.sd.huawei.com/openapi/v1/openSceneTask/createTask Authorization: bearer XXXXXXXXXXXXXX Content-Type: application/json 父主题： 接口调用方法

获取合作伙伴Token时状态码返回401 Unauthorized 如果调用IAM的“获取用户Token”接口获取合作伙伴Token时报如下屏显的401错误， { "error": { "message": "The username or password is wrong.", "code": 401, "title": "Unauthorized" } } 请首先检查请求参数中使用的账号和密码是否为华为云账号和密码。 企业注册华为账号并开通华为云，完成企业实名认证并完成标准解决方案提供商合作伙伴认证后，即可成为解决方案提供商合作伙伴。需要使用华为云账号登录伙伴中心获取到华为云账号的密码后，通过华为云账号和密码获取合作伙伴Token。 如果获取Token时，请求参数中使用的是华为云账号和密码，请确认账号或密码是否有误。 父主题： 接口调用

单个条件 示例1： { "params": { "sort": "desc", "orderBy": "name", "filter": { "conditionName": "name", "operator": "=", "conditionValues": [ "wyc" ] } } } 示例2： { "params": { "sort": "desc", "orderBy": "name", "filter": { "joiner": "and", // and或者or "conditions": [ { "conditionName": "name", "operator": "=", "conditionValues": [ "wyc" ] } ] } } }

分类属性 分类属性的固定前缀为“clsAttrs”，格式有“clsAttrs.分类名.分类内属性名”和“clsAttrs.分类名.分类内属性名.value”两种。其中，“clsAttrs.分类名.分类内属性名.value”适用于自定义精度的分类属性。 { "params": { "filter": { "joiner": "and", "conditions": [ { "conditionName": "clsAttrs.clsAttrName.attrName1", "operator": "=", "conditionValues": [ "123" ] }, { "conditionName": "clsAttrs.clsAttrName.attrName2.value", "operator": "=", "conditionValues": [ "12.123" ] } ] } } }

多字段排序 多字段排序一般使用“sorts”字段表示，其结构如下： { "sorts": [ { "sort": "DESC", "orderBy": "description" }， { "sort": "ASC", "orderBy": "name" } ] } 使用“sorts”字段后，将按照其列表顺序进行排序。如上所示，对象会先按照“description”进行倒序排序，再按照“name”进行正序排序。 以“services/api/SZAPITEST202211280329/find/20/1”的URI为例，使用如下接口进行多字段排序。 Find接口： { "params": { "sorts": [ { "sort": "DESC", "orderBy": "description" }， { "sort": "ASC", "orderBy": "name" } ], "filter": { "joiner": "and", "conditions": [ { "conditionName": "description", "operator": "=", "conditionValues": [ "a" ] }, { "conditionName": "rdmDeleteFlag", "operator": "=", "conditionValues": [ "0" ] } ] } } } Query接口： { "params": { "sorts": [ { "sort": "DESC", "orderBy": "description" }， { "sort": "ASC", "orderBy": "name" } ], "filter": { "joiner": "and", "conditions": [ { "conditionName": "description", "operator": "=", "conditionValues": [ "a" ] }, { "conditionName": "rdmDeleteFlag", "operator": "=", "conditionValues": [ "0" ] } ] } } } Select接口： { "params": { "selectedField": [ { "name": "name", "nameAs": "nameAsName" }, { "name": "description", "nameAs": "nameAsDescription" }, { "name": "creator" }, { "name": "id" } ], "sorts": [ { "sort": "DESC", "orderBy": "name" }, { "sort": "asc", "orderBy": "id" } ], "filter": { "joiner": "and", "conditions": [ { "conditionName": "description", "operator": "=", "conditionValues": [ "a" ] } ] } } }