// Copyright 2023 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_instances.proto

#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_SQL_V1_SQL_INSTANCES_CLIENT_H

#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_SQL_V1_SQL_INSTANCES_CLIENT_H

#include "google/cloud/sql/v1/sql_instances_rest_connection.h"

#include "google/cloud/future.h"

#include "google/cloud/options.h"

#include "google/cloud/polling_policy.h"

#include "google/cloud/status_or.h"

#include "google/cloud/version.h"

#include <map>

#include <memory>

#include <string>

namespace google {

namespace cloud {

namespace sql_v1 {

GOOGLE_CLOUD_CPP_INLINE_NAMESPACE_BEGIN

///

/// SqlInstancesServiceClient

///

/// @par Equality

///

/// Instances of this class created via copy-construction or copy-assignment

/// always compare equal. Instances created with equal

/// `std::shared_ptr<*Connection>` objects compare equal. Objects that compare

/// equal share the same underlying resources.

///

/// @par Performance

///

/// Creating a new instance of this class is a relatively expensive operation,

/// new objects establish new connections to the service. In contrast,

/// copy-construction, move-construction, and the corresponding assignment

/// operations are relatively efficient as the copies share all underlying

/// resources.

///

/// @par Thread Safety

///

/// Concurrent access to different instances of this class, even if they compare

/// equal, is guaranteed to work. Two or more threads operating on the same

/// instance of this class is not guaranteed to work. Since copy-construction

/// and move-construction is a relatively efficient operation, consider using

/// such a copy when using this class from multiple threads.

///

class SqlInstancesServiceClient {

public:

explicit SqlInstancesServiceClient(

std::shared_ptr<SqlInstancesServiceConnection> connection,

Options opts = {});

~SqlInstancesServiceClient();

///@{

/// @name Copy and move support

SqlInstancesServiceClient(SqlInstancesServiceClient const&) = default;

SqlInstancesServiceClient& operator=(SqlInstancesServiceClient const&) =

default;

SqlInstancesServiceClient(SqlInstancesServiceClient&&) = default;

SqlInstancesServiceClient& operator=(SqlInstancesServiceClient&&) = default;

///@}

///@{

/// @name Equality

friend bool operator==(SqlInstancesServiceClient const& a,

SqlInstancesServiceClient const& b) {

return a.connection_ == b.connection_;

}

friend bool operator!=(SqlInstancesServiceClient const& a,

SqlInstancesServiceClient const& b) {

return !(a == b);

}

///@}

// clang-format off

///

/// Adds a new trusted Certificate Authority (CA) version for the specified

/// instance. Required to prepare for a certificate rotation. If a CA version

/// was previously added but never used in a certificate rotation, this

/// operation replaces that version. There cannot be more than one CA version

/// waiting to be rotated in. For instances that have enabled Certificate

/// Authority Service (CAS) based server CA, use AddServerCertificate to add a

/// new server certificate.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesAddServerCaRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesAddServerCaRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L452}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> AddServerCa(

google::cloud::sql::v1::SqlInstancesAddServerCaRequest const& request,

Options opts = {});

// clang-format off

///

/// Add a new trusted server certificate version for the specified instance

/// using Certificate Authority Service (CAS) server CA. Required to prepare

/// for a certificate rotation. If a server certificate version was previously

/// added but never used in a certificate rotation, this operation replaces

/// that version. There cannot be more than one certificate version waiting to

/// be rotated in. For instances not using CAS server CA, use AddServerCa

/// instead.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesAddServerCertificateRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesAddServerCertificateRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L461}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> AddServerCertificate(

google::cloud::sql::v1::SqlInstancesAddServerCertificateRequest const&

request,

Options opts = {});

// clang-format off

///

/// Adds a new Entra ID certificate for the specified instance. If an Entra ID

/// certificate was previously added but never used in a certificate rotation,

/// this operation replaces that version.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesAddEntraIdCertificateRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesAddEntraIdCertificateRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L470}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> AddEntraIdCertificate(

google::cloud::sql::v1::SqlInstancesAddEntraIdCertificateRequest const&

request,

Options opts = {});

// clang-format off

///

/// Creates a Cloud SQL instance as a clone of the source instance. Using this

/// operation might cause your instance to restart.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesCloneRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesCloneRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L479}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> Clone(

google::cloud::sql::v1::SqlInstancesCloneRequest const& request,

Options opts = {});

// clang-format off

///

/// Deletes a Cloud SQL instance.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesDeleteRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesDeleteRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L491}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> Delete(

google::cloud::sql::v1::SqlInstancesDeleteRequest const& request,

Options opts = {});

// clang-format off

///

/// Demotes the stand-alone instance to be a Cloud SQL read replica for an

/// external database server.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesDemoteMasterRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesDemoteMasterRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L516}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> DemoteMaster(

google::cloud::sql::v1::SqlInstancesDemoteMasterRequest const& request,

Options opts = {});

// clang-format off

///

/// Demotes an existing standalone instance to be a Cloud SQL read replica

