github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/aws/d/iam_server_certificate.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_iam_server_certificate"
     4  sidebar_current: "docs-aws-iam-server-certificate"
     5  description: |-
     6    Get information about a server certificate
     7  ---
     8  
     9  # aws\_iam\_server\_certificate
    10  
    11  Use this data source to lookup information about IAM Server Certificates.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  data "aws_iam_server_certificate" "my-domain" {
    17    name_prefix = "my-domain.org"
    18    latest      = true
    19  }
    20  
    21  resource "aws_elb" "elb" {
    22    name = "my-domain-elb"
    23  
    24    listener {
    25      instance_port      = 8000
    26      instance_protocol  = "https"
    27      lb_port            = 443
    28      lb_protocol        = "https"
    29      ssl_certificate_id = "${data.aws_iam_server_certificate.my-domain.arn}"
    30    }
    31  }
    32  ```
    33  
    34  ## Argument Reference
    35  
    36  * `name_prefix` - prefix of cert to filter by
    37  * `name` - exact name of the cert to lookup
    38  * `latest` - sort results by expiration date. returns the certificate with expiration date in furthest in the future.
    39  
    40  ## Attributes Reference
    41  
    42  `arn` is set to the ARN of the IAM Server Certificate
    43  `path` is set to the path of the IAM Server Certificate
    44  `expiration_date` is set to the expiration date of the IAM Server Certificate
    45  
    46  ## Import 
    47  
    48  The terraform import function will read in certificate body, certificate chain (if it exists), id, name, path, and arn. 
    49  It will not retrieve the private key which is not available through the AWS API.   
    50  
    51