Merge branch 'main' into image-generation

Author: beqqrry-aws

.doc_gen/metadata/cloudfront_metadata.yaml

@@ -80,6 +80,56 @@ cloudfront_CreateDistribution:
                 - cloudfront.java2.createdistribution.main
   services:
     cloudfront: {CreateDistribution}
+cloudfront_CreateSaasResources:
+  title: Create SaaS manager resources &AWS; SDK
+  title_abbrev: Create a multi-tenant distribution and distribution tenant
+  synopsis: create a multi-tenant distribution and distribution tenant with various configurations.
+  category: Scenarios
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/cloudfront
+          sdkguide:
+          excerpts:
+            - description: >-
+                The following example demonstrates how to create a multi-tenant distribution with parameters and wildcard certificate.
+              snippet_tags:
+                - cloudfront.java2.createmultitenantdistribution.import
+                - cloudfront.java2.createmultitenantdistribution.main
+            - description: >-
+                The following example demonstrates how to create a distribution tenant associated with that template, including utilizing the parameter we declared above.  Note that we don't need to add certificate info here because our domain is already covered by the parent template.
+              snippet_tags:
+                - cloudfront.java2.createdistributiontenant.import
+                - cloudfront.java2.createdistributiontenant.title
+                - cloudfront.java2.createdistributiontenant.nocert
+                - cloudfront.java2.createdistributiontenant.closebrace
+            - description: >-
+                If the viewer certificate was omitted from the parent template, you would need to add certificate info on the tenant(s) associated with it instead.
+                The following example demonstrates how to do so via an ACM certificate arn that covers the necessary domain for the tenant.
+              snippet_tags:
+                - cloudfront.java2.createdistributiontenant.import
+                - cloudfront.java2.createdistributiontenant.title
+                - cloudfront.java2.createdistributiontenant.withcert
+                - cloudfront.java2.createdistributiontenant.closebrace
+            - description: >-
+                The following example demonstrates how to do so with a CloudFront-hosted managed certificate request.  This is ideal if you don't already have traffic towards your domain.
+                In this case, we create a ConnectionGroup to generate a RoutingEndpoint.  Then we use that RoutingEndpoint to create DNS records which verify domain ownership and point to CloudFront. CloudFront will then automatically serve a token to validate domain ownership and create a managed certificate.
+              snippet_tags:
+                - cloudfront.java2.createdistributiontenant.import
+                - cloudfront.java2.createdistributiontenant.title
+                - cloudfront.java2.createdistributiontenant.cfhosted
+                - cloudfront.java2.createdistributiontenant.closebrace
+            - description: >-
+                The following example demonstrates how to do so with a self-hosted managed certificate request.  This is ideal if you have traffic towards your domain and can't tolerate downtime during a migration.
+                At the end of this example, the Tenant will be created in a state awaiting domain validation and DNS setup.  Follow steps [here](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/managed-cloudfront-certificates.html#complete-domain-ownership) to complete setup when you are ready to migrate traffic.
+              snippet_tags:
+                - cloudfront.java2.createdistributiontenant.import
+                - cloudfront.java2.createdistributiontenant.title
+                - cloudfront.java2.createdistributiontenant.selfhosted
+                - cloudfront.java2.createdistributiontenant.closebrace
+  services:
+    cloudfront: {CreateDistribution, CreateDistributionTenant}
 cloudfront_CreateKeyGroup:
   languages:
     Java:

.doc_gen/metadata/cognito-identity-provider_metadata.yaml

@@ -433,6 +433,7 @@ cognito-identity-provider_ListUsers:
       versions:
         - sdk_version: 1
           github: swift/example_code/cognito-identity-provider
+          sdkguide:
           excerpts:
             - description:
               snippet_tags:

.doc_gen/metadata/dynamodb_metadata.yaml

@@ -1877,7 +1877,7 @@ dynamodb_Scenario_GettingStartedMovies:
           excerpts:
             - description:
               snippet_tags:
-                - DynamoDB.dotnetv3.DynamoDB_Basics_Scenario
+                - DynamoDB.dotnetv4.DynamoDB_Basics_Scenario
             - description: Creates a table to contain movie data.
               snippet_tags:
                 - DynamoDB.dotnetv4.dynamodb-basics.CreateTable

.doc_gen/metadata/ec2_metadata.yaml

@@ -76,6 +76,17 @@ ec2_Hello:
           excerpts:
             - snippet_tags:
                 - ec2.rust.ec2-helloworld
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description: The <filename>Package.swift</filename> file.
+              snippet_tags:
+                - swift.ec2.hello.package
+            - description: The <filename>entry.swift</filename> file.
+              snippet_tags:
+                - swift.ec2.hello
   services:
     ec2: {DescribeSecurityGroups}
 ec2_GetPasswordData:
@@ -188,6 +199,15 @@ ec2_CreateKeyPair:
             - description: A function that calls the create_key impl and securely saves the PEM private key.
               snippet_tags:
                 - ec2.rust.create_key.wrapper
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.CreateKeyPair
   services:
     ec2: {CreateKeyPair}
 ec2_DescribeKeyPairs:
@@ -274,6 +294,15 @@ ec2_DescribeKeyPairs:
           excerpts:
             - snippet_tags:
                 - ec2.rust.list_keys.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.DescribeKeyPairs
   services:
     ec2: {DescribeKeyPairs}
 
@@ -370,6 +399,15 @@ ec2_CreateSecurityGroup:
           excerpts:
             - snippet_tags:
                 - ec2.rust.create_security_group.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.CreateSecurityGroup
   services:
     ec2: {CreateSecurityGroup}
 ec2_RunInstances:
@@ -457,6 +495,15 @@ ec2_RunInstances:
           excerpts:
             - snippet_tags:
                 - ec2.rust.create_instance.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.RunInstances
   services:
     ec2: {RunInstances}
 ec2_StartInstances:
@@ -557,6 +604,15 @@ ec2_StartInstances:
               snippet_tags:
                 - aws-cli.bash-linux.ec2.errecho
                 - aws-cli.bash-linux.ec2.aws_cli_error_log
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.StartInstances
   services:
     ec2: {StartInstances}
 ec2_StopInstances:
@@ -656,6 +712,15 @@ ec2_StopInstances:
               snippet_tags:
                 - aws-cli.bash-linux.ec2.errecho
                 - aws-cli.bash-linux.ec2.aws_cli_error_log
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.StopInstances
   services:
     ec2: {StopInstances}
 ec2_AllocateAddress:
@@ -752,6 +817,15 @@ ec2_AllocateAddress:
           excerpts:
             - snippet_tags:
                 - ec2.rust.allocate_address.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.AllocateAddress
   services:
     ec2: {AllocateAddress}
 ec2_AssociateAddress:
@@ -848,6 +922,15 @@ ec2_AssociateAddress:
           excerpts:
             - snippet_tags:
                 - ec2.rust.associate_address.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.AssociateAddress
   services:
     ec2: {AssociateAddress}
 ec2_DisassociateAddress:
@@ -918,6 +1001,15 @@ ec2_DisassociateAddress:
           excerpts:
             - snippet_tags:
                 - ec2.rust.disassociate_address.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.DisassociateAddress
   services:
     ec2: {DisassociateAddress}
 ec2_ReleaseAddress:
@@ -1013,6 +1105,15 @@ ec2_ReleaseAddress:
           excerpts:
             - snippet_tags:
                 - ec2.rust.deallocate_address.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.ReleaseAddress
   services:
     ec2: {ReleaseAddress}
 ec2_AuthorizeSecurityGroupIngress:
@@ -1094,6 +1195,15 @@ ec2_AuthorizeSecurityGroupIngress:
           excerpts:
             - snippet_tags:
                 - ec2.rust.authorize_security_group_ssh_ingress.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.AuthorizeSecurityGroupIngress
   services:
     ec2: {AuthorizeSecurityGroupIngress}
 ec2_DeleteKeyPair:
@@ -1183,6 +1293,15 @@ ec2_DeleteKeyPair:
                 - ec2.rust.delete_key.wrapper
             - snippet_tags:
                 - ec2.rust.delete_key.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.DeleteKeyPair
   services:
     ec2: {DeleteKeyPair}
 ec2_DescribeSecurityGroups:
@@ -1269,6 +1388,19 @@ ec2_DescribeSecurityGroups:
           excerpts:
             - snippet_tags:
                 - ec2.rust.ec2-helloworld
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description: Using pagination with <code>describeSecurityGroupsPaginated()</code>.
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.DescribeSecurityGroupsPaginated
+            - description: Without pagination.
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.DescribeSecurityGroups
   services:
     ec2: {DescribeSecurityGroups}
 ec2_DeleteSecurityGroup:
@@ -1355,6 +1487,15 @@ ec2_DeleteSecurityGroup:
           excerpts:
             - snippet_tags:
                 - ec2.rust.delete_security_group.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.DeleteSecurityGroup
   services:
     ec2: {DeleteSecurityGroup}
 ec2_DeleteSnapshot:
@@ -1473,6 +1614,15 @@ ec2_TerminateInstances:
             - description: Wait for an instance to be in the terminted state, using the Waiters API. Using the Waiters API requires `use aws_sdk_ec2::client::Waiters` in the rust file.
               snippet_tags:
                 - ec2.rust.wait_for_instance_terminated.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.TerminateInstances
   services:
     ec2: {TerminateInstances}
 ec2_DescribeInstances:
@@ -1807,6 +1957,15 @@ ec2_DescribeImages:
               snippet_tags:
                 - aws-cli.bash-linux.ec2.errecho
                 - aws-cli.bash-linux.ec2.aws_cli_error_log
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.DescribeImages
   services:
     ec2: {DescribeImages}
 ec2_DescribeInstanceTypes:
@@ -1877,6 +2036,15 @@ ec2_DescribeInstanceTypes:
           excerpts:
             - snippet_tags:
                 - ec2.rust.list_instance_types.impl
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description:
+              snippet_tags:
+                - swift.ec2.import
+                - swift.ec2.DescribeInstanceTypes
   services:
     ec2: {DescribeInstanceTypes}
 ec2_DescribeAddresses:
@@ -2419,6 +2587,17 @@ ec2_Scenario_GetStartedInstances:
             - description: The main entry point for the scenario.
               snippet_files:
                 - rustv1/examples/ec2/src/bin/getting-started.rs
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/ec2
+          excerpts:
+            - description: The <filename>Package.swift</filename> file.
+              snippet_tags:
+                - swift.ec2.scenario.package
+            - description: The <filename>entry.swift</filename> file.
+              snippet_tags:
+                - swift.ec2.scenario
   services:
     ec2:
       {