Performs management operations on Bare Metal Solution servers.
The baremetalsolution.googleapis.com
service provides management capabilities for Bare Metal Solution servers. To access the API methods, you must assign Bare Metal Solution IAM roles containing the desired permissions to your staff in your Google Cloud project. You must also enable the Bare Metal Solution API. Once enabled, the methods act upon specific servers in your Bare Metal Solution environment.
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
BareMetalSolutionClient(BareMetalSolutionClient const &)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
BareMetalSolutionClient const &
|
BareMetalSolutionClient(BareMetalSolutionClient &&)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
BareMetalSolutionClient &&
|
BareMetalSolutionClient(std::shared_ptr< BareMetalSolutionConnection >, Options)
Parameters | |
---|---|
Name | Description |
connection |
std::shared_ptr< BareMetalSolutionConnection >
|
opts |
Options
|
Operators
operator=(BareMetalSolutionClient const &)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
BareMetalSolutionClient const &
|
Returns | |
---|---|
Type | Description |
BareMetalSolutionClient & |
operator=(BareMetalSolutionClient &&)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
BareMetalSolutionClient &&
|
Returns | |
---|---|
Type | Description |
BareMetalSolutionClient & |
Functions
ListInstances(std::string const &, Options)
List servers in a given project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. Parent value for ListInstancesRequest. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::baremetalsolution::v2::Instance > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListInstances(google::cloud::baremetalsolution::v2::ListInstancesRequest, Options)
List servers in a given project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::ListInstancesRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::baremetalsolution::v2::Instance > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetInstance(std::string const &, Options)
Get details about a single server.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Name of the resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::Instance > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.Instance) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetInstance(google::cloud::baremetalsolution::v2::GetInstanceRequest const &, Options)
Get details about a single server.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::GetInstanceRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::Instance > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.Instance) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
UpdateInstance(google::cloud::baremetalsolution::v2::Instance const &, google::protobuf::FieldMask const &, Options)
Update details of a single server.
Parameters | |
---|---|
Name | Description |
instance |
google::cloud::baremetalsolution::v2::Instance const &
Required. The server to update. |
update_mask |
google::protobuf::FieldMask const &
The list of fields to update. The currently supported fields are: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::Instance > > |
A |
UpdateInstance(google::cloud::baremetalsolution::v2::UpdateInstanceRequest const &, Options)
Update details of a single server.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::UpdateInstanceRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::Instance > > |
A |
ResetInstance(std::string const &, Options)
Perform an ungraceful, hard reset on a server.
Equivalent to shutting the power off and then turning it back on.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Name of the resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::ResetInstanceResponse > > |
A |
ResetInstance(google::cloud::baremetalsolution::v2::ResetInstanceRequest const &, Options)
Perform an ungraceful, hard reset on a server.
Equivalent to shutting the power off and then turning it back on.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::ResetInstanceRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::ResetInstanceResponse > > |
A |
StartInstance(std::string const &, Options)
Starts a server that was shutdown.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Name of the resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::StartInstanceResponse > > |
A |
StartInstance(google::cloud::baremetalsolution::v2::StartInstanceRequest const &, Options)
Starts a server that was shutdown.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::StartInstanceRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::StartInstanceResponse > > |
A |
StopInstance(std::string const &, Options)
Stop a running server.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Name of the resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::StopInstanceResponse > > |
A |
StopInstance(google::cloud::baremetalsolution::v2::StopInstanceRequest const &, Options)
Stop a running server.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::StopInstanceRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::StopInstanceResponse > > |
A |
DetachLun(std::string const &, std::string const &, Options)
Detach LUN from Instance.
Parameters | |
---|---|
Name | Description |
instance |
std::string const &
Required. Name of the instance. |
lun |
std::string const &
Required. Name of the Lun to detach. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::Instance > > |
A |
DetachLun(google::cloud::baremetalsolution::v2::DetachLunRequest const &, Options)
Detach LUN from Instance.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::DetachLunRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::Instance > > |
A |
ListVolumes(std::string const &, Options)
List storage volumes in a given project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. Parent value for ListVolumesRequest. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::baremetalsolution::v2::Volume > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListVolumes(google::cloud::baremetalsolution::v2::ListVolumesRequest, Options)
List storage volumes in a given project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::ListVolumesRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::baremetalsolution::v2::Volume > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetVolume(std::string const &, Options)
Get details of a single storage volume.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Name of the resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::Volume > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.Volume) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetVolume(google::cloud::baremetalsolution::v2::GetVolumeRequest const &, Options)
Get details of a single storage volume.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::GetVolumeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::Volume > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.Volume) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
UpdateVolume(google::cloud::baremetalsolution::v2::Volume const &, google::protobuf::FieldMask const &, Options)
Update details of a single storage volume.
Parameters | |
---|---|
Name | Description |
volume |
google::cloud::baremetalsolution::v2::Volume const &
Required. The volume to update. |
update_mask |
google::protobuf::FieldMask const &
The list of fields to update. The only currently supported fields are: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::Volume > > |
A |
UpdateVolume(google::cloud::baremetalsolution::v2::UpdateVolumeRequest const &, Options)
Update details of a single storage volume.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::UpdateVolumeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::Volume > > |
A |
ResizeVolume(std::string const &, std::int64_t, Options)
Emergency Volume resize.
Parameters | |
---|---|
Name | Description |
volume |
std::string const &
Required. Volume to resize. |
size_gib |
std::int64_t
New Volume size, in GiB. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::Volume > > |
A |
ResizeVolume(google::cloud::baremetalsolution::v2::ResizeVolumeRequest const &, Options)
Emergency Volume resize.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::ResizeVolumeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::Volume > > |
A |
ListNetworks(std::string const &, Options)
List network in a given project and location.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. Parent value for ListNetworksRequest. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::baremetalsolution::v2::Network > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListNetworks(google::cloud::baremetalsolution::v2::ListNetworksRequest, Options)
List network in a given project and location.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::ListNetworksRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::baremetalsolution::v2::Network > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListNetworkUsage(std::string const &, Options)
List all Networks (and used IPs for each Network) in the vendor account associated with the specified project.
Parameters | |
---|---|
Name | Description |
location |
std::string const &
Required. Parent value (project and location). |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::ListNetworkUsageResponse > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.ListNetworkUsageResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
ListNetworkUsage(google::cloud::baremetalsolution::v2::ListNetworkUsageRequest const &, Options)
List all Networks (and used IPs for each Network) in the vendor account associated with the specified project.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::ListNetworkUsageRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::ListNetworkUsageResponse > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.ListNetworkUsageResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetNetwork(std::string const &, Options)
Get details of a single network.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Name of the resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::Network > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.Network) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetNetwork(google::cloud::baremetalsolution::v2::GetNetworkRequest const &, Options)
Get details of a single network.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::GetNetworkRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::Network > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.Network) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
UpdateNetwork(google::cloud::baremetalsolution::v2::Network const &, google::protobuf::FieldMask const &, Options)
Update details of a single network.
Parameters | |
---|---|
Name | Description |
network |
google::cloud::baremetalsolution::v2::Network const &
Required. The network to update. |
update_mask |
google::protobuf::FieldMask const &
The list of fields to update. The only currently supported fields are: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::Network > > |
A |
UpdateNetwork(google::cloud::baremetalsolution::v2::UpdateNetworkRequest const &, Options)
Update details of a single network.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::UpdateNetworkRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::Network > > |
A |
GetLun(std::string const &, Options)
Get details of a single storage logical unit number(LUN).
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Name of the resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::Lun > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.Lun) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetLun(google::cloud::baremetalsolution::v2::GetLunRequest const &, Options)
Get details of a single storage logical unit number(LUN).
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::GetLunRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::Lun > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.Lun) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
ListLuns(std::string const &, Options)
List storage volume luns for given storage volume.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. Parent value for ListLunsRequest. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::baremetalsolution::v2::Lun > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListLuns(google::cloud::baremetalsolution::v2::ListLunsRequest, Options)
List storage volume luns for given storage volume.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::ListLunsRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::baremetalsolution::v2::Lun > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetNfsShare(std::string const &, Options)
Get details of a single NFS share.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Name of the resource. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::NfsShare > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.NfsShare) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetNfsShare(google::cloud::baremetalsolution::v2::GetNfsShareRequest const &, Options)
Get details of a single NFS share.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::GetNfsShareRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::cloud::baremetalsolution::v2::NfsShare > |
the result of the RPC. The response message type (google.cloud.baremetalsolution.v2.NfsShare) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
ListNfsShares(std::string const &, Options)
List NFS shares.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. Parent value for ListNfsSharesRequest. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::baremetalsolution::v2::NfsShare > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListNfsShares(google::cloud::baremetalsolution::v2::ListNfsSharesRequest, Options)
List NFS shares.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::ListNfsSharesRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::cloud::baremetalsolution::v2::NfsShare > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
UpdateNfsShare(google::cloud::baremetalsolution::v2::NfsShare const &, google::protobuf::FieldMask const &, Options)
Update details of a single NFS share.
Parameters | |
---|---|
Name | Description |
nfs_share |
google::cloud::baremetalsolution::v2::NfsShare const &
Required. The NFS share to update. |
update_mask |
google::protobuf::FieldMask const &
The list of fields to update. The only currently supported fields are: |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::NfsShare > > |
A |
UpdateNfsShare(google::cloud::baremetalsolution::v2::UpdateNfsShareRequest const &, Options)
Update details of a single NFS share.
Parameters | |
---|---|
Name | Description |
request |
google::cloud::baremetalsolution::v2::UpdateNfsShareRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::cloud::baremetalsolution::v2::NfsShare > > |
A |