# 查询MITRE战术列表 - ListTactics #### 功能介绍 查询MITRE ATT\&CK矩阵中的战术列表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-secmaster/secmaster_03_0008.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-secmaster/secmaster_03_0023.html)。 #### URI GET /v1/soc/mitres/tactics #### 请求参数 表1请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。[获取用户Token](https://support.huaweicloud.com/api-secmaster/secmaster_03_0010.html) **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | tactics | Array of [TacticObject] objects | **参数解释：** 战术列表数据。 **取值范围：** 0\~100条记录 | 表3TacticObject | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 战术记录ID。 **取值范围：** 只能由英文字母、数字、下划线、连字符组成，且长度为1\~64个字符。 | | created | String | **参数解释：** 创建时间，用于记录资源的创建时间。 **取值范围：** 格式为yyyy-MM-ddTHH:mm:ssZ+0800，例如2023-04-14T00:00:00Z+0800 | | last_modified | String | **参数解释：** 最后修改时间，用于记录资源的最后修改时间。 **取值范围：** 格式为yyyy-MM-ddTHH:mm:ssZ+0800，例如2023-04-14T00:00:00Z+0800 | | tactic_id | String | **参数解释：** MITRE战术ID，用于标识战术。 **取值范围：** 只能由英文字母、数字、连字符组成，且长度为1\~64个字符。 | | name | String | **参数解释：** 战术名称。 **取值范围：** 长度为1\~256个字符。 | | description | String | **参数解释：** 战术描述。 **取值范围：** 长度为0\~65535个字符。 | | url | String | **参数解释：** 参考链接。 **取值范围：** 长度为0\~1024个字符。 | | latest_version | String | **参数解释：** 最新MITRE版本。 **取值范围：** 长度为1\~64个字符。 | | techniques | Array of [TechniqueObject] objects | **参数解释：** 技术列表。 **取值范围：** 0\~100条记录 | 表4TechniqueObject | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 技术记录ID。 **取值范围：** 只能由英文字母、数字、下划线、连字符组成，且长度为1\~64个字符。 | | tactic_ids | String | **参数解释：** 关联的战术ID列表。 **取值范围：** 长度为0\~1024个字符。 | | created | String | **参数解释：** 创建时间，用于记录资源的创建时间。 **取值范围：** 格式为yyyy-MM-ddTHH:mm:ssZ+0800，例如2023-04-14T00:00:00Z+0800 | | last_modified | String | **参数解释：** 最后修改时间，用于记录资源的最后修改时间。 **取值范围：** 格式为yyyy-MM-ddTHH:mm:ssZ+0800，例如2023-04-14T00:00:00Z+0800 | | technique_id | String | **参数解释：** MITRE技术ID，用于标识技术。 **取值范围：** 只能由英文字母、数字、连字符组成，且长度为1\~64个字符。 | | name | String | **参数解释：** 技术名称。 **取值范围：** 长度为1\~256个字符。 | | description | String | **参数解释：** 技术描述。 **取值范围：** 长度为0\~65535个字符。 | | url | String | **参数解释：** 参考链接。 **取值范围：** 长度为0\~1024个字符。 | | version | String | **参数解释：** 技术版本。 **取值范围：** 长度为1\~64个字符。 | | platforms | String | **参数解释：** 适用平台。 **取值范围：** 长度为0\~256个字符。 | | tactic_names | String | **参数解释：** 关联的战术名称列表。 **取值范围：** 长度为0\~1024个字符。 | **状态码：400** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 错误码 **取值范围：** 不涉及 | | error_msg | String | **参数解释**: 错误描述 **取值范围：** 不涉及 | #### 请求示例 查询MITRE战术列表 ``` https://{endpoint}/v1/soc/mitres/tactics ``` #### 响应示例 **状态码：200** MITRE战术列表 ``` { "tactics" : [ { "id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "created" : "2020-10-02T00:00:00Z+0800", "last_modified" : "2020-10-18T00:00:00Z+0800", "tactic_id" : "TA0001", "name" : "初始访问", "description" : "The adversary is trying to get into your network.", "url" : "https://attack.mitre.org/tactics/TA0001", "latest_version" : "v14", "techniques" : [ { "id" : "c2fab5b0-b602-11ee-bfbb-fa163e5cde0d", "created" : "2020-10-02T00:00:00Z+0800", "last_modified" : "2020-10-18T00:00:00Z+0800", "tactic_ids" : "TA0001", "technique_id" : "T1199", "name" : "信任关系", "description" : "Adversaries may leverage external-facing remote services to initially access and/or persist within a network.", "url" : "http://attack.mitre.org/techniques/T1199", "version" : "2.3" } ] } ] } ``` **状态码：400** 参数异常 ``` { "error_code" : "SecMaster.20040001", "error_msg" : "请求参数错误，请检查输入参数" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | MITRE战术列表 | | 400 | 参数异常 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-secmaster/ErrorCode.html)。