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

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_dms_certificate"
     4  sidebar_current: "docs-aws-resource-dms-certificate"
     5  description: |-
     6    Provides a DMS (Data Migration Service) certificate resource.
     7  ---
     8  
     9  # aws\_dms\_certificate
    10  
    11  Provides a DMS (Data Migration Service) certificate resource. DMS certificates can be created, deleted, and imported.
    12  
    13  ~> **Note:** All arguments including the PEM encoded certificate will be stored in the raw state as plain-text.
    14  [Read more about sensitive data in state](/docs/state/sensitive-data.html).
    15  
    16  ## Example Usage
    17  
    18  ```hcl
    19  # Create a new certificate
    20  resource "aws_dms_certificate" "test" {
    21    certificate_id  = "test-dms-certificate-tf"
    22    certificate_pem = "..."
    23  }
    24  ```
    25  
    26  ## Argument Reference
    27  
    28  The following arguments are supported:
    29  
    30  * `certificate_id` - (Required) The certificate identifier.
    31  
    32      - Must contain from 1 to 255 alphanumeric characters and hyphens.
    33  
    34  * `certificate_pem` - (Optional) The contents of the .pem X.509 certificate file for the certificate. Either `certificate_pem` or `certificate_wallet` must be set.
    35  * `certificate_wallet` - (Optional) The contents of the Oracle Wallet certificate for use with SSL. Either `certificate_pem` or `certificate_wallet` must be set.
    36  
    37  ## Attributes Reference
    38  
    39  The following attributes are exported:
    40  
    41  * `certificate_arn` - The Amazon Resource Name (ARN) for the certificate.
    42  
    43  ## Import
    44  
    45  Certificates can be imported using the `certificate_arn`, e.g.
    46  
    47  ```
    48  $ terraform import aws_dms_certificate.test arn:aws:dms:us-west-2:123456789:cert:xxxxxxxxxx
    49  ```