Contains experimental features for the GCS C++ Client Library.
Classes
AsyncClient
A client for Google Cloud Storage offering asynchronous operations.
AsyncConnection
The *Connection
object for AsyncClient
.
AsyncReader
A handle for streaming downloads.
AsyncReaderConnection
The *Connection
object for AsyncReader
.
AsyncToken
Serialize streams of asynchronous operations.
ComposeObjectRequest
A request to compose multiple objects into a single object.
DeleteObjectRequest
A request to delete an object.
InsertObjectRequest
A request to insert object sans the data payload.
ReadObjectRequest
A request to read an object.
ReadPayload
A partial response to a streaming download.
WritePayload
An opaque representation of the data for an object payload.
Structs
AsyncReadObjectRangeResponse
Represents the response from reading a subset of an object.
GrpcPluginOption
Configure the GCS+gRPC plugin.
HttpVersionOption
Set the HTTP version used by the client.
Functions
DefaultGrpcClient(Options)
Create a google::cloud::storage::Client
object configured to use gRPC.
Example
void GrpcReadWrite(std::string const& bucket_name) {
namespace gcs = ::google::cloud::storage;
auto constexpr kText = R"""(Hello World!)""";
auto client = google::cloud::storage_experimental::DefaultGrpcClient();
auto object = client.InsertObject(bucket_name, "lorem.txt", kText);
if (!object) throw std::move(object).status();
auto input = client.ReadObject(bucket_name, "lorem.txt",
gcs::Generation(object->generation()));
std::string const actual(std::istreambuf_iterator<char>{input}, {});
if (input.bad()) throw google::cloud::Status(input.status());
std::cout << "The contents read back are:\n"
<< actual
<< "\nThe received checksums are: " << input.received_hash()
<< "\nThe computed checksums are: " << input.computed_hash()
<< "\nThe original hashes are: crc32c=" << object->crc32c()
<< ",md5=" << object->md5_hash() << "\n";
}
Parameter | |
---|---|
Name | Description |
opts |
the configuration parameters for the Client. |
Returns | |
---|---|
Type | Description |
google::cloud::storage::Client |