aws-sdk-ec2 1.36.0 → 1.37.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 350bd1c350a006abe7235d62c5a412f5f029825f
-  data.tar.gz: b3aa25788a96aea0485a05bf8245a4dd099c100b
+  metadata.gz: 5bc1054d7de2e127ff2a659ece66ee3e8032f18b
+  data.tar.gz: bc047ad8017d23cd971731fcabc52eff36a9ea77
 SHA512:
-  metadata.gz: 5d18006622677d4b9ce0adda2ce4dda8e9ecaf19a55f8b9120349b2d7888320a46cde6953daa5f839debb71c41c2a1fe0333ddb491eca0ef0ff3586e86986df6
-  data.tar.gz: 4df48da8b4a4f0ca895cf2a3e3cd71147d814562e897f95f35ac6a6f32c4165109fe63b3bbcaaf19a9e0d358c9919b3bf620bde17f1336705e5f87fcaa34ca56
+  metadata.gz: f1ea6d9e7b149b3edbda599b7f4335e56d0822e1c3780faa2089286d90b730c4c8a149d520ea5417fce4ee8e7a5513d41c42d932235f9283da2101dbeb5f940f
+  data.tar.gz: 460306f8fe1a92b7ff3f48305f6e6f25554354d9288f6b660b585b642504f0c51be57ff8fdd37a6cf7e1e68cb73312dfe7c01c32f3e66c01b477b41287c6a758

data/lib/aws-sdk-ec2.rb

@@ -65,6 +65,6 @@ require_relative 'aws-sdk-ec2/customizations'
 # @service
 module Aws::EC2
 
-  GEM_VERSION = '1.36.0'
+  GEM_VERSION = '1.37.0'
 
 end

data/lib/aws-sdk-ec2/client.rb

@@ -412,9 +412,9 @@ module Aws::EC2
       req.send_request(options)
     end
 
-    # Allocates a Dedicated Host to your account. At minimum you need to
-    # specify the instance size type, Availability Zone, and quantity of
-    # hosts you want to allocate.
+    # Allocates a Dedicated Host to your account. At a minimum, specify the
+    # instance size type, Availability Zone, and quantity of hosts to
+    # allocate.
     #
     # @option params [String] :auto_placement
     #   This is enabled by default. This property allows instances to be
@@ -427,22 +427,22 @@ module Aws::EC2
     #   The Availability Zone for the Dedicated Hosts.
     #
     # @option params [String] :client_token
-    #   Unique, case-sensitive identifier you provide to ensure idempotency of
-    #   the request. For more information, see [How to Ensure Idempotency][1]
-    #   in the *Amazon Elastic Compute Cloud User Guide*.
+    #   Unique, case-sensitive identifier that you provide to ensure the
+    #   idempotency of the request. For more information, see [How to Ensure
+    #   Idempotency][1] in the *Amazon Elastic Compute Cloud User Guide*.
     #
     #
     #
     #   [1]: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Run_Instance_Idempotency.html
     #
     # @option params [required, String] :instance_type
-    #   Specify the instance type that you want your Dedicated Hosts to be
-    #   configured for. When you specify the instance type, that is the only
-    #   instance type that you can launch onto that host.
+    #   Specify the instance type for which to configure your Dedicated Hosts.
+    #   When you specify the instance type, that is the only instance type
+    #   that you can launch onto that host.
     #
     # @option params [required, Integer] :quantity
-    #   The number of Dedicated Hosts you want to allocate to your account
-    #   with these parameters.
+    #   The number of Dedicated Hosts to allocate to your account with these
+    #   parameters.
     #
     # @return [Types::AllocateHostsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -828,6 +828,31 @@ module Aws::EC2
     #
     #   * {Types::AssociateIamInstanceProfileResult#iam_instance_profile_association #iam_instance_profile_association} => Types::IamInstanceProfileAssociation
     #
+    #
+    # @example Example: To associate an IAM instance profile with an instance
+    #
+    #   # This example associates an IAM instance profile named admin-role with the specified instance.
+    #
+    #   resp = client.associate_iam_instance_profile({
+    #     iam_instance_profile: {
+    #       name: "admin-role", 
+    #     }, 
+    #     instance_id: "i-123456789abcde123", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     iam_instance_profile_association: {
+    #       association_id: "iip-assoc-0e7736511a163c209", 
+    #       iam_instance_profile: {
+    #         arn: "arn:aws:iam::123456789012:instance-profile/admin-role", 
+    #         id: "AIPAJBLK7RKJKWDXVHIEC", 
+    #       }, 
+    #       instance_id: "i-123456789abcde123", 
+    #       state: "associating", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.associate_iam_instance_profile({
@@ -1212,9 +1237,6 @@ module Aws::EC2
     #   the product. For example, you can't detach a volume from a Windows
     #   instance and attach it to a Linux instance.
     #
-    # For an overview of the AWS Marketplace, see [Introducing AWS
-    # Marketplace][4].
-    #
     # For more information about EBS volumes, see [Attaching Amazon EBS
     # Volumes][2] in the *Amazon Elastic Compute Cloud User Guide*.
     #
@@ -1223,7 +1245,6 @@ module Aws::EC2
     # [1]: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html
     # [2]: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-attaching-volume.html
     # [3]: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html
-    # [4]: https://aws.amazon.com/marketplace/help/200900000
     #
     # @option params [required, String] :device
     #   The device name (for example, `/dev/sdh` or `xvdh`).
