Class TagValuesGrpc.TagValuesFutureStub (1.31.0)

public static final class TagValuesGrpc.TagValuesFutureStub extends AbstractFutureStub<TagValuesGrpc.TagValuesFutureStub>

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

Allow users to create and manage tag values.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > TagValuesGrpc.TagValuesFutureStub

Methods

build(Channel channel, CallOptions callOptions)

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

createTagValue(CreateTagValueRequest request)

public ListenableFuture<Operation> createTagValue(CreateTagValueRequest request)

Creates a TagValue as a child of the specified TagKey. If a another request with the same parameters is sent while the original request is in process the second request will receive an error. A maximum of 1000 TagValues can exist under a TagKey at any given time.

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

deleteTagValue(DeleteTagValueRequest request)

public ListenableFuture<Operation> deleteTagValue(DeleteTagValueRequest request)

Deletes a TagValue. The TagValue cannot have any bindings when it is deleted.

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

getIamPolicy(GetIamPolicyRequest request)

public ListenableFuture<Policy> getIamPolicy(GetIamPolicyRequest request)

Gets the access control policy for a TagValue. The returned policy may be empty if no such policy or resource exists. The resource field should be the TagValue's resource name. For example: tagValues/1234. The caller must have the cloudresourcemanager.googleapis.com/tagValues.getIamPolicy permission on the identified TagValue to get the access control policy.

Parameter
NameDescription
requestcom.google.iam.v1.GetIamPolicyRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<com.google.iam.v1.Policy>

getNamespacedTagValue(GetNamespacedTagValueRequest request)

public ListenableFuture<TagValue> getNamespacedTagValue(GetNamespacedTagValueRequest request)

Retrieves a TagValue by its namespaced name. This method will return PERMISSION_DENIED if the value does not exist or the user does not have permission to view it.

Parameter
NameDescription
requestGetNamespacedTagValueRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<TagValue>

getTagValue(GetTagValueRequest request)

public ListenableFuture<TagValue> getTagValue(GetTagValueRequest request)

Retrieves a TagValue. This method will return PERMISSION_DENIED if the value does not exist or the user does not have permission to view it.

Parameter
NameDescription
requestGetTagValueRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<TagValue>

listTagValues(ListTagValuesRequest request)

public ListenableFuture<ListTagValuesResponse> listTagValues(ListTagValuesRequest request)

Lists all TagValues for a specific TagKey.

Parameter
NameDescription
requestListTagValuesRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListTagValuesResponse>

setIamPolicy(SetIamPolicyRequest request)

public ListenableFuture<Policy> setIamPolicy(SetIamPolicyRequest request)

Sets the access control policy on a TagValue, replacing any existing policy. The resource field should be the TagValue's resource name. For example: tagValues/1234. The caller must have resourcemanager.tagValues.setIamPolicy permission on the identified tagValue.

Parameter
NameDescription
requestcom.google.iam.v1.SetIamPolicyRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<com.google.iam.v1.Policy>

testIamPermissions(TestIamPermissionsRequest request)

public ListenableFuture<TestIamPermissionsResponse> testIamPermissions(TestIamPermissionsRequest request)

Returns permissions that a caller has on the specified TagValue. The resource field should be the TagValue's resource name. For example: tagValues/1234. There are no permissions required for making this API call.

Parameter
NameDescription
requestcom.google.iam.v1.TestIamPermissionsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<com.google.iam.v1.TestIamPermissionsResponse>

updateTagValue(UpdateTagValueRequest request)

public ListenableFuture<Operation> updateTagValue(UpdateTagValueRequest request)

Updates the attributes of the TagValue resource.

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