feat(parametermanager): Added samples for kms_key field in global parameter

parametermanager/src/main/java/parametermanager/CreateParamWithKmsKey.java

@@ -0,0 +1,66 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package parametermanager;
+
+// [START parametermanager_create_param_with_kms_key]
+
+import com.google.cloud.parametermanager.v1.LocationName;
+import com.google.cloud.parametermanager.v1.Parameter;
+import com.google.cloud.parametermanager.v1.ParameterManagerClient;
+import java.io.IOException;
+
+/**
+ * Example class to create a new parameter with provided KMS key
+ * using the Parameter Manager SDK for GCP.
+ */
+public class CreateParamWithKmsKey {
+
+  public static void main(String[] args) throws IOException {
+    // TODO(developer): Replace these variables before running the sample.
+    String projectId = "your-project-id";
+    String parameterId = "your-parameter-id";
+    String kmsKeyName = "your-kms-key";
+
+    // Call the method to create a parameter with the specified kms key.
+    createParameterWithKmsKey(projectId, parameterId, kmsKeyName);
+  }
+
+  // This is an example snippet for creating a new parameter with a specific format.
+  public static Parameter createParameterWithKmsKey(
+      String projectId, String parameterId, String kmsKeyName) throws IOException {
+    // Initialize the client that will be used to send requests.
+    try (ParameterManagerClient client = ParameterManagerClient.create()) {
+      String locationId = "global";
+
+      // Build the parent name from the project.
+      LocationName location = LocationName.of(projectId, locationId);
+
+      // Build the parameter to create with the provided format.
+      Parameter parameter = Parameter.newBuilder().setKmsKey(kmsKeyName).build();
+
+      // Create the parameter.
+      Parameter createdParameter =
+          client.createParameter(location.toString(), parameter, parameterId);
+      System.out.printf(
+          "Created parameter %s with kms key %s\n",
+          createdParameter.getName(), createdParameter.getKmsKey());
+
+      return createdParameter;
+    }
+  }
+}
+// [END parametermanager_create_param_with_kms_key]

parametermanager/src/main/java/parametermanager/RemoveParamKmsKey.java

@@ -0,0 +1,74 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package parametermanager;
+
+// [START parametermanager_remove_param_kms_key]
+
+import com.google.cloud.parametermanager.v1.Parameter;
+import com.google.cloud.parametermanager.v1.ParameterManagerClient;
+import com.google.cloud.parametermanager.v1.ParameterManagerSettings;
+import com.google.cloud.parametermanager.v1.ParameterName;
+import com.google.protobuf.FieldMask;
+import com.google.protobuf.util.FieldMaskUtil;
+import java.io.IOException;
+
+/**
+ * This class demonstrates how to change the kms key of a parameter
+ * using the Parameter Manager SDK for GCP.
+ */
+public class RemoveParamKmsKey {
+
+  public static void main(String[] args) throws IOException {
+    // TODO(developer): Replace these variables before running the sample.
+    String projectId = "your-project-id";
+    String parameterId = "your-parameter-id";
+
+    // Call the method to remove kms key of a parameter.
+    removeParamKmsKey(projectId, parameterId);
+  }
+
+  // This is an example snippet for updating the kms key of a parameter.
+  public static Parameter removeParamKmsKey(
+      String projectId, String parameterId) throws IOException {
+    // Initialize the client that will be used to send requests. This client only
+    // needs to be created once, and can be reused for multiple requests.
+    try (ParameterManagerClient client = ParameterManagerClient.create()) {
+      String locationId = "global";
+
+      // Build the parameter name.
+      ParameterName name = ParameterName.of(projectId, locationId, parameterId);
+
+      // Remove kms key of a parameter  .
+      Parameter parameter = Parameter.newBuilder()
+          .setName(name.toString())
+          .clearKmsKey()
+          .build();
+
+      // Build the field mask for the kms_key field.
+      FieldMask fieldMask = FieldMaskUtil.fromString("kms_key");
+
+      // Update the parameter kms key.
+      Parameter updatedParameter = client.updateParameter(parameter, fieldMask);
+      System.out.printf(
+          "Removed kms key for parameter %s\n",
+          updatedParameter.getName());
+
+      return updatedParameter;
+    }
+  }
+}
+// [END parametermanager_remove_param_kms_key]

parametermanager/src/main/java/parametermanager/UpdateParamKmsKey.java

@@ -0,0 +1,75 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package parametermanager;
+
+// [START parametermanager_update_param_kms_key]
+
+import com.google.cloud.parametermanager.v1.Parameter;
+import com.google.cloud.parametermanager.v1.ParameterManagerClient;
+import com.google.cloud.parametermanager.v1.ParameterManagerSettings;
+import com.google.cloud.parametermanager.v1.ParameterName;
+import com.google.protobuf.FieldMask;
+import com.google.protobuf.util.FieldMaskUtil;
+import java.io.IOException;
+
+/**
+ * This class demonstrates how to change the kms key of a parameter
+ * using theParameter Manager SDK for GCP.
+ */
+public class UpdateParamKmsKey {
+
+  public static void main(String[] args) throws IOException {
+    // TODO(developer): Replace these variables before running the sample.
+    String projectId = "your-project-id";
+    String parameterId = "your-parameter-id";
+    String kmsKeyName = "your-kms-key";
+
+    // Call the method to update kms key of a parameter.
+    updateParamKmsKey(projectId, parameterId, kmsKeyName);
+  }
+
+  // This is an example snippet for updating the kms key of a parameter.
+  public static Parameter updateParamKmsKey(
+      String projectId, String parameterId, String kmsKeyName) throws IOException {
+    // Initialize the client that will be used to send requests. This client only
+    // needs to be created once, and can be reused for multiple requests.
+    try (ParameterManagerClient client = ParameterManagerClient.create()) {
+      String locationId = "global";
+
+      // Build the parameter name.
+      ParameterName name = ParameterName.of(projectId, locationId, parameterId);
+
+      // Set the parameter kms key to update.
+      Parameter parameter = Parameter.newBuilder()
+          .setName(name.toString())
+          .setKmsKey(kmsKeyName)
+          .build();
+
+      // Build the field mask for the kms_key field.
+      FieldMask fieldMask = FieldMaskUtil.fromString("kms_key");
+
+      // Update the parameter kms key.
+      Parameter updatedParameter = client.updateParameter(parameter, fieldMask);
+      System.out.printf(
+          "Updated parameter %s with kms key %s\n",
+          updatedParameter.getName(), updatedParameter.getKmsKey());
+
+      return updatedParameter;
+    }
+  }
+}
+// [END parametermanager_update_param_kms_key]