# 搜索ECS
#### 操作场景
购买弹性云服务器后，可以通过管理控制台提供的搜索功能快速检索当前区域的云服务器资源。本节操作介绍搜索云服务器的操作步骤。当前支持使用名称、ID、可用区、状态、规格名称、镜像ID、弹性公网IP地址、私有IP地址(IPv4/IPv6)、创建时间、计费模式、VPC ID、企业项目、资源标签等属性进行搜索。
#### 搜索语法
弹性云服务器支持多种类型的搜索，详细的说明和示例请参考[表1]。
![](https://support.huaweicloud.com/usermanual-ecs/public_sys-resources/note_3.0-zh-cn.png)
- 部分属性支持系统自动匹配属性搜索，但必须输入完整的属性值。
- 选择属性搜索时，以下属性仅支持精确搜索，需输入完整的属性值：ID、镜像ID、弹性公网IP地址、VPC ID、企业项目。
- 多值搜索时私有IP地址也必须使用精确搜索，需输入完整的属性值。
- 私有IP地址的网段需在以下范围内：10.0.0.0/8-24 ，172.16.0.0/12-24，192.168.0.0/16-24 。
- 按标签过滤时可选择键或键值对搜索。支持设置多个标签，如果键不同，则标签按"与"的关系搜索。如果键相同，值不同，则标签按"与"的关系搜索。
- 未选择属性的时候标签不支持多值搜索。
- 私有IP和弹性公网IP不能同时搜索。
 
 表1搜索语法 
| 搜索类型                                    | 支持的属性                                                                                                            | 格式                       | 示例                                                                                                                                                 | 说明                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|:---|
| 属性值 自动匹配属性  | ID 规格名称 弹性公网IP地址 私有IP地址 | 完整的属性值                  | ID：4a79dfec-f0d8-4181-9bef-495b8b7220e1 规格名称：s2.xlarge.4 私有IP地址：192.168.99.231           | 使用关键字搜索时，不需要选择属性，仅输入完整的属性值，系统自动匹配属性类型进行搜索。 多个取值使用","分隔。否则后输入的取值会替换之前输入的取值。多个属性值之间为"或"的关系。                                                                                                                                                                                                                      |
| 属性值 模糊搜索 | 名称 私有IP地址 规格名称                                           | 属性：不完整的属性值               | 名称：ecs-c 规格名称：s7n 私有IP地址：192.168.0                                                        | 选择属性后，输入对应的属性信息。                                                                                                                                                                                                                                                                                                                          |
| 单属性                                     | 控制台支持的所有属性                                                                                                       | 属性：属性值                   | 私有IP地址：192.168.99.231                                                                                                                                | 选择属性后，输入或选择对应的属性信息。 以下属性仅支持精确搜索，需输入完整的属性值：ID、弹性公网IP地址、镜像ID、VPC ID。                                                                                                                                                                                                                                         |
| 多属性                                     | 控制台支持的所有属性                                                                                                      | 属性1：取值 属性2：取值           | 私有IP地址：192.168.99.231 名称：ecs-c                                                                                                                       | 支持选择多个不同的属性，搜索时多个属性为"与"的关系。 以下属性仅支持精确搜索，需输入完整的属性值：ID、弹性公网IP地址、镜像ID、VPC ID。                                                                                                                                                                                                                                  |
| 单属性、多值                                  | ID 规格名称 弹性公网IP地址                                 | 属性：取值1,取值2               | ID： 624eda28-6bd9-402a-934b-26c8969f7169,bf6c0281-f749-42d7-b732-23ac69d80ebe 规格名称：s2,s3 | 选择一个属性后，输入多个取值，多个取值之间为"或"的关系。 以下属性仅支持精确搜索，需输入完整的属性值：ID。                                                                                                                                                                                                                                                    |
| 单属性、多值                                  | 状态 计费模式                                                                           | 属性：取值1 属性：取值2           | 状态：运行中 状态：关闭                                                                                                                                         | 选择一个属性后，勾选多个取值，多个取值之间为"或"的关系。                                                                                                                                                                                                                                                                                                             |
| 多属性、多值                                   | ID、规格名称、状态、弹性公网IP地址、私有IP地址、计费模式                                                                            | 属性1：取值1,取值2 属性2：取值1,取值2 | ID： 624eda28-6bd9-402a-934b-26c8969f7169,bf6c0281-f749-42d7-b732-23ac69d80ebe 规格名称：s2,s3                                 | 选择多属性、多值搜索时： - 多个属性之间为"与"的关系。  - 同一属性的多个取值之间为"或"的关系。   以下属性仅支持精确搜索，需输入完整的属性值：ID。 以下属性的多个值之间支持使用"\|"分隔或直接勾选：状态、计费模式。 |
   
#### 操作步骤
1. 登录[ECS控制台](https://console.huaweicloud.com/ecm/?#/ecs/manager/vmList)，进入弹性云服务器列表页面。
2. 在搜索的输入框中，设置搜索条件。 您可以根据需要，选择并设置合适搜索条件。
   - 在搜索框直接输入属性值，系统自动识别属性并搜索。
   
   - 设置搜索属性类型进行搜索。
     1. 单击搜索框，在列表中选择搜索的属性类型。
        图1设置搜索属性类型   
        ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001643899604.png "点击放大") 
     
     2. 根据提示，在搜索栏中选择属性值直接搜索，或者输入属性值后单击回车键进行搜索。
      
    
3. （可选）在搜索栏中修改搜索条件。
   完成ECS实例搜索后，如果需要按照其他的属性类型或值重新搜索，可修改搜索条件。
   1. 单击搜索栏中需要修改的搜索条件。
   
   2. 在"属性类型"下拉框中输入或选择搜索属性，在"值"下拉框中输入或选择搜索值。
   
   3. 单击"确定"，系统将按照新的搜索条件重新搜索ECS实例。
     
 
#### 示例1：使用属性值搜索，系统自动匹配属性
输入完整的属性值后，系统自动识别属性并搜索。多个取值使用","分隔，否则后输入的取值会替换之前输入的取值。多个属性值之间为"或"的关系。
- 单值搜索： 在云服务器列表页搜索的输入框中输入完整ID，按回车键进行搜索。
  图2输入完整的ID   
  ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001644060224.png "点击放大")
  图3系统自动匹配属性   
  ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001692302985.png "点击放大") 
