华为云用户手册

回答 MRS 集群外部的节点，推荐配置镜像源后，直接使用pip安装impala-shell客户端。 执行如下命令确认python版本是2还是3： pip --version 如果节点操作系统为Euler/HCE/Centos，执行如下命令安装impala-shell客户端： python2执行如下命令： yum install -y gcc gcc-c++ python-devel cyrus-sasl-devel krb5-devel pip install impala-shell python3执行如下命令： yum install -y gcc gcc-c++ python3-devel cyrus-sasl-devel krb5-devel pip install impala-shell 如果节点操作系统为Ubuntu，执行如下命令安装impala-shell客户端： python2执行如下命令： apt-get update apt install -y gcc g++ python2-dev cyrus-dev libkrb5-dev pip install impala-shell python3执行如下命令： apt-get update apt install -y gcc g++ python3-dev cyrus-dev libkrb5-dev pip install impala-shell 如果节点操作系统为SUSE，执行如下命令安装impala-shell客户端： 仅SUSE 13.2及之后版本支持安装impala-shell，低版本中没有cyrus-sasl-devel包和krb5-devel暂不支持。 python2执行如下命令： zypper install -y gcc gcc-c++ python-devel cyrus-sasl-devel krb5-devel 由于安装krb5-devel后，krb5-config不在PATH目录下，需要创建软链接： ln -s /usr/lib/mit/bin/krb5-config /usr/bin/krb5-config pip install impala-shell python3执行如下命令： zypper install -y gcc gcc-c++ python3-devel cyrus-sasl-devel krb5-devel 由于安装krb5-devel后，krb5-config不在PATH目录下，需要创建软链接： ln -s /usr/lib/mit/bin/krb5-config /usr/bin/krb5-config pip install impala-shell

请求示例 批量删除 域名 组，防火墙id为fced7179-64a4-4438-bc6d-b510a2da2f64，目标防护对象id为b71922fd-3539-421c-9317-c54ebc1bc4ea，待删除的域名组id为7d772766-6c44-4fa3-a140-8ddc7eac0fc5和e17e24d2-bd7d-4e25-993c-38559d44a571，项目id为408972e72dcd4c1a9b033e955802a36b。 https://{Endpoint}/v1/408972e72dcd4c1a9b033e955802a36b/domain-sets/batch-delete { "object_id" : "b71922fd-3539-421c-9317-c54ebc1bc4ea", "set_ids" : [ "7d772766-6c44-4fa3-a140-8ddc7eac0fc5", "e17e24d2-bd7d-4e25-993c-38559d44a571" ] }

响应示例 状态码： 200 批量删除域名组请求的响应数据 { "data" : { "responseDatas" : [ { "name" : "9", "id" : "7d772766-6c44-4fa3-a140-8ddc7eac0fc5" }, { "name" : "8", "id" : "e17e24d2-bd7d-4e25-993c-38559d44a571" } ] } }

URI POST /v1/{project_id}/domain-sets/batch-delete 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，可以从调API处获取，也可以从控制台获取。可通过项目ID获取方式获取 表2 Query参数 参数 是否必选 参数类型 描述 fw_instance_id 否 String 防火墙ID，可通过防火墙ID获取方式获取 enterprise_project_id 否 String 企业项目ID，用户根据组织规划企业项目，对应的ID为企业项目ID，可通过如何获取企业项目ID获取，用户未开启企业项目时为0

响应示例 状态码： 200 OK { "data" : { "scan_protocol_configs" : [ { "action" : 0, "protocol_type" : 0 }, { "action" : 1, "protocol_type" : 1 }, { "action" : 2, "protocol_type" : 2 }, { "action" : 2, "protocol_type" : 4 }, { "action" : 2, "protocol_type" : 3 }, { "action" : 2, "protocol_type" : 6 }, { "action" : 2, "protocol_type" : 5 } ], "total" : 7 } }

