Skip to main content
openstack_compute_keypair_v2
Last update:

openstack_compute_keypair_v2

For your information

This instruction is an adapted copy of the official OpenStack Terraform provider documentation in the Terraform Registry.

The private key generated by this resource will be stored unencrypted in your Terraform state file. Use of this resource for production deployments is not recommended. Instead, generate a private key file outside of Terraform and distribute it securely to the system where Terraform will be run.

Example Usage⁠

Import an Existing Public Key⁠

resource "openstack_compute_keypair_v2" "test-keypair" {
  name       = "my-keypair"
  public_key = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQCfeXP/9p4ffqe+yfGOP4a53nFdAkkJj0sFUg8z1KxLonuhF2hBRI5hWZFa7af40ShJGNaRD1IJUMtpUSltyUwLYNsBSPpnrJ56YhCZFu5X+GPgGmzegR1T7m7MlL6zjsrLdVRaVyj944CWjEOL0iF0Is3VmgdYQxkb77GXGSwsd6rr8s1LZwayuyM+bPqbi2e91aODMGre6uTI/4D6u2p9upwwEPs80bMOVFk8T3foRGE0euYWbUqgi1zV/yzBoOSUJ6OxI+CMlR7k2jzl0Ld1ZlUNoIutrLhMmRtBWHlHSZfPSWlv7xtcWqD8pe8JVi5acrHFLV4hSqtLm6/m+hscKKtEMZikM3rEaO1qMTuXdj2eyxk/tY83KEk4RnS656w/y6JuZ35Uhu2/3diKfuNEUe7GQeYxSCVmFShoOtjuSnoDG67PKHbmw0buC5CZ7A2e6GyvktmYMqmSPXGR6gv1hL5F9WKoQZaSsOuzgFnBG1dLJ9a2AD4mCjfIy4+HbHk="
}

Generate a Public/Private Key Pair⁠

resource "openstack_compute_keypair_v2" "test-keypair" {
  name = "my-keypair"
}

Argument Reference⁠

The following arguments are supported:

  • region — (Optional) The region in which to obtain the V2 Compute client. Keypairs are associated with accounts, but a Compute client is needed to create one. If omitted, the region argument of the provider is used. Changing this creates a new keypair.

  • name — (Required) A unique name for the keypair. Changing this creates a new keypair.

  • public_key — (Optional) A pregenerated OpenSSH-formatted public key. Changing this creates a new keypair. If a public key is not specified, then a public/private key pair will be automatically generated. If a pair is created, then destroying this resource means you will lose access to that keypair forever.

  • user_id — (Optional) This allows administrative users to operate key-pairs of specified user ID. For this feature you need to have openstack microversion 2.10 (Liberty) or later.

  • value_specs — (Optional) Map of additional options.

Attributes Reference⁠

The following attributes are exported:

  • region — See Argument Reference above.
  • name — See Argument Reference above.
  • public_key — See Argument Reference above.
  • fingerprint — The fingerprint of the public key.
  • private_key — The generated private key when no public key is specified.

Import⁠

Keypairs can be imported using the name, e.g.

$ terraform import openstack_compute_keypair_v2.my-keypair test-keypair