Changes the logon password of a host.

You can call this operation to change the logon password of a host that is created in an ApsaraDB MyBase for Redis Enhanced Edition (Tair) dedicated cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyDedicatedHostPassword

The operation that you want to perform. Set the value to ModifyDedicatedHostPassword.

RegionId String No cn-hangzhou

The ID of the region where the host is deployed. You can call the DescribeDedicatedHostAttribute operation to obtain the region ID.

NewPassword String Yes test*****

The new password. The password must meet the following requirements:

  • The password must be 8 to 32 characters in length.
  • The password must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.
  • The password can contain the following special characters: ! @ # $ % ^ & * ( ) _ + - =
Note If the host is used for SQL Server databases, the password cannot include the username of the account, regardless of lowercase letters or uppercase letters.
DedicatedHostId String Yes ch-bp10a5id3boqi****

The ID of the host. You can call the DescribeDedicatedHosts operation to obtain the ID of the host.

Response parameters

Parameter Type Example Description
DedicatedHostName String test123****

The name of the host.

RequestId String D6E068C3-25BC-455A-85FE-45F0B22E12AS

The ID of the request.

Examples

Sample requests

http(s)://cddc.aliyuncs.com/?Action=ModifyDedicatedHostPassword
&NewPassword=test*****
&DedicatedHostId=ch-bp10a5id3boqi****
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDedicatedHostPasswordReponse>
<RequestId>D6E068C3-25BC-455A-85FE-45F0B22E12AS</RequestId>
<DedicatedHostName>test123****</DedicatedHostName>
</ModifyDedicatedHostPasswordReponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "D6E068C3-25BC-455A-85FE-45F0B22E12AS",
  "DedicatedHostName" : "test123****"
}

Error codes

HttpCode Error code Error message Description
404 InvalidDBInstance.NotFound The specified instance does not exist or is not supported. The error message returned because the instance does not exist or does not support this operation.

For a list of error codes, visit the API Error Center.