POST
/
kvm
/
v2
/
upload_qcow2
curl --request POST \
  --url https://{api_host}.edisglobal.com/kvm/v2/upload_qcow2 \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data signature=session_signature_12345 \
  --data kvm_id=kvm_xxxxx_yyyyy \
  --data valid_until=2025-01-12T15:30:00Z \
  --data yes_purge_all_my_data=1 \
  --data pw=new-root-password \
  --data 'cloudinit_user_data=#cloud-config
user: root
password: "new-root-password"
ssh_pwauth: True
'
{
  "status": "success"
}

Body

application/x-www-form-urlencoded
Required parameters to upload and replace the qcow2 image. All parameters must be passed in the request body as `application/x-www-form-urlencoded` or as file upload where specified.
​
signature
string

The session signature obtained from the "Create AUTH-session" call.

Example:

"session_signature_12345"

​
kvm_id
string

The unique identifier of the KVM VPS where the qcow2 image will be replaced.
This value is specific to your VPS.

Example:

"kvm_xxxxx_yyyyy"

​
valid_until
string

The expiration timestamp for the session, as obtained from the "Create AUTH-session" call.
Ensure that the session is valid and has not expired.

Example:

"2025-01-12T15:30:00Z"

​
yes_purge_all_my_data
integer

Confirmation to purge all data on the VPS.
This parameter must be set to 1 to proceed.

Example:

1

​
file
file

The qcow2 file to upload.
Provide the full path to the file.

​
pw
string

The new root password for the VPS.
Used if cloud-init is enabled.

Example:

"new-root-password"

​
cloudinit_user_data
string

Optional cloud-init configuration for the VPS.
See Cloud-init Documentation for examples.

Example:

"#cloud-config\nuser: root\npassword: \"new-root-password\"\nssh_pwauth: True\n"

Response

200
application/json
The qcow2 image was successfully uploaded and replaced on the VPS.
​
status
string

The status of the operation.

Example:

"success"

Was this page helpful?