重置边缘实例密码

本接口用于重置重置边缘实例的密码。密码类型允许修改。

接口说明

前提条件：

• 重置密码的实例需处于运行中状态。

注意事项：

• 重置实例的密码后，您必须重启实例才能使新密码生效。您可以选择在重置密码时同步重启实例，或者选择在重置密码后重启实例。如果您登录实例的操作系统内部来重启实例，重置密码的操作不会生效。重启实例可能会影响您的业务。因此，建议您在业务流量低谷期执行该操作以降低对业务的影响。

• Linux实例支持以下两种类型的登录密码：自定义密码和SSH Key。自定义密码意味着您需要通过用户名和密码登录实例。SSH Key意味着您需要通过密钥对方式登录实例。密码类型变更后，密码的有效性可能会发生变化。例如，如果您为一个Linux实例设置了自定义密码，然后将自定义密码变更为了密钥对，自定义密码会失效。此种情况下，如果您既需要使用自定义密码又需要使用SSH Key，请将密钥对变更为自定义密码。登录密码的有效性，请参见下表说明。

  密码变更类型	旧的登录密码	新的登录密码
  将SSH Key变更为自定义密码	可用	可用
  将SSH Key变更为SSH Key	不可用	可用
  将自定义密码变更为自定义密码	不可用	可用
  将自定义密码变更为SSH Key	不可用	可用

请求方法

POST

请求参数

下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数，请参见公共参数。

返回数据

无

请求示例

POST https://veenedge.volcengineapi.com/?Action=ResetLoginCredential&Version=2021-04-30
&<其他公共参数>
{
  "instance_identity": "veen21112705010175****",
  "secret_type": 2,
  "secret_data": "My_password"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202305251821543FE4E72F4433C311****",
        "Action": "ResetLoginCredential",
        "Version": "2021-04-30",
        "Service": "veenedge",
        "Region": "cn-north-1"
    }
}

错误码

如果响应正文中包含 Error 字段，则表示 API 请求失败。关于错误码的更多信息，参见错误码。