opentf/website/source/docs/providers/openstack/r/compute_instance.html.markdown

layout, page_title, sidebar_current, description

layout	page_title	sidebar_current	description
openstack	OpenStack: openstack_compute_instance	docs-openstack-resource-compute-instance	Manages a VM instance resource within OpenStack.

openstack_compute_instance

Manages a VM instance resource within OpenStack.

Example Usage

resource "openstack_compute_instance" "test-server" {
  name = "tf-test"
  image_ref = "ad091b52-742f-469e-8f3c-fd81cadf0743"
  flavor_ref = "3"
  metadata {
    this = "that"
  }
  key_pair = "my_key_pair_name"
  security_groups = ["test-group-1"]
}

Argument Reference

The following arguments are supported:

• name - (Required) A unique name for the resource.

• image_ref - (Required) The image reference (ID) for the desired image for the server. Changing this creates a new server.

• flavor_ref - (Required) The flavor reference (ID) for the desired flavor for the server. Changing this resizes the existing server.

• security_groups - (Optional) An array of one or more security group names to associate with the server. Changing this results in adding/removing security groups from the existing server.

• availability_zone - (Optional) The availability zone in which to create the server. Changing this creates a new server.

• networks - (Optional) An array of one or more networks to attach to the instance. The network object structure is documented below.

• metadata - (Optional) Metadata key/value pairs to make available from within the instance. Changing this updates the existing server metadata.

• admin_pass - (Optional) The administrative password to assign to the server. Changing this changes the root password on the existing server.

• key_pair - (Optional) The name of a key pair to put on the server. The key pair must already be created and associated with the tenant's account. Changing this creates a new server.

The network block supports:

• uuid - (Required unless port is provided) The network UUID to attach to the server.

• port - (Required unless uuid is provided) The port UUID of a network to attach to the server.

• fixed_ip - (Optional) Specifies a fixed IP address to be used on this network.

Attributes Reference

The following attributes are exported:

• name - See Argument Reference above.
• access_ip_v4 - See Argument Reference above.
• access_ip_v6 - See Argument Reference above.
• metadata - See Argument Reference above.
• security_groups - See Argument Reference above.
• flavor_ref - See Argument Reference above.