URI GET /v1/{project_id}/anti-virus/rule 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，可以从调API处获取，也可以从控制台获取。可通过项目ID获取方式获取 表2 Query参数 参数 是否必选 参数类型 描述 object_id 是 String 防护对象ID，是创建 云防火墙 后用于区分互联网边界防护和VPC边界防护的标志id，可通过调用查询防火墙实例接口获得，通过返回值中的data.records.protect_objects.object_id（.表示各对象之间层级的区分）获得，注意type为0的为互联网边界防护对象id，type为1的为VPC边界防护对象id。此处仅取type为1的防护对象id，可通过data.records.protect_objects.type（.表示各对象之间层级的区分）获得。 engine_type 是 Integer 防火墙类型 limit 是 Integer 每页显示的数据量 offset 是 Integer 查询偏移量 enterprise_project_id 否 String 企业项目ID，用户根据组织规划企业项目，对应的ID为企业项目ID，可通过如何获取企业项目ID获取，用户未开启企业项目时为0

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 data AntiVirusRuleVO object 表5 AntiVirusRuleVO 参数 参数类型 描述 id String name String scan_protocol_configs Array of ScanProtocolConfig objects total Integer 表6 ScanProtocolConfig 参数 参数类型 描述 action Integer 反病毒动作，0：观察 1：拦截 2：禁用 protocol_type Integer 协议类型

请求示例 查询项目id为408972e72dcd4c1a9b033e955802a36b的防病毒规则，防火墙id为e743cfaf-8164-4807-aa13-d893d83313cf，企业项目id为fb55459c-41b3-47fc-885d-540946fddda4，目标对象id为1b90f031-0c7b-4f25-95e2-b6d9940d269e，引擎类型为1。查询结果限制为50条，偏移量为0。 https://{Endpoint}/v1/408972e72dcd4c1a9b033e955802a36b/anti-virus/rule?fw_instance_id=e743cfaf-8164-4807-aa13-d893d83313cf&enterprise_project_id=fb55459c-41b3-47fc-885d-540946fddda4&limit=50&offset=0&object_id=1b90f031-0c7b-4f25-95e2-b6d9940d269e&engine_type=1

请求示例 查询防火墙id为e743cfaf-8164-4807-aa13-d893d83313cf的标签信息 https://{Endpoint}/v2/408972e72dcd4c1a9b033e955802a36b/cfw-cfw/tags?fw_instance_id=e743cfaf-8164-4807-aa13-d893d83313cf&enterprise_project_id=fb55459c-41b3-47fc-885d-540946fddda4

URI GET /v2/{project_id}/cfw-cfw/tags 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，可以从调API处获取，也可以从控制台获取。可通过项目ID获取方式获取 表2 Query参数 参数 是否必选 参数类型 描述 limit 是 Integer 分页查询数据限制 offset 是 Integer 查询偏移量 enterprise_project_id 否 String 企业项目ID，用户根据组织规划企业项目，对应的ID为企业项目ID，可通过如何获取企业项目ID获取，用户未开启企业项目时为0

URI PUT /v1/{project_id}/anti-virus/switch 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，可以从调API处获取，也可以从控制台获取。可通过项目ID获取方式获取 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 企业项目ID，用户根据组织规划企业项目，对应的ID为企业项目ID，可通过如何获取企业项目ID获取，用户未开启企业项目时为0

请求示例 打开反病毒开关 https://{Endpoint}/v1/408972e72dcd4c1a9b033e955802a36b/anti-virus/switch?fw_instance_id=e743cfaf-8164-4807-aa13-d893d83313cf&enterprise_project_id=fb55459c-41b3-47fc-885d-540946fddda4 { "object_id" : "1b90f031-0c7b-4f25-95e2-b6d9940d269e", "anti_virus_status" : 1 }

请求示例 查询项目id为408972e72dcd4c1a9b033e955802a36b的防火墙资源标签 https://{Endpoint}/v2/408972e72dcd4c1a9b033e955802a36b/cfw-cfw/e743cfaf-8164-4807-aa13-d893d83313cf/tags?fw_instance_id=e743cfaf-8164-4807-aa13-d893d83313cf&enterprise_project_id=fb55459c-41b3-47fc-885d-540946fddda4

URI GET /v2/{project_id}/cfw-cfw/{fw_instance_id}/tags 表1 路径参数 参数 是否必选 参数类型 描述 fw_instance_id 是 String 防火墙ID，可通过防火墙ID获取方式获取 project_id 是 String 项目ID，可以从调API处获取，也可以从控制台获取。可通过项目ID获取方式获取 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 企业项目ID，用户根据组织规划企业项目，对应的ID为企业项目ID，可通过如何获取企业项目ID获取，用户未开启企业项目时为0

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 data String sys_tags Array of ResourceTag objects tags Array of ResourceTag objects 表5 ResourceTag 参数 参数类型 描述 key String 标签键 value String 标签值 update_time String 标签更新时间

