Help Center/ Bare Metal Server/ API Reference/ BMS APIs/ BMS Password Management/ Deleting the Password of a Windows BMS
Updated on 2024-10-22 GMT+08:00

Deleting the Password of a Windows BMS

Function

This API is used to delete the random password generated during initial Windows BMS installation. After the password is deleted, you can still use your password to log in to your BMS. However, you cannot use the Get Password function to recover the BMS initial password.

If the BMS is created from a private image, ensure that Cloudbase-Init has been installed. Cloudbase-Init is installed on public images by default.

URI

DELETE /v1/{project_id}/baremetalservers/{server_id}/os-server-password

Table 1 lists the parameters.

Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

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

server_id

Yes

Specifies the BMS ID.

You can obtain the BMS ID from the BMS console or by calling the Querying BMSs (Discarded).

Request Parameters

None

Example Request

Deleting the password of a BMS (ID: cf2a8b97-b5c6-47ef-9714-eb27adf26e5b)
1
DELETE https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/os-server-password

Response

N/A

Returned Values

Normal values

Returned Value

Description

202

The request has been accepted, but the processing has been delayed.

For details about other returned values, see Status Codes.

Error Codes

See Error Codes.