- 多值搜索：
  在云服务器列表页搜索的输入框中输入完整的规格名称，按回车键进行搜索。
  图4输入多个完整的规格名称   
  ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001643901532.png "点击放大")
  图5系统自动匹配属性并搜索   
  ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001692421321.png "点击放大") 
 
#### 示例2：单属性搜索
选择属性后，输入/选择对应的属性信息。
以下属性仅支持精确搜索，需输入完整的属性值：ID、弹性公网IP地址、镜像ID、VPC ID。
- 模糊搜索：使用私有IP地址搜索
  1. 在云服务器列表页搜索的输入框中选择"私有IP地址"。
  
  2. 根据提示，输入私有IP地址，按回车键进行搜索。"私有IP地址"支持模糊搜索，例如输入"192.168.0"，可以搜索到所有使用192.168.0网段的云服务器。
     图6按私有IP地址搜索云服务器   
     ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001136346748.png "点击放大") 
   
- 精确搜索：使用ID搜索
  1. 在云服务器列表页搜索的输入框中选择"ID"。
  
  2. 根据提示，输入完整的ID，按回车键进行搜索。
     图7按ID搜索云服务器   
     ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001692423833.png "点击放大") 
   
 
#### 示例3：多属性搜索
支持选择多个不同的属性，搜索时多个属性为"与"的关系。
以下属性仅支持精确搜索，需输入完整的属性值：ID、弹性公网IP地址、镜像ID、VPC ID。
本例同时使用"名称"和"私有IP地址"进行搜索。
1. 在云服务器列表页搜索的输入框中选择"名称"并输入取值。按回车键进行搜索。本例名称使用模糊搜索。
2. 添加筛选属性条件，选择"私有IP地址"，根据提示输入私有IP地址，按回车键进行搜索。本例私有IP地址使用模糊搜索。
   图8按名称和私有IP地址搜索云服务器   
   ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001136506546.png "点击放大") 
 
