Class VmMigrationClient (2.11.0)

VM Migration Service.

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

VmMigrationClient(VmMigrationClient const &)

Copy and move support

Parameter
Name Description
VmMigrationClient const &

VmMigrationClient(VmMigrationClient &&)

Copy and move support

Parameter
Name Description
VmMigrationClient &&

VmMigrationClient(std::shared_ptr< VmMigrationConnection >, Options)

Parameters
Name Description
connection std::shared_ptr< VmMigrationConnection >
opts Options

Operators

operator=(VmMigrationClient const &)

Copy and move support

Parameter
Name Description
VmMigrationClient const &
Returns
Type Description
VmMigrationClient &

operator=(VmMigrationClient &&)

Copy and move support

Parameter
Name Description
VmMigrationClient &&
Returns
Type Description
VmMigrationClient &

Functions

ListSources(std::string const &, Options)

Lists Sources in a given project and location.

Parameters
Name Description
parent std::string const &

Required. The parent, which owns this collection of sources.

opts Options

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

Returns
Type Description
StreamRange< google::cloud::vmmigration::v1::Source >

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.vmmigration.v1.Source, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListSources(google::cloud::vmmigration::v1::ListSourcesRequest, Options)

Lists Sources in a given project and location.

Parameters
Name Description
request google::cloud::vmmigration::v1::ListSourcesRequest

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.vmmigration.v1.ListSourcesRequest. 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::vmmigration::v1::Source >

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.vmmigration.v1.Source, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetSource(std::string const &, Options)

Gets details of a single Source.

Parameters
Name Description
name std::string const &

Required. The Source name.

opts Options

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

Returns
Type Description
StatusOr< google::cloud::vmmigration::v1::Source >

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

GetSource(google::cloud::vmmigration::v1::GetSourceRequest const &, Options)

Gets details of a single Source.

Parameters
Name Description
request google::cloud::vmmigration::v1::GetSourceRequest 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.vmmigration.v1.GetSourceRequest. 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::vmmigration::v1::Source >

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

CreateSource(std::string const &, google::cloud::vmmigration::v1::Source const &, std::string const &, Options)

Creates a new Source in a given project and location.

Parameters
Name Description
parent std::string const &

Required. The Source's parent.

source google::cloud::vmmigration::v1::Source const &

Required. The create request body.

source_id std::string const &

Required. The source identifier.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::Source > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.Source proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateSource(google::cloud::vmmigration::v1::CreateSourceRequest const &, Options)

Creates a new Source in a given project and location.

Parameters
Name Description
request google::cloud::vmmigration::v1::CreateSourceRequest 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.vmmigration.v1.CreateSourceRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::Source > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.Source proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateSource(google::cloud::vmmigration::v1::Source const &, google::protobuf::FieldMask const &, Options)

Updates the parameters of a single Source.

Parameters
Name Description
source google::cloud::vmmigration::v1::Source const &

Required. The update request body.

update_mask google::protobuf::FieldMask const &

Field mask is used to specify the fields to be overwritten in the Source resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::Source > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.Source proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateSource(google::cloud::vmmigration::v1::UpdateSourceRequest const &, Options)

Updates the parameters of a single Source.

Parameters
Name Description
request google::cloud::vmmigration::v1::UpdateSourceRequest 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.vmmigration.v1.UpdateSourceRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::Source > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.Source proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteSource(std::string const &, Options)

Deletes a single Source.

Parameters
Name Description
name std::string const &

Required. The Source name.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteSource(google::cloud::vmmigration::v1::DeleteSourceRequest const &, Options)

Deletes a single Source.

Parameters
Name Description
request google::cloud::vmmigration::v1::DeleteSourceRequest 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.vmmigration.v1.DeleteSourceRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

FetchInventory(std::string const &, Options)

List remote source's inventory of VMs.

