Class StorageGrpc.StorageFutureStub (2.27.1)

public static final class StorageGrpc.StorageFutureStub extends AbstractFutureStub<StorageGrpc.StorageFutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service Storage.

API Overview and Naming Syntax

The Cloud Storage gRPC API allows applications to read and write data through the abstractions of buckets and objects. For a description of these abstractions please see https://cloud.google.com/storage/docs. Resources are named as follows:

  • Projects are referred to as they are defined by the Resource Manager API, using strings like projects/123456 or projects/my-string-id.
  • Buckets are named using string names of the form: projects/{project}/buckets/{bucket} For globally unique buckets, _ may be substituted for the project.
  • Objects are uniquely identified by their name along with the name of the bucket they belong to, as separate strings in this API. For example: ReadObjectRequest { bucket: 'projects/_/buckets/my-bucket' object: 'my-object' } Note that object names can contain / characters, which are treated as any other character (no special directory semantics).

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > StorageGrpc.StorageFutureStub

Methods

build(Channel channel, CallOptions callOptions)

protected StorageGrpc.StorageFutureStub build(Channel channel, CallOptions callOptions)
Parameters
NameDescription
channelio.grpc.Channel
callOptionsio.grpc.CallOptions
Returns
TypeDescription
StorageGrpc.StorageFutureStub
Overrides
io.grpc.stub.AbstractStub.build(io.grpc.Channel,io.grpc.CallOptions)

cancelResumableWrite(CancelResumableWriteRequest request)

public ListenableFuture<CancelResumableWriteResponse> cancelResumableWrite(CancelResumableWriteRequest request)

Cancels an in-progress resumable upload. Any attempts to write to the resumable upload after cancelling the upload will fail. The behavior for currently in progress write operations is not guaranteed - they could either complete before the cancellation or fail if the cancellation completes first.

Parameter
NameDescription
requestCancelResumableWriteRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<CancelResumableWriteResponse>

composeObject(ComposeObjectRequest request)

public ListenableFuture<Object> composeObject(ComposeObjectRequest request)

Concatenates a list of existing objects into a new object in the same bucket.

Parameter
NameDescription
requestComposeObjectRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Object>

createBucket(CreateBucketRequest request)

public ListenableFuture<Bucket> createBucket(CreateBucketRequest request)

Creates a new bucket.

Parameter
NameDescription
requestCreateBucketRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Bucket>

createHmacKey(CreateHmacKeyRequest request)

public ListenableFuture<CreateHmacKeyResponse> createHmacKey(CreateHmacKeyRequest request)

Creates a new HMAC key for the given service account.