Improve documentation to show ebs.snapshot_id support (ansible-collections#854)

ec2_instance: Add example to spin up instance with a attached volume from a snapshot

SUMMARY

Fixes ansible-collections#803
Add example to spin up new instance with an attached volume from a snapshot

ISSUE TYPE


Docs Pull Request

COMPONENT NAME

ec2_instance

Reviewed-by: Jill R <None>

Author: mandar242

plugins/modules/ec2_instance.py

@@ -206,7 +206,7 @@
     description:
     - A list of block device mappings, by default this will always use the AMI root device so the volumes option is primarily for adding more storage.
     - A mapping contains the (optional) keys device_name, virtual_name, ebs.volume_type, ebs.volume_size, ebs.kms_key_id,
-      ebs.iops, and ebs.delete_on_termination.
+      ebs.snapshot_id, ebs.iops, and ebs.delete_on_termination.
     - For more information about each parameter, see U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_BlockDeviceMapping.html).
     type: list
     elements: dict
@@ -396,6 +396,17 @@
           volume_size: 16
           delete_on_termination: true
 
+- name: start an instance and Add EBS volume from a snapshot
+  amazon.aws.ec2_instance:
+    name: "public-withebs-instance"
+    instance_type: t2.micro
+    image_id: ami-1234567890
+    vpc_subnet_id: subnet-5ca1ab1e
+    volumes:
+      - device_name: /dev/sda2
+        ebs:
+          snapshot_id: snap-1234567890
+
 - name: start an instance with a cpu_options
   amazon.aws.ec2_instance:
     name: "public-cpuoption-instance"