The remote source is the onprem vCenter (remote in the sense it's not in Compute Engine). The inventory describes the list of existing VMs in that source. Note that this operation lists the VMs on the remote source, as opposed to listing the MigratingVms resources in the vmmigration service.

Parameters
Name Description
source std::string const &

Required. The name of the Source.

opts Options

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

Returns
Type Description
StatusOr< google::cloud::vmmigration::v1::FetchInventoryResponse >

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

FetchInventory(google::cloud::vmmigration::v1::FetchInventoryRequest const &, Options)

List remote source's inventory of VMs.

The remote source is the onprem vCenter (remote in the sense it's not in Compute Engine). The inventory describes the list of existing VMs in that source. Note that this operation lists the VMs on the remote source, as opposed to listing the MigratingVms resources in the vmmigration service.

Parameters
Name Description
request google::cloud::vmmigration::v1::FetchInventoryRequest 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.vmmigration.v1.FetchInventoryRequest. 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::vmmigration::v1::FetchInventoryResponse >

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

ListUtilizationReports(std::string const &, Options)

Lists Utilization Reports of the given Source.

Parameters
Name Description
parent std::string const &

Required. The Utilization Reports parent.

opts Options

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

Returns
Type Description
StreamRange< google::cloud::vmmigration::v1::UtilizationReport >

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.vmmigration.v1.UtilizationReport, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListUtilizationReports(google::cloud::vmmigration::v1::ListUtilizationReportsRequest, Options)

Lists Utilization Reports of the given Source.

Parameters
Name Description
request google::cloud::vmmigration::v1::ListUtilizationReportsRequest

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.vmmigration.v1.ListUtilizationReportsRequest. 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::vmmigration::v1::UtilizationReport >

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.vmmigration.v1.UtilizationReport, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetUtilizationReport(std::string const &, Options)

Gets a single Utilization Report.

Parameters
Name Description
name std::string const &

Required. The Utilization Report name.

opts Options

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

Returns
Type Description
StatusOr< google::cloud::vmmigration::v1::UtilizationReport >

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

GetUtilizationReport(google::cloud::vmmigration::v1::GetUtilizationReportRequest const &, Options)

Gets a single Utilization Report.

Parameters
Name Description
request google::cloud::vmmigration::v1::GetUtilizationReportRequest 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.vmmigration.v1.GetUtilizationReportRequest. 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::vmmigration::v1::UtilizationReport >

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

CreateUtilizationReport(std::string const &, google::cloud::vmmigration::v1::UtilizationReport const &, std::string const &, Options)

Creates a new UtilizationReport.

Parameters
Name Description
parent std::string const &

Required. The Utilization Report's parent.

utilization_report google::cloud::vmmigration::v1::UtilizationReport const &

Required. The report to create.

utilization_report_id std::string const &

Required. The ID to use for the report, which will become the final component of the reports's resource name.
This value maximum length is 63 characters, and valid characters are /[a-z][0-9]-/. It must start with an english letter and must not end with a hyphen.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::UtilizationReport > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.UtilizationReport proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateUtilizationReport(google::cloud::vmmigration::v1::CreateUtilizationReportRequest const &, Options)

Creates a new UtilizationReport.

Parameters
Name Description
request google::cloud::vmmigration::v1::CreateUtilizationReportRequest 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.vmmigration.v1.CreateUtilizationReportRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::UtilizationReport > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.UtilizationReport proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteUtilizationReport(std::string const &, Options)

Deletes a single Utilization Report.

Parameters
Name Description
name std::string const &

Required. The Utilization Report name.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteUtilizationReport(google::cloud::vmmigration::v1::DeleteUtilizationReportRequest const &, Options)

Deletes a single Utilization Report.

Parameters
Name Description
request google::cloud::vmmigration::v1::DeleteUtilizationReportRequest 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.vmmigration.v1.DeleteUtilizationReportRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ListDatacenterConnectors(std::string const &, Options)

Lists DatacenterConnectors in a given Source.

Parameters
Name Description
parent std::string const &

Required. The parent, which owns this collection of connectors.

opts Options

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

Returns
Type Description
StreamRange< google::cloud::vmmigration::v1::DatacenterConnector >

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.vmmigration.v1.DatacenterConnector, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListDatacenterConnectors(google::cloud::vmmigration::v1::ListDatacenterConnectorsRequest, Options)

Lists DatacenterConnectors in a given Source.

Parameters
Name Description
request google::cloud::vmmigration::v1::ListDatacenterConnectorsRequest

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.vmmigration.v1.ListDatacenterConnectorsRequest. 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::vmmigration::v1::DatacenterConnector >

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.vmmigration.v1.DatacenterConnector, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetDatacenterConnector(std::string const &, Options)

Gets details of a single DatacenterConnector.

Parameters
Name Description
name std::string const &

Required. The name of the DatacenterConnector.

opts Options

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

Returns
Type Description
StatusOr< google::cloud::vmmigration::v1::DatacenterConnector >

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

GetDatacenterConnector(google::cloud::vmmigration::v1::GetDatacenterConnectorRequest const &, Options)

Gets details of a single DatacenterConnector.

Parameters
Name Description
request google::cloud::vmmigration::v1::GetDatacenterConnectorRequest 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.vmmigration.v1.GetDatacenterConnectorRequest. 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::vmmigration::v1::DatacenterConnector >

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

CreateDatacenterConnector(std::string const &, google::cloud::vmmigration::v1::DatacenterConnector const &, std::string const &, Options)

Creates a new DatacenterConnector in a given Source.

Parameters
Name Description
parent std::string const &

Required. The DatacenterConnector's parent. Required. The Source in where the new DatacenterConnector will be created. For example: projects/my-project/locations/us-central1/sources/my-source

datacenter_connector google::cloud::vmmigration::v1::DatacenterConnector const &

Required. The create request body.

datacenter_connector_id std::string const &

Required. The datacenterConnector identifier.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::DatacenterConnector > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.DatacenterConnector proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateDatacenterConnector(google::cloud::vmmigration::v1::CreateDatacenterConnectorRequest const &, Options)

Creates a new DatacenterConnector in a given Source.

Parameters
Name Description
request google::cloud::vmmigration::v1::CreateDatacenterConnectorRequest 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.vmmigration.v1.CreateDatacenterConnectorRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::DatacenterConnector > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.DatacenterConnector proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteDatacenterConnector(std::string const &, Options)

Deletes a single DatacenterConnector.

Parameters
Name Description
name std::string const &

Required. The DatacenterConnector name.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteDatacenterConnector(google::cloud::vmmigration::v1::DeleteDatacenterConnectorRequest const &, Options)

Deletes a single DatacenterConnector.

Parameters
Name Description
request google::cloud::vmmigration::v1::DeleteDatacenterConnectorRequest 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.vmmigration.v1.DeleteDatacenterConnectorRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpgradeAppliance(google::cloud::vmmigration::v1::UpgradeApplianceRequest const &, Options)

Upgrades the appliance relate to this DatacenterConnector to the in-place updateable version.

Parameters
Name Description
request google::cloud::vmmigration::v1::UpgradeApplianceRequest 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.vmmigration.v1.UpgradeApplianceRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::UpgradeApplianceResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.UpgradeApplianceResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateMigratingVm(std::string const &, google::cloud::vmmigration::v1::MigratingVm const &, std::string const &, Options)

Creates a new MigratingVm in a given Source.

Parameters
Name Description
parent std::string const &

Required. The MigratingVm's parent.

migrating_vm google::cloud::vmmigration::v1::MigratingVm const &

Required. The create request body.

migrating_vm_id std::string const &

Required. The migratingVm identifier.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::MigratingVm > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.MigratingVm proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateMigratingVm(google::cloud::vmmigration::v1::CreateMigratingVmRequest const &, Options)

Creates a new MigratingVm in a given Source.

Parameters
Name Description
request google::cloud::vmmigration::v1::CreateMigratingVmRequest 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.vmmigration.v1.CreateMigratingVmRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::MigratingVm > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.MigratingVm proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ListMigratingVms(std::string const &, Options)

Lists MigratingVms in a given Source.

Parameters
Name Description
parent std::string const &

Required. The parent, which owns this collection of MigratingVms.

opts Options

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

Returns
Type Description
StreamRange< google::cloud::vmmigration::v1::MigratingVm >

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.vmmigration.v1.MigratingVm, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListMigratingVms(google::cloud::vmmigration::v1::ListMigratingVmsRequest, Options)

Lists MigratingVms in a given Source.

Parameters
Name Description
request google::cloud::vmmigration::v1::ListMigratingVmsRequest

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.vmmigration.v1.ListMigratingVmsRequest. 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::vmmigration::v1::MigratingVm >

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.vmmigration.v1.MigratingVm, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetMigratingVm(std::string const &, Options)

Gets details of a single MigratingVm.

Parameters
Name Description
name std::string const &

Required. The name of the MigratingVm.

opts Options

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

Returns
Type Description
StatusOr< google::cloud::vmmigration::v1::MigratingVm >

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

GetMigratingVm(google::cloud::vmmigration::v1::GetMigratingVmRequest const &, Options)

Gets details of a single MigratingVm.

Parameters
Name Description
request google::cloud::vmmigration::v1::GetMigratingVmRequest 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.vmmigration.v1.GetMigratingVmRequest. 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::vmmigration::v1::MigratingVm >

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

UpdateMigratingVm(google::cloud::vmmigration::v1::MigratingVm const &, google::protobuf::FieldMask const &, Options)

Updates the parameters of a single MigratingVm.

Parameters
Name Description
migrating_vm google::cloud::vmmigration::v1::MigratingVm const &

Required. The update request body.

update_mask google::protobuf::FieldMask const &

Field mask is used to specify the fields to be overwritten in the MigratingVm resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::MigratingVm > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.MigratingVm proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateMigratingVm(google::cloud::vmmigration::v1::UpdateMigratingVmRequest const &, Options)

Updates the parameters of a single MigratingVm.

Parameters
Name Description
request google::cloud::vmmigration::v1::UpdateMigratingVmRequest 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.vmmigration.v1.UpdateMigratingVmRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::MigratingVm > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.MigratingVm proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteMigratingVm(std::string const &, Options)

Deletes a single MigratingVm.

Parameters
Name Description
name std::string const &

Required. The name of the MigratingVm.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteMigratingVm(google::cloud::vmmigration::v1::DeleteMigratingVmRequest const &, Options)

Deletes a single MigratingVm.

Parameters
Name Description
request google::cloud::vmmigration::v1::DeleteMigratingVmRequest 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.vmmigration.v1.DeleteMigratingVmRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

StartMigration(std::string const &, Options)

Starts migration for a VM.

Starts the process of uploading data and creating snapshots, in replication cycles scheduled by the policy.

Parameters
Name Description
migrating_vm std::string const &

Required. The name of the MigratingVm.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::StartMigrationResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.StartMigrationResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

StartMigration(google::cloud::vmmigration::v1::StartMigrationRequest const &, Options)

Starts migration for a VM.

Starts the process of uploading data and creating snapshots, in replication cycles scheduled by the policy.

Parameters
Name Description
request google::cloud::vmmigration::v1::StartMigrationRequest 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.vmmigration.v1.StartMigrationRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::StartMigrationResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.StartMigrationResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ResumeMigration(google::cloud::vmmigration::v1::ResumeMigrationRequest const &, Options)

Resumes a migration for a VM.

When called on a paused migration, will start the process of uploading data and creating snapshots; when called on a completed cut-over migration, will update the migration to active state and start the process of uploading data and creating snapshots.

Parameters
Name Description
request google::cloud::vmmigration::v1::ResumeMigrationRequest 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.vmmigration.v1.ResumeMigrationRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::ResumeMigrationResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.ResumeMigrationResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

PauseMigration(google::cloud::vmmigration::v1::PauseMigrationRequest const &, Options)

Pauses a migration for a VM.

If cycle tasks are running they will be cancelled, preserving source task data. Further replication cycles will not be triggered while the VM is paused.

Parameters
Name Description
request google::cloud::vmmigration::v1::PauseMigrationRequest 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.vmmigration.v1.PauseMigrationRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::PauseMigrationResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.PauseMigrationResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

FinalizeMigration(std::string const &, Options)

Marks a migration as completed, deleting migration resources that are no longer being used.

Only applicable after cutover is done.

Parameters
Name Description
migrating_vm std::string const &

Required. The name of the MigratingVm.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::FinalizeMigrationResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.FinalizeMigrationResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

FinalizeMigration(google::cloud::vmmigration::v1::FinalizeMigrationRequest const &, Options)

Marks a migration as completed, deleting migration resources that are no longer being used.

Only applicable after cutover is done.

Parameters
Name Description
request google::cloud::vmmigration::v1::FinalizeMigrationRequest 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.vmmigration.v1.FinalizeMigrationRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::FinalizeMigrationResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.FinalizeMigrationResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCloneJob(std::string const &, google::cloud::vmmigration::v1::CloneJob const &, std::string const &, Options)

Initiates a Clone of a specific migrating VM.

Parameters
Name Description
parent std::string const &

Required. The Clone's parent.

clone_job google::cloud::vmmigration::v1::CloneJob const &

Required. The clone request body.

clone_job_id std::string const &

Required. The clone job identifier.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::CloneJob > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.CloneJob proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCloneJob(google::cloud::vmmigration::v1::CreateCloneJobRequest const &, Options)

Initiates a Clone of a specific migrating VM.

Parameters
Name Description
request google::cloud::vmmigration::v1::CreateCloneJobRequest 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.vmmigration.v1.CreateCloneJobRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::CloneJob > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.CloneJob proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CancelCloneJob(std::string const &, Options)

Initiates the cancellation of a running clone job.

Parameters
Name Description
name std::string const &

Required. The clone job id

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::CancelCloneJobResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.CancelCloneJobResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CancelCloneJob(google::cloud::vmmigration::v1::CancelCloneJobRequest const &, Options)

Initiates the cancellation of a running clone job.

Parameters
Name Description
request google::cloud::vmmigration::v1::CancelCloneJobRequest 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.vmmigration.v1.CancelCloneJobRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::CancelCloneJobResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.CancelCloneJobResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ListCloneJobs(std::string const &, Options)

Lists CloneJobs of a given migrating VM.

Parameters
Name Description
parent std::string const &

Required. The parent, which owns this collection of source VMs.

opts Options

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

Returns
Type Description
StreamRange< google::cloud::vmmigration::v1::CloneJob >

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.vmmigration.v1.CloneJob, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListCloneJobs(google::cloud::vmmigration::v1::ListCloneJobsRequest, Options)

Lists CloneJobs of a given migrating VM.

Parameters
Name Description
request google::cloud::vmmigration::v1::ListCloneJobsRequest

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.vmmigration.v1.ListCloneJobsRequest. 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::vmmigration::v1::CloneJob >

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.vmmigration.v1.CloneJob, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetCloneJob(std::string const &, Options)

Gets details of a single CloneJob.

Parameters
Name Description
name std::string const &

Required. The name of the CloneJob.

opts Options

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

Returns
Type Description
StatusOr< google::cloud::vmmigration::v1::CloneJob >

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

GetCloneJob(google::cloud::vmmigration::v1::GetCloneJobRequest const &, Options)

Gets details of a single CloneJob.

Parameters
Name Description
request google::cloud::vmmigration::v1::GetCloneJobRequest 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.vmmigration.v1.GetCloneJobRequest. 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::vmmigration::v1::CloneJob >

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

CreateCutoverJob(std::string const &, google::cloud::vmmigration::v1::CutoverJob const &, std::string const &, Options)

Initiates a Cutover of a specific migrating VM.

The returned LRO is completed when the cutover job resource is created and the job is initiated.

Parameters
Name Description
parent std::string const &

Required. The Cutover's parent.

cutover_job google::cloud::vmmigration::v1::CutoverJob const &

Required. The cutover request body.

cutover_job_id std::string const &

Required. The cutover job identifier.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::CutoverJob > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.CutoverJob proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateCutoverJob(google::cloud::vmmigration::v1::CreateCutoverJobRequest const &, Options)

Initiates a Cutover of a specific migrating VM.

The returned LRO is completed when the cutover job resource is created and the job is initiated.

Parameters
Name Description
request google::cloud::vmmigration::v1::CreateCutoverJobRequest 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.vmmigration.v1.CreateCutoverJobRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::CutoverJob > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.CutoverJob proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CancelCutoverJob(std::string const &, Options)

Initiates the cancellation of a running cutover job.

Parameters
Name Description
name std::string const &

Required. The cutover job id

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::CancelCutoverJobResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.CancelCutoverJobResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CancelCutoverJob(google::cloud::vmmigration::v1::CancelCutoverJobRequest const &, Options)

Initiates the cancellation of a running cutover job.

Parameters
Name Description
request google::cloud::vmmigration::v1::CancelCutoverJobRequest 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.vmmigration.v1.CancelCutoverJobRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::CancelCutoverJobResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.CancelCutoverJobResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ListCutoverJobs(std::string const &, Options)

Lists CutoverJobs of a given migrating VM.

Parameters
Name Description
parent std::string const &

Required. The parent, which owns this collection of migrating VMs.

opts Options

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

Returns
Type Description
StreamRange< google::cloud::vmmigration::v1::CutoverJob >

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.vmmigration.v1.CutoverJob, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListCutoverJobs(google::cloud::vmmigration::v1::ListCutoverJobsRequest, Options)

Lists CutoverJobs of a given migrating VM.

Parameters
Name Description
request google::cloud::vmmigration::v1::ListCutoverJobsRequest

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.vmmigration.v1.ListCutoverJobsRequest. 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::vmmigration::v1::CutoverJob >

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.vmmigration.v1.CutoverJob, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetCutoverJob(std::string const &, Options)

Gets details of a single CutoverJob.

Parameters
Name Description
name std::string const &

Required. The name of the CutoverJob.

opts Options

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

Returns
Type Description
StatusOr< google::cloud::vmmigration::v1::CutoverJob >

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

GetCutoverJob(google::cloud::vmmigration::v1::GetCutoverJobRequest const &, Options)

Gets details of a single CutoverJob.

Parameters
Name Description
request google::cloud::vmmigration::v1::GetCutoverJobRequest 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.vmmigration.v1.GetCutoverJobRequest. 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::vmmigration::v1::CutoverJob >

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

ListGroups(std::string const &, Options)

Lists Groups in a given project and location.

Parameters
Name Description
parent std::string const &

Required. The parent, which owns this collection of groups.

opts Options

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

Returns
Type Description
StreamRange< google::cloud::vmmigration::v1::Group >

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.vmmigration.v1.Group, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListGroups(google::cloud::vmmigration::v1::ListGroupsRequest, Options)

Lists Groups in a given project and location.

Parameters
Name Description
request google::cloud::vmmigration::v1::ListGroupsRequest

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.vmmigration.v1.ListGroupsRequest. 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::vmmigration::v1::Group >

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.vmmigration.v1.Group, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetGroup(std::string const &, Options)

Gets details of a single Group.

Parameters
Name Description
name std::string const &

Required. The group name.

opts Options

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

Returns
Type Description
StatusOr< google::cloud::vmmigration::v1::Group >

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

GetGroup(google::cloud::vmmigration::v1::GetGroupRequest const &, Options)

Gets details of a single Group.

Parameters
Name Description
request google::cloud::vmmigration::v1::GetGroupRequest 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.vmmigration.v1.GetGroupRequest. 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::vmmigration::v1::Group >

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

CreateGroup(std::string const &, google::cloud::vmmigration::v1::Group const &, std::string const &, Options)

Creates a new Group in a given project and location.

Parameters
Name Description
parent std::string const &

Required. The Group's parent.

group google::cloud::vmmigration::v1::Group const &

Required. The create request body.

group_id std::string const &

Required. The group identifier.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::Group > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.Group proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateGroup(google::cloud::vmmigration::v1::CreateGroupRequest const &, Options)

Creates a new Group in a given project and location.

Parameters
Name Description
request google::cloud::vmmigration::v1::CreateGroupRequest 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.vmmigration.v1.CreateGroupRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::Group > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.Group proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateGroup(google::cloud::vmmigration::v1::Group const &, google::protobuf::FieldMask const &, Options)

Updates the parameters of a single Group.

Parameters
Name Description
group google::cloud::vmmigration::v1::Group const &

Required. The update request body.

update_mask google::protobuf::FieldMask const &

Field mask is used to specify the fields to be overwritten in the Group resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::Group > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.Group proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateGroup(google::cloud::vmmigration::v1::UpdateGroupRequest const &, Options)

Updates the parameters of a single Group.

Parameters
Name Description
request google::cloud::vmmigration::v1::UpdateGroupRequest 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.vmmigration.v1.UpdateGroupRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::Group > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.Group proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteGroup(std::string const &, Options)

Deletes a single Group.

Parameters
Name Description
name std::string const &

Required. The Group name.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteGroup(google::cloud::vmmigration::v1::DeleteGroupRequest const &, Options)

Deletes a single Group.

Parameters
Name Description
request google::cloud::vmmigration::v1::DeleteGroupRequest 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.vmmigration.v1.DeleteGroupRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

AddGroupMigration(std::string const &, Options)

Adds a MigratingVm to a Group.

Parameters
Name Description
group std::string const &

Required. The full path name of the Group to add to.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::AddGroupMigrationResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.AddGroupMigrationResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

AddGroupMigration(google::cloud::vmmigration::v1::AddGroupMigrationRequest const &, Options)

Adds a MigratingVm to a Group.

Parameters
Name Description
request google::cloud::vmmigration::v1::AddGroupMigrationRequest 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.vmmigration.v1.AddGroupMigrationRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::AddGroupMigrationResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.AddGroupMigrationResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

RemoveGroupMigration(std::string const &, Options)

Removes a MigratingVm from a Group.

Parameters
Name Description
group std::string const &

Required. The name of the Group.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::RemoveGroupMigrationResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.RemoveGroupMigrationResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

RemoveGroupMigration(google::cloud::vmmigration::v1::RemoveGroupMigrationRequest const &, Options)

Removes a MigratingVm from a Group.

Parameters
Name Description
request google::cloud::vmmigration::v1::RemoveGroupMigrationRequest 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.vmmigration.v1.RemoveGroupMigrationRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::RemoveGroupMigrationResponse > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.RemoveGroupMigrationResponse proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ListTargetProjects(std::string const &, Options)

Lists TargetProjects in a given project.

NOTE: TargetProject is a global resource; hence the only supported value for location is global.

Parameters
Name Description
parent std::string const &

Required. The parent, which owns this collection of targets.

opts Options

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

Returns
Type Description
StreamRange< google::cloud::vmmigration::v1::TargetProject >

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.vmmigration.v1.TargetProject, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListTargetProjects(google::cloud::vmmigration::v1::ListTargetProjectsRequest, Options)

Lists TargetProjects in a given project.

NOTE: TargetProject is a global resource; hence the only supported value for location is global.

Parameters
Name Description
request google::cloud::vmmigration::v1::ListTargetProjectsRequest

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.vmmigration.v1.ListTargetProjectsRequest. 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::vmmigration::v1::TargetProject >

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.vmmigration.v1.TargetProject, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetTargetProject(std::string const &, Options)

Gets details of a single TargetProject.

NOTE: TargetProject is a global resource; hence the only supported value for location is global.

Parameters
Name Description
name std::string const &

Required. The TargetProject name.

opts Options

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

Returns
Type Description
StatusOr< google::cloud::vmmigration::v1::TargetProject >

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

GetTargetProject(google::cloud::vmmigration::v1::GetTargetProjectRequest const &, Options)

Gets details of a single TargetProject.

NOTE: TargetProject is a global resource; hence the only supported value for location is global.

Parameters
Name Description
request google::cloud::vmmigration::v1::GetTargetProjectRequest 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.vmmigration.v1.GetTargetProjectRequest. 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::vmmigration::v1::TargetProject >

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

CreateTargetProject(std::string const &, google::cloud::vmmigration::v1::TargetProject const &, std::string const &, Options)

Creates a new TargetProject in a given project.

NOTE: TargetProject is a global resource; hence the only supported value for location is global.

Parameters
Name Description
parent std::string const &

Required. The TargetProject's parent.

target_project google::cloud::vmmigration::v1::TargetProject const &

Required. The create request body.

target_project_id std::string const &

Required. The target_project identifier.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::TargetProject > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.TargetProject proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateTargetProject(google::cloud::vmmigration::v1::CreateTargetProjectRequest const &, Options)

Creates a new TargetProject in a given project.

NOTE: TargetProject is a global resource; hence the only supported value for location is global.

Parameters
Name Description
request google::cloud::vmmigration::v1::CreateTargetProjectRequest 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.vmmigration.v1.CreateTargetProjectRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::TargetProject > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.TargetProject proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateTargetProject(google::cloud::vmmigration::v1::TargetProject const &, google::protobuf::FieldMask const &, Options)

Updates the parameters of a single TargetProject.

NOTE: TargetProject is a global resource; hence the only supported value for location is global.

Parameters
Name Description
target_project google::cloud::vmmigration::v1::TargetProject const &

Required. The update request body.

update_mask google::protobuf::FieldMask const &

Field mask is used to specify the fields to be overwritten in the TargetProject resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::TargetProject > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.TargetProject proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateTargetProject(google::cloud::vmmigration::v1::UpdateTargetProjectRequest const &, Options)

Updates the parameters of a single TargetProject.

NOTE: TargetProject is a global resource; hence the only supported value for location is global.

Parameters
Name Description
request google::cloud::vmmigration::v1::UpdateTargetProjectRequest 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.vmmigration.v1.UpdateTargetProjectRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::TargetProject > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.TargetProject proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteTargetProject(std::string const &, Options)

Deletes a single TargetProject.

NOTE: TargetProject is a global resource; hence the only supported value for location is global.

Parameters
Name Description
name std::string const &

Required. The TargetProject name.

opts Options

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

Returns
Type Description
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteTargetProject(google::cloud::vmmigration::v1::DeleteTargetProjectRequest const &, Options)

Deletes a single TargetProject.

NOTE: TargetProject is a global resource; hence the only supported value for location is global.

Parameters
Name Description
request google::cloud::vmmigration::v1::DeleteTargetProjectRequest 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.vmmigration.v1.DeleteTargetProjectRequest. 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
future< StatusOr< google::cloud::vmmigration::v1::OperationMetadata > >

A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.cloud.vmmigration.v1.OperationMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

ListReplicationCycles(std::string const &, Options)

Lists ReplicationCycles in a given MigratingVM.

Parameters
Name Description
parent std::string const &

Required. The parent, which owns this collection of ReplicationCycles.

opts Options

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

Returns
Type Description
StreamRange< google::cloud::vmmigration::v1::ReplicationCycle >

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.vmmigration.v1.ReplicationCycle, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListReplicationCycles(google::cloud::vmmigration::v1::ListReplicationCyclesRequest, Options)

Lists ReplicationCycles in a given MigratingVM.

Parameters
Name Description
request google::cloud::vmmigration::v1::ListReplicationCyclesRequest

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.vmmigration.v1.ListReplicationCyclesRequest. 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::vmmigration::v1::ReplicationCycle >

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.vmmigration.v1.ReplicationCycle, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetReplicationCycle(std::string const &, Options)

Gets details of a single ReplicationCycle.

Parameters
Name Description
name std::string const &

Required. The name of the ReplicationCycle.

opts Options

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

Returns
Type Description
StatusOr< google::cloud::vmmigration::v1::ReplicationCycle >

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

GetReplicationCycle(google::cloud::vmmigration::v1::GetReplicationCycleRequest const &, Options)

Gets details of a single ReplicationCycle.

Parameters
Name Description
request google::cloud::vmmigration::v1::GetReplicationCycleRequest 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.vmmigration.v1.GetReplicationCycleRequest. 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::vmmigration::v1::ReplicationCycle >

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