请求示例 获取项目id为408972e72dcd4c1a9b033e955802a36b的自定义IPS规则列表，防火墙id为e743cfaf-8164-4807-aa13-d893d83313cf，企业项目id为fb55459c-41b3-47fc-885d-540946fddda4，目标对象id为1b90f031-0c7b-4f25-95e2-b6d9940d269e。查询结果限制为1000条，偏移量为0。 https://{Endpoint}/v1/408972e72dcd4c1a9b033e955802a36b/ips/custom-rule?fw_instance_id=e743cfaf-8164-4807-aa13-d893d83313cf&enterprise_project_id=fb55459c-41b3-47fc-885d-540946fddda4&object_id=1b90f031-0c7b-4f25-95e2-b6d9940d269e&limit=1000&offset=0

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 data PageInfo«CustomerIpsListVO» object 表5 PageInfo«CustomerIpsListVO» 参数 参数类型 描述 limit Integer offset Integer records Array of CustomerIpsListVO objects total Integer 表6 CustomerIpsListVO 参数 参数类型 描述 action Integer 动作（0：只记录日志，1：重置/拦截） affected_os Integer 操作系统 attack_type Integer 攻击类型 config_status Integer 规则状态（0：初始化，1：配置中，2：配置成功，3：配置失败） content String 内容json存储 dst_port_type Integer 目的端口类型 dst_ports String 目的端口 group_id String 防火墙集群id ips_cfw_id String cfw侧自定义ips规则id ips_id String 山石侧规则id ips_name String ips规则名称 protocol Integer 协议 severity Integer 严重程度（critical：致命，high：高危，medium:中危，low:低危） software Integer 影响软件 src_port_type Integer 源端口类型 src_ports String 源端口

URI GET /v1/{project_id}/ips/custom-rule 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，可以从调API处获取，也可以从控制台获取。可通过项目ID获取方式获取 表2 Query参数 参数 是否必选 参数类型 描述 action_type 否 Integer 动作（0：只记录日志，1：重置/拦截） affected_os 否 Integer 操作系统 attack_type 否 Integer 攻击类型 fw_instance_id 是 String 防火墙ID，可通过防火墙ID获取方式获取 ips_name 否 String ips规则名称 limit 是 Integer 分页查询数据量限制 object_id 是 String 防护对象ID，是创建云防火墙后用于区分互联网边界防护和VPC边界防护的标志id，可通过调用查询防火墙实例接口获得，通过返回值中的data.records.protect_objects.object_id（.表示各对象之间层级的区分）获得，注意type为0的为互联网边界防护对象id，type为1的为VPC边界防护对象id。此处仅取type为1的防护对象id，可通过data.records.protect_objects.type（.表示各对象之间层级的区分）获得。 offset 是 Integer 查询偏移量 protocol 否 Integer 协议 severity 否 Integer 严重程度（critical：致命，high：高危，medium:中危，low:低危） software 否 Integer 影响软件 enterprise_project_id 否 String 企业项目ID，用户根据组织规划企业项目，对应的ID为企业项目ID，可通过如何获取企业项目ID获取，用户未开启企业项目时为0

请求示例 更改ips规则模式为"OBSERVE" https://{Endpoint}/v1/408972e72dcd4c1a9b033e955802a36b/ips-rule/mode?fw_instance_id=e743cfaf-8164-4807-aa13-d893d83313cf&enterprise_project_id=fb55459c-41b3-47fc-885d-540946fddda4 { "object_id" : "1b90f031-0c7b-4f25-95e2-b6d9940d269e", "status" : "OBSERVE", "ips_ids" : [ "340724" ] }

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 data IpsRuleChangeRespBody object 表6 IpsRuleChangeRespBody 参数 参数类型 描述 error_code String 错误代码 error_msg String 错误信息 group_id String 分组id id String 防火墙id ips_ids Array of strings ips的id列表 result Boolean 修改结果

URI POST /v1/{project_id}/ips-rule/mode 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，可以从调API处获取，也可以从控制台获取。可通过项目ID获取方式获取 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 企业项目ID，用户根据组织规划企业项目，对应的ID为企业项目ID，可通过如何获取企业项目ID获取，用户未开启企业项目时为0

