Manages TPU nodes and other resources.
TPU API v2
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
TpuClient(TpuClient const &)
Copy and move support
TpuClient const &
TpuClient(TpuClient &&)
Copy and move support
TpuClient &&
TpuClient(std::shared_ptr< TpuConnection >, Options)
connection
std::shared_ptr< TpuConnection >
opts
Options
Operators
operator=(TpuClient const &)
Copy and move support
TpuClient const &
TpuClient &
operator=(TpuClient &&)
Copy and move support
TpuClient &&
TpuClient &
Functions
ListNodes(std::string const &, Options)
Lists nodes.
parent
std::string const &
Required. The parent resource name.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
StreamRange< google::cloud::tpu::v2::Node >
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.tpu.v2.Node
, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules
.
ListNodes(google::cloud::tpu::v2::ListNodesRequest, Options)
Lists nodes.
request
google::cloud::tpu::v2::ListNodesRequest
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.tpu.v2.ListNodesRequest
. 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.
StreamRange< google::cloud::tpu::v2::Node >
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.tpu.v2.Node
, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules
.
GetNode(std::string const &, Options)
Gets the details of a node.
name
std::string const &
Required. The resource name.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
StatusOr< google::cloud::tpu::v2::Node >
the result of the RPC. The response message type ( google.cloud.tpu.v2.Node
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
GetNode(google::cloud::tpu::v2::GetNodeRequest const &, Options)
Gets the details of a node.
request
google::cloud::tpu::v2::GetNodeRequest 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.tpu.v2.GetNodeRequest
. 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.
StatusOr< google::cloud::tpu::v2::Node >
the result of the RPC. The response message type ( google.cloud.tpu.v2.Node
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
CreateNode(std::string const &, google::cloud::tpu::v2::Node const &, std::string const &, Options)
Creates a node.
parent
std::string const &
Required. The parent resource name.
node
google::cloud::tpu::v2::Node const &
Required. The node.
node_id
std::string const &
The unqualified resource name.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
future< StatusOr< google::cloud::tpu::v2::Node > >
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.tpu.v2.Node
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
CreateNode(NoAwaitTag, std::string const &, google::cloud::tpu::v2::Node const &, std::string const &, Options)
Creates a node.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
parent
std::string const &
node
google::cloud::tpu::v2::Node const &
node_id
std::string const &
opts
Options
StatusOr< google::longrunning::Operation >
CreateNode(google::cloud::tpu::v2::CreateNodeRequest const &, Options)
Creates a node.
request
google::cloud::tpu::v2::CreateNodeRequest 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.tpu.v2.CreateNodeRequest
. 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.
future< StatusOr< google::cloud::tpu::v2::Node > >
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.tpu.v2.Node
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
CreateNode(NoAwaitTag, google::cloud::tpu::v2::CreateNodeRequest const &, Options)
Creates a node.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
request
google::cloud::tpu::v2::CreateNodeRequest const &
opts
Options
StatusOr< google::longrunning::Operation >
CreateNode(google::longrunning::Operation const &, Options)
Creates a node.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
operation
google::longrunning::Operation const &
opts
Options
future< StatusOr< google::cloud::tpu::v2::Node > >
DeleteNode(std::string const &, Options)
Deletes a node.
name
std::string const &
Required. The resource name.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
future< StatusOr< google::cloud::tpu::v2::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.tpu.v2.OperationMetadata
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
DeleteNode(NoAwaitTag, std::string const &, Options)
Deletes a node.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
name
std::string const &
opts
Options
StatusOr< google::longrunning::Operation >
DeleteNode(google::cloud::tpu::v2::DeleteNodeRequest const &, Options)
Deletes a node.
request
google::cloud::tpu::v2::DeleteNodeRequest 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.tpu.v2.DeleteNodeRequest
. 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.
future< StatusOr< google::cloud::tpu::v2::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.tpu.v2.OperationMetadata
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
DeleteNode(NoAwaitTag, google::cloud::tpu::v2::DeleteNodeRequest const &, Options)
Deletes a node.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
request
google::cloud::tpu::v2::DeleteNodeRequest const &
opts
Options
StatusOr< google::longrunning::Operation >
DeleteNode(google::longrunning::Operation const &, Options)
Deletes a node.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
operation
google::longrunning::Operation const &
opts
Options
future< StatusOr< google::cloud::tpu::v2::OperationMetadata > >
StopNode(google::cloud::tpu::v2::StopNodeRequest const &, Options)
Stops a node.
This operation is only available with single TPU nodes.
request
google::cloud::tpu::v2::StopNodeRequest 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.tpu.v2.StopNodeRequest
. 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.
future< StatusOr< google::cloud::tpu::v2::Node > >
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.tpu.v2.Node
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
StopNode(NoAwaitTag, google::cloud::tpu::v2::StopNodeRequest const &, Options)
Stops a node.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
request
google::cloud::tpu::v2::StopNodeRequest const &
opts
Options
StatusOr< google::longrunning::Operation >
StopNode(google::longrunning::Operation const &, Options)
Stops a node.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
operation
google::longrunning::Operation const &
opts
Options
future< StatusOr< google::cloud::tpu::v2::Node > >
StartNode(google::cloud::tpu::v2::StartNodeRequest const &, Options)
Starts a node.
request
google::cloud::tpu::v2::StartNodeRequest 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.tpu.v2.StartNodeRequest
. 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.
future< StatusOr< google::cloud::tpu::v2::Node > >
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.tpu.v2.Node
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
StartNode(NoAwaitTag, google::cloud::tpu::v2::StartNodeRequest const &, Options)
Starts a node.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
request
google::cloud::tpu::v2::StartNodeRequest const &
opts
Options
StatusOr< google::longrunning::Operation >
StartNode(google::longrunning::Operation const &, Options)
Starts a node.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
operation
google::longrunning::Operation const &
opts
Options
future< StatusOr< google::cloud::tpu::v2::Node > >
UpdateNode(google::cloud::tpu::v2::Node const &, google::protobuf::FieldMask const &, Options)
Updates the configurations of a node.
node
google::cloud::tpu::v2::Node const &
Required. The node. Only fields specified in update_mask are updated.
update_mask
google::protobuf::FieldMask const &
Required. Mask of fields from [Node][Tpu.Node] to update. Supported fields: [description, tags, labels, metadata, network_config.enable_external_ips].
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
future< StatusOr< google::cloud::tpu::v2::Node > >
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.tpu.v2.Node
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
UpdateNode(NoAwaitTag, google::cloud::tpu::v2::Node const &, google::protobuf::FieldMask const &, Options)
Updates the configurations of a node.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
node
google::cloud::tpu::v2::Node const &
update_mask
google::protobuf::FieldMask const &
opts
Options
StatusOr< google::longrunning::Operation >
UpdateNode(google::cloud::tpu::v2::UpdateNodeRequest const &, Options)
Updates the configurations of a node.
request
google::cloud::tpu::v2::UpdateNodeRequest 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.tpu.v2.UpdateNodeRequest
. 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.
future< StatusOr< google::cloud::tpu::v2::Node > >
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.tpu.v2.Node
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
UpdateNode(NoAwaitTag, google::cloud::tpu::v2::UpdateNodeRequest const &, Options)
Updates the configurations of a node.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
request
google::cloud::tpu::v2::UpdateNodeRequest const &
opts
Options
StatusOr< google::longrunning::Operation >
UpdateNode(google::longrunning::Operation const &, Options)
Updates the configurations of a node.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
operation
google::longrunning::Operation const &
opts
Options
future< StatusOr< google::cloud::tpu::v2::Node > >
ListQueuedResources(std::string const &, Options)
Lists queued resources.
parent
std::string const &
Required. The parent resource name.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
StreamRange< google::cloud::tpu::v2::QueuedResource >
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.tpu.v2.QueuedResource
, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules
.
ListQueuedResources(google::cloud::tpu::v2::ListQueuedResourcesRequest, Options)
Lists queued resources.
request
google::cloud::tpu::v2::ListQueuedResourcesRequest
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.tpu.v2.ListQueuedResourcesRequest
. 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.
StreamRange< google::cloud::tpu::v2::QueuedResource >
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.tpu.v2.QueuedResource
, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules
.
GetQueuedResource(std::string const &, Options)
Gets details of a queued resource.
name
std::string const &
Required. The resource name.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
StatusOr< google::cloud::tpu::v2::QueuedResource >
the result of the RPC. The response message type ( google.cloud.tpu.v2.QueuedResource
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
GetQueuedResource(google::cloud::tpu::v2::GetQueuedResourceRequest const &, Options)
Gets details of a queued resource.
request
google::cloud::tpu::v2::GetQueuedResourceRequest 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.tpu.v2.GetQueuedResourceRequest
. 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.
StatusOr< google::cloud::tpu::v2::QueuedResource >
the result of the RPC. The response message type ( google.cloud.tpu.v2.QueuedResource
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
CreateQueuedResource(std::string const &, google::cloud::tpu::v2::QueuedResource const &, std::string const &, Options)
Creates a QueuedResource TPU instance.
parent
std::string const &
Required. The parent resource name.
queued_resource
google::cloud::tpu::v2::QueuedResource const &
Required. The queued resource.
queued_resource_id
std::string const &
Optional. The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
regex format.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
future< StatusOr< google::cloud::tpu::v2::QueuedResource > >
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.tpu.v2.QueuedResource
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
CreateQueuedResource(NoAwaitTag, std::string const &, google::cloud::tpu::v2::QueuedResource const &, std::string const &, Options)
Creates a QueuedResource TPU instance.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
parent
std::string const &
queued_resource
google::cloud::tpu::v2::QueuedResource const &
queued_resource_id
std::string const &
opts
Options
StatusOr< google::longrunning::Operation >
CreateQueuedResource(google::cloud::tpu::v2::CreateQueuedResourceRequest const &, Options)
Creates a QueuedResource TPU instance.
request
google::cloud::tpu::v2::CreateQueuedResourceRequest 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.tpu.v2.CreateQueuedResourceRequest
. 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.
future< StatusOr< google::cloud::tpu::v2::QueuedResource > >
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.tpu.v2.QueuedResource
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
CreateQueuedResource(NoAwaitTag, google::cloud::tpu::v2::CreateQueuedResourceRequest const &, Options)
Creates a QueuedResource TPU instance.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
request
google::cloud::tpu::v2::CreateQueuedResourceRequest const &
opts
Options
StatusOr< google::longrunning::Operation >
CreateQueuedResource(google::longrunning::Operation const &, Options)
Creates a QueuedResource TPU instance.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
operation
google::longrunning::Operation const &
opts
Options
future< StatusOr< google::cloud::tpu::v2::QueuedResource > >
DeleteQueuedResource(std::string const &, Options)
Deletes a QueuedResource TPU instance.
name
std::string const &
Required. The resource name.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
future< StatusOr< google::cloud::tpu::v2::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.tpu.v2.OperationMetadata
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
DeleteQueuedResource(NoAwaitTag, std::string const &, Options)
Deletes a QueuedResource TPU instance.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
name
std::string const &
opts
Options
StatusOr< google::longrunning::Operation >
DeleteQueuedResource(google::cloud::tpu::v2::DeleteQueuedResourceRequest const &, Options)
Deletes a QueuedResource TPU instance.
request
google::cloud::tpu::v2::DeleteQueuedResourceRequest 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.tpu.v2.DeleteQueuedResourceRequest
. 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.
future< StatusOr< google::cloud::tpu::v2::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.tpu.v2.OperationMetadata
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
DeleteQueuedResource(NoAwaitTag, google::cloud::tpu::v2::DeleteQueuedResourceRequest const &, Options)
Deletes a QueuedResource TPU instance.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
request
google::cloud::tpu::v2::DeleteQueuedResourceRequest const &
opts
Options
StatusOr< google::longrunning::Operation >
DeleteQueuedResource(google::longrunning::Operation const &, Options)
Deletes a QueuedResource TPU instance.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
operation
google::longrunning::Operation const &
opts
Options
future< StatusOr< google::cloud::tpu::v2::OperationMetadata > >
ResetQueuedResource(std::string const &, Options)
Resets a QueuedResource TPU instance.
name
std::string const &
Required. The name of the queued resource.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
future< StatusOr< google::cloud::tpu::v2::QueuedResource > >
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.tpu.v2.QueuedResource
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
ResetQueuedResource(NoAwaitTag, std::string const &, Options)
Resets a QueuedResource TPU instance.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
name
std::string const &
opts
Options
StatusOr< google::longrunning::Operation >
ResetQueuedResource(google::cloud::tpu::v2::ResetQueuedResourceRequest const &, Options)
Resets a QueuedResource TPU instance.
request
google::cloud::tpu::v2::ResetQueuedResourceRequest 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.tpu.v2.ResetQueuedResourceRequest
. 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.
future< StatusOr< google::cloud::tpu::v2::QueuedResource > >
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.tpu.v2.QueuedResource
proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules
.
ResetQueuedResource(NoAwaitTag, google::cloud::tpu::v2::ResetQueuedResourceRequest const &, Options)
Resets a QueuedResource TPU instance.
Specifying the NoAwaitTag
immediately returns the [ google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
NoAwaitTag
request
google::cloud::tpu::v2::ResetQueuedResourceRequest const &
opts
Options
StatusOr< google::longrunning::Operation >
ResetQueuedResource(google::longrunning::Operation const &, Options)
Resets a QueuedResource TPU instance.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
operation
google::longrunning::Operation const &
opts
Options
future< StatusOr< google::cloud::tpu::v2::QueuedResource > >
GenerateServiceIdentity(google::cloud::tpu::v2::GenerateServiceIdentityRequest const &, Options)
Generates the Cloud TPU service identity for the project.
request
google::cloud::tpu::v2::GenerateServiceIdentityRequest 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.tpu.v2.GenerateServiceIdentityRequest
. 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.
StatusOr< google::cloud::tpu::v2::GenerateServiceIdentityResponse >
the result of the RPC. The response message type ( google.cloud.tpu.v2.GenerateServiceIdentityResponse
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
ListAcceleratorTypes(std::string const &, Options)
Lists accelerator types supported by this API.
parent
std::string const &
Required. The parent resource name.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
StreamRange< google::cloud::tpu::v2::AcceleratorType >
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.tpu.v2.AcceleratorType
, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules
.
ListAcceleratorTypes(google::cloud::tpu::v2::ListAcceleratorTypesRequest, Options)
Lists accelerator types supported by this API.
request
google::cloud::tpu::v2::ListAcceleratorTypesRequest
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.tpu.v2.ListAcceleratorTypesRequest
. 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.
StreamRange< google::cloud::tpu::v2::AcceleratorType >
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.tpu.v2.AcceleratorType
, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules
.
GetAcceleratorType(std::string const &, Options)
Gets AcceleratorType.
name
std::string const &
Required. The resource name.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
StatusOr< google::cloud::tpu::v2::AcceleratorType >
the result of the RPC. The response message type ( google.cloud.tpu.v2.AcceleratorType
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
GetAcceleratorType(google::cloud::tpu::v2::GetAcceleratorTypeRequest const &, Options)
Gets AcceleratorType.
request
google::cloud::tpu::v2::GetAcceleratorTypeRequest 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.tpu.v2.GetAcceleratorTypeRequest
. 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.
StatusOr< google::cloud::tpu::v2::AcceleratorType >
the result of the RPC. The response message type ( google.cloud.tpu.v2.AcceleratorType
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
ListRuntimeVersions(std::string const &, Options)
Lists runtime versions supported by this API.
parent
std::string const &
Required. The parent resource name.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
StreamRange< google::cloud::tpu::v2::RuntimeVersion >
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.tpu.v2.RuntimeVersion
, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules
.
ListRuntimeVersions(google::cloud::tpu::v2::ListRuntimeVersionsRequest, Options)
Lists runtime versions supported by this API.
request
google::cloud::tpu::v2::ListRuntimeVersionsRequest
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.tpu.v2.ListRuntimeVersionsRequest
. 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.
StreamRange< google::cloud::tpu::v2::RuntimeVersion >
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.tpu.v2.RuntimeVersion
, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules
.
GetRuntimeVersion(std::string const &, Options)
Gets a runtime version.
name
std::string const &
Required. The resource name.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
StatusOr< google::cloud::tpu::v2::RuntimeVersion >
the result of the RPC. The response message type ( google.cloud.tpu.v2.RuntimeVersion
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
GetRuntimeVersion(google::cloud::tpu::v2::GetRuntimeVersionRequest const &, Options)
Gets a runtime version.
request
google::cloud::tpu::v2::GetRuntimeVersionRequest 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.tpu.v2.GetRuntimeVersionRequest
. 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.
StatusOr< google::cloud::tpu::v2::RuntimeVersion >
the result of the RPC. The response message type ( google.cloud.tpu.v2.RuntimeVersion
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
GetGuestAttributes(google::cloud::tpu::v2::GetGuestAttributesRequest const &, Options)
Retrieves the guest attributes for the node.
request
google::cloud::tpu::v2::GetGuestAttributesRequest 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.tpu.v2.GetGuestAttributesRequest
. 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.
StatusOr< google::cloud::tpu::v2::GetGuestAttributesResponse >
the result of the RPC. The response message type ( google.cloud.tpu.v2.GetGuestAttributesResponse
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
ListLocations(google::cloud::location::ListLocationsRequest, Options)
Lists information about the supported locations for this service.
request
google::cloud::location::ListLocationsRequest
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.location.ListLocationsRequest
. 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.
StreamRange< google::cloud::location::Location >
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.location.Location
, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules
.
GetLocation(google::cloud::location::GetLocationRequest const &, Options)
Gets information about a location.
request
google::cloud::location::GetLocationRequest 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.location.GetLocationRequest
. 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.
StatusOr< google::cloud::location::Location >
the result of the RPC. The response message type ( google.cloud.location.Location
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
ListOperations(std::string const &, std::string const &, Options)
Lists operations that match the specified filter in the request.
If the server doesn't support this method, it returns UNIMPLEMENTED
.
name
std::string const &
The name of the operation's parent resource.
filter
std::string const &
The standard list filter.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
StreamRange< google::longrunning::Operation >
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.longrunning.Operation
, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules
.
ListOperations(google::longrunning::ListOperationsRequest, Options)
Lists operations that match the specified filter in the request.
If the server doesn't support this method, it returns UNIMPLEMENTED
.
request
google::longrunning::ListOperationsRequest
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.longrunning.ListOperationsRequest
. 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.
StreamRange< google::longrunning::Operation >
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.longrunning.Operation
, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules
.
GetOperation(std::string const &, Options)
Gets the latest state of a long-running operation.
Clients can use this method to poll the operation result at intervals as recommended by the API service.
name
std::string const &
The name of the operation resource.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
StatusOr< google::longrunning::Operation >
the result of the RPC. The response message type ( google.longrunning.Operation
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
GetOperation(google::longrunning::GetOperationRequest const &, Options)
Gets the latest state of a long-running operation.
Clients can use this method to poll the operation result at intervals as recommended by the API service.
request
google::longrunning::GetOperationRequest 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.longrunning.GetOperationRequest
. 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.
StatusOr< google::longrunning::Operation >
the result of the RPC. The response message type ( google.longrunning.Operation
) is mapped to a C++ class using the Protobuf mapping rules
. If the request fails, the StatusOr
contains the error details.
DeleteOperation(std::string const &, Options)
Deletes a long-running operation.
This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED
.
name
std::string const &
The name of the operation resource to be deleted.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
Status
a Status
object. If the request failed, the status contains the details of the failure.
DeleteOperation(google::longrunning::DeleteOperationRequest const &, Options)
Deletes a long-running operation.
This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED
.
request
google::longrunning::DeleteOperationRequest 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.longrunning.DeleteOperationRequest
. 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.
Status
a Status
object. If the request failed, the status contains the details of the failure.
CancelOperation(std::string const &, Options)
Starts asynchronous cancellation on a long-running operation.
The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED
. Clients can use Operations.GetOperation
or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error
value with a google.rpc.Status.code
of 1
, corresponding to Code.CANCELLED
.
name
std::string const &
The name of the operation resource to be cancelled.
opts
Options
Optional. Override the class-level options, such as retry and backoff policies.
Status
a Status
object. If the request failed, the status contains the details of the failure.
CancelOperation(google::longrunning::CancelOperationRequest const &, Options)
Starts asynchronous cancellation on a long-running operation.
The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED
. Clients can use Operations.GetOperation
or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error
value with a google.rpc.Status.code
of 1
, corresponding to Code.CANCELLED
.
request
google::longrunning::CancelOperationRequest 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.longrunning.CancelOperationRequest
. 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.
Status
a Status
object. If the request failed, the status contains the details of the failure.
