terraform/website/source/docs/providers/aws/r/ssm_association.html.markdown

layout	page_title	sidebar_current	description
aws	AWS: aws_ssm_association	docs-aws-resource-ssm-association	Assosciates an SSM Document to an instance.

aws_ssm_association

Assosciates an SSM Document to an instance.

Example Usage

resource "aws_security_group" "tf_test_foo" {
  name        = "tf_test_foo"
  description = "foo"

  ingress {
    protocol    = "icmp"
    from_port   = -1
    to_port     = -1
    cidr_blocks = ["0.0.0.0/0"]
  }
}

resource "aws_instance" "foo" {
  # eu-west-1
  ami               = "ami-f77ac884"
  availability_zone = "eu-west-1a"
  instance_type     = "t2.small"
  security_groups   = ["${aws_security_group.tf_test_foo.name}"]
}

resource "aws_ssm_document" "foo_document" {
  name = "test_document_association-%s"

  content = <<DOC
  {
    "schemaVersion": "1.2",
    "description": "Check ip configuration of a Linux instance.",
    "parameters": {

    },
    "runtimeConfig": {
      "aws:runShellScript": {
        "properties": [
          {
            "id": "0.aws:runShellScript",
            "runCommand": ["ifconfig"]
          }
        ]
      }
    }
  }
DOC
}

resource "aws_ssm_association" "foo" {
  name        = "test_document_association-%s"
  instance_id = "${aws_instance.foo.id}"
}

Argument Reference

The following arguments are supported:

• name - (Required) The name of the SSM document to apply.
• instance_id - (Optional) The instance id to apply an SSM document to.
• parameters - (Optional) Additional parameters to pass to the SSM document.
• targets - (Optional) The targets (either instances or tags). Instances are specified using Key=instanceids,Values=instanceid1,instanceid2. Tags are specified using Key=tag name,Values=tag value. Only 1 target is currently supported by AWS.

Attributes Reference

The following attributes are exported:

• name - The name of the SSM document to apply.
• instance_ids - The instance id that the SSM document was applied to.
• parameters - Additional parameters passed to the SSM document.