AWS ec2 documentation change
Summary
Expanded PowerShell V5 examples for DescribeAddresses with multiple query scenarios and output formats
Security assessment
Adds documentation for querying Elastic IP addresses but does not disclose or mitigate security issues. The examples focus on operational use cases rather than security controls.
Diff
diff --git a/ec2/latest/devguide/example_ec2_DescribeAddresses_section.md b/ec2/latest/devguide/example_ec2_DescribeAddresses_section.md index 283ac6061..2b2bac809 100644 --- a//ec2/latest/devguide/example_ec2_DescribeAddresses_section.md +++ b//ec2/latest/devguide/example_ec2_DescribeAddresses_section.md @@ -385,0 +386,117 @@ PowerShell +**Tools for PowerShell V5** + + +**Example 1: This example describes the specified Elastic IP address for instances in EC2-Classic.** + + + Get-EC2Address -AllocationId eipalloc-12345678 + + +**Output:** + + + AllocationId : eipalloc-12345678 + AssociationId : eipassoc-12345678 + Domain : vpc + InstanceId : i-87654321 + NetworkInterfaceId : eni-12345678 + NetworkInterfaceOwnerId : 12345678 + PrivateIpAddress : 10.0.2.172 + PublicIp : 198.51.100.2 + +**Example 2: This example describes your Elastic IP addresses for instances in a VPC. This syntax requires PowerShell version 3 or later.** + + + Get-EC2Address -Filter @{ Name="domain";Values="vpc" } + + +**Example 3: This example describes the specified Elastic IP address for instances in EC2-Classic.** + + + Get-EC2Address -PublicIp 203.0.113.17 + + +**Output:** + + + AllocationId : + AssociationId : + Domain : standard + InstanceId : i-12345678 + NetworkInterfaceId : + NetworkInterfaceOwnerId : + PrivateIpAddress : + PublicIp : 203.0.113.17 + +**Example 4: This example describes your Elastic IP addresses for instances in EC2-Classic. This syntax requires PowerShell version 3 or later.** + + + Get-EC2Address -Filter @{ Name="domain";Values="standard" } + + +**Example 5: This example describes all your Elastic IP addresses.** + + + Get-EC2Address + + +**Example 6: This example returns the public and private IP for the instance id provided in filter** + + + Get-EC2Address -Region eu-west-1 -Filter @{Name="instance-id";Values="i-0c12d3f4f567ffb89"} | Select-Object PrivateIpAddress, PublicIp + + +**Output:** + + + PrivateIpAddress PublicIp + ---------------- -------- + 10.0.0.99 63.36.5.227 + +**Example 7: This example retrieves all the Elastic IPs with its allocation id, association id and instance ids** + + + Get-EC2Address -Region eu-west-1 | Select-Object InstanceId, AssociationId, AllocationId, PublicIp + + +**Output:** + + + InstanceId AssociationId AllocationId PublicIp + ---------- ------------- ------------ -------- + eipalloc-012e3b456789e1fad 17.212.120.178 + i-0c123dfd3415bac67 eipassoc-0e123456bb7890bdb eipalloc-01cd23ebf45f7890c 17.212.124.77 + eipalloc-012345678eeabcfad 17.212.225.7 + i-0123d405c67e89a0c eipassoc-0c123b456783966ba eipalloc-0123cdd456a8f7892 37.216.52.173 + i-0f1bf2f34c5678d09 eipassoc-0e12934568a952d96 eipalloc-0e1c23e4d5e6789e4 37.218.222.278 + i-012e3cb4df567e8aa eipassoc-0d1b2fa4d67d03810 eipalloc-0123f456f78a01b58 37.210.82.27 + i-0123bcf4b567890e1 eipassoc-01d2345f678903fb1 eipalloc-0e1db23cfef5c45c7 37.215.222.270 + +**Example 8: This example fetches list of EC2 IP addresses matching tag key 'Category' with value 'Prod'** + + + Get-EC2Address -Filter @{Name="tag:Category";Values="Prod"} + + +**Output:** + + + AllocationId : eipalloc-0123f456f81a01b58 + AssociationId : eipassoc-0d1b23a456d103810 + CustomerOwnedIp : + CustomerOwnedIpv4Pool : + Domain : vpc + InstanceId : i-012e3cb4df567e1aa + NetworkBorderGroup : eu-west-1 + NetworkInterfaceId : eni-0123f41d5a60d5f40 + NetworkInterfaceOwnerId : 123456789012 + PrivateIpAddress : 192.168.1.84 + PublicIp : 34.250.81.29 + PublicIpv4Pool : amazon + Tags : {Category, Name} + + * For API details, see [DescribeAddresses](https://docs.aws.amazon.com/powershell/v5/reference) in _AWS Tools for PowerShell Cmdlet Reference (V5)_. + + + +