Class AdminServiceGrpc.AdminServiceFutureStub (1.12.22)

public static final class AdminServiceGrpc.AdminServiceFutureStub extends AbstractFutureStub<AdminServiceGrpc.AdminServiceFutureStub>

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

The service that a client application uses to manage topics and subscriptions, such creating, listing, and deleting topics and subscriptions.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > AdminServiceGrpc.AdminServiceFutureStub

Methods

build(Channel channel, CallOptions callOptions)

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

createReservation(CreateReservationRequest request)

public ListenableFuture<Reservation> createReservation(CreateReservationRequest request)

Creates a new reservation.

Parameter
NameDescription
requestCreateReservationRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Reservation>

createSubscription(CreateSubscriptionRequest request)

public ListenableFuture<Subscription> createSubscription(CreateSubscriptionRequest request)

Creates a new subscription.

Parameter
NameDescription
requestCreateSubscriptionRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Subscription>

createTopic(CreateTopicRequest request)

public ListenableFuture<Topic> createTopic(CreateTopicRequest request)

Creates a new topic.

Parameter
NameDescription
requestCreateTopicRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Topic>

deleteReservation(DeleteReservationRequest request)

public ListenableFuture<Empty> deleteReservation(DeleteReservationRequest request)

Deletes the specified reservation.

Parameter
NameDescription
requestDeleteReservationRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>

deleteSubscription(DeleteSubscriptionRequest request)

public ListenableFuture<Empty> deleteSubscription(DeleteSubscriptionRequest request)

Deletes the specified subscription.

Parameter
NameDescription
requestDeleteSubscriptionRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>

deleteTopic(DeleteTopicRequest request)

public ListenableFuture<Empty> deleteTopic(DeleteTopicRequest request)

Deletes the specified topic.

Parameter
NameDescription
requestDeleteTopicRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>

getReservation(GetReservationRequest request)

public ListenableFuture<Reservation> getReservation(GetReservationRequest request)

Returns the reservation configuration.

Parameter
NameDescription
requestGetReservationRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Reservation>

getSubscription(GetSubscriptionRequest request)

public ListenableFuture<Subscription> getSubscription(GetSubscriptionRequest request)

Returns the subscription configuration.

Parameter
NameDescription
requestGetSubscriptionRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Subscription>

getTopic(GetTopicRequest request)

public ListenableFuture<Topic> getTopic(GetTopicRequest request)

Returns the topic configuration.

Parameter
NameDescription
requestGetTopicRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Topic>

getTopicPartitions(GetTopicPartitionsRequest request)

public ListenableFuture<TopicPartitions> getTopicPartitions(GetTopicPartitionsRequest request)

Returns the partition information for the requested topic.

Parameter
NameDescription
requestGetTopicPartitionsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<TopicPartitions>

listReservationTopics(ListReservationTopicsRequest request)

public ListenableFuture<ListReservationTopicsResponse> listReservationTopics(ListReservationTopicsRequest request)

Lists the topics attached to the specified reservation.

Parameter
NameDescription
requestListReservationTopicsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListReservationTopicsResponse>

listReservations(ListReservationsRequest request)

public ListenableFuture<ListReservationsResponse> listReservations(ListReservationsRequest request)

Returns the list of reservations for the given project.

Parameter
NameDescription
requestListReservationsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListReservationsResponse>

listSubscriptions(ListSubscriptionsRequest request)

public ListenableFuture<ListSubscriptionsResponse> listSubscriptions(ListSubscriptionsRequest request)

Returns the list of subscriptions for the given project.

Parameter
NameDescription
requestListSubscriptionsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListSubscriptionsResponse>

listTopicSubscriptions(ListTopicSubscriptionsRequest request)

public ListenableFuture<ListTopicSubscriptionsResponse> listTopicSubscriptions(ListTopicSubscriptionsRequest request)

Lists the subscriptions attached to the specified topic.

Parameter
NameDescription
requestListTopicSubscriptionsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListTopicSubscriptionsResponse>

listTopics(ListTopicsRequest request)

public ListenableFuture<ListTopicsResponse> listTopics(ListTopicsRequest request)

Returns the list of topics for the given project.

Parameter
NameDescription
requestListTopicsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListTopicsResponse>

seekSubscription(SeekSubscriptionRequest request)

public ListenableFuture<Operation> seekSubscription(SeekSubscriptionRequest request)

Performs an out-of-band seek for a subscription to a specified target, which may be timestamps or named positions within the message backlog. Seek translates these targets to cursors for each partition and orchestrates subscribers to start consuming messages from these seek cursors. If an operation is returned, the seek has been registered and subscribers will eventually receive messages from the seek cursors (i.e. eventual consistency), as long as they are using a minimum supported client library version and not a system that tracks cursors independently of Pub/Sub Lite (e.g. Apache Beam, Dataflow, Spark). The seek operation will fail for unsupported clients. If clients would like to know when subscribers react to the seek (or not), they can poll the operation. The seek operation will succeed and complete once subscribers are ready to receive messages from the seek cursors for all partitions of the topic. This means that the seek operation will not complete until all subscribers come online. If the previous seek operation has not yet completed, it will be aborted and the new invocation of seek will supersede it.

Parameter
NameDescription
requestSeekSubscriptionRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Operation>

updateReservation(UpdateReservationRequest request)

public ListenableFuture<Reservation> updateReservation(UpdateReservationRequest request)

Updates properties of the specified reservation.

Parameter
NameDescription
requestUpdateReservationRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Reservation>

updateSubscription(UpdateSubscriptionRequest request)

public ListenableFuture<Subscription> updateSubscription(UpdateSubscriptionRequest request)

Updates properties of the specified subscription.

Parameter
NameDescription
requestUpdateSubscriptionRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Subscription>

updateTopic(UpdateTopicRequest request)

public ListenableFuture<Topic> updateTopic(UpdateTopicRequest request)

Updates properties of the specified topic.

Parameter
NameDescription
requestUpdateTopicRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Topic>