Key Pairs · Compute API Reference · Quake AI

Antelope 2023.1

GET/os-keypairs

List key pairs

Returns a list of SSH key pairs owned by the current user.

Parameters

Name	In	Type	Description
X-OpenStack-Nova-Microversion	header	`string`	Request a specific Nova microversion. Defaults to 2.1. Maximum supported on Rumble Cloud: 2.95. Example: `2.95`

Responses

200List of key pairs

keypairs array[object]

401Unauthorized

curl -X GET "https://nova.YOUR_REGION.rumble.cloud/v2.1/YOUR_PROJECT_ID/os-keypairs" \
  -H "X-Auth-Token: $TOKEN" \
  -H "X-OpenStack-Nova-Microversion: YOUR_X-OPENSTACK-NOVA-MICROVERSION"

POST/os-keypairs

Create or import key pair

Creates a new key pair or imports an existing public key. If `public_key` is omitted, Nova generates an RSA key pair and returns the **private key in the response** — this is the only time the private key is accessible. Store it immediately.

Parameters

Name	In	Type	Description
X-OpenStack-Nova-Microversion	header	`string`	Request a specific Nova microversion. Defaults to 2.1. Maximum supported on Rumble Cloud: 2.95. Example: `2.95`

Request Bodyrequired

application/json

keypair* object

Responses

200Key pair created. If Nova generated the key, `private_key` is present in the response and is not stored — save it immediately.

keypair allOf

400Bad request — name already exists or invalid key format

401Unauthorized

curl -X POST "https://nova.YOUR_REGION.rumble.cloud/v2.1/YOUR_PROJECT_ID/os-keypairs" \
  -H "X-Auth-Token: $TOKEN" \
  -H "X-OpenStack-Nova-Microversion: YOUR_X-OPENSTACK-NOVA-MICROVERSION" \
  -H "Content-Type: application/json" \
  -d '{
  "keypair": {}
}'

GET/os-keypairs/{keypair_name}

Show key pair

Returns details for a specific key pair.

Parameters

Name	In	Type	Description
keypair_name*	path	`string`	The name of the key pair
X-OpenStack-Nova-Microversion	header	`string`	Request a specific Nova microversion. Defaults to 2.1. Maximum supported on Rumble Cloud: 2.95. Example: `2.95`

Responses

200Key pair detail

keypair object An SSH key pair

401Unauthorized

404Key pair not found

curl -X GET "https://nova.YOUR_REGION.rumble.cloud/v2.1/YOUR_PROJECT_ID/os-keypairs/YOUR_KEYPAIR_NAME" \
  -H "X-Auth-Token: $TOKEN" \
  -H "X-OpenStack-Nova-Microversion: YOUR_X-OPENSTACK-NOVA-MICROVERSION"

DELETE/os-keypairs/{keypair_name}

Delete key pair

Deletes a key pair. Existing servers using this key pair are unaffected.

Parameters

Name	In	Type	Description
keypair_name*	path	`string`	The name of the key pair
X-OpenStack-Nova-Microversion	header	`string`	Request a specific Nova microversion. Defaults to 2.1. Maximum supported on Rumble Cloud: 2.95. Example: `2.95`

Responses

204Key pair deleted (no content)

401Unauthorized

404Key pair not found

curl -X DELETE "https://nova.YOUR_REGION.rumble.cloud/v2.1/YOUR_PROJECT_ID/os-keypairs/YOUR_KEYPAIR_NAME" \
  -H "X-Auth-Token: $TOKEN" \
  -H "X-OpenStack-Nova-Microversion: YOUR_X-OPENSTACK-NOVA-MICROVERSION"