feat(maintenance): generate library (#15832)

Author: scotthart

CHANGELOG.md

@@ -6,6 +6,13 @@ breaking changes in the upcoming 3.x release. This release is scheduled for
 
 ## v2.45.0 - TBD
 
+### New Libraries
+
+We are happy to announce the following GA libraries. Unless specifically noted,
+the APIs in these libraries are stable, and are ready for production use.
+
+- [Cloud Maintenance API](/google/cloud/maintenance/README.md)
+
 ## v2.44.0 - 2025-12
 
 ### [BigQueryControl](google/cloud/bigquerycontrol/README.md)

README.md

@@ -326,6 +326,9 @@ See each library's `README.md` file for more information about:
 - [Google Cloud Managed Lustre API](google/cloud/lustre/README.md)
   [[quickstart]](google/cloud/lustre/quickstart/README.md)
   [[reference]](https://cloud.google.com/cpp/docs/reference/lustre/latest)
+- [Maintenance API](google/cloud/maintenance/README.md)
+  [[quickstart]](google/cloud/maintenance/quickstart/README.md)
+  [[reference]](https://cloud.google.com/cpp/docs/reference/maintenance/latest)
 - [Managed Service for Microsoft Active Directory API](google/cloud/managedidentities/README.md)
   [[quickstart]](google/cloud/managedidentities/quickstart/README.md)
   [[reference]](https://cloud.google.com/cpp/docs/reference/managedidentities/latest)

ci/abi-dumps/google_cloud_cpp_maintenance.expected.abi.dump.gz

@@ -881,6 +881,11 @@
 ./include/google/cloud/lustre/v1
 ./include/google/cloud/lustre/v1/internal
 ./include/google/cloud/lustre/v1/mocks
+./include/google/cloud/maintenance
+./include/google/cloud/maintenance/api
+./include/google/cloud/maintenance/api/v1
+./include/google/cloud/maintenance/api/v1/internal
+./include/google/cloud/maintenance/api/v1/mocks
 ./include/google/cloud/managedidentities
 ./include/google/cloud/managedidentities/mocks
 ./include/google/cloud/managedidentities/v1
@@ -1491,6 +1496,8 @@
 ./lib64/cmake/google_cloud_cpp_logging_mocks
 ./lib64/cmake/google_cloud_cpp_lustre
 ./lib64/cmake/google_cloud_cpp_lustre_mocks
+./lib64/cmake/google_cloud_cpp_maintenance
+./lib64/cmake/google_cloud_cpp_maintenance_mocks
 ./lib64/cmake/google_cloud_cpp_managedidentities
 ./lib64/cmake/google_cloud_cpp_managedidentities_mocks
 ./lib64/cmake/google_cloud_cpp_managedkafka

ci/etc/expected_install_directories

@@ -118,6 +118,7 @@ set(GOOGLE_CLOUD_CPP_GA_LIBRARIES
     "licensemanager"
     "logging"
     "lustre"
+    "maintenance"
     "managedidentities"
     "managedkafka"
     "memcache"

cmake/GoogleCloudCppFeatures.cmake

@@ -0,0 +1,7 @@
+@com_google_googleapis//google/api:annotations_proto
+@com_google_googleapis//google/api:client_proto
+@com_google_googleapis//google/api:field_behavior_proto
+@com_google_googleapis//google/api:field_info_proto
+@com_google_googleapis//google/api:http_proto
+@com_google_googleapis//google/api:launch_stage_proto
+@com_google_googleapis//google/api:resource_proto

external/googleapis/protodeps/maintenance.deps

@@ -0,0 +1 @@
+@com_google_googleapis//google/cloud/maintenance/api/v1:maintenance_service.proto

external/googleapis/protolists/maintenance.list

@@ -193,6 +193,7 @@ declare -A -r LIBRARIES=(
   ["logging_type"]="@com_google_googleapis//google/logging/type:type_cc_grpc"
   ["logging"]="@com_google_googleapis//google/logging/v2:logging_cc_grpc"
   ["lustre"]="@com_google_googleapis//google/cloud/lustre/v1:lustre_cc_grpc"
+  ["maintenance"]="@com_google_googleapis//google/cloud/maintenance/api/v1:api_cc_grpc"
   ["managedidentities"]="@com_google_googleapis//google/cloud/managedidentities/v1:managedidentities_cc_grpc"
   ["managedkafka"]="$(
     printf ",%s" \

external/googleapis/update_libraries.sh

@@ -2884,6 +2884,14 @@ service {
   retryable_status_codes: ["kUnavailable"]
 }
 
+# Maintenance
+service {
+  service_proto_path: "google/cloud/maintenance/api/v1/maintenance_service.proto"
+  product_path: "google/cloud/maintenance/api/v1"
+  initial_copyright_year: "2025"
+  retryable_status_codes: ["kUnavailable"]
+}
+
 # Managed Microsoft Active Directory (Managed Microsoft AD or Managed Identities)
 service {
   service_proto_path: "google/cloud/managedidentities/v1/managed_identities_service.proto"

generator/generator_config.textproto

@@ -0,0 +1,31 @@
+# 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
+#
+#     https://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.
+
+load("//bazel:gapic.bzl", "cc_gapic_library")
+
+package(default_visibility = ["//visibility:private"])
+
+licenses(["notice"])  # Apache 2.0
+
+service_dirs = ["api/v1/"]
+
+googleapis_deps = [
+    "@com_google_googleapis//google/cloud/maintenance/api/v1:api_cc_grpc",
+]
+
+cc_gapic_library(
+    name = "maintenance",
+    googleapis_deps = googleapis_deps,
+    service_dirs = service_dirs,
+)