@@ -1406,6 +1427,55 @@ module Aws::EC2
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To add a rule that allows outbound traffic to a specific address range
+    #
+    #   # This example adds a rule that grants access to the specified address ranges on TCP port 80.
+    #
+    #   resp = client.authorize_security_group_egress({
+    #     group_id: "sg-1a2b3c4d", 
+    #     ip_permissions: [
+    #       {
+    #         from_port: 80, 
+    #         ip_protocol: "tcp", 
+    #         ip_ranges: [
+    #           {
+    #             cidr_ip: "10.0.0.0/16", 
+    #           }, 
+    #         ], 
+    #         to_port: 80, 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Example: To add a rule that allows outbound traffic to a specific security group
+    #
+    #   # This example adds a rule that grants access to the specified security group on TCP port 80.
+    #
+    #   resp = client.authorize_security_group_egress({
+    #     group_id: "sg-1a2b3c4d", 
+    #     ip_permissions: [
+    #       {
+    #         from_port: 80, 
+    #         ip_protocol: "tcp", 
+    #         to_port: 80, 
+    #         user_id_group_pairs: [
+    #           {
+    #             group_id: "sg-4b51a32f", 
+    #           }, 
+    #         ], 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.authorize_security_group_egress({
@@ -1558,6 +1628,86 @@ module Aws::EC2
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To add a rule that allows inbound SSH traffic from an IPv4 address range
+    #
+    #   # This example enables inbound traffic on TCP port 22 (SSH). The rule includes a description to help you identify it
+    #   # later.
+    #
+    #   resp = client.authorize_security_group_ingress({
+    #     group_id: "sg-903004f8", 
+    #     ip_permissions: [
+    #       {
+    #         from_port: 22, 
+    #         ip_protocol: "tcp", 
+    #         ip_ranges: [
+    #           {
+    #             cidr_ip: "203.0.113.0/24", 
+    #             description: "SSH access from the LA office", 
+    #           }, 
+    #         ], 
+    #         to_port: 22, 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Example: To add a rule that allows inbound HTTP traffic from another security group
+    #
+    #   # This example enables inbound traffic on TCP port 80 from the specified security group. The group must be in the same VPC
+    #   # or a peer VPC. Incoming traffic is allowed based on the private IP addresses of instances that are associated with the
+    #   # specified security group.
+    #
+    #   resp = client.authorize_security_group_ingress({
+    #     group_id: "sg-111aaa22", 
+    #     ip_permissions: [
+    #       {
+    #         from_port: 80, 
+    #         ip_protocol: "tcp", 
+    #         to_port: 80, 
+    #         user_id_group_pairs: [
+    #           {
+    #             description: "HTTP access from other instances", 
+    #             group_id: "sg-1a2b3c4d", 
+    #           }, 
+    #         ], 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Example: To add a rule that allows inbound RDP traffic from an IPv6 address range
+    #
+    #   # This example adds an inbound rule that allows RDP traffic from the specified IPv6 address range. The rule includes a
+    #   # description to help you identify it later.
+    #
+    #   resp = client.authorize_security_group_ingress({
+    #     group_id: "sg-123abc12 ", 
+    #     ip_permissions: [
+    #       {
+    #         from_port: 3389, 
+    #         ip_protocol: "tcp", 
+    #         ipv_6_ranges: [
+    #           {
+    #             cidr_ipv_6: "2001:db8:1234:1a00::/64", 
+    #             description: "RDP access from the NY office", 
+    #           }, 
+    #         ], 
+    #         to_port: 3389, 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.authorize_security_group_ingress({
@@ -2278,6 +2428,23 @@ module Aws::EC2
     #
     #   * {Types::CopyImageResult#image_id #image_id} => String
     #
+    #
+    # @example Example: To copy an AMI to another region
+    #
+    #   # This example copies the specified AMI from the us-east-1 region to the current region.
+    #
+    #   resp = client.copy_image({
+    #     description: "", 
+    #     name: "My server", 
+    #     source_image_id: "ami-5731123e", 
+    #     source_region: "us-east-1", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     image_id: "ami-438bea42", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.copy_image({
@@ -2992,7 +3159,16 @@ module Aws::EC2
     #   Indicates whether EC2 Fleet should replace unhealthy instances.
     #
     # @option params [Array<Types::TagSpecification>] :tag_specifications
-    #   The tags for an EC2 Fleet resource.
+    #   The key-value pair for tagging the EC2 Fleet request on creation. The
+    #   value for `ResourceType` must be `fleet`, otherwise the fleet request
+    #   fails. To tag instances at launch, specify the tags in the [launch
+    #   template][1]. For information about tagging after launch, see [Tagging
+    #   Your Resources][2].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html#create-launch-template
+    #   [2]: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-resources
     #
     # @return [Types::CreateFleetResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3273,6 +3449,36 @@ module Aws::EC2
     #
     #   * {Types::CreateImageResult#image_id #image_id} => String
     #
+    #
+    # @example Example: To create an AMI from an Amazon EBS-backed instance
+    #
+    #   # This example creates an AMI from the specified instance and adds an EBS volume with the device name /dev/sdh and an
+    #   # instance store volume with the device name /dev/sdc.
+    #
+    #   resp = client.create_image({
+    #     block_device_mappings: [
+    #       {
+    #         device_name: "/dev/sdh", 
+    #         ebs: {
+    #           volume_size: 100, 
+    #         }, 
+    #       }, 
+    #       {
+    #         device_name: "/dev/sdc", 
+    #         virtual_name: "ephemeral1", 
+    #       }, 
+    #     ], 
+    #     description: "An AMI for my server", 
+    #     instance_id: "i-1234567890abcdef0", 
+    #     name: "My server", 
+    #     no_reboot: true, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     image_id: "ami-1a2b3c4d", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_image({
@@ -3540,6 +3746,52 @@ module Aws::EC2
     #
     #   * {Types::CreateLaunchTemplateResult#launch_template #launch_template} => Types::LaunchTemplate
     #
+    #
+    # @example Example: To create a launch template
+    #
+    #   # This example creates a launch template that specifies the subnet in which to launch the instance, assigns a public IP
+    #   # address and an IPv6 address to the instance, and creates a tag for the instance.
+    #
+    #   resp = client.create_launch_template({
+    #     launch_template_data: {
+    #       image_id: "ami-8c1be5f6", 
+    #       instance_type: "t2.small", 
+    #       network_interfaces: [
+    #         {
+    #           associate_public_ip_address: true, 
+    #           device_index: 0, 
+    #           ipv_6_address_count: 1, 
+    #           subnet_id: "subnet-7b16de0c", 
+    #         }, 
+    #       ], 
+    #       tag_specifications: [
+    #         {
+    #           resource_type: "instance", 
+    #           tags: [
+    #             {
+    #               key: "Name", 
+    #               value: "webserver", 
+    #             }, 
+    #           ], 
+    #         }, 
+    #       ], 
+    #     }, 
+    #     launch_template_name: "my-template", 
+    #     version_description: "WebVersion1", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     launch_template: {
+    #       create_time: Time.parse("2017-11-27T09:13:24.000Z"), 
+    #       created_by: "arn:aws:iam::123456789012:root", 
+    #       default_version_number: 1, 
+    #       latest_version_number: 1, 
+    #       launch_template_id: "lt-01238c059e3466abc", 
+    #       launch_template_name: "my-template", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_launch_template({
@@ -3715,6 +3967,50 @@ module Aws::EC2
     #
     #   * {Types::CreateLaunchTemplateVersionResult#launch_template_version #launch_template_version} => Types::LaunchTemplateVersion
     #
