Create VM Certificate

On successful completion of the request, the newly created VM certificate for the Cloud VM Set can be downloaded from the URI provided in the response. hcl requires the name of the certificate file to be in the format: <cvmid>_<timestamp>.bin, where <cvmid> is provided in the response and <timestamp> is an integer corresponding to a locally computed Unix timestamp (seconds since epoch).

Request

Method

URI

POST

v5/cvmsets/cvmsetid/ where cvmsetid is the Cloud VM Set id retrieved from the List Cloud VM Sets method. (For example: 78a7e865947a11e3b4ed080027cbdf2a.)

Privileges Required

A valid KeyControl user account with CLOUD_ADMIN privileges can create a certificate for any Cloud VM Set as long as the set belongs to a Cloud Admin group in which the account is a member.

Parameters

Name

Type

Example

passphrase

string

 
thisisasamplepassphrase

Optional passphrase for the certificate.

expiration

string

 
12/05/2019

Response

Name

Type

Example

certificate

string

 
/v5/certificates/c2593/

cvmid

string

 
c2593

result

string

 
success

Errors

Reason

Example

Invalid Cloud VM Set ID

 
Cloud VM Set not found

Invalid expiration

 
Please enter a valid expiration date