github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/aws/d/acm_certificate.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_acm_certificate"
     4  sidebar_current: "docs-aws-datasource-acm-certificate"
     5  description: |-
     6    Get information on a Amazon Certificate Manager (ACM) Certificate
     7  ---
     8  
     9  # aws\_acm\_certificate
    10  
    11  Use this data source to get the ARN of a certificate in AWS Certificate
    12  Manager (ACM). The process of requesting and verifying a certificate in ACM
    13  requires some manual steps, which means that Terraform cannot automate the
    14  creation of ACM certificates. But using this data source, you can reference
    15  them by domain without having to hard code the ARNs as input.
    16  
    17  ## Example Usage
    18  
    19  ```hcl
    20  data "aws_acm_certificate" "example" {
    21    domain   = "tf.example.com"
    22    statuses = ["ISSUED"]
    23  }
    24  ```
    25  
    26  ## Argument Reference
    27  
    28   * `domain` - (Required) The domain of the certificate to look up. If no certificate is found with this name, an error will be returned.
    29   * `statuses` - (Optional) A list of statuses on which to filter the returned list. Valid values are `PENDING_VALIDATION`, `ISSUED`,
    30     `INACTIVE`, `EXPIRED`, `VALIDATION_TIMED_OUT`, `REVOKED` and `FAILED`. If no value is specified, only certificates in the `ISSUED` state
    31     are returned.
    32  
    33  ## Attributes Reference
    34  
    35   * `arn` - Set to the ARN of the found certificate, suitable for referencing in other resources that support ACM certificates.