Add IPAM example

Author: mccgeoff

.doc_gen/metadata/vpc_gs_metadata.yaml

@@ -7,7 +7,7 @@ vpc_GettingStartedCLI:
     - Configure your network
     - Configure security
     - Deploy resources
-    - Test and verify 
+    - Test and verify
     - Clean up resources
     - Consider production implications
     - Consider security implications
@@ -23,4 +23,32 @@ vpc_GettingStartedCLI:
                 - tuts/002-vpc-gs/vpc-gs.sh
   services:
     ec2: {
-      AllocateAddress, AssociateRouteTable, AttachInternetGateway, AuthorizeSecurityGroupIngress, CreateInternetGateway, CreateKeyPair, CreateNatGateway, CreateRoute, CreateRouteTable, CreateSecurityGroup, CreateSubnet, CreateVpc, DeleteInternetGateway, DeleteKeyPair, DeleteNatGateway, DeleteRouteTable, DeleteSecurityGroup, DeleteSubnet, DeleteVpc, DescribeAvailabilityZones, DescribeImages, DescribeInstances, DescribeInternetGateways, DescribeNatGateways, DescribeRouteTables, DescribeSecurityGroups, DescribeSubnets, DescribeVpcs, DetachInternetGateway, DisassociateRouteTable, ModifySubnetAttribute, ModifyVpcAttribute, ReleaseAddress, RunInstances, TerminateInstances}
+      AllocateAddress, AssociateRouteTable, AttachInternetGateway, AuthorizeSecurityGroupIngress, CreateInternetGateway, CreateKeyPair, CreateNatGateway, CreateRoute, CreateRouteTable, CreateSecurityGroup, CreateSubnet, CreateVpc, DeleteInternetGateway, DeleteKeyPair, DeleteNatGateway, DeleteRouteTable, DeleteSecurityGroup, DeleteSubnet, DeleteVpc, DescribeAvailabilityZones, DescribeImages, DescribeInstances, DescribeInternetGateways, DescribeNatGateways, DescribeRouteTables, DescribeSecurityGroups, DescribeSubnets, DescribeVpcs, DetachInternetGateway, DisassociateRouteTable, ModifySubnetAttribute, ModifyVpcAttribute, ReleaseAddress, RunInstances, TerminateInstances}
+
+vpc_GettingStartedIpam:
+  title: Get started using Amazon VPC IPAM using the CLI
+  title_abbrev: Get started with Amazon VPC IPAM
+  synopsis_list:
+  - Set up and configure Amazon VPC IP Address Manager (IPAM) using the AWS CLI.
+  - Create an IPAM with operating regions (e.g., us-east-1, us-west-2).
+  - Retrieve the private scope ID for the IPAM.
+  - Create a hierarchical structure of IPv4 pools (top-level, regional, and development pools).
+  - Provision CIDR blocks to each pool (e.g., 10.0.0.0/8, 10.0.0.0/16, 10.0.0.0/24).
+  - Create a VPC using a CIDR allocated from an IPAM pool.
+  - Verify IPAM pool allocations and VPC creation.
+  - Troubleshoot common issues like permission errors, CIDR allocation failures, and dependency violations.
+  - Clean up IPAM resources (VPC, pools, CIDRs, and IPAM) to avoid unnecessary charges.
+  - Explore next steps for advanced IPAM features.
+  category: Scenarios
+  languages:
+    Bash:
+      versions:
+        - sdk_version: 3
+          github: tuts/009-vpc-ipam-gs
+          excerpts:
+            - description:
+              snippet_files:
+                - tuts/009-vpc-ipam-gs/vpc-ipam-gs.sh
+  services:
+    ec2: {
+      CreateIpam, CreateIpamPool, CreateVpc, DeleteIpam, DeleteIpamPool, DeleteVpc, DeprovisionIpamPoolCidr, DescribeIpamPools, DescribeIpams, DescribeVpcs, GetIpamPoolAllocations, GetIpamPoolCidrs, ProvisionIpamPoolCidr}