/// for an external database server.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesDemoteRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesDemoteRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L527}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> Demote(

google::cloud::sql::v1::SqlInstancesDemoteRequest const& request,

Options opts = {});

// clang-format off

///

/// Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL

/// dump or CSV file.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesExportRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesExportRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L539}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> Export(

google::cloud::sql::v1::SqlInstancesExportRequest const& request,

Options opts = {});

// clang-format off

///

/// Initiates a manual failover of a high availability (HA) primary instance

/// to a standby instance, which becomes the primary instance. Users are

/// then rerouted to the new primary. For more information, see the

/// [Overview of high

/// availability](https://cloud.google.com/sql/docs/mysql/high-availability)

/// page in the Cloud SQL documentation.

/// If using Legacy HA (MySQL only), this causes the instance to failover to

/// its failover replica instance.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesFailoverRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesFailoverRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L550}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> Failover(

google::cloud::sql::v1::SqlInstancesFailoverRequest const& request,

Options opts = {});

// clang-format off

///

/// Reencrypt CMEK instance with latest key version.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesReencryptRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesReencryptRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L833}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> Reencrypt(

google::cloud::sql::v1::SqlInstancesReencryptRequest const& request,

Options opts = {});

// clang-format off

///

/// Retrieves a resource containing information about a Cloud SQL instance.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesGetRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.DatabaseInstance])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.DatabaseInstance]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L1384}

/// [google.cloud.sql.v1.SqlInstancesGetRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L561}

///

// clang-format on

StatusOr<google::cloud::sql::v1::DatabaseInstance> Get(

google::cloud::sql::v1::SqlInstancesGetRequest const& request,

Options opts = {});

// clang-format off

///

/// Imports data into a Cloud SQL instance from a SQL dump or CSV file in

/// Cloud Storage.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesImportRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesImportRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L570}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> Import(

google::cloud::sql::v1::SqlInstancesImportRequest const& request,

Options opts = {});

// clang-format off

///

/// Creates a new Cloud SQL instance.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesInsertRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesInsertRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L581}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> Insert(

google::cloud::sql::v1::SqlInstancesInsertRequest const& request,

Options opts = {});

// clang-format off

///

/// Lists instances under a given project.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesListRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return a [StreamRange](@ref google::cloud::StreamRange)

/// to iterate of the results. See the documentation of this type for

/// details. In brief, this class has `begin()` and `end()` member

/// functions returning a iterator class meeting the

/// [input iterator requirements]. The value type for this iterator is a

/// [`StatusOr`] as the iteration may fail even after some values are

/// retrieved successfully, for example, if there is a network disconnect.

/// An empty set of results does not indicate an error, it indicates

/// that there are no resources meeting the request criteria.

/// On a successful iteration the `StatusOr<T>` contains elements of type

/// [google.cloud.sql.v1.DatabaseInstance], or rather,

/// the C++ class generated by Protobuf from that type. Please consult the

/// Protobuf documentation for details on the [Protobuf mapping rules].

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.DatabaseInstance]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L1384}

/// [google.cloud.sql.v1.SqlInstancesListRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L590}

///

// clang-format on

StreamRange<google::cloud::sql::v1::DatabaseInstance> List(

google::cloud::sql::v1::SqlInstancesListRequest request,

Options opts = {});

// clang-format off

///

/// Lists all of the trusted Certificate Authorities (CAs) for the specified

/// instance. There can be up to three CAs listed: the CA that was used to sign

/// the certificate that is currently in use, a CA that has been added but not

/// yet used to sign a certificate, and a CA used to sign a certificate that

/// has previously rotated out.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesListServerCasRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.InstancesListServerCasResponse])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.InstancesListServerCasResponse]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L1094}

/// [google.cloud.sql.v1.SqlInstancesListServerCasRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L617}

///

// clang-format on

StatusOr<google::cloud::sql::v1::InstancesListServerCasResponse>

ListServerCas(

google::cloud::sql::v1::SqlInstancesListServerCasRequest const& request,

Options opts = {});

// clang-format off

///

/// Lists all versions of server certificates and certificate authorities (CAs)

/// for the specified instance. There can be up to three sets of certs listed:

/// the certificate that is currently in use, a future that has been added but

/// not yet used to sign a certificate, and a certificate that has been rotated

/// out. For instances not using Certificate Authority Service (CAS) server CA,

/// use ListServerCas instead.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesListServerCertificatesRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.InstancesListServerCertificatesResponse])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.InstancesListServerCertificatesResponse]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L1105}

/// [google.cloud.sql.v1.SqlInstancesListServerCertificatesRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L626}

///

// clang-format on

StatusOr<google::cloud::sql::v1::InstancesListServerCertificatesResponse>

ListServerCertificates(

google::cloud::sql::v1::SqlInstancesListServerCertificatesRequest const&

request,

Options opts = {});

// clang-format off

///

/// Lists all versions of EntraID certificates for the specified instance.

/// There can be up to three sets of certificates listed: the certificate that

/// is currently in use, a future that has been added but not yet used to sign

