# 获取ecs详情 - ShowEcs #### 功能介绍 功能介绍：获取ecs详情 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET /v1/{project_id}/sdg/data-map/ecs/{server_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID。可参考获取项目ID获取。 **约束限制：** 不涉及 **取值范围：** 以IAM服务接口返回值为准，字符长度32-32。 **默认取值：** 不涉及 | | server_id | 是 | String | **参数解释：** 服务器ID **约束限制：** 不涉及 **取值范围：** 1到64个字符 **默认取值：** 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及 **取值范围：** IAM服务查询用户Token接口为准 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | server_id | String | **参数解释：** 弹性云服务器详情ID **取值范围：** 不涉及 | | name | String | **参数解释：** ECS实例名称 **取值范围：** 不涉及 | | risk_level | String | **参数解释：** 弹性云服务器详情等级 **取值范围：** - HIGH-高 - MIDDLE-中 - LOW-低 - UNKNOWN-未知 - IGNORED-已忽略 - INIT-初始化 | | security_groups | Array of [SecurityGroupInfo] objects | **参数解释：** 安全组列表 **取值范围：** 不涉及 | | risk_security_group_num | Integer | **参数解释：** 风险安全组数量 **取值范围：** 不涉及 | | created | String | **参数解释：** 创建时间 **取值范围：** 不涉及 | | status | String | **参数解释：** 操作结果状态 **取值范围：** 不涉及 | | vcpus | Integer | **参数解释：** 虚拟CPU数 **取值范围：** 不涉及 | | ram | Integer | **参数解释：** 内存大小 **取值范围：** 不涉及 | | flavor | String | **参数解释：** 规格 **取值范围：** 不涉及 | | image_name | String | **参数解释：** 弹性云服务器详情名称 **取值范围：** 不涉及 | 表4SecurityGroupInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 资源ID，唯一标识 **取值范围：** 不涉及 | | name | String | **参数解释：** 安全组名称 **取值范围：** 不涉及 | | description | String | **参数解释：** 资源描述信息 **取值范围：** 不涉及 | | risk_level | String | **参数解释：** 安全分组信息等级 **取值范围：** - HIGH-高 - MIDDLE-中 - LOW-低 - UNKNOWN-未知 - IGNORED-已忽略 - INIT-初始化 | | risk_rules | Array of [SecurityGroupRule] objects | **参数解释：** 风险规则 **取值范围：** 不涉及 | 表5SecurityGroupRule | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 资源ID，唯一标识 **取值范围：** 不涉及 | | security_group_id | String | **参数解释：** 安全组ID **取值范围：** 不涉及 | | direction | String | **参数解释：** 方向 **取值范围：** 不涉及 | | protocol | String | **参数解释：** 协议 **取值范围：** 不涉及 | | ethertype | String | **参数解释：** 以太类型 **取值范围：** 不涉及 | | description | String | **参数解释：** 资源描述信息 **取值范围：** 不涉及 | | remote_ip_prefix | String | **参数解释：** 远程IP地址前缀 **取值范围：** 不涉及 | | port_range_max | Integer | **参数解释：** 端口范围最大 **取值范围：** 不涉及 | | port_range_min | Integer | **参数解释：** 端口范围最小 **取值范围：** 不涉及 | | remote_group_id | String | **参数解释：** 安全分组规则ID **取值范围：** 不涉及 | #### 请求示例 获取ecs详情 ``` /v1/2b31ed520xxxxxxebedb6e57xxxxxxxx/sdg/data-map/ecs/xxxx-xxxx-xxxx-xxxx ``` #### 响应示例 **状态码：200** ``` { "server_id" : "826314dd-1b5b-4037-b976-5f9b7a17df46", "name" : "asset-resource-01", "risk_level" : "HIGH", "security_groups" : [ { "id" : "0cfd1d3e-2c4a-4d1f-8e2b-9a3c4d5e6f70", "name" : "asset-resource-01", "description" : "资产中心数据资源描述", "risk_level" : "HIGH", "risk_rules" : [ { "id" : "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d", "security_group_id" : "f7e6d5c4-b3a2-1908-7f6e-5d4c3b2a1908", "direction" : "asset-value-01", "protocol" : "asset-value-01", "ethertype" : "asset-value-01", "description" : "资产中心数据资源描述", "remote_ip_prefix" : "asset-value-01", "port_range_max" : 1, "port_range_min" : 1, "remote_group_id" : "3a7b8c9d-0e1f-2a3b-4c5d-6e7f8a9b0c1d" } ] } ], "risk_security_group_num" : 2, "created" : "asset-value-01", "status" : "ENABLE", "vcpus" : 1, "ram" : 1, "flavor" : "asset-value-01", "image_name" : "image-resource-01" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 请求已成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。