Getting StartedExamplesImagesInstancesSSH KeysList SSH keysExamples (cURL)Security GroupsSnapshotsVolumes

SSH Keys

Genesis Cloud allows you to add SSH public keys to the interface so that you can embed your public key into an instance at the time of creation.

List SSH keys

To list all of the keys in your account, send a GET request to /compute/v1/ssh-keys.

The response will be a JSON object with a key set to ssh_keys. The value of this will be an array of key objects, each containing the standard key attributes.

GET /compute/v1/ssh-keys (HTTP 200 - OK)

Query parameters

  • per_page Integer Optional - A positive integer lower than or equal to 100 to select the number of items to return (default: 50).
  • page Integer Optional - A positive integer to choose the page to return.

Response body

The response will be a JSON object with pagination details and a key called ssh_keys. This will be set to an array of ssh key objects, each of which will contain the standard ssh key attributes:

  • id String - A unique identifier that can be used to reference a specific image.
  • name String - The display name that has been given to an image. This is what is shown in the control panel and is generally a descriptive title for the image in question.
  • public_key String - SSH public key.
  • created_at String - A time value given in ISO8601 combined date and time format that represents when the image was created.
{
"ssh_keys": [
{
"id": "string",
"name": "string",
"public_key": "string",
"created_at": "2020-03-20T18:06:32.767Z"
}
],
"total_count": 1,
"page": 1,
"per_page": 10
}

Examples (cURL)

curl -H 'X-Auth-Token: <TOKEN>' -H 'Content-Type: application/json' \
'https://api.genesiscloud.com/compute/v1/ssh-keys?page=1&per_page=10'