Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,9 @@ for details on updating existing applications using v1.x.y or v2.x.y.
### [Cloud Quotas API](/google/cloud/cloudquotas/README.md)
- The library has been expanded to include the QuotaAdjusterSettingsManager service.

### [Cloud Sql Admin API](/google/cloud/sql/README.md)
- The library has been expanded to include the Backups and FeatureEligibility services.

## v3.7.0 - 2026-07

### Removed Libraries
Expand Down
Binary file modified ci/abi-dumps/google_cloud_cpp_sql.expected.abi.dump.gz
Binary file not shown.
20 changes: 20 additions & 0 deletions generator/generator_config.textproto
Original file line number Diff line number Diff line change
Expand Up @@ -3780,6 +3780,16 @@ service {
preserve_proto_field_names_in_json: true
}

service {
service_proto_path: "google/cloud/sql/v1/cloud_sql_backups.proto"
product_path: "google/cloud/sql/v1"
initial_copyright_year: "2026"
retryable_status_codes: ["kUnavailable"]
generate_rest_transport: true
generate_grpc_transport: false
preserve_proto_field_names_in_json: true
}

service {
service_proto_path: "google/cloud/sql/v1/cloud_sql_connect.proto"
product_path: "google/cloud/sql/v1"
Expand Down Expand Up @@ -3810,6 +3820,16 @@ service {
preserve_proto_field_names_in_json: true
}

service {
service_proto_path: "google/cloud/sql/v1/cloud_sql_feature_eligibility.proto"
product_path: "google/cloud/sql/v1"
initial_copyright_year: "2026"
retryable_status_codes: ["kUnavailable"]
generate_rest_transport: true
generate_grpc_transport: false
preserve_proto_field_names_in_json: true
}

service {
service_proto_path: "google/cloud/sql/v1/cloud_sql_flags.proto"
product_path: "google/cloud/sql/v1"
Expand Down
8 changes: 8 additions & 0 deletions google/cloud/sql/doc/environment-variables.dox
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,10 @@ environment variables are convenient when troubleshooting problems.
`EndpointOption` (which defaults to "sqladmin.googleapis.com")
used by `MakeSqlAvailableDatabaseVersionsServiceConnection()`.

- `GOOGLE_CLOUD_CPP_SQL_BACKUPS_SERVICE_ENDPOINT=...` overrides the
`EndpointOption` (which defaults to "sqladmin.googleapis.com")
used by `MakeSqlBackupsServiceConnection()`.
Comment thread
scotthart marked this conversation as resolved.

- `GOOGLE_CLOUD_CPP_SQL_BACKUP_RUNS_SERVICE_ENDPOINT=...` overrides the
`EndpointOption` (which defaults to "sqladmin.googleapis.com")
used by `MakeSqlBackupRunsServiceConnection()`.
Expand All @@ -29,6 +33,10 @@ environment variables are convenient when troubleshooting problems.
`EndpointOption` (which defaults to "sqladmin.googleapis.com")
used by `MakeSqlEventsServiceConnection()`.

- `GOOGLE_CLOUD_CPP_SQL_FEATURE_ELIGIBILITY_SERVICE_ENDPOINT=...` overrides the
`EndpointOption` (which defaults to "sqladmin.googleapis.com")
used by `MakeSqlFeatureEligibilityServiceConnection()`.
Comment thread
scotthart marked this conversation as resolved.

- `GOOGLE_CLOUD_CPP_SQL_FLAGS_SERVICE_ENDPOINT=...` overrides the
`EndpointOption` (which defaults to "sqladmin.googleapis.com")
used by `MakeSqlFlagsServiceConnection()`.
Expand Down
2 changes: 2 additions & 0 deletions google/cloud/sql/doc/main.dox
Original file line number Diff line number Diff line change
Expand Up @@ -33,9 +33,11 @@ application.

- [\c sql_v1::SqlAvailableDatabaseVersionsServiceClient](@ref google::cloud::sql_v1::SqlAvailableDatabaseVersionsServiceClient)
- [\c sql_v1::SqlBackupRunsServiceClient](@ref google::cloud::sql_v1::SqlBackupRunsServiceClient)
- [\c sql_v1::SqlBackupsServiceClient](@ref google::cloud::sql_v1::SqlBackupsServiceClient)
- [\c sql_v1::SqlConnectServiceClient](@ref google::cloud::sql_v1::SqlConnectServiceClient)
- [\c sql_v1::SqlDatabasesServiceClient](@ref google::cloud::sql_v1::SqlDatabasesServiceClient)
- [\c sql_v1::SqlEventsServiceClient](@ref google::cloud::sql_v1::SqlEventsServiceClient)
- [\c sql_v1::SqlFeatureEligibilityServiceClient](@ref google::cloud::sql_v1::SqlFeatureEligibilityServiceClient)
- [\c sql_v1::SqlFlagsServiceClient](@ref google::cloud::sql_v1::SqlFlagsServiceClient)
- [\c sql_v1::SqlIamPoliciesServiceClient](@ref google::cloud::sql_v1::SqlIamPoliciesServiceClient)
- [\c sql_v1::SqlInstanceNamesServiceClient](@ref google::cloud::sql_v1::SqlInstanceNamesServiceClient)
Expand Down
14 changes: 14 additions & 0 deletions google/cloud/sql/doc/override-authentication.dox
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,11 @@ Follow these links to find examples for other \c *Client classes:

- [\c sql_v1::SqlAvailableDatabaseVersionsServiceClient](@ref sql_v1::SqlAvailableDatabaseVersionsServiceClient-service-account-snippet)
- [\c sql_v1::SqlBackupRunsServiceClient](@ref sql_v1::SqlBackupRunsServiceClient-service-account-snippet)
- [\c sql_v1::SqlBackupsServiceClient](@ref sql_v1::SqlBackupsServiceClient-service-account-snippet)
- [\c sql_v1::SqlConnectServiceClient](@ref sql_v1::SqlConnectServiceClient-service-account-snippet)
- [\c sql_v1::SqlDatabasesServiceClient](@ref sql_v1::SqlDatabasesServiceClient-service-account-snippet)
- [\c sql_v1::SqlEventsServiceClient](@ref sql_v1::SqlEventsServiceClient-service-account-snippet)
- [\c sql_v1::SqlFeatureEligibilityServiceClient](@ref sql_v1::SqlFeatureEligibilityServiceClient-service-account-snippet)
- [\c sql_v1::SqlFlagsServiceClient](@ref sql_v1::SqlFlagsServiceClient-service-account-snippet)
- [\c sql_v1::SqlIamPoliciesServiceClient](@ref sql_v1::SqlIamPoliciesServiceClient-service-account-snippet)
- [\c sql_v1::SqlInstanceNamesServiceClient](@ref sql_v1::SqlInstanceNamesServiceClient-service-account-snippet)
Expand Down Expand Up @@ -56,6 +58,12 @@ guide for more details.

*/

/*! @page sql_v1::SqlBackupsServiceClient-service-account-snippet Override sql_v1::SqlBackupsServiceClient Authentication Defaults

@snippet google/cloud/sql/v1/samples/sql_backups_client_samples.cc with-service-account

*/

/*! @page sql_v1::SqlConnectServiceClient-service-account-snippet Override sql_v1::SqlConnectServiceClient Authentication Defaults

@snippet google/cloud/sql/v1/samples/sql_connect_client_samples.cc with-service-account
Expand All @@ -74,6 +82,12 @@ guide for more details.

*/

/*! @page sql_v1::SqlFeatureEligibilityServiceClient-service-account-snippet Override sql_v1::SqlFeatureEligibilityServiceClient Authentication Defaults

@snippet google/cloud/sql/v1/samples/sql_feature_eligibility_client_samples.cc with-service-account

*/

/*! @page sql_v1::SqlFlagsServiceClient-service-account-snippet Override sql_v1::SqlFlagsServiceClient Authentication Defaults

@snippet google/cloud/sql/v1/samples/sql_flags_client_samples.cc with-service-account
Expand Down
14 changes: 14 additions & 0 deletions google/cloud/sql/doc/override-endpoint.dox
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,11 @@ Follow these links to find examples for other \c *Client classes:

- [\c sql_v1::SqlAvailableDatabaseVersionsServiceClient](@ref sql_v1::SqlAvailableDatabaseVersionsServiceClient-endpoint-snippet)
- [\c sql_v1::SqlBackupRunsServiceClient](@ref sql_v1::SqlBackupRunsServiceClient-endpoint-snippet)
- [\c sql_v1::SqlBackupsServiceClient](@ref sql_v1::SqlBackupsServiceClient-endpoint-snippet)
- [\c sql_v1::SqlConnectServiceClient](@ref sql_v1::SqlConnectServiceClient-endpoint-snippet)
- [\c sql_v1::SqlDatabasesServiceClient](@ref sql_v1::SqlDatabasesServiceClient-endpoint-snippet)
- [\c sql_v1::SqlEventsServiceClient](@ref sql_v1::SqlEventsServiceClient-endpoint-snippet)
- [\c sql_v1::SqlFeatureEligibilityServiceClient](@ref sql_v1::SqlFeatureEligibilityServiceClient-endpoint-snippet)
- [\c sql_v1::SqlFlagsServiceClient](@ref sql_v1::SqlFlagsServiceClient-endpoint-snippet)
- [\c sql_v1::SqlIamPoliciesServiceClient](@ref sql_v1::SqlIamPoliciesServiceClient-endpoint-snippet)
- [\c sql_v1::SqlInstanceNamesServiceClient](@ref sql_v1::SqlInstanceNamesServiceClient-endpoint-snippet)
Expand Down Expand Up @@ -46,6 +48,12 @@ Follow these links to find examples for other \c *Client classes:

*/

/*! @page sql_v1::SqlBackupsServiceClient-endpoint-snippet Override sql_v1::SqlBackupsServiceClient Endpoint Configuration

@snippet google/cloud/sql/v1/samples/sql_backups_client_samples.cc set-client-endpoint

*/

/*! @page sql_v1::SqlConnectServiceClient-endpoint-snippet Override sql_v1::SqlConnectServiceClient Endpoint Configuration

@snippet google/cloud/sql/v1/samples/sql_connect_client_samples.cc set-client-endpoint
Expand All @@ -64,6 +72,12 @@ Follow these links to find examples for other \c *Client classes:

*/

/*! @page sql_v1::SqlFeatureEligibilityServiceClient-endpoint-snippet Override sql_v1::SqlFeatureEligibilityServiceClient Endpoint Configuration

@snippet google/cloud/sql/v1/samples/sql_feature_eligibility_client_samples.cc set-client-endpoint

*/

/*! @page sql_v1::SqlFlagsServiceClient-endpoint-snippet Override sql_v1::SqlFlagsServiceClient Endpoint Configuration

@snippet google/cloud/sql/v1/samples/sql_flags_client_samples.cc set-client-endpoint
Expand Down
26 changes: 26 additions & 0 deletions google/cloud/sql/doc/override-retry-policies.dox
Original file line number Diff line number Diff line change
Expand Up @@ -80,9 +80,11 @@ Follow these links to find examples for other \c *Client classes:

- [\c sql_v1::SqlAvailableDatabaseVersionsServiceClient](@ref sql_v1::SqlAvailableDatabaseVersionsServiceClient-retry-snippet)
- [\c sql_v1::SqlBackupRunsServiceClient](@ref sql_v1::SqlBackupRunsServiceClient-retry-snippet)
- [\c sql_v1::SqlBackupsServiceClient](@ref sql_v1::SqlBackupsServiceClient-retry-snippet)
- [\c sql_v1::SqlConnectServiceClient](@ref sql_v1::SqlConnectServiceClient-retry-snippet)
- [\c sql_v1::SqlDatabasesServiceClient](@ref sql_v1::SqlDatabasesServiceClient-retry-snippet)
- [\c sql_v1::SqlEventsServiceClient](@ref sql_v1::SqlEventsServiceClient-retry-snippet)
- [\c sql_v1::SqlFeatureEligibilityServiceClient](@ref sql_v1::SqlFeatureEligibilityServiceClient-retry-snippet)
- [\c sql_v1::SqlFlagsServiceClient](@ref sql_v1::SqlFlagsServiceClient-retry-snippet)
- [\c sql_v1::SqlIamPoliciesServiceClient](@ref sql_v1::SqlIamPoliciesServiceClient-retry-snippet)
- [\c sql_v1::SqlInstanceNamesServiceClient](@ref sql_v1::SqlInstanceNamesServiceClient-retry-snippet)
Expand Down Expand Up @@ -131,6 +133,18 @@ Assuming you have created a custom idempotency policy. Such as:

*/

/*! @page sql_v1::SqlBackupsServiceClient-retry-snippet Override sql_v1::SqlBackupsServiceClient Retry Policies

This shows how to override the retry policies for sql_v1::SqlBackupsServiceClient:

@snippet google/cloud/sql/v1/samples/sql_backups_client_samples.cc set-retry-policy

Assuming you have created a custom idempotency policy. Such as:

@snippet google/cloud/sql/v1/samples/sql_backups_client_samples.cc custom-idempotency-policy

*/

/*! @page sql_v1::SqlConnectServiceClient-retry-snippet Override sql_v1::SqlConnectServiceClient Retry Policies

This shows how to override the retry policies for sql_v1::SqlConnectServiceClient:
Expand Down Expand Up @@ -167,6 +181,18 @@ Assuming you have created a custom idempotency policy. Such as:

*/

/*! @page sql_v1::SqlFeatureEligibilityServiceClient-retry-snippet Override sql_v1::SqlFeatureEligibilityServiceClient Retry Policies

This shows how to override the retry policies for sql_v1::SqlFeatureEligibilityServiceClient:

@snippet google/cloud/sql/v1/samples/sql_feature_eligibility_client_samples.cc set-retry-policy

Assuming you have created a custom idempotency policy. Such as:

@snippet google/cloud/sql/v1/samples/sql_feature_eligibility_client_samples.cc custom-idempotency-policy

*/

/*! @page sql_v1::SqlFlagsServiceClient-retry-snippet Override sql_v1::SqlFlagsServiceClient Retry Policies

This shows how to override the retry policies for sql_v1::SqlFlagsServiceClient:
Expand Down
14 changes: 14 additions & 0 deletions google/cloud/sql/doc/override-universe-domain.dox
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,11 @@ Follow these links to find examples for other \c *Client classes:

- [\c sql_v1::SqlAvailableDatabaseVersionsServiceClient](@ref sql_v1::SqlAvailableDatabaseVersionsServiceClient-universe-domain-snippet)
- [\c sql_v1::SqlBackupRunsServiceClient](@ref sql_v1::SqlBackupRunsServiceClient-universe-domain-snippet)
- [\c sql_v1::SqlBackupsServiceClient](@ref sql_v1::SqlBackupsServiceClient-universe-domain-snippet)
- [\c sql_v1::SqlConnectServiceClient](@ref sql_v1::SqlConnectServiceClient-universe-domain-snippet)
- [\c sql_v1::SqlDatabasesServiceClient](@ref sql_v1::SqlDatabasesServiceClient-universe-domain-snippet)
- [\c sql_v1::SqlEventsServiceClient](@ref sql_v1::SqlEventsServiceClient-universe-domain-snippet)
- [\c sql_v1::SqlFeatureEligibilityServiceClient](@ref sql_v1::SqlFeatureEligibilityServiceClient-universe-domain-snippet)
- [\c sql_v1::SqlFlagsServiceClient](@ref sql_v1::SqlFlagsServiceClient-universe-domain-snippet)
- [\c sql_v1::SqlIamPoliciesServiceClient](@ref sql_v1::SqlIamPoliciesServiceClient-universe-domain-snippet)
- [\c sql_v1::SqlInstanceNamesServiceClient](@ref sql_v1::SqlInstanceNamesServiceClient-universe-domain-snippet)
Expand Down Expand Up @@ -45,6 +47,12 @@ Follow these links to find examples for other \c *Client classes:

*/

/*! @page sql_v1::SqlBackupsServiceClient-universe-domain-snippet Override sql_v1::SqlBackupsServiceClient Universe Domain

@snippet google/cloud/sql/v1/samples/sql_backups_client_samples.cc set-client-universe-domain

*/

/*! @page sql_v1::SqlConnectServiceClient-universe-domain-snippet Override sql_v1::SqlConnectServiceClient Universe Domain

@snippet google/cloud/sql/v1/samples/sql_connect_client_samples.cc set-client-universe-domain
Expand All @@ -63,6 +71,12 @@ Follow these links to find examples for other \c *Client classes:

*/

/*! @page sql_v1::SqlFeatureEligibilityServiceClient-universe-domain-snippet Override sql_v1::SqlFeatureEligibilityServiceClient Universe Domain

@snippet google/cloud/sql/v1/samples/sql_feature_eligibility_client_samples.cc set-client-universe-domain

*/

/*! @page sql_v1::SqlFlagsServiceClient-universe-domain-snippet Override sql_v1::SqlFlagsServiceClient Universe Domain

@snippet google/cloud/sql/v1/samples/sql_flags_client_samples.cc set-client-universe-domain
Expand Down
67 changes: 67 additions & 0 deletions google/cloud/sql/v1/internal/sql_backups_option_defaults.cc
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
// Copyright 2026 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.

// Generated by the Codegen C++ plugin.
// If you make any local changes, they will be lost.
// source: google/cloud/sql/v1/cloud_sql_backups.proto

#include "google/cloud/sql/v1/internal/sql_backups_option_defaults.h"
#include "google/cloud/sql/v1/sql_backups_connection.h"
#include "google/cloud/sql/v1/sql_backups_options.h"
#include "google/cloud/internal/populate_common_options.h"
#include "google/cloud/internal/populate_grpc_options.h"
#include <memory>
#include <utility>

namespace google {
namespace cloud {
namespace sql_v1_internal {
GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN

namespace {
auto constexpr kBackoffScaling = 2.0;
} // namespace

Options SqlBackupsServiceDefaultOptions(Options options) {
options = internal::PopulateCommonOptions(
std::move(options), "GOOGLE_CLOUD_CPP_SQL_BACKUPS_SERVICE_ENDPOINT", "",
"GOOGLE_CLOUD_CPP_SQL_BACKUPS_SERVICE_AUTHORITY",
"sqladmin.googleapis.com");
options = internal::PopulateGrpcOptions(std::move(options));
if (!options.has<sql_v1::SqlBackupsServiceRetryPolicyOption>()) {
options.set<sql_v1::SqlBackupsServiceRetryPolicyOption>(
sql_v1::SqlBackupsServiceLimitedTimeRetryPolicy(
std::chrono::minutes(10))
.clone());
}
if (!options.has<sql_v1::SqlBackupsServiceBackoffPolicyOption>()) {
options.set<sql_v1::SqlBackupsServiceBackoffPolicyOption>(
ExponentialBackoffPolicy(
std::chrono::seconds(0), std::chrono::seconds(1),
std::chrono::minutes(5), kBackoffScaling, kBackoffScaling)
.clone());
}
if (!options
.has<sql_v1::SqlBackupsServiceConnectionIdempotencyPolicyOption>()) {
options.set<sql_v1::SqlBackupsServiceConnectionIdempotencyPolicyOption>(
sql_v1::MakeDefaultSqlBackupsServiceConnectionIdempotencyPolicy());
}

return options;
}

GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END
} // namespace sql_v1_internal
} // namespace cloud
} // namespace google
37 changes: 37 additions & 0 deletions google/cloud/sql/v1/internal/sql_backups_option_defaults.h
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
// Copyright 2026 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.

// Generated by the Codegen C++ plugin.
// If you make any local changes, they will be lost.
// source: google/cloud/sql/v1/cloud_sql_backups.proto

#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_SQL_V1_INTERNAL_SQL_BACKUPS_OPTION_DEFAULTS_H
#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_SQL_V1_INTERNAL_SQL_BACKUPS_OPTION_DEFAULTS_H

#include "google/cloud/options.h"
#include "google/cloud/version.h"

namespace google {
namespace cloud {
namespace sql_v1_internal {
GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN

Options SqlBackupsServiceDefaultOptions(Options options);

GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_END
} // namespace sql_v1_internal
} // namespace cloud
} // namespace google

#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_SQL_V1_INTERNAL_SQL_BACKUPS_OPTION_DEFAULTS_H
Loading
Loading