云服务器内容精选

  • 请求消息 表3 请求Header参数 参数 是否必选 参数类型 描述 x-environment 否 String 指定查询配置的environment,取值包括:development、testing、acceptance、production。其他值均被作为空值处理。 Authorization 是 String 若微服务引擎专享版开启了安全认证,此参数必填。否则,无此参数。 开启了安全认证的微服务引擎专享版Token,格式为: Authorization:Bearer {Token} Token获取方法,请参考获取微服务引擎专享版用户Token。
  • URI GET /v3/{project_id}/configuration/items 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 微服务引擎专业版,请填租户项目id,长度为1~64。也可以填固定值default。 微服务引擎专享版,请填固定值:default。 表2 Query参数 参数 是否必选 参数类型 描述 dimensionsInfo 是 String 服务信息,为服务名、应用、版本的拼接(服务名、应用必填,版本选填),拼接格式为(请注意“@”和“#”添加到http url时需转义,“@”转义为“%40”,“#”转义为“%23”): {serviceName}@{appId}#{version} 或{serviceName}@{appId} 不能包含$%^&+/\特殊字符和空格。 keyFilter 否 String key的筛选条件, 支持正则表达式。涉及特殊字符的正则表达式需要自行转义。 revision 否 String 配置项版本。用于判断本地缓存配置和配置管理中心的配置差异。 首次传值0。 若传入的revision值与当前配置的revision一致,则返回304状态码,无body体返回;若不一致,则返回当前配置和revision信息。 下次请求若需要传入revision,则该值为当前返回body体中的revision中的version的值 。
  • 接口使用说明(OpenStack Nova API) 网络相关服务API,请参考《虚拟私有云API参考》。 专属分布式存储相关API,请参考《专属分布式存储API参考》。 使用OpenStack原生接口时,您需要使用E CS 服务的终端节点(Endpoint),获取方式请参见地区和终端节点。 文档中没有体现的OpenStack原生接口(例如:挂载云硬盘),请使用弹性云服务器对应的原生接口,参考《弹性云服务器API参考》了解详细操作。 为了支持功能不断扩展,Nova API支持版本号区分。Nova中有两种形式的版本号: 主版本号:具有独立的URL。 微版本号:通过HTTP请求头X-OpenStack-Nova-API-Version来使用,从2.27版本开始支持新的微版本头:OpenStack-API-Version。 父主题: 历史API
  • 响应参数 状态码为200时 表3 响应参数 参数 参数类型 描述 gpu_ip String 分配给设备使用的 GPU云服务器 的IP地址。 link_token String 设备用于连接GPU云服务器的认证凭据。 task_id String 渲染任务的任务ID。 port String 云服务器端口。 状态码为400时 表4 响应参数 参数 参数类型 描述 error_code String 返回的错误码,如CVR.0001。 error_msg String 错误的英文描述。
  • 请求示例 请求URL示例 POST https://{endpoint}/v1/{project_id}/cvr/node/scheduler 请求示例 { "app_id": "5afa7bb2-53d7-11eb-a5aa-fa1640a9b002", "device_id": "477e10fc9938405cb2eceb631a0e6615", "device_brand": "HUAWEI", "device_type": "pc", "application_user": "user1", "protocol_type": "udp", "location": ["cn-north-1"], "resolution": "480p", "gpu_ip_type": "private" }
  • 响应示例 状态码为200时 OK { "gpu_ip" : "255.255.255.255", "link_token" : "******", "task_id" : "5afa7bb2-53d7-11eb-a5aa-fa1640a9b003", "port":"10001" } 状态码为400时 { "error_code" : "string", "error_msg" : "string" }
  • 请求参数 表2 请求参数 参数 是否必选 参数类型 描述 app_id 是 String 设备需要使用的应用ID。 device_id 是 String 设备ID。 长度范围1到40个字符。 只允许输入英文大小写字母、数字及“_”、“-”。 device_brand 否 String 设备品牌。 长度范围1到30个字符。 只允许输入英文大小写字母、数字、空格及“_”、“-”、“.“。 device_type 否 String 设备类型。 device_type的取值范围如下: vr:VR头显 pc:台式机或笔记本电脑 mobile: 手机或平板 ideahub: 智慧屏 VR应用仅支持设备类型为vr,3D应用默认设备类型为pc。 application_launch_args 否 String 应用启动参数。 长度范围1到200个字符。 只允许输入中文字符、英文大小写字母、数字、空格、英文引号及“_”、“-”、“.“、“/”、“:”。 application_user 否 String 应用使用用户标识(该参数仅对3D应用生效)。 长度范围1到40个字符。 只允许输入英文大小写字母、数字及下划线“_”。 protocol_type 否 String 设备与云服务器进行通信时所使用的协议类型。 取值范围如下: udp:集成Android VR SDK的客户端需使用该协议 webrtc: 集成Windows SDK或Android 3D SDK的客户端需使用该协议 websocket:集成Web SDK的客户端需使用该协议 默认值:udp,VR应用仅支持udp协议类型。 location 否 Array of strings 区域列表或边缘小站列表。 分配指定区域中的空闲云服务器。 最多输入10个区域或边缘小站。 每个区域或边缘小站的长度不超过40个字符。 sandbox_enable 否 Boolean 该参数已废弃。 是否支持多路会话的云服务器(该参数仅对VR应用生效)。 true,表示支持多路会话的云服务器。此时,在单路会话和多路会话的云服务器上均可启动渲染任务。 false,表示不支持多路会话的云服务器。此时,只能在单路会话的云服务器上启动渲染任务。 默认值:false。 resolution 否 String GPU云服务器传给设备的画面分辨率(该参数仅对3D应用生效)。 允许输入480p,540p,720p,1080p,2k,4k。 默认值:1080p。 gpu_ip_type 否 String 分配给设备使用的GPU云服务器的IP类型。 public:表示响应的gpu_ip的IP地址为公网,适用于使用公网连接设备与云服务器的场景。 private: 表示响应的gpu_ip的IP地址为私网,适用于使用专线或者内网等连接设备与云服务器的场景。 默认值:public。
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 total Long 历史记录总数。 histories Array of histories objects 所有历史记录的信息。 表4 histories 参数 参数类型 描述 id String 流运行记录ID。 flow_id String 流ID。 flow_name String 流名称。 flow_version_id String 流运行版本ID。 run_model String 流运行模式,通常有手动、自动、测试三种。 手动:需要用户在页面单击运行流。 自动:会按照触发器的类型自动运行流。 测试:用户在创建流的时候可以测试流的功能。 status String 最后一次运行,流程运行状态。 success:流运行成功 fail:流运行失败 icon String 流图标。 start_time String 开始时间。 end_time String 结束时间。 exec_time Long 执行时间,单位:毫秒。 running_times Long 运行次数。 last_time String 最后一次运行时间。 message String 最后一次运行,输出的错误信息。 状态码: 403 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度:8 最大长度:36 error_msg String 错误描述。 最小长度:2 最大长度:512 状态码: 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度:8 最大长度:36 error_msg String 错误描述。 最小长度:2 最大长度:512
  • URI GET /v1/{project_id}/flows/{flow_id}/running-history 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,用于资源隔离。获取方式请参考获取项目ID。 flow_id 是 String 流程ID。 表2 Query参数 参数 是否必选 参数类型 描述 time_range 否 String 时间筛选范围,UTC时间。格式:yyyy-MM-dd'T'HH:mm:ss.SSS'Z'toyyyy-MM-dd'T'HH:mm:ss.SSS'Z' 例如:2020-11-10T00:00:00Zto2020-11-12T00:00:00 status 否 String 流的状态。 枚举值: success fail offset 否 Integer 当前页,起始页数应大于等于0。 limit 否 Integer 每页记录数,每页记录数应大于等于1。
  • 响应 要素说明 参数 是否必选 类型 说明 traffic_limited_list 是 列表数据结构 流量限制列表 http_limited_list 是 列表数据结构 HTTP限制列表 connection_limited_list 是 列表数据结构 连接数限制列表 traffic_limited_list字段数据结构说明 参数 是否必选 类型 说明 traffic_pos_id 是 Integer 流量分段ID traffic_per_second 是 Integer 每秒流量(Mbit/s)阈值 packet_per_second 是 Integer 每秒报文数(个/s)阈值 http_limited_list字段数据结构说明 参数 是否必选 类型 说明 http_request_pos_id 是 Integer HTTP请求数分段ID http_packet_per_second 是 Integer 每秒HTTP请求数(个/s)阈值 connection_limited_list字段数据结构说明 参数 是否必选 类型 说明 cleaning_access_pos_id 是 Integer 清洗时访问限制分段ID new_connection_limited 是 Integer 单一源IP新建连接个数 total_connection_limited 是 Integer 单一源IP连接数总个数 响应样例
  • 响应消息 表2 响应参数 名称 参数类型 说明 status String JOB执行状态。 SUC CES S: 标示该任务执行已经结束,任务执行成功; FAIL:标示该任务执行已经结束,任务执行失败; RUNNING:标示该任务正在执行; INIT:标示给任务还未执行,正在初始化。 entities 字典数据结构 资源信息或错误信息。响应样例以elb的资源ID举例。 job_id String 组合API唯一标识任务的任务号。 job_type String JOB的类型。 error_code String 错误码。 fail_reason String 错误原因。
  • 响应参数 状态码: 400 表34 响应Body参数 参数 参数类型 描述 error_msg String 无效请求提示信息 最小长度:1 最大长度:128 error_code String 错误码 最小长度:1 最大长度:128 状态码: 401 表35 响应Body参数 参数 参数类型 描述 error_msg String 权限错误 最小长度:1 最大长度:128 error_code String 错误码 最小长度:1 最大长度:128 状态码: 500 表36 响应Body参数 参数 参数类型 描述 error_msg String 系统内部错误 最小长度:1 最大长度:128 error_code String 错误码 最小长度:1 最大长度:128
  • 请求示例 POST https://{endpoint}/v1/{project_id}/events/import{ "events" : [ { "version" : "1.0.0", "domain_id" : "dfaf9864b95c448797b5dc0f00709a55", "project_id" : "2b31ed520xxxxxxebedb6e57xxxxxxxx", "data_source" : { "type" : 1, "domain_id" : "39d29606d49b483a9914c581ce190d54", "project_id" : "86670b7b5c6b41e0a5716c0ed77dfc32", "region" : "cn-north-4", "company_name" : "Huawei", "product_name" : "Anti-DDOS", "product_feature" : "Anti-DDOS" }, "first_observed_time" : "2020-10-10T13:10:40.436+0800", "last_observed_time" : "2020-10-10T13:10:40.436+0800", "create_time" : "2020-10-10T13:10:40.436+0800", "arrive_time" : "2020-10-21T01:20:31.343+0800", "event_id" : "1683fbf6-01fd-49f4-8222-0fe33d3f2d2e", "title" : "TCP Malformed", "description" : "TCP Malformed", "severity" : { "original_score" : 1, "label" : "TIPS" }, "business_code" : "attack", "types" : [ { "namespace" : "Attack", "category" : "DDoS", "classifier" : "TCP Malformed" } ], "network" : { "direction" : "IN", "dest_ip" : "119.8.124.133", "dest_port" : 0, "dest_geo" : { "latitude" : 1.352083, "longitude" : 103.81984 } }, "resources" : [ { "id" : "f1f4076a-9d12-497f-aac4-a9dcb5462fcc", "name" : "ecs-s3_large_2_win-20200828214727", "type" : "CloudServers", "service" : "ECS", "provider" : "Huawei", "region" : "cn-north-4", "domain_id" : "dfaf9864b95c448797b5dc0f00709a55", "project_id" : "2b31ed520xxxxxxebedb6e57xxxxxxxx" } ], "verification_state" : "Unknown", "handle_status" : "New" } ]}
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:1 最大长度:2097152 X-Language 否 String 最小长度:2 最大长度:6 表3 请求Body参数 参数 是否必选 参数类型 描述 events 否 Array of Event objects event 批量导入 表4 Event 参数 是否必选 参数类型 描述 version 是 String SA数据对象版本号,数据接入时需携带版本号。版本号由SA服务团队负责更新,数据源只可填写SA给定的版本号。目前版本为1.0.0。 最小长度:5 最大长度:5 domain_id 是 String 租户账号ID,用来标识事件所属租户。 最小长度:32 最大长度:36 project_id 否 String 租户项目ID,用来标识事件所属项目区域。 最小长度:32 最大长度:36 data_source 是 DataSource object 提供数据来源相关信息,必选对象。 first_observed_time 是 String 首次发现时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区。 last_observed_time 否 String 最新发现时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区。 create_time 是 String 记录时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区。 arrive_time 是 String 数据接收时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区。 是指事件数据被SA侧接收的时间,由SA接收时填写,产品上报数据时不用填写。 event_id 是 String 事件唯一标识,UUID格式。 最小长度:32 最大长度:36 title 是 String 事件标题,最大255字符。 最小长度:1 最大长度:255 description 是 String 事件描述信息,最大1024个字符 最小长度:1 最大长度:1024 source_url 否 String 事件URL链接,指向数据源产品中有关当前事件说明的页面。 最小长度:1 最大长度:4096 count 是 Integer 事件发生次数,默认为1,必填。 最小值:1 最大值:9223372036854775807 confidence 否 Integer 事件的置信度。置信度的定义旨在说明识别的行为或问题的可能性。 取值范围:0-100,0表示置信度为0%,100表示置信度为100%。 最小值:0 最大值:100 severity 是 Severity object 严重性对象。 criticality 否 Integer 关键性,是指事件涉及的资源的重要性级别。 取值范围:0-100,0表示资源不关键,100表示最关键资源。 最小值:0 最大值:100 business_code 是 String 业务类型。 attack:攻击;vulnerability:漏洞;compliance check:合规检查; risk:风险;public opinion:舆情;illegal&violation:违法违规;security bulletin:公告。 最小长度:1 最大长度:1024 types 是 Array of Type objects 事件分类,最多50个。 compliance 否 Compliance object 扩展信息,用来提供合规检查信息。合规检查相关的数据上报时,必须填充此对象。 network 否 Network object 扩展信息,用来提供网络信息。 process 否 Process object 扩展信息,用来提供进程信息。 vulnerabilities 否 Vulnerabilities object 扩展信息,用来提供漏洞信息。 malware 否 Array of Malware objects 恶意软件,最多5个。 threat_intel 否 Array of ThreatIntel objects 威胁情报,最多5个。 resources 是 Array of Resource objects 受影响资源,最多10个。 remediation 否 remediation object 补救措施。 related_events 否 Array of RelatedEvent objects 相关事件。 data_source_fields 否 Object 数据源自定义信息,最多支持50个key/value对,约束条件: 1、该对象不能包含冗余数据,并且不能与已定义的SSA事件格式字段冲突。 2、字段名称可以包含字母数字字符、空格和以下符号:_ . / = + \ - @。 示例: "data_source_fields": { "key1": "value1", "key2", "value2", } verification_state 是 String 事件验证状态,标识事件的准确性。 Unknown – 未知,默认 True_positive – 确认 False_positive – 误报。 最小长度:1 最大长度:512 handle_status 是 String 事件处理状态,New/Ignored/Resolved;默认New。 最小长度:1 最大长度:512 表5 DataSource 参数 是否必选 参数类型 描述 type 是 Integer 数据源类型,取值范围如下: 1 - 华为产品 2 - 第三方产品 3 - 租户私有产品 最小值:1 最大值:3 domain_id 是 String 数据源产品所属管理账号的ID,最大36个字符。 最小长度:32 最大长度:36 project_id 否 String 数据源产品所属项目的ID,最大36个字符。 最小长度:32 最大长度:36 region 否 String 数据源产品所在区域,具体取值范围查看华为云地区和终端节点定义。 最小长度:1 最大长度:512 company_name 是 String 数据源产品所属公司的名称。 最小长度:1 最大长度:512 product_name 是 String 数据源产品的名称。 最小长度:1 最大长度:512 product_feature 是 String 产品功能特性名称,用来指明检测到当前事件的产品的功能特性。 最小长度:1 最大长度:512 表6 Severity 参数 是否必选 参数类型 描述 label 是 String 严重性等级取值范围:TIPS、LOW、MEDIUM、HIGH、FATAL。 TIPS:未发现任何问题。 LOW:无需针对问题执行任何操作。 MEDIUM:问题需要处理,但不紧急。 HIGH:问题必须优先处理。 FATAL:问题必须立即处理,以防止产生进一步的损害。 最小长度:1 最大长度:512 normalize_score 否 Integer 严重性评分取值范围:0-100; 与严重性等级的对应关系: TIPS 0; LOW 1-39; MEDIUM 40-69; HIGH 70-89; FATAL 90-100。 最小值:0 最大值:100 original_score 否 Integer 严重性原始评分,指在数据源产品中的评分。 最小值:0 最大值:9223372036854775807 表7 Type 参数 是否必选 参数类型 描述 namespace 是 String 命名空间,只能使用预定义的命名空间值,有效取值如下: Compliance Checks、Vulnerabilities、Attack、Illegal and Violation、Risk、Public Opinion、TTPs、Killchain、Effects、Sensitive Data Identifications、Unusual Behaviors 最小长度:1 最大长度:512 category 否 String 类别,推荐使用预定义的类型分类。 最小长度:1 最大长度:512 classifier 否 String 分类器,推荐使用预定义的分类器。 如果指定了分类器,则必须指定类别。 最小长度:1 最大长度:512 表8 Compliance 参数 是否必选 参数类型 描述 status 是 String 合规检查结果,取值定义:PASSED、WARNING、FAILED、NOT_AVAILABLE。 说明: PASSED - 接受评估的所有资源都已通过安全检查。 WARNING - 某些信息缺失或配置不支持此检查。 FAILED - 至少有一个接受评估的资源未能通过安全检查。 NOT_AVAILABLE - 由于服务中断或 API 错误,无法执行检查。 最小长度:1 最大长度:512 related_requirements 是 Array of strings 与该合规检查相关的行业或监管要求,最多可以提供32个相关的要求。用规范要求的识别码来标识。 status_reasons 否 Array of strings 与该合规检查相关的原因。 表9 Network 参数 是否必选 参数类型 描述 direction 否 String 方向,取值范围:IN、OUT。 最小长度:2 最大长度:3 protocol 否 String 协议。 最小长度:0 最大长度:512 src_ip 否 String 源IP地址。 最小长度:7 最大长度:15 src_port 否 Integer 源端口,0–65535。 最小值:0 最大值:65535 src_domain 否 String 源 域名 ,最大128个字符。 最小长度:1 最大长度:128 src_geo 否 Geo object 源IP的地理位置信息。 destc_ip 否 String 目标IP地址。 最小长度:7 最大长度:15 dest_port 否 Integer 目标端口,0–65535。 最小值:0 最大值:65535 dest_domain 否 String 目标域名,最大128个字符。 最小长度:1 最大长度:128 dest_geo 否 Geo object 目标IP的地理位置信息。 表10 Geo 参数 是否必选 参数类型 描述 latitude 否 Number 纬度。 最小值:-180.0 最大值:180.0 longitude 否 Number 经度。 最小值:-180.0 最大值:180.0 city_code 否 String 城市编码。 最小长度:1 最大长度:128 country_code 否 String 国家简码ISO 3166-1 alpha-2,例如:CN、US、DE、IT、SG。 最小长度:1 最大长度:128 表11 Process 参数 是否必选 参数类型 描述 name 是 String 进程名,最大64个字符。 最小长度:1 最大长度:64 path 是 String 进程执行文件路径,最大512个字符。 最小长度:1 最大长度:512 pid 是 Integer 进程ID。 最小值:0 最大值:65535 parent_pid 否 Integer 父进程ID。 最小值:0 最大值:65535 launche_time 否 String 进程启动时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区。 terminate_time 否 String 进程结束时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区。 表12 Vulnerabilities 参数 是否必选 参数类型 描述 vulnerability_list 否 Array of Vulnerability objects 漏洞信息。 patch_list 否 Array of Patch objects 补丁信息。 reference_urls 否 Array of strings 参考链接,提供有关此漏洞更多信息的URL列表。 related_vulnerabilities 否 Array of strings 相关漏洞,提供与此漏洞相关的漏洞ID列表。 vendor_name 否 String 漏洞报告提供者信息。 最小长度:1 最大长度:32 vulnerable_packages 否 Array of strings 受影响软件及版本列表。 表13 Vulnerability 参数 是否必选 参数类型 描述 vul_id 否 String 漏洞编号。 最小长度:1 最大长度:256 type 否 String 漏洞类型。 最小长度:1 最大长度:32 threat_type 否 String 威胁类型。 最小长度:1 最大长度:32 severity 否 String 危害等级(超危、高危、中危、低危)。 最小长度:1 最大长度:32 score 否 Number CVSS评分。 最小值:0.0 最大值:10.0 vector 否 String 评分向量。 最小长度:0 最大长度:512 version 否 String CVSS版本。 最小长度:0 最大长度:512 description 否 String 漏洞描述。 最小长度:0 最大长度:512 created_at 否 String 漏洞报告的创建时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区。 updated_at 否 String 漏洞报告的更新时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区。 表14 Patch 参数 是否必选 参数类型 描述 patch_id 否 String 补丁编号。 最小长度:1 最大长度:256 patch_name 否 String 补丁名称。 最小长度:1 最大长度:256 type 否 String 补丁类型(0:linux,1:windows,2:web-cms)。 最小长度:1 最大长度:32 major_level 否 String 重要等级。 最小长度:1 最大长度:32 status 否 String 补丁状态。 最小长度:1 最大长度:32 repair_cmd 否 String 修复命令。 最小长度:0 最大长度:512 repair_necessity 否 String 修复必要程度(1:需立刻修复,2:可延后修复,3:暂可以不修复)。 最小长度:0 最大长度:512 release_time 否 String 发布时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息 为事件发生时区,无法解析时区的时间,默认时区填东八区。 表15 Malware 参数 是否必选 参数类型 描述 name 是 String 恶意软件名称,最大64个字符。 最小长度:1 最大长度:64 type 是 String 恶意软件类型,遵循STIX规范: adware、backdoor、bot、bootkit、ddos、downloader、dropper、exploit-kit、keylogger、ransomware、remote-access-trojan、resource-exploitation、rogue-security-software、rootkit、screen-capture、spyware、trojan、unknown、virus、webshell、wiper、worm 最小长度:1 最大长度:512 path 否 String 恶意软件在系统中的路径,最大512个字符。 最小长度:0 最大长度:512 state 否 String 恶意软件状态,取值范围:OBSERVED、REMOVAL_FAILED、REMOVED。 最小长度:0 最大长度:512 表16 ThreatIntel 参数 是否必选 参数类型 描述 type 否 String 威胁情报类型,Domain、Email_Address、Hash_MD5、Hash_SHA1、Hash_SHA256、 Hash_SHA512、IPv4_Address、IPv6_Address、URL。 最小长度:0 最大长度:64 value 否 String 威胁情报指标值,最大512个字符。 最小长度:0 最大长度:512 source 是 String 威胁情报源,最大64个字符。 最小长度:0 最大长度:64 description 是 String 威胁情报描述。 最小长度:0 最大长度:4096 update_time 否 String 威胁情报的更新时间,格式ISO8601:YYYY-MM-DDTHH:mm:ss.ms+timezone。时区信息为事件发生时区,无法解析时区的时间,默认时区填东八区。 source_url 否 String 链接,提供有关威胁情报源的更多详细信息。 最小长度:0 最大长度:512 表17 Resource 参数 是否必选 参数类型 描述 id 是 String 资源ID。 最小长度:32 最大长度:36 name 是 String 资源名称;最大长度255个字符。 最小长度:1 最大长度:255 type 是 String 资源类型;cloud_servers、vpcs、security_groups、public_ips、volumes、containers、websites、hws_account、iam_user、firewall、security_group_rules、elb_loadbalancers、elb_listeners、cts、obs_buckets、rds_instances、dds_instances、dcs_instances、certificates、anti_ddos_eip、dns、other。 最小长度:1 最大长度:128 service 否 String 资源所属服务名称。 最小长度:1 最大长度:128 provider 是 String 资源提供商名称。 最小长度:1 最大长度:128 region 否 String 区域。 最小长度:1 最大长度:128 domain_id 是 String 资源所属租户账号ID。 最小长度:32 最大长度:36 project_id 否 String 资源所属项目ID。 最小长度:32 最大长度:36 idc_id 否 String 线下机房ID。 最小长度:32 最大长度:36 tags 否 Object 资源标签 1、最多50个key/values对。 2、values:最大255字符。 3、取值范围:字母数字、空格、“+”、“-”、“=”、“.”、“_”、“:”、“/”、“@”。 details 否 Detail object 资源详情。 表18 Detail 参数 是否必选 参数类型 描述 cloud_servers 否 CloudServers object ECS实例详情。 vpcs 否 Vpcs object 虚拟私有云。 public_ips 否 PublicIps object 弹性公网IP。 volumes 否 Volumes object 磁盘。 containers 否 Container object 容器。 websites 否 Websites object 网站。 表19 CloudServers 参数 是否必选 参数类型 描述 status 是 String 弹性云服务器状态。 取值范围: ACTIVE、BUILD、ERROR、HARD_REBOOT、MIGRATING、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、VERIFY_RESIZE 最小长度:1 最大长度:128 addresses 是 Array of Addresses objects 弹性云服务器的网络属性。 flavor 是 Flavor object 云服务器规格。 security_groups 是 Array of SecurityGroups objects 弹性云服务器所属安全组列表。 metadata 是 Metadata object 元数据。 host_id 是 String 弹性云服务器所在主机的主机ID。 最小长度:1 最大长度:128 host_status 是 String 云服务器所在主机状态。 UP:服务正常; UNKNOWN:状态未知; DOWN:服务异常; MAINTENANCE:维护状态; 空字符串:弹性云服务器无主机信息。 最小长度:1 最大长度:128 volumes_attached 是 Array of VolumesAttached objects 挂载到弹性云服务器上的磁盘。 表20 Addresses 参数 是否必选 参数类型 描述 version 是 String IP地址版本。“4”:代表IPv4。“6”:代表IPv6。 最小长度:1 最大长度:1 addr 是 String IP地址。 最小长度:7 最大长度:15 ip_type 是 String IP地址类型 fixed:代表私有IP地址。floating:代表浮动IP地址。 最小长度:1 最大长度:128 mac_addr 是 String MAC地址。 最小长度:1 最大长度:128 表21 Flavor 参数 是否必选 参数类型 描述 id 是 String 云服务器规格ID。 最小长度:1 最大长度:128 name 是 String 云服务器规格名称。 最小长度:1 最大长度:128 disk 是 String 该云服务器规格对应要求系统盘大小,0为不限制。 最小长度:1 最大长度:128 vcpus 是 String 该云服务器规格对应的CPU核数。 最小长度:1 最大长度:10 ram 是 String 该云服务器规格对应的内存大小,单位为MB。 最小长度:1 最大长度:10 表22 SecurityGroups 参数 是否必选 参数类型 描述 id 是 String 安全组ID。 最小长度:1 最大长度:128 name 是 String 安全组名称。 最小长度:1 最大长度:128 表23 Metadata 参数 是否必选 参数类型 描述 vpc_id 是 String 云服务器所属的虚拟私有云ID。 最小长度:1 最大长度:128 image_id 是 String 云服务器操作系统对应的镜像ID。 最小长度:1 最大长度:128 image_name 是 String 云服务器操作系统对应的镜像名称。 最小长度:1 最大长度:128 image_type 是 String 镜像类型,目前支持: 公共镜像(gold)、 私有镜像(private)、 共享镜像(shared)。 最小长度:1 最大长度:128 os_bit 是 String 操作系统位数,一般取值为“32”或者“64”。 最小长度:1 最大长度:128 os_type 是 String 操作系统类型,取值为:Linux、Windows。 最小长度:1 最大长度:128 表24 VolumesAttached 参数 是否必选 参数类型 描述 id 是 String 磁盘ID。 最小长度:1 最大长度:128 boot_index 是 String 云硬盘启动顺序。0为系统盘,非0为数据盘。 最小长度:1 最大长度:128 device 是 String 云硬盘挂载盘符,即磁盘挂载点。 最小长度:1 最大长度:128 表25 Vpcs 参数 是否必选 参数类型 描述 cidr 是 String 虚拟私有云下可用子网的范围。 取值范围: 10.0.0.0/8~10.255.255.240/28、 172.16.0.0/12 ~ 172.31.255.240/28、 192.168.0.0/16 ~ 192.168.255.240/28。 约束:必须是cidr格式,例如:192.168.0.0/16。 最小长度:1 最大长度:128 status 是 String 功能说明:虚拟私有云的状态。 取值范围: CREATING:创建中; OK:创建成功。 最小长度:1 最大长度:128 表26 PublicIps 参数 是否必选 参数类型 描述 status 是 String 弹性公网IP的状态。 取值范围: FREEZED:冻结; BIND_ERROR:绑定失败; BINDING:绑定中; PENDING_DELETE:释放中; PENDING_CREATE:创建中; PENDING_UPDATE:更新中; DOWN:未绑定; ACTIVE:绑定; ELB:绑定ELB; ERROR:异常失败。 最小长度:1 最大长度:128 type 是 String 弹性公网IP的类型。 取值范围:5_telcom(电信)、5_union(联通)、5_bgp(全动态BGP)、5_sbgp(静态BGP)。 最小长度:1 最大长度:128 ip_version 是 Integer IP版本信息,取值范围是4和6。 4:表示IPv4; 6:表示IPv6。 最小值:4 最大值:6 public_ipv6_address 否 String IPv4时无此字段,IPv6时为申请到的弹性公网IP地址。 最小长度:1 最大长度:128 public_ip_address 是 String IPv4时是申请到的弹性公网IP地址,IPv6时是IPv6地址对应的IPv4地址。 最小长度:1 最大长度:128 private_ip_address 是 String 绑定弹性公网IP的私有IP地址。 最小长度:1 最大长度:128 vpc_id 是 String 弹性公网IP所属虚拟私有云ID。 最小长度:1 最大长度:128 port_id 否 String 端口id。 约束:只有绑定了的弹性公网IP查询才会返回该参数。 最小长度:1 最大长度:128 device_id 否 String 端口所属设备ID。 最小长度:1 最大长度:128 bandwidth_id 是 String 弹性公网IP对应带宽ID。 最小长度:1 最大长度:128 bandwidth_name 是 String 带宽名称。 最小长度:1 最大长度:128 表27 Volumes 参数 是否必选 参数类型 描述 status 是 String 云硬盘状态,见EVS服务云硬盘状态描述。 最小长度:1 最大长度:128 availability_zone 是 String 云硬盘所属的AZ信息。 最小长度:1 最大长度:128 attachments 是 Array of Attachment objects 云硬盘的挂载信息。 size 是 String 云硬盘大小,单位为GB。 最小长度:1 最大长度:10 volume_type 是 String 云硬盘类型。 目前支持“SSD”,“SAS”和“SATA”三种。 “SSD”为超高IO云硬盘, “SAS”为高IO云硬盘, “SATA”为普通IO云硬盘。 最小长度:1 最大长度:10 encrypted 是 Boolean 是否加密。 multiattach 是 Boolean 是否为共享云硬盘。 true:表示为共享云硬盘。 false:表示为非共享云硬盘。 表28 Attachment 参数 是否必选 参数类型 描述 server_id 是 String 云硬盘挂载到的云服务器的ID。 最小长度:1 最大长度:128 attachment_id 是 String 挂载信息对应的ID。 最小长度:1 最大长度:128 attached_at 是 String 挂载时间。 device 是 String 挂载点。 最小长度:1 最大长度:128 表29 Container 参数 是否必选 参数类型 描述 image_id 是 String 镜像ID。 最小长度:1 最大长度:128 image_name 是 String 镜像名称。 最小长度:1 最大长度:128 node_id 否 String 容器所在节点ID。 最小长度:1 最大长度:128 node_name 否 String 容器所在节点名称。 最小长度:1 最大长度:128 launched_time 否 String 容器启动时间。 表30 Websites 参数 是否必选 参数类型 描述 url 是 String 网站地址,最长128个字符。 最小长度:1 最大长度:128 port 否 String 端口号。 最小长度:1 最大长度:12 表31 remediation 参数 是否必选 参数类型 描述 recommendation 否 Recommendation object 补救措施。 表32 Recommendation 参数 是否必选 参数类型 描述 text 是 String 处理建议,最长512个字符。 最小长度:1 最大长度:512 url 否 String 链接,指向该事件的一般修复信息。该URL必须可以从公网访问,不需要提供凭证。 最小长度:1 最大长度:128 表33 RelatedEvent 参数 是否必选 参数类型 描述 id 是 String 与当前事件相关的事件的ID,最大36个字符。 最小长度:1 最大长度:36 company_name 是 String 生成相关事件的产品所属公司名称,最大16个字符。 最小长度:1 最大长度:16 product_name 是 String 生成相关事件的产品名称,最大24个字符。 最小长度:1 最大长度:24
  • 响应 要素说明 参数 是否必选 类型 说明 traffic_limited_list 是 列表数据结构 流量限制列表 http_limited_list 是 列表数据结构 HTTP限制列表 connection_limited_list 是 列表数据结构 连接数限制列表 traffic_limited_list字段数据结构说明 参数 是否必选 类型 说明 traffic_pos_id 是 Integer 流量分段ID traffic_per_second 是 Integer 每秒流量(Mbit/s)阈值 packet_per_second 是 Integer 每秒报文数(个/s)阈值 http_limited_list字段数据结构说明 参数 是否必选 类型 说明 http_request_pos_id 是 Integer HTTP请求数分段ID http_packet_per_second 是 Integer 每秒HTTP请求数(个/s)阈值 connection_limited_list字段数据结构说明 参数 是否必选 类型 说明 cleaning_access_pos_id 是 Integer 清洗时访问限制分段ID new_connection_limited 是 Integer 单一源IP新建连接个数 total_connection_limited 是 Integer 单一源IP连接数总个数 响应样例