Updated on 2024-04-16 GMT+08:00

Obtaining the Password for Logging In to an ECS

Function

This API is used to obtain the random password generated during initial Windows ECS installation for user Administrator or the configured Cloudbase-init user when you use an image that supports Cloudbase-Init to create a Windows ECS.

After starting an ECS, wait for 5 to 10 minutes and ensure that the password is injected. Then, you can use this API to query the password.

Linux ECSs do not use this API to obtain a password.

URI

GET /v2.1/{project_id}/servers/{server_id}/os-server-password

Table 1 describes the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

For details about how to obtain the ID, see Obtaining a Project ID.

server_id

Yes

Specifies the ECS ID.

Request

None

Response

Table 2 describes the response parameters.
Table 2 Response parameters

Parameter

Type

Description

password

String

Specifies the password in ciphertext.

Example Request

Obtain a random password of the administrator account (administrator or the account configured in Cloudbase-Init) generated by the system during the initial installation of a specified Windows ECS.

GET https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-server-password

Example Response

{
    "password": "UHC9+YW1xDC1Yu8Mg*************************"
}