Renew VM Certificate

Create a new certificate for an existing Cloud VM. This method may be used to issue a new certificate for a Cloud VM whose certificate is about to expire.

Request

Method	URI
POST	`v5/cvms/cvmid/renew/` where `cvmid` is the VM id retrieved from the Cloud VM Set Details method. (For example: `213f965193f911e3b4ed080027cbdf2a`.)

Privileges Required

Any valid KeyControl user account that has CLOUD_ADMIN privileges for the Cloud VM Set with which the VM is associated.

Parameters

Name	Type	Example
passphrase	string	thisisasamplepassphrase Optional passphrase for the certificate.
expiration	string	12/05/2019

Name

Type

Example

passphrase

string

thisisasamplepassphrase

Optional passphrase for the certificate.

expiration

string

12/05/2019

Response

Name	Type	Example
result	string	success
certificate	string	/v5/certificates/87be8aed-8f7e-11e8-b660-0050568521f6/ The path to the certificate.
cvmid	string	87be8aed-8f7e-11e8-b660-0050568521f6 The VM's ID.

Name

Type

Example

result

string

success

certificate

string

/v5/certificates/87be8aed-8f7e-11e8-b660-0050568521f6/

The path to the certificate.

cvmid

string

87be8aed-8f7e-11e8-b660-0050568521f6

The VM's ID.

Errors

Reason	Example
Invalid Cloud VM ID	Cloud VM not found