请求示例 切换项目id为408972e72dcd4c1a9b033e955802a36b的EIP自动保护状态，防火墙id为e743cfaf-8164-4807-aa13-d893d83313cf，目标防护对象id为1b90f031-0c7b-4f25-95e2-b6d9940d269e，将开关状态切换为0 https://{Endpoint}/v1/408972e72dcd4c1a9b033e955802a36b/eip/auto-protect-status/switch { "object_id" : "1b90f031-0c7b-4f25-95e2-b6d9940d269e", "fw_instance_id" : "e743cfaf-8164-4807-aa13-d893d83313cf", "status" : 0 }

URI POST /v1/{project_id}/eip/auto-protect-status/switch 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，可以从调API处获取，也可以从控制台获取。可通过项目ID获取方式获取 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 企业项目ID，用户根据组织规划企业项目，对应的ID为企业项目ID，可通过如何获取企业项目ID获取，用户未开启企业项目时为0

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，可通过如何获取用户Token获取 表4 请求Body参数 参数 是否必选 参数类型 描述 fw_instance_id 否 String 防火墙id object_id 否 String 防护对象id status 否 Integer 是否开启新增eip自动防护，1；是，0：否

请求示例 获取项目id为408972e72dcd4c1a9b033e955802a36b的EIP自动防护状态信息，防火墙id为e743cfaf-8164-4807-aa13-d893d83313cf，企业项目id为fb55459c-41b3-47fc-885d-540946fddda4，目标对象id为1b90f031-0c7b-4f25-95e2-b6d9940d269e。 https://{Endpoint}/v1/408972e72dcd4c1a9b033e955802a36b/eip/auto-protect-status/1b90f031-0c7b-4f25-95e2-b6d9940d269e?fw_instance_id=e743cfaf-8164-4807-aa13-d893d83313cf&enterprise_project_id=fb55459c-41b3-47fc-885d-540946fddda4&object_id=1b90f031-0c7b-4f25-95e2-b6d9940d269e&project_id=408972e72dcd4c1a9b033e955802a36b

响应示例 状态码： 200 OK { "data" : { "available_eip_count" : 50, "beyond_max_count" : false, "eip_protected_self" : 15, "eip_total" : 24, "eip_un_protected" : 9, "object_id" : "1b90f031-0c7b-4f25-95e2-b6d9940d269e", "status" : 1 } }

URI GET /v1/{project_id}/eip/auto-protect-status/{object_id} 表1 路径参数 参数 是否必选 参数类型 描述 object_id 是 String 防护对象ID，是创建云防火墙后用于区分互联网边界防护和VPC边界防护的标志id，可通过调用查询防火墙实例接口获得，通过返回值中的data.records.protect_objects.object_id（.表示各对象之间层级的区分）获得，注意type为0的为互联网边界防护对象id，type为1的为VPC边界防护对象id。此处仅取type为1的防护对象id，可通过data.records.protect_objects.type（.表示各对象之间层级的区分）获得。 project_id 是 String 项目ID，可以从调API处获取，也可以从控制台获取。可通过项目ID获取方式获取 表2 Query参数 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 企业项目ID，用户根据组织规划企业项目，对应的ID为企业项目ID，可通过如何获取企业项目ID获取，用户未开启企业项目时为0

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 data FirewallStatusVO object 防火墙状态对象 表5 FirewallStatusVO 参数 参数类型 描述 available_eip_count Integer 可防护eip数量 beyond_max_count Boolean 是否超出eip数量限制 eip_protected_self Integer 已防护eip数量 eip_total Integer eip总数 eip_un_protected Integer 未防护eip数量 object_id String 防护对象id status Integer 是否开启新增eip自动防护，1；是，0：否

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 data Array of IpsRuleUpdateTimeVO objects error_code String error_description String fail_reason String job_id String order_id String trace_id String 表5 IpsRuleUpdateTimeVO 参数 参数类型 描述 ips_type Integer ips_version String update_time Long

请求示例 获取项目id为408972e72dcd4c1a9b033e955802a36b的IPS规则细节，防火墙id为e743cfaf-8164-4807-aa13-d893d83313cf，企业项目id为fb55459c-41b3-47fc-885d-540946fddda4 https://{Endpoint}/v1/408972e72dcd4c1a9b033e955802a36b/ips-rule/detail?fw_instance_id=e743cfaf-8164-4807-aa13-d893d83313cf&enterprise_project_id=fb55459c-41b3-47fc-885d-540946fddda4