Add SSM Java examples to the Code Lib (#5185)

add SSM Java examples to Code Lib

.doc_gen/metadata/ssm_metadata.yaml

@@ -5,6 +5,15 @@ ssm_DescribeParameters:
   synopsis: get &SYS; parameters information.
   category:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ssm
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ssm.Java2.get_para_value.main
     Rust:
       versions:
         - sdk_version: 1
@@ -21,6 +30,15 @@ ssm_PutParameter:
   synopsis: add a &SYS; parameter.
   category:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ssm
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ssm.Java2.put_para_value.main
     Rust:
       versions:
         - sdk_version: 1
@@ -31,3 +49,54 @@ ssm_PutParameter:
                 - ssm.rust.create-parameter
   services:
     ssm: {PutParameter}
+ssm_CreateOpsItem:
+  title: Create a new OpsItem using an &AWS; SDK
+  title_abbrev: Create a new OpsItem
+  synopsis: create a new OpsItem.
+  category:
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ssm
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ssm.java2.create_ops.main
+  services:
+    ssm: {CreateOpsItem} 
+ssm_DescribeOpsItems:
+  title: Describe an OpsItem using an &AWS; SDK
+  title_abbrev: Describe an OpsItem
+  synopsis: describe an OpsItem.
+  category:
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ssm
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ssm.java2.describe_ops.main
+  services:
+    ssm: {DescribeOpsItems}
+ssm_UpdateOpsItem:
+  title: Updates an OpsItem using an &AWS; SDK
+  title_abbrev: Updates an OpsItem
+  synopsis: updates an OpsItem.
+  category:
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ssm
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ssm.Java2.resolve_ops.main
+  services:
+    ssm: {UpdateOpsItem}                 

javav2/example_code/ssm/src/main/java/com/example/ssm/PutParameter.java

@@ -0,0 +1,67 @@
+// snippet-comment:[These are tags for the AWS doc team's sample catalog. Do not remove.]
+// snippet-sourcedescription:[PutParameter.java demonstrates how to add a parameter to the system.]
+// snippet-keyword:[AWS SDK for Java v2]
+// snippet-keyword:[Amazon Simple Systems Management]
+
+/*
+   Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+   SPDX-License-Identifier: Apache-2.0
+*/
+
+package com.example.ssm;
+
+import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
+import software.amazon.awssdk.regions.Region;
+import software.amazon.awssdk.services.ssm.SsmClient;
+import software.amazon.awssdk.services.ssm.model.ParameterType;
+import software.amazon.awssdk.services.ssm.model.PutParameterRequest;
+import software.amazon.awssdk.services.ssm.model.PutParameterResponse;
+import software.amazon.awssdk.services.ssm.model.SsmException;
+
+public class PutParameter {
+
+    public static void main(String[] args) {
+
+        final String usage = "\n" +
+            "Usage:\n" +
+            "    <paraName>\n\n" +
+            "Where:\n" +
+            "    paraName - The name of the parameter.\n" +
+            "    paraValue - The value of the parameter.\n" ;
+
+        if (args.length != 2) {
+            System.out.println(usage);
+            System.exit(1);
+        }
+
+        String paraName = args[0];
+        String paraValue = args[1];
+        Region region = Region.US_EAST_1;
+        SsmClient ssmClient = SsmClient.builder()
+            .region(region)
+            .credentialsProvider(ProfileCredentialsProvider.create())
+            .build();
+
+        putParaValue(ssmClient, paraName, paraValue);
+        ssmClient.close();
+    }
+
+    // snippet-start:[ssm.Java2.put_para_value.main]
+    public static void putParaValue(SsmClient ssmClient, String paraName, String value) {
+        try {
+             PutParameterRequest parameterRequest = PutParameterRequest.builder()
+                 .name(paraName)
+                 .type(ParameterType.STRING)
+                 .value(value)
+                 .build();
+
+             ssmClient.putParameter(parameterRequest);
+             System.out.println("The parameter was successfully added.");
+
+        } catch (SsmException e) {
+            System.err.println(e.getMessage());
+            System.exit(1);
+        }
+    }
+    // snippet-end:[ssm.Java2.put_para_value.main]
+}