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 - (Required) The instance id to apply an SSM document to.
• parameters - (Optional) Additional parameters to pass to the SSM document.

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.