Class SqlInstancesServiceClient (2.13.0)

Service to manage Cloud SQL instances.

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.

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.

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.

Constructors

SqlInstancesServiceClient(SqlInstancesServiceClient const &)

Copy and move support

Parameter
Name Description
SqlInstancesServiceClient const &

SqlInstancesServiceClient(SqlInstancesServiceClient &&)

Copy and move support

Parameter
Name Description
SqlInstancesServiceClient &&

SqlInstancesServiceClient(ExperimentalTag, std::shared_ptr< SqlInstancesServiceConnection >, Options)

Parameters
Name Description
ExperimentalTag
connection std::shared_ptr< SqlInstancesServiceConnection >
opts Options

Operators

operator=(SqlInstancesServiceClient const &)

Copy and move support

Parameter
Name Description
SqlInstancesServiceClient const &
Returns
Type Description
SqlInstancesServiceClient &

operator=(SqlInstancesServiceClient &&)

Copy and move support

Parameter
Name Description
SqlInstancesServiceClient &&
Returns
Type Description
SqlInstancesServiceClient &

Functions

AddServerCa(google::cloud::sql::v1::SqlInstancesAddServerCaRequest const &, Options)

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.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesAddServerCaRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

Clone(google::cloud::sql::v1::SqlInstancesCloneRequest const &, Options)

Creates a Cloud SQL instance as a clone of the source instance.

Using this operation might cause your instance to restart.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesCloneRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

Delete(google::cloud::sql::v1::SqlInstancesDeleteRequest const &, Options)

Deletes a Cloud SQL instance.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesDeleteRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

DemoteMaster(google::cloud::sql::v1::SqlInstancesDemoteMasterRequest const &, Options)

Demotes the stand-alone instance to be a Cloud SQL read replica for an external database server.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesDemoteMasterRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

Export(google::cloud::sql::v1::SqlInstancesExportRequest const &, Options)

Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump or CSV file.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesExportRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

Failover(google::cloud::sql::v1::SqlInstancesFailoverRequest const &, Options)

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 page in the Cloud SQL documentation. If using Legacy HA (MySQL only), this causes the instance to failover to its failover replica instance.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesFailoverRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

Get(google::cloud::sql::v1::SqlInstancesGetRequest const &, Options)

Retrieves a resource containing information about a Cloud SQL instance.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesGetRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::DatabaseInstance >

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.

Import(google::cloud::sql::v1::SqlInstancesImportRequest const &, Options)

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

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesImportRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

Insert(google::cloud::sql::v1::SqlInstancesInsertRequest const &, Options)

Creates a new Cloud SQL instance.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesInsertRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

List(google::cloud::sql::v1::SqlInstancesListRequest, Options)

Lists instances under a given project.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesListRequest

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StreamRange< google::cloud::sql::v1::DatabaseInstance >

a 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.

ListServerCas(google::cloud::sql::v1::SqlInstancesListServerCasRequest const &, Options)

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.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesListServerCasRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::InstancesListServerCasResponse >

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.

Patch(google::cloud::sql::v1::SqlInstancesPatchRequest const &, Options)

Updates settings of a Cloud SQL instance.

This method supports patch semantics.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesPatchRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

PromoteReplica(google::cloud::sql::v1::SqlInstancesPromoteReplicaRequest const &, Options)

Promotes the read replica instance to be a stand-alone Cloud SQL instance.

Using this operation might cause your instance to restart.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesPromoteReplicaRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

ResetSslConfig(google::cloud::sql::v1::SqlInstancesResetSslConfigRequest const &, Options)

Deletes all client certificates and generates a new server SSL certificate for the instance.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesResetSslConfigRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

Restart(google::cloud::sql::v1::SqlInstancesRestartRequest const &, Options)

Restarts a Cloud SQL instance.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesRestartRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

RestoreBackup(google::cloud::sql::v1::SqlInstancesRestoreBackupRequest const &, Options)

Restores a backup of a Cloud SQL instance.

Using this operation might cause your instance to restart.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesRestoreBackupRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

RotateServerCa(google::cloud::sql::v1::SqlInstancesRotateServerCaRequest const &, Options)

Rotates the server certificate to one signed by the Certificate Authority (CA) version previously added with the addServerCA method.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesRotateServerCaRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

StartReplica(google::cloud::sql::v1::SqlInstancesStartReplicaRequest const &, Options)

Starts the replication in the read replica instance.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesStartReplicaRequest const &

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.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

StopReplica(google::cloud::sql::v1::SqlInstancesStopReplicaRequest const &, Options)

Stops the replication in the read replica instance.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesStopReplicaRequest const &

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.SqlInstancesStopReplicaRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

TruncateLog(google::cloud::sql::v1::SqlInstancesTruncateLogRequest const &, Options)

Truncate MySQL general and slow query log tables MySQL only.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesTruncateLogRequest const &

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.SqlInstancesTruncateLogRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

Update(google::cloud::sql::v1::SqlInstancesUpdateRequest const &, Options)

Updates settings of a Cloud SQL instance.

Using this operation might cause your instance to restart.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesUpdateRequest const &

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.SqlInstancesUpdateRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

CreateEphemeral(google::cloud::sql::v1::SqlInstancesCreateEphemeralCertRequest const &, Options)

Generates a short-lived X509 certificate containing the provided public key and signed by a private key specific to the target instance.

Users may use the certificate to authenticate as themselves when connecting to the database.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesCreateEphemeralCertRequest const &

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.SqlInstancesCreateEphemeralCertRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::SslCert >

the result of the RPC. The response message type (google.cloud.sql.v1.SslCert) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

RescheduleMaintenance(google::cloud::sql::v1::SqlInstancesRescheduleMaintenanceRequest const &, Options)

Reschedules the maintenance on the given instance.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesRescheduleMaintenanceRequest const &

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.SqlInstancesRescheduleMaintenanceRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.

VerifyExternalSyncSettings(google::cloud::sql::v1::SqlInstancesVerifyExternalSyncSettingsRequest const &, Options)

Verify External primary instance external sync settings.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesVerifyExternalSyncSettingsRequest const &

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.SqlInstancesVerifyExternalSyncSettingsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::SqlInstancesVerifyExternalSyncSettingsResponse >

the result of the RPC. The response message type (google.cloud.sql.v1.SqlInstancesVerifyExternalSyncSettingsResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

StartExternalSync(google::cloud::sql::v1::SqlInstancesStartExternalSyncRequest const &, Options)

Start External primary instance migration.

Parameters
Name Description
request google::cloud::sql::v1::SqlInstancesStartExternalSyncRequest const &

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.SqlInstancesStartExternalSyncRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.

opts Options

Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type Description
StatusOr< google::cloud::sql::v1::Operation >

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.