/// a certificate, and a certificate that has been rotated out.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesListEntraIdCertificatesRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.InstancesListEntraIdCertificatesResponse])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.InstancesListEntraIdCertificatesResponse]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L1121}

/// [google.cloud.sql.v1.SqlInstancesListEntraIdCertificatesRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L635}

///

// clang-format on

StatusOr<google::cloud::sql::v1::InstancesListEntraIdCertificatesResponse>

ListEntraIdCertificates(

google::cloud::sql::v1::SqlInstancesListEntraIdCertificatesRequest const&

request,

Options opts = {});

// clang-format off

///

/// Partially updates settings of a Cloud SQL instance by merging the request

/// with the current configuration. This method supports patch semantics.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesPatchRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesPatchRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L644}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> Patch(

google::cloud::sql::v1::SqlInstancesPatchRequest const& request,

Options opts = {});

// clang-format off

///

/// Promotes the read replica instance to be an independent Cloud SQL

/// primary instance.

/// Using this operation might cause your instance to restart.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesPromoteReplicaRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesPromoteReplicaRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L655}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> PromoteReplica(

google::cloud::sql::v1::SqlInstancesPromoteReplicaRequest const& request,

Options opts = {});

// clang-format off

///

/// Switches over from the primary instance to the DR replica

/// instance.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesSwitchoverRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesSwitchoverRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L672}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> Switchover(

google::cloud::sql::v1::SqlInstancesSwitchoverRequest const& request,

Options opts = {});

// clang-format off

///

/// Deletes all client certificates and generates a new server SSL certificate

/// for the instance.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesResetSslConfigRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesResetSslConfigRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L687}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> ResetSslConfig(

google::cloud::sql::v1::SqlInstancesResetSslConfigRequest const& request,

Options opts = {});

// clang-format off

///

/// Restarts a Cloud SQL instance.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesRestartRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesRestartRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L713}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> Restart(

google::cloud::sql::v1::SqlInstancesRestartRequest const& request,

Options opts = {});

// clang-format off

///

/// Restores a backup of a Cloud SQL instance. Using this operation might cause

/// your instance to restart.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesRestoreBackupRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesRestoreBackupRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L722}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> RestoreBackup(

google::cloud::sql::v1::SqlInstancesRestoreBackupRequest const& request,

Options opts = {});

// clang-format off

///

/// Rotates the server certificate to one signed by the Certificate Authority

/// (CA) version previously added with the addServerCA method. For instances

/// that have enabled Certificate Authority Service (CAS) based server CA,

/// use RotateServerCertificate to rotate the server certificate.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesRotateServerCaRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesRotateServerCaRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L733}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> RotateServerCa(

google::cloud::sql::v1::SqlInstancesRotateServerCaRequest const& request,

Options opts = {});

// clang-format off

///

/// Rotates the server certificate version to one previously added with the

/// addServerCertificate method. For instances not using Certificate Authority

/// Service (CAS) server CA, use RotateServerCa instead.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesRotateServerCertificateRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesRotateServerCertificateRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L744}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> RotateServerCertificate(

google::cloud::sql::v1::SqlInstancesRotateServerCertificateRequest const&

request,

Options opts = {});

// clang-format off

///

/// Rotates the server certificate version to one previously added with the

/// addEntraIdCertificate method.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesRotateEntraIdCertificateRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesRotateEntraIdCertificateRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L757}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> RotateEntraIdCertificate(

google::cloud::sql::v1::SqlInstancesRotateEntraIdCertificateRequest const&

request,

Options opts = {});

// clang-format off

///

/// Starts the replication in the read replica instance.

///

/// @param request Unary RPCs, such as the one wrapped by this

/// function, receive a single `request` proto message which includes all

/// the inputs for the RPC. In this case, the proto message is a

/// [google.cloud.sql.v1.SqlInstancesStartReplicaRequest].

/// Proto messages are converted to C++ classes by Protobuf, using the

/// [Protobuf mapping rules].

/// @param opts Optional. Override the class-level options, such as retry and

/// backoff policies.

/// @return the result of the RPC. The response message type

/// ([google.cloud.sql.v1.Operation])

/// is mapped to a C++ class using the [Protobuf mapping rules].

/// If the request fails, the [`StatusOr`] contains the error details.

///

/// [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/

/// [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator

/// [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string

/// [`future`]: @ref google::cloud::future

/// [`StatusOr`]: @ref google::cloud::StatusOr

/// [`Status`]: @ref google::cloud::Status

/// [google.cloud.sql.v1.Operation]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_resources.proto#L1170}

/// [google.cloud.sql.v1.SqlInstancesStartReplicaRequest]: @googleapis_reference_link{google/cloud/sql/v1/cloud_sql_instances.proto#L770}

///

// clang-format on

StatusOr<google::cloud::sql::v1::Operation> StartReplica(

google::cloud::sql::v1::SqlInstancesStartReplicaRequest const& request,

Options opts = {});

// clang-format off

///

/// Stops the replication in the read replica instance.

///

/// @param request Unary RPCs, such as the one wrapped by this