#### 示例4：单属性、多值搜索
仅以下属性支持单属性、多值搜索：状态、ID、规格名称、私有IP地址、弹性公网IP地址、计费模式、标签。
其中以下属性仅支持精确搜索，需输入完整的属性值：ID、私有IP地址、弹性公网IP地址。
选择一个属性后，输入多个取值，多个取值之间为"或"的关系。
- 模糊搜索
  1. 在云服务器列表页搜索的输入框中选择"规格名称"。
  
  2. 根据提示输入多个规格名称，使用","分隔，按回车键进行搜索。
     图9按规格名称搜索云服务器   
     ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001182746035.png "点击放大") 
   
- 精确搜索
  1. 在云服务器列表页搜索的输入框中选择"私有IP地址"。
  
  2. 根据提示输入多个完整的私有IP地址，使用","分隔，按回车键进行搜索。
     图10按私有IP地址搜索云服务器   
     ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001136506548.png "点击放大") 
   
 
#### 示例5：多属性、多值搜索
仅以下属性支持多属性、多值搜索：ID、规格名称、状态、弹性公网IP地址、计费模式。
选择多属性、多值搜索：
- 多个属性之间为"与"的关系。
- 同一属性的多个取值之间为"或"的关系。
以下属性仅支持精确搜索，需输入完整的属性值：ID。
- 模糊搜索
  1. 在云服务器列表页搜索的输入框中选择"状态"，并选择"运行中"、"关机"，按回车键进行搜索。
  
  2. 添加筛选条件，选择"规格名称"，输入多个规格名称，使用","分隔，按回车键进行搜索。
     图11按状态和规格名称搜索云服务器   
     ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001136346754.png "点击放大") 
   
- 精确搜索
  1. 在云服务器列表页搜索的输入框中选择"状态"，并选择"运行中"、"关机"，按回车键进行搜索。
  
  2. 添加筛选条件，选择"ID"，根据提示输入多个完整的ID，使用","分隔，按回车键进行搜索。
     图12按状态和ID搜索云服务器   
     ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001643918060.png "点击放大") 
   
 
#### 示例6：按标签搜索
按标签过滤时可选择键或键值对搜索。
支持设置多个标签，如果键不同，则标签按"与"的关系搜索。
如果键相同，值不同，则标签按"与"的关系搜索。
- 单个标签搜索 在云服务器列表页搜索的输入框中选择"标签"，选择标签键值对后自动搜索。
  图13按标签搜索云服务器   
  ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001692331177.png) 
- 多个标签搜索 在云服务器列表页搜索的输入框中选择"标签"，选择多个标签键值对后自动搜索。
  按"与"的关系搜索，搜索同时具备这两个标签的云服务器。
  图14按标签搜索云服务器   
  ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001644093714.png "点击放大") 
 
#### 示例7：修改搜索条件
搜索完成后，您可以修改搜索条件，按照其他的属性类型或值重新搜索。本示例将其中一个搜索条件由"名称：ecs-test1"变更为"可用区：可用区1"。
1. 单击搜索栏中需要修改的搜索条件"名称：ecs-test1"。
   图15选择搜索条件   
   ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000002298844406.png "点击放大") 
2. 在"属性类型"下拉框中选择"可用区"，在"值"下拉框中选择"可用区1"。
   图16修改搜索属性   
   ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000002298870924.png "点击放大") 
3. 单击"确定"，系统将搜索"可用区1"中状态为"运行中"的ECS实例。
   图17搜索ECS实例   
   ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000002334793505.png "点击放大") 
 