+    #
+    # @example Example: To create a launch template version
+    #
+    #   # This example creates a new launch template version based on version 1 of the specified launch template and specifies a
+    #   # different AMI ID.
+    #
+    #   resp = client.create_launch_template_version({
+    #     launch_template_data: {
+    #       image_id: "ami-c998b6b2", 
+    #     }, 
+    #     launch_template_id: "lt-0abcd290751193123", 
+    #     source_version: "1", 
+    #     version_description: "WebVersion2", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     launch_template_version: {
+    #       create_time: Time.parse("2017-12-01T13:35:46.000Z"), 
+    #       created_by: "arn:aws:iam::123456789012:root", 
+    #       default_version: false, 
+    #       launch_template_data: {
+    #         image_id: "ami-c998b6b2", 
+    #         instance_type: "t2.micro", 
+    #         network_interfaces: [
+    #           {
+    #             associate_public_ip_address: true, 
+    #             device_index: 0, 
+    #             ipv_6_addresses: [
+    #               {
+    #                 ipv_6_address: "2001:db8:1234:1a00::123", 
+    #               }, 
+    #             ], 
+    #             subnet_id: "subnet-7b16de0c", 
+    #           }, 
+    #         ], 
+    #       }, 
+    #       launch_template_id: "lt-0abcd290751193123", 
+    #       launch_template_name: "my-template", 
+    #       version_description: "WebVersion2", 
+    #       version_number: 2, 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_launch_template_version({
@@ -4927,6 +5223,22 @@ module Aws::EC2
     #
     #   * {Types::CreateSecurityGroupResult#group_id #group_id} => String
     #
+    #
+    # @example Example: To create a security group for a VPC
+    #
+    #   # This example creates a security group for the specified VPC.
+    #
+    #   resp = client.create_security_group({
+    #     description: "My security group", 
+    #     group_name: "my-security-group", 
+    #     vpc_id: "vpc-1a2b3c4d", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     group_id: "sg-903004f8", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_security_group({
@@ -6437,12 +6749,12 @@ module Aws::EC2
 
     # Deletes the specified EC2 Fleet.
     #
-    # After you delete an EC2 Fleet, the EC2 Fleet launches no new
-    # instances. You must specify whether the EC2 Fleet should also
-    # terminate its instances. If you terminate the instances, the EC2 Fleet
-    # enters the `deleted_terminating` state. Otherwise, the EC2 Fleet
-    # enters the `deleted_running` state, and the instances continue to run
-    # until they are interrupted or you terminate them manually.
+    # After you delete an EC2 Fleet, it launches no new instances. You must
+    # specify whether an EC2 Fleet should also terminate its instances. If
+    # you terminate the instances, the EC2 Fleet enters the
+    # `deleted_terminating` state. Otherwise, the EC2 Fleet enters the
+    # `deleted_running` state, and the instances continue to run until they
+    # are interrupted or you terminate them manually.
     #
     # @option params [Boolean] :dry_run
     #   Checks whether you have the required permissions for the action,
@@ -6655,6 +6967,27 @@ module Aws::EC2
     #
     #   * {Types::DeleteLaunchTemplateResult#launch_template #launch_template} => Types::LaunchTemplate
     #
+    #
+    # @example Example: To delete a launch template
+    #
+    #   # This example deletes the specified launch template.
+    #
+    #   resp = client.delete_launch_template({
+    #     launch_template_id: "lt-0abcd290751193123", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     launch_template: {
+    #       create_time: Time.parse("2017-11-23T16:46:25.000Z"), 
+    #       created_by: "arn:aws:iam::123456789012:root", 
+    #       default_version_number: 2, 
+    #       latest_version_number: 2, 
+    #       launch_template_id: "lt-0abcd290751193123", 
+    #       launch_template_name: "my-template", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_launch_template({
@@ -6712,6 +7045,31 @@ module Aws::EC2
     #   * {Types::DeleteLaunchTemplateVersionsResult#successfully_deleted_launch_template_versions #successfully_deleted_launch_template_versions} => Array&lt;Types::DeleteLaunchTemplateVersionsResponseSuccessItem&gt;
     #   * {Types::DeleteLaunchTemplateVersionsResult#unsuccessfully_deleted_launch_template_versions #unsuccessfully_deleted_launch_template_versions} => Array&lt;Types::DeleteLaunchTemplateVersionsResponseErrorItem&gt;
     #
