github.com/hobbeswalsh/terraform@v0.3.7-0.20150619183303-ad17cf55a0fa/website/source/docs/providers/cloudstack/r/ssh_keypair.html.markdown (about)

     1  ---
     2  layout: "cloudstack"
     3  page_title: "CloudStack: cloudstack_ssh_keypair"
     4  sidebar_current: "docs-cloudstack-resource-ssh-keypair"
     5  description: |-
     6    Creates or registers an SSH key pair.
     7  ---
     8  
     9  # cloudstack\_ssh\_keypair
    10  
    11  Creates or registers an SSH key pair.
    12  
    13  ## Example Usage
    14  
    15  ```
    16  resource "cloudstack_ssh_keypair" "default" {
    17    name = "myKey"
    18  }
    19  ```
    20  
    21  ## Argument Reference
    22  
    23  The following arguments are supported:
    24  
    25  * `name` - (Required) The name of the SSH key pair. This is a unique value
    26      within a CloudStack account. Changing this forces a new resource to be
    27      created.
    28  
    29  * `public_key` - (Optional) The path to a public key that will be uploaded
    30      the remote machine. If this is omitted, CloudStack will generate a new
    31      key pair. Changing this forces a new resource to be created.
    32  
    33  ## Attributes Reference
    34  
    35  The following attributes are exported:
    36  
    37  * `id` - The key pair ID.
    38  * `fingerprint` - The fingerprint of the public key specified or created.
    39  * `private_key` - The private key generated by CloudStack. Only available
    40      if CloudStack generated the key pair.