Java V2 Add examples for Control Tower (#7668)

Author: scmacdon

.doc_gen/metadata/controltower_metadata.yaml

@@ -4,6 +4,15 @@ controltower_Hello:
   synopsis: get started using &CTower;.
   category: Hello
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.hello.main
     Python:
       versions:
         - sdk_version: 3
@@ -25,6 +34,15 @@ controltower_Hello:
 
 controltower_ListBaselines:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.list_baselines.main
     Python:
       versions:
         - sdk_version: 3
@@ -47,6 +65,15 @@ controltower_ListBaselines:
 
 controltower_ListEnabledBaselines:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.list_enabled_baselines.main
     Python:
       versions:
         - sdk_version: 3
@@ -69,6 +96,15 @@ controltower_ListEnabledBaselines:
 
 controltower_EnableBaseline:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.enable_baseline.main
     Python:
       versions:
         - sdk_version: 3
@@ -91,6 +127,15 @@ controltower_EnableBaseline:
 
 controltower_ResetEnabledBaseline:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.reset_enabled_baseline.main
     Python:
       versions:
         - sdk_version: 3
@@ -113,6 +158,15 @@ controltower_ResetEnabledBaseline:
 
 controltower_DisableBaseline:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.disable_baseline.main
     Python:
       versions:
         - sdk_version: 3
@@ -135,6 +189,15 @@ controltower_DisableBaseline:
 
 controltower_ListEnabledControls:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.list_enabled_controls.main
     Python:
       versions:
         - sdk_version: 3
@@ -157,6 +220,15 @@ controltower_ListEnabledControls:
 
 controltower_EnableControl:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.enable_control.main
     Python:
       versions:
         - sdk_version: 3
@@ -179,6 +251,15 @@ controltower_EnableControl:
 
 controltower_GetControlOperation:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.get_control_operation.main
     Python:
       versions:
         - sdk_version: 3
@@ -201,6 +282,15 @@ controltower_GetControlOperation:
 
 controltower_DisableControl:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.disable_control.main
     Python:
       versions:
         - sdk_version: 3
@@ -223,6 +313,15 @@ controltower_DisableControl:
 
 controltower_ListLandingZones:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.list_landing_zones.main
     Python:
       versions:
         - sdk_version: 3
@@ -245,6 +344,15 @@ controltower_ListLandingZones:
 
 controltower_GetBaselineOperation:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - controltower.java2.get_baseline_operation.main
     Python:
       versions:
         - sdk_version: 3
@@ -272,6 +380,16 @@ controltower_Scenario:
     - List, enable, get, and disable controls.
   category: Basics
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/controltower
+          sdkguide:
+          excerpts:
+            - description: Run an interactive scenario demonstrating &CTowerlong; features.
+              snippet_tags:
+                - controltower.java2.controltower_scenario.main
+                - controltower.java2.controltower_actions.main
     Python:
       versions:
         - sdk_version: 3

javav2/example_code/controltower/README.md

@@ -0,0 +1,119 @@
+# AWS Control Tower code examples for the SDK for Java 2.x
+
+## Overview
+
+Shows how to use the AWS SDK for Java 2.x to work with AWS Control Tower.
+
+<!--custom.overview.start-->
+<!--custom.overview.end-->
+
+_AWS Control Tower enables you to enforce and manage governance rules for security, operations, and compliance at scale across all your organizations and accounts._
+
+## ⚠ Important
+
+* Running this code might result in charges to your AWS account. For more details, see [AWS Pricing](https://aws.amazon.com/pricing/) and [Free Tier](https://aws.amazon.com/free/).
+* Running the tests might result in charges to your AWS account.
+* We recommend that you grant your code least privilege. At most, grant only the minimum permissions required to perform the task. For more information, see [Grant least privilege](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege).
+* This code is not tested in every AWS Region. For more information, see [AWS Regional Services](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services).
+
+<!--custom.important.start-->
+<!--custom.important.end-->
+
+## Code examples
+
+### Prerequisites
+
+For prerequisites, see the [README](../../README.md#Prerequisites) in the `javav2` folder.
+
+
+<!--custom.prerequisites.start-->
+<!--custom.prerequisites.end-->
+
+### Get started
+
+- [Hello AWS Control Tower](src/main/java/com/example/controltower/HelloControlTower.java#L27) (`ListBaselines`)
+
+
+### Basics
+
+Code examples that show you how to perform the essential operations within a service.
+
+- [Learn the basics](src/main/java/com/example/controltower/scenario/ControlTowerActions.java)
+
+
+### Single actions
+
+Code excerpts that show you how to call individual service functions.
+
+- [DisableBaseline](src/main/java/com/example/controltower/scenario/ControlTowerActions.java#L493)
+- [DisableControl](src/main/java/com/example/controltower/scenario/ControlTowerActions.java#L803)
+- [EnableBaseline](src/main/java/com/example/controltower/scenario/ControlTowerActions.java#L387)
+- [EnableControl](src/main/java/com/example/controltower/scenario/ControlTowerActions.java#L706)
+- [GetBaselineOperation](src/main/java/com/example/controltower/scenario/ControlTowerActions.java#L574)
+- [GetControlOperation](src/main/java/com/example/controltower/scenario/ControlTowerActions.java#L886)
+- [ListBaselines](src/main/java/com/example/controltower/scenario/ControlTowerActions.java#L257)
+- [ListEnabledBaselines](src/main/java/com/example/controltower/scenario/ControlTowerActions.java#L317)
+- [ListEnabledControls](src/main/java/com/example/controltower/scenario/ControlTowerActions.java#L638)
+- [ListLandingZones](src/main/java/com/example/controltower/scenario/ControlTowerActions.java#L204)
+- [ResetEnabledBaseline](src/main/java/com/example/controltower/scenario/ControlTowerActions.java#L986)
+
+
+<!--custom.examples.start-->
+<!--custom.examples.end-->
+
+## Run the examples
+
+### Instructions
+
+
+<!--custom.instructions.start-->
+<!--custom.instructions.end-->
+
+#### Hello AWS Control Tower
+
+This example shows you how to get started using AWS Control Tower.
+
+
+#### Learn the basics
+
+This example shows you how to do the following:
+
+- List landing zones.
+- List, enable, get, reset, and disable baselines.
+- List, enable, get, and disable controls.
+
+<!--custom.basic_prereqs.controltower_Scenario.start-->
+<!--custom.basic_prereqs.controltower_Scenario.end-->
+
+
+<!--custom.basics.controltower_Scenario.start-->
+<!--custom.basics.controltower_Scenario.end-->
+
+
+### Tests
+
+⚠ Running tests might result in charges to your AWS account.
+
+
+To find instructions for running these tests, see the [README](../../README.md#Tests)
+in the `javav2` folder.
+
+
+
+<!--custom.tests.start-->
+<!--custom.tests.end-->
+
+## Additional resources
+
+- [AWS Control Tower User Guide](https://docs.aws.amazon.com/controltower/latest/userguide/what-is-control-tower.html)
+- [AWS Control Tower API Reference](https://docs.aws.amazon.com/controltower/latest/APIReference/Welcome.html)
+- [SDK for Java 2.x AWS Control Tower reference](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/controltower/package-summary.html)
+
+<!--custom.resources.start-->
+<!--custom.resources.end-->
+
+---
+
+Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+SPDX-License-Identifier: Apache-2.0