+    #
+    # @example Example: To delete a launch template version
+    #
+    #   # This example deletes the specified launch template version.
+    #
+    #   resp = client.delete_launch_template_versions({
+    #     launch_template_id: "lt-0abcd290751193123", 
+    #     versions: [
+    #       "1", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     successfully_deleted_launch_template_versions: [
+    #       {
+    #         launch_template_id: "lt-0abcd290751193123", 
+    #         launch_template_name: "my-template", 
+    #         version_number: 1, 
+    #       }, 
+    #     ], 
+    #     unsuccessfully_deleted_launch_template_versions: [
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_launch_template_versions({
@@ -7119,6 +7477,19 @@ module Aws::EC2
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To delete a security group
+    #
+    #   # This example deletes the specified security group.
+    #
+    #   resp = client.delete_security_group({
+    #     group_id: "sg-903004f8", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_security_group({
@@ -7927,13 +8298,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of the
-    #     tag's key). If you want to list only resources where Purpose is X,
-    #     see the `tag`\:*key*=*value* filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     # @option params [Array<String>] :public_ips
     #   \[EC2-Classic\] One or more Elastic IP addresses.
@@ -8353,16 +8720,9 @@ module Aws::EC2
     #   * `tag`\:*key*=*value* - The key/value combination of a tag assigned
     #     to the resource.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `vpc-id` - The ID of the VPC that the instance is linked to.
     #
@@ -8544,16 +8904,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     # @option params [Boolean] :dry_run
     #   Checks whether you have the required permissions for the action,
@@ -8652,16 +9005,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     # @option params [Boolean] :dry_run
     #   Checks whether you have the required permissions for the action,
@@ -9006,6 +9352,10 @@ module Aws::EC2
     # @option params [Array<Types::Filter>] :filters
     #   One or more filters.
     #
+    #   * `instance-type` - The instance type.
+    #
+    #   ^
+    #
     # @return [Types::DescribeFleetInstancesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeFleetInstancesResult#active_instances #active_instances} => Array&lt;Types::ActiveInstance&gt;
@@ -9046,7 +9396,7 @@ module Aws::EC2
       req.send_request(options)
     end
 
-    # Describes the specified EC2 Fleet.
+    # Describes one or more of your EC2 Fleet.
     #
     # @option params [Boolean] :dry_run
     #   Checks whether you have the required permissions for the action,
@@ -9069,6 +9419,22 @@ module Aws::EC2
     # @option params [Array<Types::Filter>] :filters
     #   One or more filters.
     #
+    #   * `activity-status` - The progress of the EC2 Fleet ( `error` \|
+    #     `pending-fulfillment` \| `pending-termination` \| `fulfilled`).
+    #
+    #   * `excess-capacity-termination-policy` - Indicates whether to
+    #     terminate running instances if the target capacity is decreased
+    #     below the current EC2 Fleet size (`true` \| `false`).
+    #
+    #   * `fleet-state` - The state of the EC2 Fleet (`submitted` \| `active`
+    #     \| `deleted` \| `failed` \| `deleted-running` \|
+    #     `deleted-terminating` \| `modifying`).
+    #
+    #   * `replace-unhealthy-instances` - Indicates whether EC2 Fleet should
+    #     replace unhealthy instances (`true` \| `false`).
+    #
+    #   * `type` - The type of request (`request` \| `maintain`).
+    #
     # @return [Types::DescribeFleetsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeFleetsResult#next_token #next_token} => String
@@ -9302,16 +9668,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `update-time` - The time of the most recent update.
     #
@@ -9573,6 +9932,10 @@ module Aws::EC2
     #     `under-assessment` \| `permanent-failure` \| `released` \|
     #     `released-permanent-failure`).
     #
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
+    #
     # @option params [Array<String>] :host_ids
     #   The IDs of the Dedicated Hosts. The IDs are used for targeted instance
     #   launches.
@@ -9630,6 +9993,9 @@ module Aws::EC2
     #   resp.hosts[0].state #=> String, one of "available", "under-assessment", "permanent-failure", "released", "released-permanent-failure"
     #   resp.hosts[0].allocation_time #=> Time
     #   resp.hosts[0].release_time #=> Time
+    #   resp.hosts[0].tags #=> Array
+    #   resp.hosts[0].tags[0].key #=> String
+    #   resp.hosts[0].tags[0].value #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeHosts AWS API Documentation
@@ -9667,15 +10033,41 @@ module Aws::EC2
     #   * {Types::DescribeIamInstanceProfileAssociationsResult#iam_instance_profile_associations #iam_instance_profile_associations} => Array&lt;Types::IamInstanceProfileAssociation&gt;
     #   * {Types::DescribeIamInstanceProfileAssociationsResult#next_token #next_token} => String
     #
-    # @example Request syntax with placeholder values
+    #
+    # @example Example: To describe an IAM instance profile association
+    #
+    #   # This example describes the specified IAM instance profile association.
     #
     #   resp = client.describe_iam_instance_profile_associations({
-    #     association_ids: ["String"],
-    #     filters: [
-    #       {
-    #         name: "String",
-    #         values: ["String"],
-    #       },
+    #     association_ids: [
+    #       "iip-assoc-0db249b1f25fa24b8", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     iam_instance_profile_associations: [
+    #       {
+    #         association_id: "iip-assoc-0db249b1f25fa24b8", 
+    #         iam_instance_profile: {
+    #           arn: "arn:aws:iam::123456789012:instance-profile/admin-role", 
+    #           id: "AIPAJVQN4F5WVLGCJDRGM", 
+    #         }, 
+    #         instance_id: "i-09eb09efa73ec1dee", 
+    #         state: "associated", 
+    #       }, 
+    #     ], 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_iam_instance_profile_associations({
+    #     association_ids: ["String"],
+    #     filters: [
+    #       {
+    #         name: "String",
+    #         values: ["String"],
+    #       },
     #     ],
     #     max_results: 1,
     #     next_token: "NextToken",
@@ -9866,6 +10258,26 @@ module Aws::EC2
     #   * {Types::ImageAttribute#ramdisk_id #ramdisk_id} => Types::AttributeValue
     #   * {Types::ImageAttribute#sriov_net_support #sriov_net_support} => Types::AttributeValue
     #
+    #
+    # @example Example: To describe the launch permissions for an AMI
+    #
+    #   # This example describes the launch permissions for the specified AMI.
+    #
+    #   resp = client.describe_image_attribute({
+    #     attribute: "launchPermission", 
+    #     image_id: "ami-5731123e", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     image_id: "ami-5731123e", 
+    #     launch_permissions: [
+    #       {
+    #         user_id: "123456789012", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_image_attribute({
@@ -10003,16 +10415,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the tag-value filter. For example, if you use both
-    #     the filter "tag-key=Purpose" and the filter "tag-value=X", you
-    #     get any resources assigned both the tag key Purpose (regardless of
-    #     what the tag's value is), and the tag value X (regardless of what
-    #     the tag's key is). If you want to list only resources where Purpose
-    #     is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `virtualization-type` - The virtualization type (`paravirtual` \|
     #     `hvm`).
@@ -10039,6 +10444,50 @@ module Aws::EC2
     #
     #   * {Types::DescribeImagesResult#images #images} => Array&lt;Types::Image&gt;
     #
+    #
+    # @example Example: To describe an AMI
+    #
+    #   # This example describes the specified AMI.
+    #
+    #   resp = client.describe_images({
+    #     image_ids: [
+    #       "ami-5731123e", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     images: [
+    #       {
+    #         architecture: "x86_64", 
+    #         block_device_mappings: [
+    #           {
+    #             device_name: "/dev/sda1", 
+    #             ebs: {
+    #               delete_on_termination: true, 
+    #               snapshot_id: "snap-1234567890abcdef0", 
+    #               volume_size: 8, 
+    #               volume_type: "standard", 
+    #             }, 
+    #           }, 
+    #         ], 
+    #         description: "An AMI for my server", 
+    #         hypervisor: "xen", 
+    #         image_id: "ami-5731123e", 
+    #         image_location: "123456789012/My server", 
+    #         image_type: "machine", 
+    #         kernel_id: "aki-88aa75e1", 
+    #         name: "My server", 
+    #         owner_id: "123456789012", 
+    #         public: false, 
+    #         root_device_name: "/dev/sda1", 
+    #         root_device_type: "ebs", 
+    #         state: "available", 
+    #         virtualization_type: "paravirtual", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_images({
@@ -10602,6 +11051,49 @@ module Aws::EC2
     #   * {Types::DescribeInstanceStatusResult#instance_statuses #instance_statuses} => Array&lt;Types::InstanceStatus&gt;
     #   * {Types::DescribeInstanceStatusResult#next_token #next_token} => String
     #
+    #
+    # @example Example: To describe the status of an instance
+    #
+    #   # This example describes the current status of the specified instance.
+    #
+    #   resp = client.describe_instance_status({
+    #     instance_ids: [
+    #       "i-1234567890abcdef0", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     instance_statuses: [
+    #       {
+    #         availability_zone: "us-east-1d", 
+    #         instance_id: "i-1234567890abcdef0", 
+    #         instance_state: {
+    #           code: 16, 
+    #           name: "running", 
+    #         }, 
+    #         instance_status: {
+    #           details: [
+    #             {
+    #               name: "reachability", 
+    #               status: "passed", 
+    #             }, 
+    #           ], 
+    #           status: "ok", 
+    #         }, 
+    #         system_status: {
+    #           details: [
+    #             {
+    #               name: "reachability", 
+    #               status: "passed", 
+    #             }, 
+    #           ], 
+    #           status: "ok", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_instance_status({
@@ -10913,16 +11405,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of the
-    #     tag's key). If you want to list only resources where Purpose is X,
-    #     see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `tenancy` - The tenancy of an instance (`dedicated` \| `default` \|
     #     `host`).
@@ -10957,6 +11442,59 @@ module Aws::EC2
     #   * {Types::DescribeInstancesResult#reservations #reservations} => Array&lt;Types::Reservation&gt;
     #   * {Types::DescribeInstancesResult#next_token #next_token} => String
     #
+    #
+    # @example Example: To describe an Amazon EC2 instance
+    #
+    #   # This example describes the specified instance.
+    #
+    #   resp = client.describe_instances({
+    #     instance_ids: [
+    #       "i-1234567890abcdef0", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Example: To describe the instances with a specific instance type
+    #
+    #   # This example describes the instances with the t2.micro instance type.
+    #
+    #   resp = client.describe_instances({
+    #     filters: [
+    #       {
+    #         name: "instance-type", 
+    #         values: [
+    #           "t2.micro", 
+    #         ], 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Example: To describe the instances with a specific tag
+    #
+    #   # This example describes the instances with the Purpose=test tag.
+    #
+    #   resp = client.describe_instances({
+    #     filters: [
+    #       {
+    #         name: "tag:Purpose", 
+    #         values: [
+    #           "test", 
+    #         ], 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Filtering by tags examples
     #   # filtering by tag keys "key1" or "key2"
     #   ec2.describe_instances(filters:[{ name: 'tag-key', values: ['key1', 'key2'] }])
@@ -11116,16 +11654,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     # @option params [Boolean] :dry_run
     #   Checks whether you have the required permissions for the action,
@@ -11320,7 +11851,7 @@ module Aws::EC2
     # @option params [Integer] :max_results
     #   The maximum number of results to return in a single call. To retrieve
     #   the remaining results, make another call with the returned `NextToken`
-    #   value. This value can be between 5 and 1000.
+    #   value. This value can be between 1 and 200.
     #
     # @option params [Array<Types::Filter>] :filters
     #   One or more filters.
@@ -11348,6 +11879,68 @@ module Aws::EC2
     #   * {Types::DescribeLaunchTemplateVersionsResult#launch_template_versions #launch_template_versions} => Array&lt;Types::LaunchTemplateVersion&gt;
     #   * {Types::DescribeLaunchTemplateVersionsResult#next_token #next_token} => String
     #
+    #
+    # @example Example: To describe the versions for a launch template
+    #
+    #   # This example describes the versions for the specified launch template.
+    #
+    #   resp = client.describe_launch_template_versions({
+    #     launch_template_id: "068f72b72934aff71", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     launch_template_versions: [
+    #       {
+    #         create_time: Time.parse("2017-11-20T13:12:32.000Z"), 
+    #         created_by: "arn:aws:iam::123456789102:root", 
+    #         default_version: false, 
+    #         launch_template_data: {
+    #           image_id: "ami-6057e21a", 
+    #           instance_type: "t2.medium", 
+    #           key_name: "kp-us-east", 
+    #           network_interfaces: [
+    #             {
+    #               device_index: 0, 
+    #               groups: [
+    #                 "sg-7c227019", 
+    #               ], 
+    #               subnet_id: "subnet-1a2b3c4d", 
+    #             }, 
+    #           ], 
+    #         }, 
+    #         launch_template_id: "lt-068f72b72934aff71", 
+    #         launch_template_name: "Webservers", 
+    #         version_number: 2, 
+    #       }, 
+    #       {
+    #         create_time: Time.parse("2017-11-20T12:52:33.000Z"), 
+    #         created_by: "arn:aws:iam::123456789102:root", 
+    #         default_version: true, 
+    #         launch_template_data: {
+    #           image_id: "ami-aabbcc11", 
+    #           instance_type: "t2.medium", 
+    #           key_name: "kp-us-east", 
+    #           network_interfaces: [
+    #             {
+    #               associate_public_ip_address: true, 
+    #               delete_on_termination: false, 
+    #               device_index: 0, 
+    #               groups: [
+    #                 "sg-7c227019", 
+    #               ], 
+    #               subnet_id: "subnet-7b16de0c", 
+    #             }, 
+    #           ], 
+    #           user_data: "", 
+    #         }, 
+    #         launch_template_id: "lt-068f72b72934aff71", 
+    #         launch_template_name: "Webservers", 
+    #         version_number: 1, 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_launch_template_versions({
@@ -11479,13 +12072,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of the
-    #     tag's key). If you want to list only resources where Purpose is X,
-    #     see the `tag`\:*key*=*value* filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     # @option params [String] :next_token
     #   The token to request the next page of results.
@@ -11500,6 +12089,31 @@ module Aws::EC2
     #   * {Types::DescribeLaunchTemplatesResult#launch_templates #launch_templates} => Array&lt;Types::LaunchTemplate&gt;
     #   * {Types::DescribeLaunchTemplatesResult#next_token #next_token} => String
     #
+    #
+    # @example Example: To describe a launch template
+    #
+    #   # This example describes the specified launch template.
+    #
+    #   resp = client.describe_launch_templates({
+    #     launch_template_ids: [
+    #       "lt-01238c059e3466abc", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     launch_templates: [
+    #       {
+    #         create_time: Time.parse("2018-01-16T04:32:57.000Z"), 
+    #         created_by: "arn:aws:iam::123456789012:root", 
+    #         default_version_number: 1, 
+    #         latest_version_number: 1, 
+    #         launch_template_id: "lt-01238c059e3466abc", 
+    #         launch_template_name: "my-template", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_launch_templates({
@@ -11645,16 +12259,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `vpc-id` - The ID of the VPC in which the NAT gateway resides.
     #
@@ -11821,16 +12428,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `vpc-id` - The ID of the VPC for the network ACL.
     #
@@ -12256,16 +12856,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `vpc-id` - The ID of the VPC for the network interface.
     #
@@ -12487,6 +13080,8 @@ module Aws::EC2
     # the IP address range for the service. A prefix list ID is required for
     # creating an outbound security group rule that allows traffic from a
     # VPC to access an AWS service through a gateway VPC endpoint.
+    # Currently, the services that support this action are Amazon S3 and
+    # Amazon DynamoDB.
     #
     # @option params [Boolean] :dry_run
     #   Checks whether you have the required permissions for the action,
@@ -12806,16 +13401,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `usage-price` - The usage price of the Reserved Instance, per hour
     #     (for example, 0.84).
@@ -13366,16 +13954,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `vpc-id` - The ID of the VPC for the route table.
     #
@@ -13804,6 +14385,28 @@ module Aws::EC2
     #
     #   * {Types::DescribeSecurityGroupReferencesResult#security_group_reference_set #security_group_reference_set} => Array&lt;Types::SecurityGroupReference&gt;
     #
+    #
+    # @example Example: To describe security group references
+    #
+    #   # This example describes the security group references for the specified security group.
+    #
+    #   resp = client.describe_security_group_references({
+    #     group_id: [
+    #       "sg-903004f8", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     security_group_reference_set: [
+    #       {
+    #         group_id: "sg-903004f8", 
+    #         referencing_vpc_id: "vpc-1a2b3c4d", 
+    #         vpc_peering_connection_id: "pcx-b04deed9", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_security_group_references({
@@ -13907,9 +14510,9 @@ module Aws::EC2
     #
     #   * `owner-id` - The AWS account ID of the owner of the security group.
     #
-    #   * `tag-key` - The key of a tag assigned to the security group.
-    #
-    #   * `tag-value` - The value of a tag assigned to the security group.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `vpc-id` - The ID of the VPC specified when the security group was
     #     created.
@@ -13948,6 +14551,40 @@ module Aws::EC2
     #   * {Types::DescribeSecurityGroupsResult#security_groups #security_groups} => Array&lt;Types::SecurityGroup&gt;
     #   * {Types::DescribeSecurityGroupsResult#next_token #next_token} => String
     #
+    #
+    # @example Example: To describe a security group
+    #
+    #   # This example describes the specified security group.
+    #
+    #   resp = client.describe_security_groups({
+    #     group_ids: [
+    #       "sg-903004f8", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Example: To describe a tagged security group
+    #
+    #   # This example describes the security groups that include the specified tag (Purpose=test).
+    #
+    #   resp = client.describe_security_groups({
+    #     filters: [
+    #       {
+    #         name: "tag:Purpose", 
+    #         values: [
+    #           "test", 
+    #         ], 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_security_groups({
@@ -14183,16 +14820,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `volume-id` - The ID of the volume the snapshot is for.
     #
@@ -14921,16 +15551,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `type` - The type of Spot Instance request (`one-time` \|
     #     `persistent`).
@@ -15386,16 +16009,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `vpc-id` - The ID of the VPC for the subnet.
     #
@@ -15512,8 +16128,8 @@ module Aws::EC2
     #   * `resource-id` - The resource ID.
     #
     #   * `resource-type` - The resource type (`customer-gateway` \|
-    #     `dhcp-options` \| `elastic-ip` \| `fpga-image` \| `image` \|
-    #     `instance` \| `internet-gateway` \| `launch-template` \|
+    #     `dhcp-options` \| `elastic-ip` \| `fleet` \| `fpga-image` \| `image`
+    #     \| `instance` \| `internet-gateway` \| `launch-template` \|
     #     `natgateway` \| `network-acl` \| `network-interface` \|
     #     `reserved-instances` \| `route-table` \| `security-group` \|
     #     `snapshot` \| `spot-instances-request` \| `subnet` \| `volume` \|
@@ -15949,16 +16565,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `volume-id` - The volume ID.
     #
@@ -16315,16 +16924,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     # @option params [Boolean] :dry_run
     #   Checks whether you have the required permissions for the action,
@@ -16923,16 +17525,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `vpc-peering-connection-id` - The ID of the VPC peering connection.
     #
@@ -17046,16 +17641,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `vpc-id` - The ID of the VPC.
     #
@@ -17187,16 +17775,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `type` - The type of VPN connection. Currently the only supported
     #     type is `ipsec.1`.
@@ -17301,16 +17882,9 @@ module Aws::EC2
     #     Purpose=X, specify `tag:Purpose` for the filter name and `X` for the
     #     filter value.
     #
-    #   * `tag-key` - The key of a tag assigned to the resource. This filter
-    #     is independent of the `tag-value` filter. For example, if you use
-    #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
-    #     you get any resources assigned both the tag key Purpose (regardless
-    #     of what the tag's value is), and the tag value X (regardless of
-    #     what the tag's key is). If you want to list only resources where
-    #     Purpose is X, see the `tag`\:*key*=*value* filter.
-    #
-    #   * `tag-value` - The value of a tag assigned to the resource. This
-    #     filter is independent of the `tag-key` filter.
+    #   * `tag-key` - The key of a tag assigned to the resource. Use this
+    #     filter to find all resources assigned a tag with a specific key,
+    #     regardless of the tag value.
     #
     #   * `type` - The type of virtual private gateway. Currently the only
     #     supported type is `ipsec.1`.
@@ -17821,6 +18395,28 @@ module Aws::EC2
     #
     #   * {Types::DisassociateIamInstanceProfileResult#iam_instance_profile_association #iam_instance_profile_association} => Types::IamInstanceProfileAssociation
     #
+    #
+    # @example Example: To disassociate an IAM instance profile
+    #
+    #   # This example disassociates the specified IAM instance profile from an instance.
+    #
+    #   resp = client.disassociate_iam_instance_profile({
+    #     association_id: "iip-assoc-05020b59952902f5f", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     iam_instance_profile_association: {
+    #       association_id: "iip-assoc-05020b59952902f5f", 
+    #       iam_instance_profile: {
+    #         arn: "arn:aws:iam::123456789012:instance-profile/admin-role", 
+    #         id: "AIPAI5IVIHMFFYY2DKV5Y", 
+    #       }, 
+    #       instance_id: "i-123456789abcde123", 
+    #       state: "disassociating", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.disassociate_iam_instance_profile({
@@ -18172,12 +18768,28 @@ module Aws::EC2
     #   * {Types::GetConsoleOutputResult#output #output} => String
     #   * {Types::GetConsoleOutputResult#timestamp #timestamp} => Time
     #
-    # @example Request syntax with placeholder values
+    #
+    # @example Example: To get the console output
+    #
+    #   # This example gets the console output for the specified instance.
     #
     #   resp = client.get_console_output({
-    #     instance_id: "String", # required
-    #     dry_run: false,
-    #     latest: false,
+    #     instance_id: "i-1234567890abcdef0", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     instance_id: "i-1234567890abcdef0", 
+    #     output: "...", 
+    #     timestamp: Time.parse("2018-05-25T21:23:53.000Z"), 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_console_output({
+    #     instance_id: "String", # required
+    #     dry_run: false,
+    #     latest: false,
     #   })
     #
     # @example Response structure
@@ -18309,6 +18921,68 @@ module Aws::EC2
     #
     #   * {Types::GetLaunchTemplateDataResult#launch_template_data #launch_template_data} => Types::ResponseLaunchTemplateData
     #
+    #
+    # @example Example: To get the launch template data for an instance 
+    #
+    #   # This example gets the launch template data for the specified instance.
+    #
+    #   resp = client.get_launch_template_data({
+    #     instance_id: "0123d646e8048babc", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     launch_template_data: {
+    #       block_device_mappings: [
+    #         {
+    #           device_name: "/dev/xvda", 
+    #           ebs: {
+    #             delete_on_termination: true, 
+    #             encrypted: false, 
+    #             iops: 100, 
+    #             snapshot_id: "snap-02594938353ef77d3", 
+    #             volume_size: 8, 
+    #             volume_type: "gp2", 
+    #           }, 
+    #         }, 
+    #       ], 
+    #       ebs_optimized: false, 
+    #       image_id: "ami-32cf7b4a", 
+    #       instance_type: "t2.medium", 
+    #       key_name: "my-key-pair", 
+    #       monitoring: {
+    #         enabled: false, 
+    #       }, 
+    #       network_interfaces: [
+    #         {
+    #           associate_public_ip_address: false, 
+    #           delete_on_termination: true, 
+    #           description: "", 
+    #           device_index: 0, 
+    #           groups: [
+    #             "sg-d14e1bb4", 
+    #           ], 
+    #           ipv_6_addresses: [
+    #           ], 
+    #           network_interface_id: "eni-4338b5a9", 
+    #           private_ip_address: "10.0.3.233", 
+    #           private_ip_addresses: [
+    #             {
+    #               primary: true, 
+    #               private_ip_address: "10.0.3.233", 
+    #             }, 
+    #           ], 
+    #           subnet_id: "subnet-5264e837", 
+    #         }, 
+    #       ], 
+    #       placement: {
+    #         availability_zone: "us-east-2b", 
+    #         group_name: "", 
+    #         tenancy: "default", 
+    #       }, 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_launch_template_data({
@@ -19411,6 +20085,45 @@ module Aws::EC2
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To make an AMI public
+    #
+    #   # This example makes the specified AMI public.
+    #
+    #   resp = client.modify_image_attribute({
+    #     image_id: "ami-5731123e", 
+    #     launch_permission: {
+    #       add: [
+    #         {
+    #           group: "all", 
+    #         }, 
+    #       ], 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Example: To grant launch permissions
+    #
+    #   # This example grants launch permissions for the specified AMI to the specified AWS account.
+    #
+    #   resp = client.modify_image_attribute({
+    #     image_id: "ami-5731123e", 
+    #     launch_permission: {
+    #       add: [
+    #         {
+    #           user_id: "123456789012", 
+    #         }, 
+    #       ], 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.modify_image_attribute({
@@ -19578,6 +20291,37 @@ module Aws::EC2
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To modify the instance type
+    #
+    #   # This example modifies the instance type of the specified stopped instance.
+    #
+    #   resp = client.modify_instance_attribute({
+    #     instance_id: "i-1234567890abcdef0", 
+    #     instance_type: {
+    #       value: "m5.large", 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Example: To enable enhanced networking
+    #
+    #   # This example enables enhanced networking for the specified stopped instance.
+    #
+    #   resp = client.modify_instance_attribute({
+    #     ena_support: {
+    #       value: true, 
+    #     }, 
+    #     instance_id: "i-1234567890abcdef0", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.modify_instance_attribute({
@@ -19805,6 +20549,28 @@ module Aws::EC2
     #
     #   * {Types::ModifyLaunchTemplateResult#launch_template #launch_template} => Types::LaunchTemplate
     #
+    #
+    # @example Example: To change the default version of a launch template
+    #
+    #   # This example specifies version 2 as the default version of the specified launch template.
+    #
+    #   resp = client.modify_launch_template({
+    #     default_version: "2", 
+    #     launch_template_id: "lt-0abcd290751193123", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     launch_template: {
+    #       create_time: Time.parse("2017-12-01T13:35:46.000Z"), 
+    #       created_by: "arn:aws:iam::123456789012:root", 
+    #       default_version_number: 2, 
+    #       latest_version_number: 2, 
+    #       launch_template_id: "lt-0abcd290751193123", 
+    #       launch_template_name: "WebServers", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.modify_launch_template({
@@ -21315,6 +22081,21 @@ module Aws::EC2
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To reboot an EC2 instance
+    #
+    #   # This example reboots the specified EC2 instance.
+    #
+    #   resp = client.reboot_instances({
+    #     instance_ids: [
+    #       "i-1234567890abcdef5", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.reboot_instances({
@@ -22867,6 +23648,20 @@ module Aws::EC2
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To reset the launchPermission attribute
+    #
+    #   # This example resets the launchPermission attribute for the specified AMI. By default, AMIs are private.
+    #
+    #   resp = client.reset_image_attribute({
+    #     attribute: "launchPermission", 
+    #     image_id: "ami-5731123e", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.reset_image_attribute({
@@ -22917,6 +23712,20 @@ module Aws::EC2
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To reset the sourceDestCheck attribute
+    #
+    #   # This example resets the sourceDestCheck attribute for the specified instance.
+    #
+    #   resp = client.reset_instance_attribute({
+    #     attribute: "sourceDestCheck", 
+    #     instance_id: "i-1234567890abcdef0", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.reset_instance_attribute({
@@ -23593,9 +24402,10 @@ module Aws::EC2
     #   An elastic GPU to associate with the instance.
     #
     # @option params [Array<Types::TagSpecification>] :tag_specifications
-    #   The tags to apply to the resources during launch. You can tag
-    #   instances and volumes. The specified tags are applied to all instances
-    #   or volumes that are created during launch.
+    #   The tags to apply to the resources during launch. You can only tag
+    #   instances and volumes on launch. The specified tags are applied to all
+    #   instances or volumes that are created during launch. To tag a resource
+    #   after it has been created, see CreateTags.
     #
     # @option params [Types::LaunchTemplateSpecification] :launch_template
     #   The launch template to use to launch the instances. Any parameters
@@ -23635,6 +24445,47 @@ module Aws::EC2
     #   * {Types::Reservation#requester_id #requester_id} => String
     #   * {Types::Reservation#reservation_id #reservation_id} => String
     #
+    #
+    # @example Example: To launch an instance
+    #
+    #   # This example launches an instance using the specified AMI, instance type, security group, subnet, block device mapping,
+    #   # and tags.
+    #
+    #   resp = client.run_instances({
+    #     block_device_mappings: [
+    #       {
+    #         device_name: "/dev/sdh", 
+    #         ebs: {
+    #           volume_size: 100, 
+    #         }, 
+    #       }, 
+    #     ], 
+    #     image_id: "ami-abc12345", 
+    #     instance_type: "t2.micro", 
+    #     key_name: "my-key-pair", 
+    #     max_count: 1, 
+    #     min_count: 1, 
+    #     security_group_ids: [
+    #       "sg-1a2b3c4d", 
+    #     ], 
+    #     subnet_id: "subnet-6e7f829e", 
+    #     tag_specifications: [
+    #       {
+    #         resource_type: "instance", 
+    #         tags: [
+    #           {
+    #             key: "Purpose", 
+    #             value: "test", 
+    #           }, 
+    #         ], 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.run_instances({
@@ -24117,6 +24968,34 @@ module Aws::EC2
     #
     #   * {Types::StartInstancesResult#starting_instances #starting_instances} => Array&lt;Types::InstanceStateChange&gt;
     #
+    #
+    # @example Example: To start a stopped EC2 instance
+    #
+    #   # This example starts the specified EC2 instance.
+    #
+    #   resp = client.start_instances({
+    #     instance_ids: [
+    #       "i-1234567890abcdef0", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     starting_instances: [
+    #       {
+    #         current_state: {
+    #           code: 0, 
+    #           name: "pending", 
+    #         }, 
+    #         instance_id: "i-1234567890abcdef0", 
+    #         previous_state: {
+    #           code: 80, 
+    #           name: "stopped", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.start_instances({
@@ -24205,6 +25084,34 @@ module Aws::EC2
     #
     #   * {Types::StopInstancesResult#stopping_instances #stopping_instances} => Array&lt;Types::InstanceStateChange&gt;
     #
+    #
+    # @example Example: To stop a running EC2 instance
+    #
+    #   # This example stops the specified EC2 instance.
+    #
+    #   resp = client.stop_instances({
+    #     instance_ids: [
+    #       "i-1234567890abcdef0", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     stopping_instances: [
+    #       {
+    #         current_state: {
+    #           code: 64, 
+    #           name: "stopping", 
+    #         }, 
+    #         instance_id: "i-1234567890abcdef0", 
+    #         previous_state: {
+    #           code: 16, 
+    #           name: "running", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.stop_instances({
@@ -24281,6 +25188,34 @@ module Aws::EC2
     #
     #   * {Types::TerminateInstancesResult#terminating_instances #terminating_instances} => Array&lt;Types::InstanceStateChange&gt;
     #
+    #
+    # @example Example: To terminate an EC2 instance
+    #
+    #   # This example terminates the specified EC2 instance.
+    #
+    #   resp = client.terminate_instances({
+    #     instance_ids: [
+    #       "i-1234567890abcdef0", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     terminating_instances: [
+    #       {
+    #         current_state: {
+    #           code: 32, 
+    #           name: "shutting-down", 
+    #         }, 
+    #         instance_id: "i-1234567890abcdef0", 
+    #         previous_state: {
+    #           code: 16, 
+    #           name: "running", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.terminate_instances({
@@ -24456,6 +25391,32 @@ module Aws::EC2
     #
     #   * {Types::UpdateSecurityGroupRuleDescriptionsEgressResult#return #return} => Boolean
     #
+    #
+    # @example Example: To update an outbound security group rule description
+    #
+    #   # This example updates the description for the specified security group rule.
+    #
+    #   resp = client.update_security_group_rule_descriptions_egress({
+    #     group_id: "sg-123abc12", 
+    #     ip_permissions: [
+    #       {
+    #         from_port: 80, 
+    #         ip_protocol: "tcp", 
+    #         ip_ranges: [
+    #           {
+    #             cidr_ip: "203.0.113.0/24", 
+    #             description: "Outbound HTTP access to server 2", 
+    #           }, 
+    #         ], 
+    #         to_port: 80, 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_security_group_rule_descriptions_egress({
@@ -24544,6 +25505,32 @@ module Aws::EC2
     #
     #   * {Types::UpdateSecurityGroupRuleDescriptionsIngressResult#return #return} => Boolean
     #
+    #
+    # @example Example: To update an inbound security group rule description
+    #
+    #   # This example updates the description for the specified security group rule.
+    #
+    #   resp = client.update_security_group_rule_descriptions_ingress({
+    #     group_id: "sg-123abc12", 
+    #     ip_permissions: [
+    #       {
+    #         from_port: 22, 
+    #         ip_protocol: "tcp", 
+    #         ip_ranges: [
+    #           {
+    #             cidr_ip: "203.0.113.0/16", 
+    #             description: "SSH access from the LA office", 
+    #           }, 
+    #         ], 
+    #         to_port: 22, 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_security_group_rule_descriptions_ingress({
@@ -24614,7 +25601,7 @@ module Aws::EC2
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ec2'
-      context[:gem_version] = '1.36.0'
+      context[:gem_version] = '1.37.0'
       Seahorse::Client::Request.new(handlers, context)
     end