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

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_ssm_activation"
     4  sidebar_current: "docs-aws-resource-ssm-activation"
     5  description: |-
     6    Registers an on-premises server or virtual machine with Amazon EC2 so that it can be managed using Run Command.
     7  ---
     8  
     9  # aws\_ssm\_activation
    10  
    11  Registers an on-premises server or virtual machine with Amazon EC2 so that it can be managed using Run Command.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "aws_iam_role" "test_role" {
    17    name = "test_role"
    18  
    19    assume_role_policy = <<EOF
    20    {
    21      "Version": "2012-10-17",
    22      "Statement": {
    23        "Effect": "Allow",
    24        "Principal": {"Service": "ssm.amazonaws.com"},
    25        "Action": "sts:AssumeRole"
    26      }
    27    }
    28  EOF
    29  }
    30  
    31  resource "aws_iam_role_policy_attachment" "test_attach" {
    32    role       = "${aws_iam_role.test_role.name}"
    33    policy_arn = "arn:aws:iam::aws:policy/service-role/AmazonEC2RoleforSSM"
    34  }
    35  
    36  resource "aws_ssm_activation" "foo" {
    37    name               = "test_ssm_activation"
    38    description        = "Test"
    39    iam_role           = "${aws_iam_role.test_role.id}"
    40    registration_limit = "5"
    41    depends_on         = ["aws_iam_role_policy_attachment.test_attach"]
    42  }
    43  ```
    44  
    45  ## Argument Reference
    46  
    47  The following arguments are supported:
    48  
    49  * `name` - (Optional) The default name of the registerd managed instance.
    50  * `description` - (Optional) The description of the resource that you want to register.
    51  * `expiration_date` - (Optional) The date by which this activation request should expire. The default value is 24 hours.
    52  * `iam_role` - (Required) The IAM Role to attach to the managed instance.
    53  * `registration_limit` - (Optional) The maximum number of managed instances you want to register. The default value is 1 instance.
    54  
    55  ## Attributes Reference
    56  
    57  The following attributes are exported:
    58  
    59  * `name` - The default name of the registerd managed instance.
    60  * `description` - The description of the resource that was registered.
    61  * `expired` - If the current activation has expired.
    62  * `expiration_date` - The date by which this activation request should expire. The default value is 24 hours.
    63  * `iam_role` - The IAM Role attached to the managed instance.
    64  * `registration_limit` - The maximum number of managed instances you want to be registered. The default value is 1 instance.
    65  * `registration_count` - The number of managed instances that are currently registered using this activation.