ECS：如何使用 REST API 更改或解锁管理和监视用户

Summary: 如何使用 API 更改或解锁管理和监视用户。 如何在无法使用用户界面访问时更改 emcmonitor 密码。

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

有时用户会忘记密码，无法再使用凭据登录 ECS。

要使用 REST API 更改密码，请执行以下作：

  1. 获取当前用户的列表。以下命令将列出除 emcmonitor 和 emcservice:

命令：

# svc_rest_cmd -u root -p ChangeMe /vdc/users/

示例：

admin@ecsnode1:~> svc_rest_cmd -u root -p ChangeMe /vdc/users/
svc_rest_cmd 1.0.10

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<mgmt_user_infos>
  <mgmt_user_info>
    <is_external_group>false</is_external_group>
    <isSystemAdmin>false</isSystemAdmin>
    <isSystemMonitor>false</isSystemMonitor>
    <userId>emcsecurity</userId>
  </mgmt_user_info>
  <mgmt_user_info>
    <is_external_group>false</is_external_group>
    <isSystemAdmin>true</isSystemAdmin>
    <isSystemMonitor>true</isSystemMonitor>
    <userId>lex</userId>
  </mgmt_user_info>
  <mgmt_user_info>
    <is_external_group>false</is_external_group>
    <isSystemAdmin>true</isSystemAdmin>
    <isSystemMonitor>true</isSystemMonitor>
    <userId>root</userId>
  </mgmt_user_info>


查询特定用户，包括特殊帐户，例如 emcmonitor 和 emcservice，请使用以下语法：

命令：

# svc_rest_cmd -u root -p ChangeMe /vdc/users/<username>

示例：

admin@ecsnode1:~> svc_rest_cmd -u root -p ChangeMe /vdc/users/emcmonitor
svc_rest_cmd 1.0.10

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<mgmt_user_info>
  <is_external_group>false</is_external_group>
  <is_locked>false</is_locked>
  <isSecurityAdmin>false</isSecurityAdmin>
  <isSystemAdmin>false</isSystemAdmin>
  <isSystemMonitor>true</isSystemMonitor>
  <userId>emcmonitor</userId>
</mgmt_user_info>
  1. 使用密码创建文件 SystemAdmin 和 SystemMonitor 用户应具有的访问权限。在此示例中，必须重置的用户是 emcmonitor：
命令： 
# vi /file/path
  • 按 Insert 键。
  • 将以下内容粘贴到 CLI 会话中：（右键单击与 Windows Ctrl+v 热键相同）
<mgmt_user_info_update>
   <password>ChangeMe</password>
   <isSystemAdmin>false</isSystemAdmin>
   <isSystemMonitor>true</isSystemMonitor>
</mgmt_user_info_update>
  • 按 Esc 键
  • 在命令之前键入 :wq!
示例： 
admin@ecsnode1:~> vi /tmp/emcmonitor
<mgmt_user_info_update>
   <password>ChangeMe</password>
   <isSystemAdmin>false</isSystemAdmin>
   <isSystemMonitor>true</isSystemMonitor>
</mgmt_user_info_update>
  1. 确认文件内容：
命令： 
# cat /file/path
示例： 
admin@ecsnode1:~> cat /tmp/emcmonitor
<mgmt_user_info_update>
   <password>ChangeMe</password>
   <isSystemAdmin>false</isSystemAdmin>
   <isSystemMonitor>true</isSystemMonitor>
</mgmt_user_info_update>
NOTE:  Make sure that the SystemAdmin and SystemMonitor is correct, this will change the user abilities.  Match this with the output from step 1.
  1. 使用以下命令重置密码 svc_rest_cmd：

命令：

# svc_rest_cmd PUT -u root -p ChangeMe -xml -file <file_name> /vdc/users/<user_to_change>
示例： 
#svc_rest_cmd PUT -u root -p ChangeMe -xml -file /tmp/emcmonitor /vdc/users/emcmonitor
svc_rest_cmd 1.0.10


现在，用户可以使用步骤 2 中创建的文件中定义的密码登录。


对于锁定的帐户，要使用 REST API 解锁和更改帐户上的密码，请执行以下作：
当 VDC 启用了密码规则并且用户帐户属性在 时显示is_locked为 true时，此方法有效：

admin@ecsnode1:~> svc_rest_cmd -u root -p ChangeMe /vdc/users/emcservice
svc_rest_cmd 1.0.10

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<mgmt_user_info>
  <is_external_group>false</is_external_group>
  <is_locked>true</is_locked>
  <isSecurityAdmin>false</isSecurityAdmin>
  <isSystemAdmin>false</isSystemAdmin>
  <isSystemMonitor>true</isSystemMonitor>
  <userId>emcservice</userId>
</mgmt_user_info>
  1. 创建包含以下内容的文件。如果启用了密码规则，则所设置的密码应满足密码规则设置的任何条件。
<mgmt_user_info_unlock>
   <password>ChangeMe</password>
</mgmt_user_info_unlock>
  1. 使用以下命令解锁和重置密码 svc_rest_cmd：

命令：

# svc_rest_cmd PUT -u root -p ChangeMe -xml -file <file_name> /vdc/users/<user_to_change>/unlock

示例：

 #svc_rest_cmd PUT -u root -p ChangeMe -xml -file /tmp/emcservice /vdc/users/emcservice/unlock
svc_rest_cmd 1.0.10


预计不会产生任何输出。检查用户帐户并验证 is_locked 值是否设置为 false：

admin@ecsnode1:~> svc_rest_cmd -u root -p ChangeMe /vdc/users/emcservice
svc_rest_cmd 1.0.10

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<mgmt_user_info>
  <is_external_group>false</is_external_group>
  <is_locked>false</is_locked>
  <isSecurityAdmin>false</isSecurityAdmin>
  <isSystemAdmin>false</isSystemAdmin>
  <isSystemMonitor>true</isSystemMonitor>
  <userId>emcservice</userId>
</mgmt_user_info>

Additional Information

需要根密码或用户界面。如果客户具有非默认密码，请询问他们是否要更改为默认值。然后重置用户密码，并在维护完成后将其改回原来。这样，他们的自定义 root 密码就不会显示在历史记录中。

Affected Products

ECS Appliance

Products

ECS Appliance, ECS Appliance Gen 1, ECS Appliance Gen 2, ECS Appliance Gen 3, ECS Appliance Hardware Gen3 EX300, ECS Appliance Hardware Gen3 EX3000, ECS Appliance Hardware Gen1 U-Series, ECS Appliance Hardware Gen1 C-Series , ECS Appliance Hardware Gen2 C-Series, ECS Appliance Hardware Gen2 D-Series, ECS Appliance Hardware Gen2 U-Series, ECS Appliance Hardware Gen3 EX500, ECS Appliance Hardware Series, ECS Appliance Software with Encryption, ECS Appliance Software without Encryption ...
Article Properties
Article Number: 000019704
Article Type: How To
Last Modified: 14 Aug 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.