com.google.cloud.aiplatform.v1beta1.FeaturestoreServiceClient Maven / Gradle / Ivy
Show all versions of google-cloud-aiplatform Show documentation
/*
* Copyright 2024 Google LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.cloud.aiplatform.v1beta1;
import com.google.api.core.ApiFuture;
import com.google.api.core.ApiFutures;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
import com.google.api.gax.longrunning.OperationFuture;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.PageContext;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.aiplatform.v1beta1.stub.FeaturestoreServiceStub;
import com.google.cloud.aiplatform.v1beta1.stub.FeaturestoreServiceStubSettings;
import com.google.cloud.location.GetLocationRequest;
import com.google.cloud.location.ListLocationsRequest;
import com.google.cloud.location.ListLocationsResponse;
import com.google.cloud.location.Location;
import com.google.common.util.concurrent.MoreExecutors;
import com.google.iam.v1.GetIamPolicyRequest;
import com.google.iam.v1.Policy;
import com.google.iam.v1.SetIamPolicyRequest;
import com.google.iam.v1.TestIamPermissionsRequest;
import com.google.iam.v1.TestIamPermissionsResponse;
import com.google.longrunning.Operation;
import com.google.longrunning.OperationsClient;
import com.google.protobuf.Empty;
import com.google.protobuf.FieldMask;
import java.io.IOException;
import java.util.List;
import java.util.concurrent.TimeUnit;
import javax.annotation.Generated;
// AUTO-GENERATED DOCUMENTATION AND CLASS.
/**
* Service Description: The service that handles CRUD and List for resources for Featurestore.
*
* This class provides the ability to make remote calls to the backing service through method
* calls that map to API methods. Sample code to get started:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeaturestoreName name = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]");
* Featurestore response = featurestoreServiceClient.getFeaturestore(name);
* }
* }
*
* Note: close() needs to be called on the FeaturestoreServiceClient object to clean up resources
* such as threads. In the example above, try-with-resources is used, which automatically calls
* close().
*
*
* Methods
*
* Method
* Description
* Method Variants
*
*
* CreateFeaturestore
* Creates a new Featurestore in a given project and location.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* createFeaturestoreAsync(CreateFeaturestoreRequest request)
*
* Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
*
* createFeaturestoreAsync(LocationName parent, Featurestore featurestore)
*
createFeaturestoreAsync(String parent, Featurestore featurestore)
*
createFeaturestoreAsync(LocationName parent, Featurestore featurestore, String featurestoreId)
*
createFeaturestoreAsync(String parent, Featurestore featurestore, String featurestoreId)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* createFeaturestoreOperationCallable()
*
createFeaturestoreCallable()
*
*
*
*
* GetFeaturestore
* Gets details of a single Featurestore.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* getFeaturestore(GetFeaturestoreRequest request)
*
* "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
*
* getFeaturestore(FeaturestoreName name)
*
getFeaturestore(String name)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* getFeaturestoreCallable()
*
*
*
*
* ListFeaturestores
* Lists Featurestores in a given project and location.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* listFeaturestores(ListFeaturestoresRequest request)
*
* "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
*
* listFeaturestores(LocationName parent)
*
listFeaturestores(String parent)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* listFeaturestoresPagedCallable()
*
listFeaturestoresCallable()
*
*
*
*
* UpdateFeaturestore
* Updates the parameters of a single Featurestore.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* updateFeaturestoreAsync(UpdateFeaturestoreRequest request)
*
* Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
*
* updateFeaturestoreAsync(Featurestore featurestore, FieldMask updateMask)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* updateFeaturestoreOperationCallable()
*
updateFeaturestoreCallable()
*
*
*
*
* DeleteFeaturestore
* Deletes a single Featurestore. The Featurestore must not contain any EntityTypes or `force` must be set to true for the request to succeed.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* deleteFeaturestoreAsync(DeleteFeaturestoreRequest request)
*
* Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
*
* deleteFeaturestoreAsync(FeaturestoreName name)
*
deleteFeaturestoreAsync(String name)
*
deleteFeaturestoreAsync(FeaturestoreName name, boolean force)
*
deleteFeaturestoreAsync(String name, boolean force)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* deleteFeaturestoreOperationCallable()
*
deleteFeaturestoreCallable()
*
*
*
*
* CreateEntityType
* Creates a new EntityType in a given Featurestore.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* createEntityTypeAsync(CreateEntityTypeRequest request)
*
* Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
*
* createEntityTypeAsync(FeaturestoreName parent, EntityType entityType)
*
createEntityTypeAsync(String parent, EntityType entityType)
*
createEntityTypeAsync(FeaturestoreName parent, EntityType entityType, String entityTypeId)
*
createEntityTypeAsync(String parent, EntityType entityType, String entityTypeId)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* createEntityTypeOperationCallable()
*
createEntityTypeCallable()
*
*
*
*
* GetEntityType
* Gets details of a single EntityType.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* getEntityType(GetEntityTypeRequest request)
*
* "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
*
* getEntityType(EntityTypeName name)
*
getEntityType(String name)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* getEntityTypeCallable()
*
*
*
*
* ListEntityTypes
* Lists EntityTypes in a given Featurestore.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* listEntityTypes(ListEntityTypesRequest request)
*
* "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
*
* listEntityTypes(FeaturestoreName parent)
*
listEntityTypes(String parent)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* listEntityTypesPagedCallable()
*
listEntityTypesCallable()
*
*
*
*
* UpdateEntityType
* Updates the parameters of a single EntityType.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* updateEntityType(UpdateEntityTypeRequest request)
*
* "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
*
* updateEntityType(EntityType entityType, FieldMask updateMask)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* updateEntityTypeCallable()
*
*
*
*
* DeleteEntityType
* Deletes a single EntityType. The EntityType must not have any Features or `force` must be set to true for the request to succeed.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* deleteEntityTypeAsync(DeleteEntityTypeRequest request)
*
* Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
*
* deleteEntityTypeAsync(EntityTypeName name)
*
deleteEntityTypeAsync(String name)
*
deleteEntityTypeAsync(EntityTypeName name, boolean force)
*
deleteEntityTypeAsync(String name, boolean force)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* deleteEntityTypeOperationCallable()
*
deleteEntityTypeCallable()
*
*
*
*
* CreateFeature
* Creates a new Feature in a given EntityType.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* createFeatureAsync(CreateFeatureRequest request)
*
* Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
*
* createFeatureAsync(EntityTypeName parent, Feature feature)
*
createFeatureAsync(FeatureGroupName parent, Feature feature)
*
createFeatureAsync(String parent, Feature feature)
*
createFeatureAsync(EntityTypeName parent, Feature feature, String featureId)
*
createFeatureAsync(FeatureGroupName parent, Feature feature, String featureId)
*
createFeatureAsync(String parent, Feature feature, String featureId)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* createFeatureOperationCallable()
*
createFeatureCallable()
*
*
*
*
* BatchCreateFeatures
* Creates a batch of Features in a given EntityType.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* batchCreateFeaturesAsync(EntityTypeName parent, List<CreateFeatureRequest> requests)
*
batchCreateFeaturesAsync(String parent, List<CreateFeatureRequest> requests)
*
batchCreateFeaturesAsync(BatchCreateFeaturesRequest request)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* batchCreateFeaturesOperationCallable()
*
batchCreateFeaturesCallable()
*
*
*
*
* GetFeature
* Gets details of a single Feature.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* getFeature(GetFeatureRequest request)
*
* "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
*
* getFeature(FeatureName name)
*
getFeature(String name)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* getFeatureCallable()
*
*
*
*
* ListFeatures
* Lists Features in a given EntityType.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* listFeatures(ListFeaturesRequest request)
*
* "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
*
* listFeatures(EntityTypeName parent)
*
listFeatures(FeatureGroupName parent)
*
listFeatures(String parent)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* listFeaturesPagedCallable()
*
listFeaturesCallable()
*
*
*
*
* UpdateFeature
* Updates the parameters of a single Feature.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* updateFeature(UpdateFeatureRequest request)
*
* "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
*
* updateFeature(Feature feature, FieldMask updateMask)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* updateFeatureCallable()
*
*
*
*
* DeleteFeature
* Deletes a single Feature.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* deleteFeatureAsync(DeleteFeatureRequest request)
*
* Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
*
* deleteFeatureAsync(FeatureName name)
*
deleteFeatureAsync(String name)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* deleteFeatureOperationCallable()
*
deleteFeatureCallable()
*
*
*
*
* ImportFeatureValues
* Imports Feature values into the Featurestore from a source storage.
*
The progress of the import is tracked by the returned operation. The imported features are guaranteed to be visible to subsequent read operations after the operation is marked as successfully done.
*
If an import operation fails, the Feature values returned from reads and exports may be inconsistent. If consistency is required, the caller must retry the same import request again and wait till the new operation returned is marked as successfully done.
*
There are also scenarios where the caller can cause inconsistency.
*
- Source data for import contains multiple distinct Feature values for the same entity ID and timestamp. - Source is modified during an import. This includes adding, updating, or removing source data and/or metadata. Examples of updating metadata include but are not limited to changing storage location, storage class, or retention policy. - Online serving cluster is under-provisioned.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* importFeatureValuesAsync(ImportFeatureValuesRequest request)
*
* Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
*
* importFeatureValuesAsync(EntityTypeName entityType)
*
importFeatureValuesAsync(String entityType)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* importFeatureValuesOperationCallable()
*
importFeatureValuesCallable()
*
*
*
*
* BatchReadFeatureValues
* Batch reads Feature values from a Featurestore.
*
This API enables batch reading Feature values, where each read instance in the batch may read Feature values of entities from one or more EntityTypes. Point-in-time correctness is guaranteed for Feature values of each read instance as of each instance's read timestamp.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* batchReadFeatureValuesAsync(BatchReadFeatureValuesRequest request)
*
* Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
*
* batchReadFeatureValuesAsync(FeaturestoreName featurestore)
*
batchReadFeatureValuesAsync(String featurestore)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* batchReadFeatureValuesOperationCallable()
*
batchReadFeatureValuesCallable()
*
*
*
*
* ExportFeatureValues
* Exports Feature values from all the entities of a target EntityType.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* exportFeatureValuesAsync(ExportFeatureValuesRequest request)
*
* Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
*
* exportFeatureValuesAsync(EntityTypeName entityType)
*
exportFeatureValuesAsync(String entityType)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* exportFeatureValuesOperationCallable()
*
exportFeatureValuesCallable()
*
*
*
*
* DeleteFeatureValues
* Delete Feature values from Featurestore.
*
The progress of the deletion is tracked by the returned operation. The deleted feature values are guaranteed to be invisible to subsequent read operations after the operation is marked as successfully done.
*
If a delete feature values operation fails, the feature values returned from reads and exports may be inconsistent. If consistency is required, the caller must retry the same delete request again and wait till the new operation returned is marked as successfully done.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* deleteFeatureValuesAsync(DeleteFeatureValuesRequest request)
*
* Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
*
* deleteFeatureValuesAsync(EntityTypeName entityType)
*
deleteFeatureValuesAsync(String entityType)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* deleteFeatureValuesOperationCallable()
*
deleteFeatureValuesCallable()
*
*
*
*
* SearchFeatures
* Searches Features matching a query in a given project.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* searchFeatures(SearchFeaturesRequest request)
*
* "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
*
* searchFeatures(LocationName location)
*
searchFeatures(String location)
*
searchFeatures(LocationName location, String query)
*
searchFeatures(String location, String query)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* searchFeaturesPagedCallable()
*
searchFeaturesCallable()
*
*
*
*
* ListLocations
* Lists information about the supported locations for this service.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* listLocations(ListLocationsRequest request)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* listLocationsPagedCallable()
*
listLocationsCallable()
*
*
*
*
* GetLocation
* Gets information about a location.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* getLocation(GetLocationRequest request)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* getLocationCallable()
*
*
*
*
* SetIamPolicy
* Sets the access control policy on the specified resource. Replacesany existing policy.
*
Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* setIamPolicy(SetIamPolicyRequest request)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* setIamPolicyCallable()
*
*
*
*
* GetIamPolicy
* Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* getIamPolicy(GetIamPolicyRequest request)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* getIamPolicyCallable()
*
*
*
*
* TestIamPermissions
* Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a `NOT_FOUND` error.
*
Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.
*
* Request object method variants only take one parameter, a request object, which must be constructed before the call.
*
* testIamPermissions(TestIamPermissionsRequest request)
*
* Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*
* testIamPermissionsCallable()
*
*
*
*
*
* See the individual methods for example code.
*
*
Many parameters require resource names to be formatted in a particular way. To assist with
* these names, this class includes a format method for each type of name, and additionally a parse
* method to extract the individual identifiers contained within names that are returned.
*
*
This class can be customized by passing in a custom instance of FeaturestoreServiceSettings to
* create(). For example:
*
*
To customize credentials:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FeaturestoreServiceSettings featurestoreServiceSettings =
* FeaturestoreServiceSettings.newBuilder()
* .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
* .build();
* FeaturestoreServiceClient featurestoreServiceClient =
* FeaturestoreServiceClient.create(featurestoreServiceSettings);
* }
*
* To customize the endpoint:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FeaturestoreServiceSettings featurestoreServiceSettings =
* FeaturestoreServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
* FeaturestoreServiceClient featurestoreServiceClient =
* FeaturestoreServiceClient.create(featurestoreServiceSettings);
* }
*
* Please refer to the GitHub repository's samples for more quickstart code snippets.
*/
@BetaApi
@Generated("by gapic-generator-java")
public class FeaturestoreServiceClient implements BackgroundResource {
private final FeaturestoreServiceSettings settings;
private final FeaturestoreServiceStub stub;
private final OperationsClient operationsClient;
/** Constructs an instance of FeaturestoreServiceClient with default settings. */
public static final FeaturestoreServiceClient create() throws IOException {
return create(FeaturestoreServiceSettings.newBuilder().build());
}
/**
* Constructs an instance of FeaturestoreServiceClient, using the given settings. The channels are
* created based on the settings passed in, or defaults for any settings that are not set.
*/
public static final FeaturestoreServiceClient create(FeaturestoreServiceSettings settings)
throws IOException {
return new FeaturestoreServiceClient(settings);
}
/**
* Constructs an instance of FeaturestoreServiceClient, using the given stub for making calls.
* This is for advanced usage - prefer using create(FeaturestoreServiceSettings).
*/
public static final FeaturestoreServiceClient create(FeaturestoreServiceStub stub) {
return new FeaturestoreServiceClient(stub);
}
/**
* Constructs an instance of FeaturestoreServiceClient, using the given settings. This is
* protected so that it is easy to make a subclass, but otherwise, the static factory methods
* should be preferred.
*/
protected FeaturestoreServiceClient(FeaturestoreServiceSettings settings) throws IOException {
this.settings = settings;
this.stub = ((FeaturestoreServiceStubSettings) settings.getStubSettings()).createStub();
this.operationsClient = OperationsClient.create(this.stub.getOperationsStub());
}
protected FeaturestoreServiceClient(FeaturestoreServiceStub stub) {
this.settings = null;
this.stub = stub;
this.operationsClient = OperationsClient.create(this.stub.getOperationsStub());
}
public final FeaturestoreServiceSettings getSettings() {
return settings;
}
public FeaturestoreServiceStub getStub() {
return stub;
}
/**
* Returns the OperationsClient that can be used to query the status of a long-running operation
* returned by another API method call.
*/
public final OperationsClient getOperationsClient() {
return operationsClient;
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Featurestore in a given project and location.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* Featurestore featurestore = Featurestore.newBuilder().build();
* Featurestore response =
* featurestoreServiceClient.createFeaturestoreAsync(parent, featurestore).get();
* }
* }
*
* @param parent Required. The resource name of the Location to create Featurestores. Format:
* `projects/{project}/locations/{location}`
* @param featurestore Required. The Featurestore to create.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
createFeaturestoreAsync(LocationName parent, Featurestore featurestore) {
CreateFeaturestoreRequest request =
CreateFeaturestoreRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.setFeaturestore(featurestore)
.build();
return createFeaturestoreAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Featurestore in a given project and location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* Featurestore featurestore = Featurestore.newBuilder().build();
* Featurestore response =
* featurestoreServiceClient.createFeaturestoreAsync(parent, featurestore).get();
* }
* }
*
* @param parent Required. The resource name of the Location to create Featurestores. Format:
* `projects/{project}/locations/{location}`
* @param featurestore Required. The Featurestore to create.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
createFeaturestoreAsync(String parent, Featurestore featurestore) {
CreateFeaturestoreRequest request =
CreateFeaturestoreRequest.newBuilder()
.setParent(parent)
.setFeaturestore(featurestore)
.build();
return createFeaturestoreAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Featurestore in a given project and location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* Featurestore featurestore = Featurestore.newBuilder().build();
* String featurestoreId = "featurestoreId-1315851738";
* Featurestore response =
* featurestoreServiceClient
* .createFeaturestoreAsync(parent, featurestore, featurestoreId)
* .get();
* }
* }
*
* @param parent Required. The resource name of the Location to create Featurestores. Format:
* `projects/{project}/locations/{location}`
* @param featurestore Required. The Featurestore to create.
* @param featurestoreId Required. The ID to use for this Featurestore, which will become the
* final component of the Featurestore's resource name.
* This value may be up to 60 characters, and valid characters are `[a-z0-9_]`. The first
* character cannot be a number.
*
The value must be unique within the project and location.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
createFeaturestoreAsync(
LocationName parent, Featurestore featurestore, String featurestoreId) {
CreateFeaturestoreRequest request =
CreateFeaturestoreRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.setFeaturestore(featurestore)
.setFeaturestoreId(featurestoreId)
.build();
return createFeaturestoreAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Featurestore in a given project and location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* Featurestore featurestore = Featurestore.newBuilder().build();
* String featurestoreId = "featurestoreId-1315851738";
* Featurestore response =
* featurestoreServiceClient
* .createFeaturestoreAsync(parent, featurestore, featurestoreId)
* .get();
* }
* }
*
* @param parent Required. The resource name of the Location to create Featurestores. Format:
* `projects/{project}/locations/{location}`
* @param featurestore Required. The Featurestore to create.
* @param featurestoreId Required. The ID to use for this Featurestore, which will become the
* final component of the Featurestore's resource name.
* This value may be up to 60 characters, and valid characters are `[a-z0-9_]`. The first
* character cannot be a number.
*
The value must be unique within the project and location.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
createFeaturestoreAsync(String parent, Featurestore featurestore, String featurestoreId) {
CreateFeaturestoreRequest request =
CreateFeaturestoreRequest.newBuilder()
.setParent(parent)
.setFeaturestore(featurestore)
.setFeaturestoreId(featurestoreId)
.build();
return createFeaturestoreAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Featurestore in a given project and location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* CreateFeaturestoreRequest request =
* CreateFeaturestoreRequest.newBuilder()
* .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
* .setFeaturestore(Featurestore.newBuilder().build())
* .setFeaturestoreId("featurestoreId-1315851738")
* .build();
* Featurestore response = featurestoreServiceClient.createFeaturestoreAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
createFeaturestoreAsync(CreateFeaturestoreRequest request) {
return createFeaturestoreOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Featurestore in a given project and location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* CreateFeaturestoreRequest request =
* CreateFeaturestoreRequest.newBuilder()
* .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
* .setFeaturestore(Featurestore.newBuilder().build())
* .setFeaturestoreId("featurestoreId-1315851738")
* .build();
* OperationFuture future =
* featurestoreServiceClient.createFeaturestoreOperationCallable().futureCall(request);
* // Do something.
* Featurestore response = future.get();
* }
* }
*/
public final OperationCallable<
CreateFeaturestoreRequest, Featurestore, CreateFeaturestoreOperationMetadata>
createFeaturestoreOperationCallable() {
return stub.createFeaturestoreOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Featurestore in a given project and location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* CreateFeaturestoreRequest request =
* CreateFeaturestoreRequest.newBuilder()
* .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
* .setFeaturestore(Featurestore.newBuilder().build())
* .setFeaturestoreId("featurestoreId-1315851738")
* .build();
* ApiFuture future =
* featurestoreServiceClient.createFeaturestoreCallable().futureCall(request);
* // Do something.
* Operation response = future.get();
* }
* }
*/
public final UnaryCallable createFeaturestoreCallable() {
return stub.createFeaturestoreCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeaturestoreName name = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]");
* Featurestore response = featurestoreServiceClient.getFeaturestore(name);
* }
* }
*
* @param name Required. The name of the Featurestore resource.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Featurestore getFeaturestore(FeaturestoreName name) {
GetFeaturestoreRequest request =
GetFeaturestoreRequest.newBuilder().setName(name == null ? null : name.toString()).build();
return getFeaturestore(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String name = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString();
* Featurestore response = featurestoreServiceClient.getFeaturestore(name);
* }
* }
*
* @param name Required. The name of the Featurestore resource.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Featurestore getFeaturestore(String name) {
GetFeaturestoreRequest request = GetFeaturestoreRequest.newBuilder().setName(name).build();
return getFeaturestore(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* GetFeaturestoreRequest request =
* GetFeaturestoreRequest.newBuilder()
* .setName(FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .build();
* Featurestore response = featurestoreServiceClient.getFeaturestore(request);
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Featurestore getFeaturestore(GetFeaturestoreRequest request) {
return getFeaturestoreCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* GetFeaturestoreRequest request =
* GetFeaturestoreRequest.newBuilder()
* .setName(FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .build();
* ApiFuture future =
* featurestoreServiceClient.getFeaturestoreCallable().futureCall(request);
* // Do something.
* Featurestore response = future.get();
* }
* }
*/
public final UnaryCallable getFeaturestoreCallable() {
return stub.getFeaturestoreCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists Featurestores in a given project and location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* for (Featurestore element :
* featurestoreServiceClient.listFeaturestores(parent).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param parent Required. The resource name of the Location to list Featurestores. Format:
* `projects/{project}/locations/{location}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListFeaturestoresPagedResponse listFeaturestores(LocationName parent) {
ListFeaturestoresRequest request =
ListFeaturestoresRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.build();
return listFeaturestores(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists Featurestores in a given project and location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* for (Featurestore element :
* featurestoreServiceClient.listFeaturestores(parent).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param parent Required. The resource name of the Location to list Featurestores. Format:
* `projects/{project}/locations/{location}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListFeaturestoresPagedResponse listFeaturestores(String parent) {
ListFeaturestoresRequest request =
ListFeaturestoresRequest.newBuilder().setParent(parent).build();
return listFeaturestores(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists Featurestores in a given project and location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListFeaturestoresRequest request =
* ListFeaturestoresRequest.newBuilder()
* .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .setOrderBy("orderBy-1207110587")
* .setReadMask(FieldMask.newBuilder().build())
* .build();
* for (Featurestore element :
* featurestoreServiceClient.listFeaturestores(request).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListFeaturestoresPagedResponse listFeaturestores(ListFeaturestoresRequest request) {
return listFeaturestoresPagedCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists Featurestores in a given project and location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListFeaturestoresRequest request =
* ListFeaturestoresRequest.newBuilder()
* .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .setOrderBy("orderBy-1207110587")
* .setReadMask(FieldMask.newBuilder().build())
* .build();
* ApiFuture future =
* featurestoreServiceClient.listFeaturestoresPagedCallable().futureCall(request);
* // Do something.
* for (Featurestore element : future.get().iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*/
public final UnaryCallable
listFeaturestoresPagedCallable() {
return stub.listFeaturestoresPagedCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists Featurestores in a given project and location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListFeaturestoresRequest request =
* ListFeaturestoresRequest.newBuilder()
* .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .setOrderBy("orderBy-1207110587")
* .setReadMask(FieldMask.newBuilder().build())
* .build();
* while (true) {
* ListFeaturestoresResponse response =
* featurestoreServiceClient.listFeaturestoresCallable().call(request);
* for (Featurestore element : response.getFeaturestoresList()) {
* // doThingsWith(element);
* }
* String nextPageToken = response.getNextPageToken();
* if (!Strings.isNullOrEmpty(nextPageToken)) {
* request = request.toBuilder().setPageToken(nextPageToken).build();
* } else {
* break;
* }
* }
* }
* }
*/
public final UnaryCallable
listFeaturestoresCallable() {
return stub.listFeaturestoresCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates the parameters of a single Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* Featurestore featurestore = Featurestore.newBuilder().build();
* FieldMask updateMask = FieldMask.newBuilder().build();
* Featurestore response =
* featurestoreServiceClient.updateFeaturestoreAsync(featurestore, updateMask).get();
* }
* }
*
* @param featurestore Required. The Featurestore's `name` field is used to identify the
* Featurestore to be updated. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @param updateMask Field mask is used to specify the fields to be overwritten in the
* Featurestore resource by the update. The fields specified in the update_mask are relative
* to the resource, not the full request. A field will be overwritten if it is in the mask. If
* the user does not provide a mask then only the non-empty fields present in the request will
* be overwritten. Set the update_mask to `*` to override all fields.
* Updatable fields:
*
* `labels` * `online_serving_config.fixed_node_count` *
* `online_serving_config.scaling` * `online_storage_ttl_days`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
updateFeaturestoreAsync(Featurestore featurestore, FieldMask updateMask) {
UpdateFeaturestoreRequest request =
UpdateFeaturestoreRequest.newBuilder()
.setFeaturestore(featurestore)
.setUpdateMask(updateMask)
.build();
return updateFeaturestoreAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates the parameters of a single Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* UpdateFeaturestoreRequest request =
* UpdateFeaturestoreRequest.newBuilder()
* .setFeaturestore(Featurestore.newBuilder().build())
* .setUpdateMask(FieldMask.newBuilder().build())
* .build();
* Featurestore response = featurestoreServiceClient.updateFeaturestoreAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
updateFeaturestoreAsync(UpdateFeaturestoreRequest request) {
return updateFeaturestoreOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates the parameters of a single Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* UpdateFeaturestoreRequest request =
* UpdateFeaturestoreRequest.newBuilder()
* .setFeaturestore(Featurestore.newBuilder().build())
* .setUpdateMask(FieldMask.newBuilder().build())
* .build();
* OperationFuture future =
* featurestoreServiceClient.updateFeaturestoreOperationCallable().futureCall(request);
* // Do something.
* Featurestore response = future.get();
* }
* }
*/
public final OperationCallable<
UpdateFeaturestoreRequest, Featurestore, UpdateFeaturestoreOperationMetadata>
updateFeaturestoreOperationCallable() {
return stub.updateFeaturestoreOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates the parameters of a single Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* UpdateFeaturestoreRequest request =
* UpdateFeaturestoreRequest.newBuilder()
* .setFeaturestore(Featurestore.newBuilder().build())
* .setUpdateMask(FieldMask.newBuilder().build())
* .build();
* ApiFuture future =
* featurestoreServiceClient.updateFeaturestoreCallable().futureCall(request);
* // Do something.
* Operation response = future.get();
* }
* }
*/
public final UnaryCallable updateFeaturestoreCallable() {
return stub.updateFeaturestoreCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Featurestore. The Featurestore must not contain any EntityTypes or `force`
* must be set to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeaturestoreName name = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]");
* featurestoreServiceClient.deleteFeaturestoreAsync(name).get();
* }
* }
*
* @param name Required. The name of the Featurestore to be deleted. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteFeaturestoreAsync(
FeaturestoreName name) {
DeleteFeaturestoreRequest request =
DeleteFeaturestoreRequest.newBuilder()
.setName(name == null ? null : name.toString())
.build();
return deleteFeaturestoreAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Featurestore. The Featurestore must not contain any EntityTypes or `force`
* must be set to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String name = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString();
* featurestoreServiceClient.deleteFeaturestoreAsync(name).get();
* }
* }
*
* @param name Required. The name of the Featurestore to be deleted. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteFeaturestoreAsync(
String name) {
DeleteFeaturestoreRequest request =
DeleteFeaturestoreRequest.newBuilder().setName(name).build();
return deleteFeaturestoreAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Featurestore. The Featurestore must not contain any EntityTypes or `force`
* must be set to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeaturestoreName name = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]");
* boolean force = true;
* featurestoreServiceClient.deleteFeaturestoreAsync(name, force).get();
* }
* }
*
* @param name Required. The name of the Featurestore to be deleted. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @param force If set to true, any EntityTypes and Features for this Featurestore will also be
* deleted. (Otherwise, the request will only work if the Featurestore has no EntityTypes.)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteFeaturestoreAsync(
FeaturestoreName name, boolean force) {
DeleteFeaturestoreRequest request =
DeleteFeaturestoreRequest.newBuilder()
.setName(name == null ? null : name.toString())
.setForce(force)
.build();
return deleteFeaturestoreAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Featurestore. The Featurestore must not contain any EntityTypes or `force`
* must be set to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String name = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString();
* boolean force = true;
* featurestoreServiceClient.deleteFeaturestoreAsync(name, force).get();
* }
* }
*
* @param name Required. The name of the Featurestore to be deleted. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @param force If set to true, any EntityTypes and Features for this Featurestore will also be
* deleted. (Otherwise, the request will only work if the Featurestore has no EntityTypes.)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteFeaturestoreAsync(
String name, boolean force) {
DeleteFeaturestoreRequest request =
DeleteFeaturestoreRequest.newBuilder().setName(name).setForce(force).build();
return deleteFeaturestoreAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Featurestore. The Featurestore must not contain any EntityTypes or `force`
* must be set to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteFeaturestoreRequest request =
* DeleteFeaturestoreRequest.newBuilder()
* .setName(FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setForce(true)
* .build();
* featurestoreServiceClient.deleteFeaturestoreAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteFeaturestoreAsync(
DeleteFeaturestoreRequest request) {
return deleteFeaturestoreOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Featurestore. The Featurestore must not contain any EntityTypes or `force`
* must be set to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteFeaturestoreRequest request =
* DeleteFeaturestoreRequest.newBuilder()
* .setName(FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setForce(true)
* .build();
* OperationFuture future =
* featurestoreServiceClient.deleteFeaturestoreOperationCallable().futureCall(request);
* // Do something.
* future.get();
* }
* }
*/
public final OperationCallable
deleteFeaturestoreOperationCallable() {
return stub.deleteFeaturestoreOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Featurestore. The Featurestore must not contain any EntityTypes or `force`
* must be set to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteFeaturestoreRequest request =
* DeleteFeaturestoreRequest.newBuilder()
* .setName(FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setForce(true)
* .build();
* ApiFuture future =
* featurestoreServiceClient.deleteFeaturestoreCallable().futureCall(request);
* // Do something.
* future.get();
* }
* }
*/
public final UnaryCallable deleteFeaturestoreCallable() {
return stub.deleteFeaturestoreCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new EntityType in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeaturestoreName parent = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]");
* EntityType entityType = EntityType.newBuilder().build();
* EntityType response =
* featurestoreServiceClient.createEntityTypeAsync(parent, entityType).get();
* }
* }
*
* @param parent Required. The resource name of the Featurestore to create EntityTypes. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @param entityType The EntityType to create.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createEntityTypeAsync(
FeaturestoreName parent, EntityType entityType) {
CreateEntityTypeRequest request =
CreateEntityTypeRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.setEntityType(entityType)
.build();
return createEntityTypeAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new EntityType in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String parent = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString();
* EntityType entityType = EntityType.newBuilder().build();
* EntityType response =
* featurestoreServiceClient.createEntityTypeAsync(parent, entityType).get();
* }
* }
*
* @param parent Required. The resource name of the Featurestore to create EntityTypes. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @param entityType The EntityType to create.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createEntityTypeAsync(
String parent, EntityType entityType) {
CreateEntityTypeRequest request =
CreateEntityTypeRequest.newBuilder().setParent(parent).setEntityType(entityType).build();
return createEntityTypeAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new EntityType in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeaturestoreName parent = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]");
* EntityType entityType = EntityType.newBuilder().build();
* String entityTypeId = "entityTypeId767740856";
* EntityType response =
* featurestoreServiceClient.createEntityTypeAsync(parent, entityType, entityTypeId).get();
* }
* }
*
* @param parent Required. The resource name of the Featurestore to create EntityTypes. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @param entityType The EntityType to create.
* @param entityTypeId Required. The ID to use for the EntityType, which will become the final
* component of the EntityType's resource name.
* This value may be up to 60 characters, and valid characters are `[a-z0-9_]`. The first
* character cannot be a number.
*
The value must be unique within a featurestore.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createEntityTypeAsync(
FeaturestoreName parent, EntityType entityType, String entityTypeId) {
CreateEntityTypeRequest request =
CreateEntityTypeRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.setEntityType(entityType)
.setEntityTypeId(entityTypeId)
.build();
return createEntityTypeAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new EntityType in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String parent = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString();
* EntityType entityType = EntityType.newBuilder().build();
* String entityTypeId = "entityTypeId767740856";
* EntityType response =
* featurestoreServiceClient.createEntityTypeAsync(parent, entityType, entityTypeId).get();
* }
* }
*
* @param parent Required. The resource name of the Featurestore to create EntityTypes. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @param entityType The EntityType to create.
* @param entityTypeId Required. The ID to use for the EntityType, which will become the final
* component of the EntityType's resource name.
* This value may be up to 60 characters, and valid characters are `[a-z0-9_]`. The first
* character cannot be a number.
*
The value must be unique within a featurestore.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createEntityTypeAsync(
String parent, EntityType entityType, String entityTypeId) {
CreateEntityTypeRequest request =
CreateEntityTypeRequest.newBuilder()
.setParent(parent)
.setEntityType(entityType)
.setEntityTypeId(entityTypeId)
.build();
return createEntityTypeAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new EntityType in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* CreateEntityTypeRequest request =
* CreateEntityTypeRequest.newBuilder()
* .setParent(
* FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setEntityType(EntityType.newBuilder().build())
* .setEntityTypeId("entityTypeId767740856")
* .build();
* EntityType response = featurestoreServiceClient.createEntityTypeAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createEntityTypeAsync(
CreateEntityTypeRequest request) {
return createEntityTypeOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new EntityType in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* CreateEntityTypeRequest request =
* CreateEntityTypeRequest.newBuilder()
* .setParent(
* FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setEntityType(EntityType.newBuilder().build())
* .setEntityTypeId("entityTypeId767740856")
* .build();
* OperationFuture future =
* featurestoreServiceClient.createEntityTypeOperationCallable().futureCall(request);
* // Do something.
* EntityType response = future.get();
* }
* }
*/
public final OperationCallable<
CreateEntityTypeRequest, EntityType, CreateEntityTypeOperationMetadata>
createEntityTypeOperationCallable() {
return stub.createEntityTypeOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new EntityType in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* CreateEntityTypeRequest request =
* CreateEntityTypeRequest.newBuilder()
* .setParent(
* FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setEntityType(EntityType.newBuilder().build())
* .setEntityTypeId("entityTypeId767740856")
* .build();
* ApiFuture future =
* featurestoreServiceClient.createEntityTypeCallable().futureCall(request);
* // Do something.
* Operation response = future.get();
* }
* }
*/
public final UnaryCallable createEntityTypeCallable() {
return stub.createEntityTypeCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* EntityTypeName name =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]");
* EntityType response = featurestoreServiceClient.getEntityType(name);
* }
* }
*
* @param name Required. The name of the EntityType resource. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final EntityType getEntityType(EntityTypeName name) {
GetEntityTypeRequest request =
GetEntityTypeRequest.newBuilder().setName(name == null ? null : name.toString()).build();
return getEntityType(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String name =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString();
* EntityType response = featurestoreServiceClient.getEntityType(name);
* }
* }
*
* @param name Required. The name of the EntityType resource. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final EntityType getEntityType(String name) {
GetEntityTypeRequest request = GetEntityTypeRequest.newBuilder().setName(name).build();
return getEntityType(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* GetEntityTypeRequest request =
* GetEntityTypeRequest.newBuilder()
* .setName(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .build();
* EntityType response = featurestoreServiceClient.getEntityType(request);
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final EntityType getEntityType(GetEntityTypeRequest request) {
return getEntityTypeCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* GetEntityTypeRequest request =
* GetEntityTypeRequest.newBuilder()
* .setName(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .build();
* ApiFuture future =
* featurestoreServiceClient.getEntityTypeCallable().futureCall(request);
* // Do something.
* EntityType response = future.get();
* }
* }
*/
public final UnaryCallable getEntityTypeCallable() {
return stub.getEntityTypeCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists EntityTypes in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeaturestoreName parent = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]");
* for (EntityType element : featurestoreServiceClient.listEntityTypes(parent).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param parent Required. The resource name of the Featurestore to list EntityTypes. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListEntityTypesPagedResponse listEntityTypes(FeaturestoreName parent) {
ListEntityTypesRequest request =
ListEntityTypesRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.build();
return listEntityTypes(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists EntityTypes in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String parent = FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString();
* for (EntityType element : featurestoreServiceClient.listEntityTypes(parent).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param parent Required. The resource name of the Featurestore to list EntityTypes. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListEntityTypesPagedResponse listEntityTypes(String parent) {
ListEntityTypesRequest request = ListEntityTypesRequest.newBuilder().setParent(parent).build();
return listEntityTypes(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists EntityTypes in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListEntityTypesRequest request =
* ListEntityTypesRequest.newBuilder()
* .setParent(
* FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .setOrderBy("orderBy-1207110587")
* .setReadMask(FieldMask.newBuilder().build())
* .build();
* for (EntityType element : featurestoreServiceClient.listEntityTypes(request).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListEntityTypesPagedResponse listEntityTypes(ListEntityTypesRequest request) {
return listEntityTypesPagedCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists EntityTypes in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListEntityTypesRequest request =
* ListEntityTypesRequest.newBuilder()
* .setParent(
* FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .setOrderBy("orderBy-1207110587")
* .setReadMask(FieldMask.newBuilder().build())
* .build();
* ApiFuture future =
* featurestoreServiceClient.listEntityTypesPagedCallable().futureCall(request);
* // Do something.
* for (EntityType element : future.get().iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*/
public final UnaryCallable
listEntityTypesPagedCallable() {
return stub.listEntityTypesPagedCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists EntityTypes in a given Featurestore.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListEntityTypesRequest request =
* ListEntityTypesRequest.newBuilder()
* .setParent(
* FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .setOrderBy("orderBy-1207110587")
* .setReadMask(FieldMask.newBuilder().build())
* .build();
* while (true) {
* ListEntityTypesResponse response =
* featurestoreServiceClient.listEntityTypesCallable().call(request);
* for (EntityType element : response.getEntityTypesList()) {
* // doThingsWith(element);
* }
* String nextPageToken = response.getNextPageToken();
* if (!Strings.isNullOrEmpty(nextPageToken)) {
* request = request.toBuilder().setPageToken(nextPageToken).build();
* } else {
* break;
* }
* }
* }
* }
*/
public final UnaryCallable
listEntityTypesCallable() {
return stub.listEntityTypesCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates the parameters of a single EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* EntityType entityType = EntityType.newBuilder().build();
* FieldMask updateMask = FieldMask.newBuilder().build();
* EntityType response = featurestoreServiceClient.updateEntityType(entityType, updateMask);
* }
* }
*
* @param entityType Required. The EntityType's `name` field is used to identify the EntityType to
* be updated. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* @param updateMask Field mask is used to specify the fields to be overwritten in the EntityType
* resource by the update. The fields specified in the update_mask are relative to the
* resource, not the full request. A field will be overwritten if it is in the mask. If the
* user does not provide a mask then only the non-empty fields present in the request will be
* overwritten. Set the update_mask to `*` to override all fields.
* Updatable fields:
*
* `description` * `labels` * `monitoring_config.snapshot_analysis.disabled`
* * `monitoring_config.snapshot_analysis.monitoring_interval_days` *
* `monitoring_config.snapshot_analysis.staleness_days` *
* `monitoring_config.import_features_analysis.state` *
* `monitoring_config.import_features_analysis.anomaly_detection_baseline` *
* `monitoring_config.numerical_threshold_config.value` *
* `monitoring_config.categorical_threshold_config.value` * `offline_storage_ttl_days`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final EntityType updateEntityType(EntityType entityType, FieldMask updateMask) {
UpdateEntityTypeRequest request =
UpdateEntityTypeRequest.newBuilder()
.setEntityType(entityType)
.setUpdateMask(updateMask)
.build();
return updateEntityType(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates the parameters of a single EntityType.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* UpdateEntityTypeRequest request =
* UpdateEntityTypeRequest.newBuilder()
* .setEntityType(EntityType.newBuilder().build())
* .setUpdateMask(FieldMask.newBuilder().build())
* .build();
* EntityType response = featurestoreServiceClient.updateEntityType(request);
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final EntityType updateEntityType(UpdateEntityTypeRequest request) {
return updateEntityTypeCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates the parameters of a single EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* UpdateEntityTypeRequest request =
* UpdateEntityTypeRequest.newBuilder()
* .setEntityType(EntityType.newBuilder().build())
* .setUpdateMask(FieldMask.newBuilder().build())
* .build();
* ApiFuture future =
* featurestoreServiceClient.updateEntityTypeCallable().futureCall(request);
* // Do something.
* EntityType response = future.get();
* }
* }
*/
public final UnaryCallable updateEntityTypeCallable() {
return stub.updateEntityTypeCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single EntityType. The EntityType must not have any Features or `force` must be set
* to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* EntityTypeName name =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]");
* featurestoreServiceClient.deleteEntityTypeAsync(name).get();
* }
* }
*
* @param name Required. The name of the EntityType to be deleted. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteEntityTypeAsync(
EntityTypeName name) {
DeleteEntityTypeRequest request =
DeleteEntityTypeRequest.newBuilder().setName(name == null ? null : name.toString()).build();
return deleteEntityTypeAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single EntityType. The EntityType must not have any Features or `force` must be set
* to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String name =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString();
* featurestoreServiceClient.deleteEntityTypeAsync(name).get();
* }
* }
*
* @param name Required. The name of the EntityType to be deleted. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteEntityTypeAsync(String name) {
DeleteEntityTypeRequest request = DeleteEntityTypeRequest.newBuilder().setName(name).build();
return deleteEntityTypeAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single EntityType. The EntityType must not have any Features or `force` must be set
* to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* EntityTypeName name =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]");
* boolean force = true;
* featurestoreServiceClient.deleteEntityTypeAsync(name, force).get();
* }
* }
*
* @param name Required. The name of the EntityType to be deleted. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* @param force If set to true, any Features for this EntityType will also be deleted. (Otherwise,
* the request will only work if the EntityType has no Features.)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteEntityTypeAsync(
EntityTypeName name, boolean force) {
DeleteEntityTypeRequest request =
DeleteEntityTypeRequest.newBuilder()
.setName(name == null ? null : name.toString())
.setForce(force)
.build();
return deleteEntityTypeAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single EntityType. The EntityType must not have any Features or `force` must be set
* to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String name =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString();
* boolean force = true;
* featurestoreServiceClient.deleteEntityTypeAsync(name, force).get();
* }
* }
*
* @param name Required. The name of the EntityType to be deleted. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* @param force If set to true, any Features for this EntityType will also be deleted. (Otherwise,
* the request will only work if the EntityType has no Features.)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteEntityTypeAsync(
String name, boolean force) {
DeleteEntityTypeRequest request =
DeleteEntityTypeRequest.newBuilder().setName(name).setForce(force).build();
return deleteEntityTypeAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single EntityType. The EntityType must not have any Features or `force` must be set
* to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteEntityTypeRequest request =
* DeleteEntityTypeRequest.newBuilder()
* .setName(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setForce(true)
* .build();
* featurestoreServiceClient.deleteEntityTypeAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteEntityTypeAsync(
DeleteEntityTypeRequest request) {
return deleteEntityTypeOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single EntityType. The EntityType must not have any Features or `force` must be set
* to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteEntityTypeRequest request =
* DeleteEntityTypeRequest.newBuilder()
* .setName(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setForce(true)
* .build();
* OperationFuture future =
* featurestoreServiceClient.deleteEntityTypeOperationCallable().futureCall(request);
* // Do something.
* future.get();
* }
* }
*/
public final OperationCallable
deleteEntityTypeOperationCallable() {
return stub.deleteEntityTypeOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single EntityType. The EntityType must not have any Features or `force` must be set
* to true for the request to succeed.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteEntityTypeRequest request =
* DeleteEntityTypeRequest.newBuilder()
* .setName(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setForce(true)
* .build();
* ApiFuture future =
* featurestoreServiceClient.deleteEntityTypeCallable().futureCall(request);
* // Do something.
* future.get();
* }
* }
*/
public final UnaryCallable deleteEntityTypeCallable() {
return stub.deleteEntityTypeCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Feature in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* EntityTypeName parent =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]");
* Feature feature = Feature.newBuilder().build();
* Feature response = featurestoreServiceClient.createFeatureAsync(parent, feature).get();
* }
* }
*
* @param parent Required. The resource name of the EntityType or FeatureGroup to create a
* Feature. Format for entity_type as parent:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* Format for feature_group as parent:
* `projects/{project}/locations/{location}/featureGroups/{feature_group}`
* @param feature Required. The Feature to create.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createFeatureAsync(
EntityTypeName parent, Feature feature) {
CreateFeatureRequest request =
CreateFeatureRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.setFeature(feature)
.build();
return createFeatureAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Feature in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeatureGroupName parent = FeatureGroupName.of("[PROJECT]", "[LOCATION]", "[FEATURE_GROUP]");
* Feature feature = Feature.newBuilder().build();
* Feature response = featurestoreServiceClient.createFeatureAsync(parent, feature).get();
* }
* }
*
* @param parent Required. The resource name of the EntityType or FeatureGroup to create a
* Feature. Format for entity_type as parent:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* Format for feature_group as parent:
* `projects/{project}/locations/{location}/featureGroups/{feature_group}`
* @param feature Required. The Feature to create.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createFeatureAsync(
FeatureGroupName parent, Feature feature) {
CreateFeatureRequest request =
CreateFeatureRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.setFeature(feature)
.build();
return createFeatureAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Feature in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String parent =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString();
* Feature feature = Feature.newBuilder().build();
* Feature response = featurestoreServiceClient.createFeatureAsync(parent, feature).get();
* }
* }
*
* @param parent Required. The resource name of the EntityType or FeatureGroup to create a
* Feature. Format for entity_type as parent:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* Format for feature_group as parent:
* `projects/{project}/locations/{location}/featureGroups/{feature_group}`
* @param feature Required. The Feature to create.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createFeatureAsync(
String parent, Feature feature) {
CreateFeatureRequest request =
CreateFeatureRequest.newBuilder().setParent(parent).setFeature(feature).build();
return createFeatureAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Feature in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* EntityTypeName parent =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]");
* Feature feature = Feature.newBuilder().build();
* String featureId = "featureId-420503887";
* Feature response =
* featurestoreServiceClient.createFeatureAsync(parent, feature, featureId).get();
* }
* }
*
* @param parent Required. The resource name of the EntityType or FeatureGroup to create a
* Feature. Format for entity_type as parent:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* Format for feature_group as parent:
* `projects/{project}/locations/{location}/featureGroups/{feature_group}`
* @param feature Required. The Feature to create.
* @param featureId Required. The ID to use for the Feature, which will become the final component
* of the Feature's resource name.
* This value may be up to 128 characters, and valid characters are `[a-z0-9_]`. The first
* character cannot be a number.
*
The value must be unique within an EntityType/FeatureGroup.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createFeatureAsync(
EntityTypeName parent, Feature feature, String featureId) {
CreateFeatureRequest request =
CreateFeatureRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.setFeature(feature)
.setFeatureId(featureId)
.build();
return createFeatureAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Feature in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeatureGroupName parent = FeatureGroupName.of("[PROJECT]", "[LOCATION]", "[FEATURE_GROUP]");
* Feature feature = Feature.newBuilder().build();
* String featureId = "featureId-420503887";
* Feature response =
* featurestoreServiceClient.createFeatureAsync(parent, feature, featureId).get();
* }
* }
*
* @param parent Required. The resource name of the EntityType or FeatureGroup to create a
* Feature. Format for entity_type as parent:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* Format for feature_group as parent:
* `projects/{project}/locations/{location}/featureGroups/{feature_group}`
* @param feature Required. The Feature to create.
* @param featureId Required. The ID to use for the Feature, which will become the final component
* of the Feature's resource name.
* This value may be up to 128 characters, and valid characters are `[a-z0-9_]`. The first
* character cannot be a number.
*
The value must be unique within an EntityType/FeatureGroup.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createFeatureAsync(
FeatureGroupName parent, Feature feature, String featureId) {
CreateFeatureRequest request =
CreateFeatureRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.setFeature(feature)
.setFeatureId(featureId)
.build();
return createFeatureAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Feature in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String parent =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString();
* Feature feature = Feature.newBuilder().build();
* String featureId = "featureId-420503887";
* Feature response =
* featurestoreServiceClient.createFeatureAsync(parent, feature, featureId).get();
* }
* }
*
* @param parent Required. The resource name of the EntityType or FeatureGroup to create a
* Feature. Format for entity_type as parent:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* Format for feature_group as parent:
* `projects/{project}/locations/{location}/featureGroups/{feature_group}`
* @param feature Required. The Feature to create.
* @param featureId Required. The ID to use for the Feature, which will become the final component
* of the Feature's resource name.
* This value may be up to 128 characters, and valid characters are `[a-z0-9_]`. The first
* character cannot be a number.
*
The value must be unique within an EntityType/FeatureGroup.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createFeatureAsync(
String parent, Feature feature, String featureId) {
CreateFeatureRequest request =
CreateFeatureRequest.newBuilder()
.setParent(parent)
.setFeature(feature)
.setFeatureId(featureId)
.build();
return createFeatureAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Feature in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* CreateFeatureRequest request =
* CreateFeatureRequest.newBuilder()
* .setParent(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setFeature(Feature.newBuilder().build())
* .setFeatureId("featureId-420503887")
* .build();
* Feature response = featurestoreServiceClient.createFeatureAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture createFeatureAsync(
CreateFeatureRequest request) {
return createFeatureOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Feature in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* CreateFeatureRequest request =
* CreateFeatureRequest.newBuilder()
* .setParent(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setFeature(Feature.newBuilder().build())
* .setFeatureId("featureId-420503887")
* .build();
* OperationFuture future =
* featurestoreServiceClient.createFeatureOperationCallable().futureCall(request);
* // Do something.
* Feature response = future.get();
* }
* }
*/
public final OperationCallable
createFeatureOperationCallable() {
return stub.createFeatureOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a new Feature in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* CreateFeatureRequest request =
* CreateFeatureRequest.newBuilder()
* .setParent(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setFeature(Feature.newBuilder().build())
* .setFeatureId("featureId-420503887")
* .build();
* ApiFuture future =
* featurestoreServiceClient.createFeatureCallable().futureCall(request);
* // Do something.
* Operation response = future.get();
* }
* }
*/
public final UnaryCallable createFeatureCallable() {
return stub.createFeatureCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a batch of Features in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* EntityTypeName parent =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]");
* List requests = new ArrayList<>();
* BatchCreateFeaturesResponse response =
* featurestoreServiceClient.batchCreateFeaturesAsync(parent, requests).get();
* }
* }
*
* @param parent Required. The resource name of the EntityType to create the batch of Features
* under. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* @param requests Required. The request message specifying the Features to create. All Features
* must be created under the same parent EntityType. The `parent` field in each child request
* message can be omitted. If `parent` is set in a child request, then the value must match
* the `parent` value in this request message.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
batchCreateFeaturesAsync(EntityTypeName parent, List requests) {
BatchCreateFeaturesRequest request =
BatchCreateFeaturesRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.addAllRequests(requests)
.build();
return batchCreateFeaturesAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a batch of Features in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String parent =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString();
* List requests = new ArrayList<>();
* BatchCreateFeaturesResponse response =
* featurestoreServiceClient.batchCreateFeaturesAsync(parent, requests).get();
* }
* }
*
* @param parent Required. The resource name of the EntityType to create the batch of Features
* under. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* @param requests Required. The request message specifying the Features to create. All Features
* must be created under the same parent EntityType. The `parent` field in each child request
* message can be omitted. If `parent` is set in a child request, then the value must match
* the `parent` value in this request message.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
batchCreateFeaturesAsync(String parent, List requests) {
BatchCreateFeaturesRequest request =
BatchCreateFeaturesRequest.newBuilder().setParent(parent).addAllRequests(requests).build();
return batchCreateFeaturesAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a batch of Features in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* BatchCreateFeaturesRequest request =
* BatchCreateFeaturesRequest.newBuilder()
* .setParent(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .addAllRequests(new ArrayList())
* .build();
* BatchCreateFeaturesResponse response =
* featurestoreServiceClient.batchCreateFeaturesAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
batchCreateFeaturesAsync(BatchCreateFeaturesRequest request) {
return batchCreateFeaturesOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a batch of Features in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* BatchCreateFeaturesRequest request =
* BatchCreateFeaturesRequest.newBuilder()
* .setParent(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .addAllRequests(new ArrayList())
* .build();
* OperationFuture future =
* featurestoreServiceClient.batchCreateFeaturesOperationCallable().futureCall(request);
* // Do something.
* BatchCreateFeaturesResponse response = future.get();
* }
* }
*/
public final OperationCallable<
BatchCreateFeaturesRequest,
BatchCreateFeaturesResponse,
BatchCreateFeaturesOperationMetadata>
batchCreateFeaturesOperationCallable() {
return stub.batchCreateFeaturesOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Creates a batch of Features in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* BatchCreateFeaturesRequest request =
* BatchCreateFeaturesRequest.newBuilder()
* .setParent(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .addAllRequests(new ArrayList())
* .build();
* ApiFuture future =
* featurestoreServiceClient.batchCreateFeaturesCallable().futureCall(request);
* // Do something.
* Operation response = future.get();
* }
* }
*/
public final UnaryCallable batchCreateFeaturesCallable() {
return stub.batchCreateFeaturesCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single Feature.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeatureName name =
* FeatureName.ofProjectLocationFeaturestoreEntityTypeFeatureName(
* "[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]", "[FEATURE]");
* Feature response = featurestoreServiceClient.getFeature(name);
* }
* }
*
* @param name Required. The name of the Feature resource. Format for entity_type as parent:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* Format for feature_group as parent:
* `projects/{project}/locations/{location}/featureGroups/{feature_group}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Feature getFeature(FeatureName name) {
GetFeatureRequest request =
GetFeatureRequest.newBuilder().setName(name == null ? null : name.toString()).build();
return getFeature(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single Feature.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String name =
* FeatureName.ofProjectLocationFeaturestoreEntityTypeFeatureName(
* "[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]", "[FEATURE]")
* .toString();
* Feature response = featurestoreServiceClient.getFeature(name);
* }
* }
*
* @param name Required. The name of the Feature resource. Format for entity_type as parent:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* Format for feature_group as parent:
* `projects/{project}/locations/{location}/featureGroups/{feature_group}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Feature getFeature(String name) {
GetFeatureRequest request = GetFeatureRequest.newBuilder().setName(name).build();
return getFeature(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single Feature.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* GetFeatureRequest request =
* GetFeatureRequest.newBuilder()
* .setName(
* FeatureName.ofProjectLocationFeaturestoreEntityTypeFeatureName(
* "[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]", "[FEATURE]")
* .toString())
* .build();
* Feature response = featurestoreServiceClient.getFeature(request);
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Feature getFeature(GetFeatureRequest request) {
return getFeatureCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets details of a single Feature.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* GetFeatureRequest request =
* GetFeatureRequest.newBuilder()
* .setName(
* FeatureName.ofProjectLocationFeaturestoreEntityTypeFeatureName(
* "[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]", "[FEATURE]")
* .toString())
* .build();
* ApiFuture future =
* featurestoreServiceClient.getFeatureCallable().futureCall(request);
* // Do something.
* Feature response = future.get();
* }
* }
*/
public final UnaryCallable getFeatureCallable() {
return stub.getFeatureCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists Features in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* EntityTypeName parent =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]");
* for (Feature element : featurestoreServiceClient.listFeatures(parent).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param parent Required. The resource name of the Location to list Features. Format for
* entity_type as parent:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* Format for feature_group as parent:
* `projects/{project}/locations/{location}/featureGroups/{feature_group}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListFeaturesPagedResponse listFeatures(EntityTypeName parent) {
ListFeaturesRequest request =
ListFeaturesRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.build();
return listFeatures(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists Features in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeatureGroupName parent = FeatureGroupName.of("[PROJECT]", "[LOCATION]", "[FEATURE_GROUP]");
* for (Feature element : featurestoreServiceClient.listFeatures(parent).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param parent Required. The resource name of the Location to list Features. Format for
* entity_type as parent:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* Format for feature_group as parent:
* `projects/{project}/locations/{location}/featureGroups/{feature_group}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListFeaturesPagedResponse listFeatures(FeatureGroupName parent) {
ListFeaturesRequest request =
ListFeaturesRequest.newBuilder()
.setParent(parent == null ? null : parent.toString())
.build();
return listFeatures(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists Features in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String parent =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString();
* for (Feature element : featurestoreServiceClient.listFeatures(parent).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param parent Required. The resource name of the Location to list Features. Format for
* entity_type as parent:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* Format for feature_group as parent:
* `projects/{project}/locations/{location}/featureGroups/{feature_group}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListFeaturesPagedResponse listFeatures(String parent) {
ListFeaturesRequest request = ListFeaturesRequest.newBuilder().setParent(parent).build();
return listFeatures(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists Features in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListFeaturesRequest request =
* ListFeaturesRequest.newBuilder()
* .setParent(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .setOrderBy("orderBy-1207110587")
* .setReadMask(FieldMask.newBuilder().build())
* .setLatestStatsCount(-878108489)
* .build();
* for (Feature element : featurestoreServiceClient.listFeatures(request).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListFeaturesPagedResponse listFeatures(ListFeaturesRequest request) {
return listFeaturesPagedCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists Features in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListFeaturesRequest request =
* ListFeaturesRequest.newBuilder()
* .setParent(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .setOrderBy("orderBy-1207110587")
* .setReadMask(FieldMask.newBuilder().build())
* .setLatestStatsCount(-878108489)
* .build();
* ApiFuture future =
* featurestoreServiceClient.listFeaturesPagedCallable().futureCall(request);
* // Do something.
* for (Feature element : future.get().iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*/
public final UnaryCallable
listFeaturesPagedCallable() {
return stub.listFeaturesPagedCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists Features in a given EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListFeaturesRequest request =
* ListFeaturesRequest.newBuilder()
* .setParent(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .setOrderBy("orderBy-1207110587")
* .setReadMask(FieldMask.newBuilder().build())
* .setLatestStatsCount(-878108489)
* .build();
* while (true) {
* ListFeaturesResponse response =
* featurestoreServiceClient.listFeaturesCallable().call(request);
* for (Feature element : response.getFeaturesList()) {
* // doThingsWith(element);
* }
* String nextPageToken = response.getNextPageToken();
* if (!Strings.isNullOrEmpty(nextPageToken)) {
* request = request.toBuilder().setPageToken(nextPageToken).build();
* } else {
* break;
* }
* }
* }
* }
*/
public final UnaryCallable listFeaturesCallable() {
return stub.listFeaturesCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates the parameters of a single Feature.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* Feature feature = Feature.newBuilder().build();
* FieldMask updateMask = FieldMask.newBuilder().build();
* Feature response = featurestoreServiceClient.updateFeature(feature, updateMask);
* }
* }
*
* @param feature Required. The Feature's `name` field is used to identify the Feature to be
* updated. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}`
* `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}`
* @param updateMask Field mask is used to specify the fields to be overwritten in the Features
* resource by the update. The fields specified in the update_mask are relative to the
* resource, not the full request. A field will be overwritten if it is in the mask. If the
* user does not provide a mask then only the non-empty fields present in the request will be
* overwritten. Set the update_mask to `*` to override all fields.
* Updatable fields:
*
* `description` * `labels` * `disable_monitoring` (Not supported for
* FeatureRegistryService Feature) * `point_of_contact` (Not supported for
* FeaturestoreService FeatureStore)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Feature updateFeature(Feature feature, FieldMask updateMask) {
UpdateFeatureRequest request =
UpdateFeatureRequest.newBuilder().setFeature(feature).setUpdateMask(updateMask).build();
return updateFeature(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates the parameters of a single Feature.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* UpdateFeatureRequest request =
* UpdateFeatureRequest.newBuilder()
* .setFeature(Feature.newBuilder().build())
* .setUpdateMask(FieldMask.newBuilder().build())
* .build();
* Feature response = featurestoreServiceClient.updateFeature(request);
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Feature updateFeature(UpdateFeatureRequest request) {
return updateFeatureCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Updates the parameters of a single Feature.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* UpdateFeatureRequest request =
* UpdateFeatureRequest.newBuilder()
* .setFeature(Feature.newBuilder().build())
* .setUpdateMask(FieldMask.newBuilder().build())
* .build();
* ApiFuture future =
* featurestoreServiceClient.updateFeatureCallable().futureCall(request);
* // Do something.
* Feature response = future.get();
* }
* }
*/
public final UnaryCallable updateFeatureCallable() {
return stub.updateFeatureCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Feature.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeatureName name =
* FeatureName.ofProjectLocationFeaturestoreEntityTypeFeatureName(
* "[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]", "[FEATURE]");
* featurestoreServiceClient.deleteFeatureAsync(name).get();
* }
* }
*
* @param name Required. The name of the Features to be deleted. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}`
* `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteFeatureAsync(
FeatureName name) {
DeleteFeatureRequest request =
DeleteFeatureRequest.newBuilder().setName(name == null ? null : name.toString()).build();
return deleteFeatureAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Feature.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String name =
* FeatureName.ofProjectLocationFeaturestoreEntityTypeFeatureName(
* "[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]", "[FEATURE]")
* .toString();
* featurestoreServiceClient.deleteFeatureAsync(name).get();
* }
* }
*
* @param name Required. The name of the Features to be deleted. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}`
* `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteFeatureAsync(String name) {
DeleteFeatureRequest request = DeleteFeatureRequest.newBuilder().setName(name).build();
return deleteFeatureAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Feature.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteFeatureRequest request =
* DeleteFeatureRequest.newBuilder()
* .setName(
* FeatureName.ofProjectLocationFeaturestoreEntityTypeFeatureName(
* "[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]", "[FEATURE]")
* .toString())
* .build();
* featurestoreServiceClient.deleteFeatureAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture deleteFeatureAsync(
DeleteFeatureRequest request) {
return deleteFeatureOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Feature.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteFeatureRequest request =
* DeleteFeatureRequest.newBuilder()
* .setName(
* FeatureName.ofProjectLocationFeaturestoreEntityTypeFeatureName(
* "[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]", "[FEATURE]")
* .toString())
* .build();
* OperationFuture future =
* featurestoreServiceClient.deleteFeatureOperationCallable().futureCall(request);
* // Do something.
* future.get();
* }
* }
*/
public final OperationCallable
deleteFeatureOperationCallable() {
return stub.deleteFeatureOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes a single Feature.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteFeatureRequest request =
* DeleteFeatureRequest.newBuilder()
* .setName(
* FeatureName.ofProjectLocationFeaturestoreEntityTypeFeatureName(
* "[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]", "[FEATURE]")
* .toString())
* .build();
* ApiFuture future =
* featurestoreServiceClient.deleteFeatureCallable().futureCall(request);
* // Do something.
* future.get();
* }
* }
*/
public final UnaryCallable deleteFeatureCallable() {
return stub.deleteFeatureCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Imports Feature values into the Featurestore from a source storage.
*
* The progress of the import is tracked by the returned operation. The imported features are
* guaranteed to be visible to subsequent read operations after the operation is marked as
* successfully done.
*
*
If an import operation fails, the Feature values returned from reads and exports may be
* inconsistent. If consistency is required, the caller must retry the same import request again
* and wait till the new operation returned is marked as successfully done.
*
*
There are also scenarios where the caller can cause inconsistency.
*
*
- Source data for import contains multiple distinct Feature values for the same entity ID
* and timestamp. - Source is modified during an import. This includes adding, updating, or
* removing source data and/or metadata. Examples of updating metadata include but are not limited
* to changing storage location, storage class, or retention policy. - Online serving cluster is
* under-provisioned.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* EntityTypeName entityType =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]");
* ImportFeatureValuesResponse response =
* featurestoreServiceClient.importFeatureValuesAsync(entityType).get();
* }
* }
*
* @param entityType Required. The resource name of the EntityType grouping the Features for which
* values are being imported. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entityType}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
importFeatureValuesAsync(EntityTypeName entityType) {
ImportFeatureValuesRequest request =
ImportFeatureValuesRequest.newBuilder()
.setEntityType(entityType == null ? null : entityType.toString())
.build();
return importFeatureValuesAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Imports Feature values into the Featurestore from a source storage.
*
* The progress of the import is tracked by the returned operation. The imported features are
* guaranteed to be visible to subsequent read operations after the operation is marked as
* successfully done.
*
*
If an import operation fails, the Feature values returned from reads and exports may be
* inconsistent. If consistency is required, the caller must retry the same import request again
* and wait till the new operation returned is marked as successfully done.
*
*
There are also scenarios where the caller can cause inconsistency.
*
*
- Source data for import contains multiple distinct Feature values for the same entity ID
* and timestamp. - Source is modified during an import. This includes adding, updating, or
* removing source data and/or metadata. Examples of updating metadata include but are not limited
* to changing storage location, storage class, or retention policy. - Online serving cluster is
* under-provisioned.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String entityType =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString();
* ImportFeatureValuesResponse response =
* featurestoreServiceClient.importFeatureValuesAsync(entityType).get();
* }
* }
*
* @param entityType Required. The resource name of the EntityType grouping the Features for which
* values are being imported. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entityType}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
importFeatureValuesAsync(String entityType) {
ImportFeatureValuesRequest request =
ImportFeatureValuesRequest.newBuilder().setEntityType(entityType).build();
return importFeatureValuesAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Imports Feature values into the Featurestore from a source storage.
*
* The progress of the import is tracked by the returned operation. The imported features are
* guaranteed to be visible to subsequent read operations after the operation is marked as
* successfully done.
*
*
If an import operation fails, the Feature values returned from reads and exports may be
* inconsistent. If consistency is required, the caller must retry the same import request again
* and wait till the new operation returned is marked as successfully done.
*
*
There are also scenarios where the caller can cause inconsistency.
*
*
- Source data for import contains multiple distinct Feature values for the same entity ID
* and timestamp. - Source is modified during an import. This includes adding, updating, or
* removing source data and/or metadata. Examples of updating metadata include but are not limited
* to changing storage location, storage class, or retention policy. - Online serving cluster is
* under-provisioned.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ImportFeatureValuesRequest request =
* ImportFeatureValuesRequest.newBuilder()
* .setEntityType(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setEntityIdField("entityIdField512670524")
* .addAllFeatureSpecs(new ArrayList())
* .setDisableOnlineServing(true)
* .setWorkerCount(372044046)
* .setDisableIngestionAnalysis(true)
* .build();
* ImportFeatureValuesResponse response =
* featurestoreServiceClient.importFeatureValuesAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
importFeatureValuesAsync(ImportFeatureValuesRequest request) {
return importFeatureValuesOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Imports Feature values into the Featurestore from a source storage.
*
* The progress of the import is tracked by the returned operation. The imported features are
* guaranteed to be visible to subsequent read operations after the operation is marked as
* successfully done.
*
*
If an import operation fails, the Feature values returned from reads and exports may be
* inconsistent. If consistency is required, the caller must retry the same import request again
* and wait till the new operation returned is marked as successfully done.
*
*
There are also scenarios where the caller can cause inconsistency.
*
*
- Source data for import contains multiple distinct Feature values for the same entity ID
* and timestamp. - Source is modified during an import. This includes adding, updating, or
* removing source data and/or metadata. Examples of updating metadata include but are not limited
* to changing storage location, storage class, or retention policy. - Online serving cluster is
* under-provisioned.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ImportFeatureValuesRequest request =
* ImportFeatureValuesRequest.newBuilder()
* .setEntityType(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setEntityIdField("entityIdField512670524")
* .addAllFeatureSpecs(new ArrayList())
* .setDisableOnlineServing(true)
* .setWorkerCount(372044046)
* .setDisableIngestionAnalysis(true)
* .build();
* OperationFuture future =
* featurestoreServiceClient.importFeatureValuesOperationCallable().futureCall(request);
* // Do something.
* ImportFeatureValuesResponse response = future.get();
* }
* }
*/
public final OperationCallable<
ImportFeatureValuesRequest,
ImportFeatureValuesResponse,
ImportFeatureValuesOperationMetadata>
importFeatureValuesOperationCallable() {
return stub.importFeatureValuesOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Imports Feature values into the Featurestore from a source storage.
*
* The progress of the import is tracked by the returned operation. The imported features are
* guaranteed to be visible to subsequent read operations after the operation is marked as
* successfully done.
*
*
If an import operation fails, the Feature values returned from reads and exports may be
* inconsistent. If consistency is required, the caller must retry the same import request again
* and wait till the new operation returned is marked as successfully done.
*
*
There are also scenarios where the caller can cause inconsistency.
*
*
- Source data for import contains multiple distinct Feature values for the same entity ID
* and timestamp. - Source is modified during an import. This includes adding, updating, or
* removing source data and/or metadata. Examples of updating metadata include but are not limited
* to changing storage location, storage class, or retention policy. - Online serving cluster is
* under-provisioned.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ImportFeatureValuesRequest request =
* ImportFeatureValuesRequest.newBuilder()
* .setEntityType(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setEntityIdField("entityIdField512670524")
* .addAllFeatureSpecs(new ArrayList())
* .setDisableOnlineServing(true)
* .setWorkerCount(372044046)
* .setDisableIngestionAnalysis(true)
* .build();
* ApiFuture future =
* featurestoreServiceClient.importFeatureValuesCallable().futureCall(request);
* // Do something.
* Operation response = future.get();
* }
* }
*/
public final UnaryCallable importFeatureValuesCallable() {
return stub.importFeatureValuesCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Batch reads Feature values from a Featurestore.
*
* This API enables batch reading Feature values, where each read instance in the batch may
* read Feature values of entities from one or more EntityTypes. Point-in-time correctness is
* guaranteed for Feature values of each read instance as of each instance's read timestamp.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* FeaturestoreName featurestore =
* FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]");
* BatchReadFeatureValuesResponse response =
* featurestoreServiceClient.batchReadFeatureValuesAsync(featurestore).get();
* }
* }
*
* @param featurestore Required. The resource name of the Featurestore from which to query Feature
* values. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture<
BatchReadFeatureValuesResponse, BatchReadFeatureValuesOperationMetadata>
batchReadFeatureValuesAsync(FeaturestoreName featurestore) {
BatchReadFeatureValuesRequest request =
BatchReadFeatureValuesRequest.newBuilder()
.setFeaturestore(featurestore == null ? null : featurestore.toString())
.build();
return batchReadFeatureValuesAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Batch reads Feature values from a Featurestore.
*
* This API enables batch reading Feature values, where each read instance in the batch may
* read Feature values of entities from one or more EntityTypes. Point-in-time correctness is
* guaranteed for Feature values of each read instance as of each instance's read timestamp.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String featurestore =
* FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString();
* BatchReadFeatureValuesResponse response =
* featurestoreServiceClient.batchReadFeatureValuesAsync(featurestore).get();
* }
* }
*
* @param featurestore Required. The resource name of the Featurestore from which to query Feature
* values. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture<
BatchReadFeatureValuesResponse, BatchReadFeatureValuesOperationMetadata>
batchReadFeatureValuesAsync(String featurestore) {
BatchReadFeatureValuesRequest request =
BatchReadFeatureValuesRequest.newBuilder().setFeaturestore(featurestore).build();
return batchReadFeatureValuesAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Batch reads Feature values from a Featurestore.
*
* This API enables batch reading Feature values, where each read instance in the batch may
* read Feature values of entities from one or more EntityTypes. Point-in-time correctness is
* guaranteed for Feature values of each read instance as of each instance's read timestamp.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* BatchReadFeatureValuesRequest request =
* BatchReadFeatureValuesRequest.newBuilder()
* .setFeaturestore(
* FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setDestination(FeatureValueDestination.newBuilder().build())
* .addAllPassThroughFields(
* new ArrayList())
* .addAllEntityTypeSpecs(new ArrayList())
* .setStartTime(Timestamp.newBuilder().build())
* .build();
* BatchReadFeatureValuesResponse response =
* featurestoreServiceClient.batchReadFeatureValuesAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture<
BatchReadFeatureValuesResponse, BatchReadFeatureValuesOperationMetadata>
batchReadFeatureValuesAsync(BatchReadFeatureValuesRequest request) {
return batchReadFeatureValuesOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Batch reads Feature values from a Featurestore.
*
* This API enables batch reading Feature values, where each read instance in the batch may
* read Feature values of entities from one or more EntityTypes. Point-in-time correctness is
* guaranteed for Feature values of each read instance as of each instance's read timestamp.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* BatchReadFeatureValuesRequest request =
* BatchReadFeatureValuesRequest.newBuilder()
* .setFeaturestore(
* FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setDestination(FeatureValueDestination.newBuilder().build())
* .addAllPassThroughFields(
* new ArrayList())
* .addAllEntityTypeSpecs(new ArrayList())
* .setStartTime(Timestamp.newBuilder().build())
* .build();
* OperationFuture
* future =
* featurestoreServiceClient
* .batchReadFeatureValuesOperationCallable()
* .futureCall(request);
* // Do something.
* BatchReadFeatureValuesResponse response = future.get();
* }
* }
*/
public final OperationCallable<
BatchReadFeatureValuesRequest,
BatchReadFeatureValuesResponse,
BatchReadFeatureValuesOperationMetadata>
batchReadFeatureValuesOperationCallable() {
return stub.batchReadFeatureValuesOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Batch reads Feature values from a Featurestore.
*
* This API enables batch reading Feature values, where each read instance in the batch may
* read Feature values of entities from one or more EntityTypes. Point-in-time correctness is
* guaranteed for Feature values of each read instance as of each instance's read timestamp.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* BatchReadFeatureValuesRequest request =
* BatchReadFeatureValuesRequest.newBuilder()
* .setFeaturestore(
* FeaturestoreName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]").toString())
* .setDestination(FeatureValueDestination.newBuilder().build())
* .addAllPassThroughFields(
* new ArrayList())
* .addAllEntityTypeSpecs(new ArrayList())
* .setStartTime(Timestamp.newBuilder().build())
* .build();
* ApiFuture future =
* featurestoreServiceClient.batchReadFeatureValuesCallable().futureCall(request);
* // Do something.
* Operation response = future.get();
* }
* }
*/
public final UnaryCallable
batchReadFeatureValuesCallable() {
return stub.batchReadFeatureValuesCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Exports Feature values from all the entities of a target EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* EntityTypeName entityType =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]");
* ExportFeatureValuesResponse response =
* featurestoreServiceClient.exportFeatureValuesAsync(entityType).get();
* }
* }
*
* @param entityType Required. The resource name of the EntityType from which to export Feature
* values. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
exportFeatureValuesAsync(EntityTypeName entityType) {
ExportFeatureValuesRequest request =
ExportFeatureValuesRequest.newBuilder()
.setEntityType(entityType == null ? null : entityType.toString())
.build();
return exportFeatureValuesAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Exports Feature values from all the entities of a target EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String entityType =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString();
* ExportFeatureValuesResponse response =
* featurestoreServiceClient.exportFeatureValuesAsync(entityType).get();
* }
* }
*
* @param entityType Required. The resource name of the EntityType from which to export Feature
* values. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
exportFeatureValuesAsync(String entityType) {
ExportFeatureValuesRequest request =
ExportFeatureValuesRequest.newBuilder().setEntityType(entityType).build();
return exportFeatureValuesAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Exports Feature values from all the entities of a target EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ExportFeatureValuesRequest request =
* ExportFeatureValuesRequest.newBuilder()
* .setEntityType(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setDestination(FeatureValueDestination.newBuilder().build())
* .setFeatureSelector(FeatureSelector.newBuilder().build())
* .addAllSettings(new ArrayList())
* .build();
* ExportFeatureValuesResponse response =
* featurestoreServiceClient.exportFeatureValuesAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
exportFeatureValuesAsync(ExportFeatureValuesRequest request) {
return exportFeatureValuesOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Exports Feature values from all the entities of a target EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ExportFeatureValuesRequest request =
* ExportFeatureValuesRequest.newBuilder()
* .setEntityType(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setDestination(FeatureValueDestination.newBuilder().build())
* .setFeatureSelector(FeatureSelector.newBuilder().build())
* .addAllSettings(new ArrayList())
* .build();
* OperationFuture future =
* featurestoreServiceClient.exportFeatureValuesOperationCallable().futureCall(request);
* // Do something.
* ExportFeatureValuesResponse response = future.get();
* }
* }
*/
public final OperationCallable<
ExportFeatureValuesRequest,
ExportFeatureValuesResponse,
ExportFeatureValuesOperationMetadata>
exportFeatureValuesOperationCallable() {
return stub.exportFeatureValuesOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Exports Feature values from all the entities of a target EntityType.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ExportFeatureValuesRequest request =
* ExportFeatureValuesRequest.newBuilder()
* .setEntityType(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .setDestination(FeatureValueDestination.newBuilder().build())
* .setFeatureSelector(FeatureSelector.newBuilder().build())
* .addAllSettings(new ArrayList())
* .build();
* ApiFuture future =
* featurestoreServiceClient.exportFeatureValuesCallable().futureCall(request);
* // Do something.
* Operation response = future.get();
* }
* }
*/
public final UnaryCallable exportFeatureValuesCallable() {
return stub.exportFeatureValuesCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Delete Feature values from Featurestore.
*
* The progress of the deletion is tracked by the returned operation. The deleted feature
* values are guaranteed to be invisible to subsequent read operations after the operation is
* marked as successfully done.
*
*
If a delete feature values operation fails, the feature values returned from reads and
* exports may be inconsistent. If consistency is required, the caller must retry the same delete
* request again and wait till the new operation returned is marked as successfully done.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* EntityTypeName entityType =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]");
* DeleteFeatureValuesResponse response =
* featurestoreServiceClient.deleteFeatureValuesAsync(entityType).get();
* }
* }
*
* @param entityType Required. The resource name of the EntityType grouping the Features for which
* values are being deleted from. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entityType}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
deleteFeatureValuesAsync(EntityTypeName entityType) {
DeleteFeatureValuesRequest request =
DeleteFeatureValuesRequest.newBuilder()
.setEntityType(entityType == null ? null : entityType.toString())
.build();
return deleteFeatureValuesAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Delete Feature values from Featurestore.
*
* The progress of the deletion is tracked by the returned operation. The deleted feature
* values are guaranteed to be invisible to subsequent read operations after the operation is
* marked as successfully done.
*
*
If a delete feature values operation fails, the feature values returned from reads and
* exports may be inconsistent. If consistency is required, the caller must retry the same delete
* request again and wait till the new operation returned is marked as successfully done.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String entityType =
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString();
* DeleteFeatureValuesResponse response =
* featurestoreServiceClient.deleteFeatureValuesAsync(entityType).get();
* }
* }
*
* @param entityType Required. The resource name of the EntityType grouping the Features for which
* values are being deleted from. Format:
* `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entityType}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
deleteFeatureValuesAsync(String entityType) {
DeleteFeatureValuesRequest request =
DeleteFeatureValuesRequest.newBuilder().setEntityType(entityType).build();
return deleteFeatureValuesAsync(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Delete Feature values from Featurestore.
*
* The progress of the deletion is tracked by the returned operation. The deleted feature
* values are guaranteed to be invisible to subsequent read operations after the operation is
* marked as successfully done.
*
*
If a delete feature values operation fails, the feature values returned from reads and
* exports may be inconsistent. If consistency is required, the caller must retry the same delete
* request again and wait till the new operation returned is marked as successfully done.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteFeatureValuesRequest request =
* DeleteFeatureValuesRequest.newBuilder()
* .setEntityType(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .build();
* DeleteFeatureValuesResponse response =
* featurestoreServiceClient.deleteFeatureValuesAsync(request).get();
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final OperationFuture
deleteFeatureValuesAsync(DeleteFeatureValuesRequest request) {
return deleteFeatureValuesOperationCallable().futureCall(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Delete Feature values from Featurestore.
*
* The progress of the deletion is tracked by the returned operation. The deleted feature
* values are guaranteed to be invisible to subsequent read operations after the operation is
* marked as successfully done.
*
*
If a delete feature values operation fails, the feature values returned from reads and
* exports may be inconsistent. If consistency is required, the caller must retry the same delete
* request again and wait till the new operation returned is marked as successfully done.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteFeatureValuesRequest request =
* DeleteFeatureValuesRequest.newBuilder()
* .setEntityType(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .build();
* OperationFuture future =
* featurestoreServiceClient.deleteFeatureValuesOperationCallable().futureCall(request);
* // Do something.
* DeleteFeatureValuesResponse response = future.get();
* }
* }
*/
public final OperationCallable<
DeleteFeatureValuesRequest,
DeleteFeatureValuesResponse,
DeleteFeatureValuesOperationMetadata>
deleteFeatureValuesOperationCallable() {
return stub.deleteFeatureValuesOperationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Delete Feature values from Featurestore.
*
* The progress of the deletion is tracked by the returned operation. The deleted feature
* values are guaranteed to be invisible to subsequent read operations after the operation is
* marked as successfully done.
*
*
If a delete feature values operation fails, the feature values returned from reads and
* exports may be inconsistent. If consistency is required, the caller must retry the same delete
* request again and wait till the new operation returned is marked as successfully done.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* DeleteFeatureValuesRequest request =
* DeleteFeatureValuesRequest.newBuilder()
* .setEntityType(
* EntityTypeName.of("[PROJECT]", "[LOCATION]", "[FEATURESTORE]", "[ENTITY_TYPE]")
* .toString())
* .build();
* ApiFuture future =
* featurestoreServiceClient.deleteFeatureValuesCallable().futureCall(request);
* // Do something.
* Operation response = future.get();
* }
* }
*/
public final UnaryCallable deleteFeatureValuesCallable() {
return stub.deleteFeatureValuesCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Searches Features matching a query in a given project.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* LocationName location = LocationName.of("[PROJECT]", "[LOCATION]");
* for (Feature element : featurestoreServiceClient.searchFeatures(location).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param location Required. The resource name of the Location to search Features. Format:
* `projects/{project}/locations/{location}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final SearchFeaturesPagedResponse searchFeatures(LocationName location) {
SearchFeaturesRequest request =
SearchFeaturesRequest.newBuilder()
.setLocation(location == null ? null : location.toString())
.build();
return searchFeatures(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Searches Features matching a query in a given project.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String location = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* for (Feature element : featurestoreServiceClient.searchFeatures(location).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param location Required. The resource name of the Location to search Features. Format:
* `projects/{project}/locations/{location}`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final SearchFeaturesPagedResponse searchFeatures(String location) {
SearchFeaturesRequest request =
SearchFeaturesRequest.newBuilder().setLocation(location).build();
return searchFeatures(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Searches Features matching a query in a given project.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* LocationName location = LocationName.of("[PROJECT]", "[LOCATION]");
* String query = "query107944136";
* for (Feature element :
* featurestoreServiceClient.searchFeatures(location, query).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param location Required. The resource name of the Location to search Features. Format:
* `projects/{project}/locations/{location}`
* @param query Query string that is a conjunction of field-restricted queries and/or
* field-restricted filters. Field-restricted queries and filters can be combined using `AND`
* to form a conjunction.
* A field query is in the form FIELD:QUERY. This implicitly checks if QUERY exists as a
* substring within Feature's FIELD. The QUERY and the FIELD are converted to a sequence of
* words (i.e. tokens) for comparison. This is done by:
*
* Removing leading/trailing whitespace and tokenizing the search value. Characters
* that are not one of alphanumeric `[a-zA-Z0-9]`, underscore `_`, or asterisk `*` are
* treated as delimiters for tokens. `*` is treated as a wildcard that matches characters
* within a token. * Ignoring case. * Prepending an asterisk to the first and
* appending an asterisk to the last token in QUERY.
*
A QUERY must be either a singular token or a phrase. A phrase is one or multiple words
* enclosed in double quotation marks ("). With phrases, the order of the words is important.
* Words in the phrase must be matching in order and consecutively.
*
Supported FIELDs for field-restricted queries:
*
* - `feature_id`
*
- `description`
*
- `entity_type_id`
*
* Examples:
*
* - `feature_id: foo` --> Matches a Feature with ID containing the substring `foo`
* (eg. `foo`, `foofeature`, `barfoo`).
*
- `feature_id: foo*feature` --> Matches a Feature with ID containing the
* substring `foo*feature` (eg. `foobarfeature`).
*
- `feature_id: foo AND description: bar` --> Matches a Feature with ID containing
* the substring `foo` and description containing the substring `bar`.
*
* Besides field queries, the following exact-match filters are supported. The exact-match
* filters do not support wildcards. Unlike field-restricted queries, exact-match filters are
* case-sensitive.
*
* - `feature_id`: Supports = comparisons.
*
- `description`: Supports = comparisons. Multi-token filters should be enclosed in
* quotes.
*
- `entity_type_id`: Supports = comparisons.
*
- `value_type`: Supports = and != comparisons.
*
- `labels`: Supports key-value equality as well as key presence.
*
- `featurestore_id`: Supports = comparisons.
*
* Examples:
*
* - `description = "foo bar"` --> Any Feature with description exactly equal to `foo
* bar`
*
- `value_type = DOUBLE` --> Features whose type is DOUBLE.
*
- `labels.active = yes AND labels.env = prod` --> Features having both (active: yes)
* and (env: prod) labels.
*
- `labels.env: *` --> Any Feature which has a label with `env` as the key.
*
*
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final SearchFeaturesPagedResponse searchFeatures(LocationName location, String query) {
SearchFeaturesRequest request =
SearchFeaturesRequest.newBuilder()
.setLocation(location == null ? null : location.toString())
.setQuery(query)
.build();
return searchFeatures(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Searches Features matching a query in a given project.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* String location = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* String query = "query107944136";
* for (Feature element :
* featurestoreServiceClient.searchFeatures(location, query).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param location Required. The resource name of the Location to search Features. Format:
* `projects/{project}/locations/{location}`
* @param query Query string that is a conjunction of field-restricted queries and/or
* field-restricted filters. Field-restricted queries and filters can be combined using `AND`
* to form a conjunction.
* A field query is in the form FIELD:QUERY. This implicitly checks if QUERY exists as a
* substring within Feature's FIELD. The QUERY and the FIELD are converted to a sequence of
* words (i.e. tokens) for comparison. This is done by:
*
* Removing leading/trailing whitespace and tokenizing the search value. Characters
* that are not one of alphanumeric `[a-zA-Z0-9]`, underscore `_`, or asterisk `*` are
* treated as delimiters for tokens. `*` is treated as a wildcard that matches characters
* within a token. * Ignoring case. * Prepending an asterisk to the first and
* appending an asterisk to the last token in QUERY.
*
A QUERY must be either a singular token or a phrase. A phrase is one or multiple words
* enclosed in double quotation marks ("). With phrases, the order of the words is important.
* Words in the phrase must be matching in order and consecutively.
*
Supported FIELDs for field-restricted queries:
*
* - `feature_id`
*
- `description`
*
- `entity_type_id`
*
* Examples:
*
* - `feature_id: foo` --> Matches a Feature with ID containing the substring `foo`
* (eg. `foo`, `foofeature`, `barfoo`).
*
- `feature_id: foo*feature` --> Matches a Feature with ID containing the
* substring `foo*feature` (eg. `foobarfeature`).
*
- `feature_id: foo AND description: bar` --> Matches a Feature with ID containing
* the substring `foo` and description containing the substring `bar`.
*
* Besides field queries, the following exact-match filters are supported. The exact-match
* filters do not support wildcards. Unlike field-restricted queries, exact-match filters are
* case-sensitive.
*
* - `feature_id`: Supports = comparisons.
*
- `description`: Supports = comparisons. Multi-token filters should be enclosed in
* quotes.
*
- `entity_type_id`: Supports = comparisons.
*
- `value_type`: Supports = and != comparisons.
*
- `labels`: Supports key-value equality as well as key presence.
*
- `featurestore_id`: Supports = comparisons.
*
* Examples:
*
* - `description = "foo bar"` --> Any Feature with description exactly equal to `foo
* bar`
*
- `value_type = DOUBLE` --> Features whose type is DOUBLE.
*
- `labels.active = yes AND labels.env = prod` --> Features having both (active: yes)
* and (env: prod) labels.
*
- `labels.env: *` --> Any Feature which has a label with `env` as the key.
*
*
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final SearchFeaturesPagedResponse searchFeatures(String location, String query) {
SearchFeaturesRequest request =
SearchFeaturesRequest.newBuilder().setLocation(location).setQuery(query).build();
return searchFeatures(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Searches Features matching a query in a given project.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* SearchFeaturesRequest request =
* SearchFeaturesRequest.newBuilder()
* .setLocation(LocationName.of("[PROJECT]", "[LOCATION]").toString())
* .setQuery("query107944136")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .build();
* for (Feature element : featurestoreServiceClient.searchFeatures(request).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final SearchFeaturesPagedResponse searchFeatures(SearchFeaturesRequest request) {
return searchFeaturesPagedCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Searches Features matching a query in a given project.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* SearchFeaturesRequest request =
* SearchFeaturesRequest.newBuilder()
* .setLocation(LocationName.of("[PROJECT]", "[LOCATION]").toString())
* .setQuery("query107944136")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .build();
* ApiFuture future =
* featurestoreServiceClient.searchFeaturesPagedCallable().futureCall(request);
* // Do something.
* for (Feature element : future.get().iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*/
public final UnaryCallable
searchFeaturesPagedCallable() {
return stub.searchFeaturesPagedCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Searches Features matching a query in a given project.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* SearchFeaturesRequest request =
* SearchFeaturesRequest.newBuilder()
* .setLocation(LocationName.of("[PROJECT]", "[LOCATION]").toString())
* .setQuery("query107944136")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .build();
* while (true) {
* SearchFeaturesResponse response =
* featurestoreServiceClient.searchFeaturesCallable().call(request);
* for (Feature element : response.getFeaturesList()) {
* // doThingsWith(element);
* }
* String nextPageToken = response.getNextPageToken();
* if (!Strings.isNullOrEmpty(nextPageToken)) {
* request = request.toBuilder().setPageToken(nextPageToken).build();
* } else {
* break;
* }
* }
* }
* }
*/
public final UnaryCallable
searchFeaturesCallable() {
return stub.searchFeaturesCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists information about the supported locations for this service.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListLocationsRequest request =
* ListLocationsRequest.newBuilder()
* .setName("name3373707")
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .build();
* for (Location element : featurestoreServiceClient.listLocations(request).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListLocationsPagedResponse listLocations(ListLocationsRequest request) {
return listLocationsPagedCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists information about the supported locations for this service.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListLocationsRequest request =
* ListLocationsRequest.newBuilder()
* .setName("name3373707")
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .build();
* ApiFuture future =
* featurestoreServiceClient.listLocationsPagedCallable().futureCall(request);
* // Do something.
* for (Location element : future.get().iterateAll()) {
* // doThingsWith(element);
* }
* }
* }
*/
public final UnaryCallable
listLocationsPagedCallable() {
return stub.listLocationsPagedCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists information about the supported locations for this service.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* ListLocationsRequest request =
* ListLocationsRequest.newBuilder()
* .setName("name3373707")
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .build();
* while (true) {
* ListLocationsResponse response =
* featurestoreServiceClient.listLocationsCallable().call(request);
* for (Location element : response.getLocationsList()) {
* // doThingsWith(element);
* }
* String nextPageToken = response.getNextPageToken();
* if (!Strings.isNullOrEmpty(nextPageToken)) {
* request = request.toBuilder().setPageToken(nextPageToken).build();
* } else {
* break;
* }
* }
* }
* }
*/
public final UnaryCallable listLocationsCallable() {
return stub.listLocationsCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets information about a location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* GetLocationRequest request = GetLocationRequest.newBuilder().setName("name3373707").build();
* Location response = featurestoreServiceClient.getLocation(request);
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Location getLocation(GetLocationRequest request) {
return getLocationCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets information about a location.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* GetLocationRequest request = GetLocationRequest.newBuilder().setName("name3373707").build();
* ApiFuture future =
* featurestoreServiceClient.getLocationCallable().futureCall(request);
* // Do something.
* Location response = future.get();
* }
* }
*/
public final UnaryCallable getLocationCallable() {
return stub.getLocationCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Sets the access control policy on the specified resource. Replacesany existing policy.
*
* Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* SetIamPolicyRequest request =
* SetIamPolicyRequest.newBuilder()
* .setResource(
* EndpointName.ofProjectLocationEndpointName(
* "[PROJECT]", "[LOCATION]", "[ENDPOINT]")
* .toString())
* .setPolicy(Policy.newBuilder().build())
* .setUpdateMask(FieldMask.newBuilder().build())
* .build();
* Policy response = featurestoreServiceClient.setIamPolicy(request);
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Policy setIamPolicy(SetIamPolicyRequest request) {
return setIamPolicyCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Sets the access control policy on the specified resource. Replacesany existing policy.
*
* Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* SetIamPolicyRequest request =
* SetIamPolicyRequest.newBuilder()
* .setResource(
* EndpointName.ofProjectLocationEndpointName(
* "[PROJECT]", "[LOCATION]", "[ENDPOINT]")
* .toString())
* .setPolicy(Policy.newBuilder().build())
* .setUpdateMask(FieldMask.newBuilder().build())
* .build();
* ApiFuture future =
* featurestoreServiceClient.setIamPolicyCallable().futureCall(request);
* // Do something.
* Policy response = future.get();
* }
* }
*/
public final UnaryCallable setIamPolicyCallable() {
return stub.setIamPolicyCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets the access control policy for a resource. Returns an empty policyif the resource exists
* and does not have a policy set.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* GetIamPolicyRequest request =
* GetIamPolicyRequest.newBuilder()
* .setResource(
* EndpointName.ofProjectLocationEndpointName(
* "[PROJECT]", "[LOCATION]", "[ENDPOINT]")
* .toString())
* .setOptions(GetPolicyOptions.newBuilder().build())
* .build();
* Policy response = featurestoreServiceClient.getIamPolicy(request);
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Policy getIamPolicy(GetIamPolicyRequest request) {
return getIamPolicyCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Gets the access control policy for a resource. Returns an empty policyif the resource exists
* and does not have a policy set.
*
* Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* GetIamPolicyRequest request =
* GetIamPolicyRequest.newBuilder()
* .setResource(
* EndpointName.ofProjectLocationEndpointName(
* "[PROJECT]", "[LOCATION]", "[ENDPOINT]")
* .toString())
* .setOptions(GetPolicyOptions.newBuilder().build())
* .build();
* ApiFuture future =
* featurestoreServiceClient.getIamPolicyCallable().futureCall(request);
* // Do something.
* Policy response = future.get();
* }
* }
*/
public final UnaryCallable getIamPolicyCallable() {
return stub.getIamPolicyCallable();
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Returns permissions that a caller has on the specified resource. If theresource does not exist,
* this will return an empty set ofpermissions, not a `NOT_FOUND` error.
*
* Note: This operation is designed to be used for buildingpermission-aware UIs and
* command-line tools, not for authorizationchecking. This operation may "fail open" without
* warning.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* TestIamPermissionsRequest request =
* TestIamPermissionsRequest.newBuilder()
* .setResource(
* EndpointName.ofProjectLocationEndpointName(
* "[PROJECT]", "[LOCATION]", "[ENDPOINT]")
* .toString())
* .addAllPermissions(new ArrayList())
* .build();
* TestIamPermissionsResponse response = featurestoreServiceClient.testIamPermissions(request);
* }
* }
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsRequest request) {
return testIamPermissionsCallable().call(request);
}
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Returns permissions that a caller has on the specified resource. If theresource does not exist,
* this will return an empty set ofpermissions, not a `NOT_FOUND` error.
*
* Note: This operation is designed to be used for buildingpermission-aware UIs and
* command-line tools, not for authorizationchecking. This operation may "fail open" without
* warning.
*
*
Sample code:
*
*
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FeaturestoreServiceClient featurestoreServiceClient = FeaturestoreServiceClient.create()) {
* TestIamPermissionsRequest request =
* TestIamPermissionsRequest.newBuilder()
* .setResource(
* EndpointName.ofProjectLocationEndpointName(
* "[PROJECT]", "[LOCATION]", "[ENDPOINT]")
* .toString())
* .addAllPermissions(new ArrayList())
* .build();
* ApiFuture future =
* featurestoreServiceClient.testIamPermissionsCallable().futureCall(request);
* // Do something.
* TestIamPermissionsResponse response = future.get();
* }
* }
*/
public final UnaryCallable
testIamPermissionsCallable() {
return stub.testIamPermissionsCallable();
}
@Override
public final void close() {
stub.close();
}
@Override
public void shutdown() {
stub.shutdown();
}
@Override
public boolean isShutdown() {
return stub.isShutdown();
}
@Override
public boolean isTerminated() {
return stub.isTerminated();
}
@Override
public void shutdownNow() {
stub.shutdownNow();
}
@Override
public boolean awaitTermination(long duration, TimeUnit unit) throws InterruptedException {
return stub.awaitTermination(duration, unit);
}
public static class ListFeaturestoresPagedResponse
extends AbstractPagedListResponse<
ListFeaturestoresRequest,
ListFeaturestoresResponse,
Featurestore,
ListFeaturestoresPage,
ListFeaturestoresFixedSizeCollection> {
public static ApiFuture createAsync(
PageContext context,
ApiFuture futureResponse) {
ApiFuture futurePage =
ListFeaturestoresPage.createEmptyPage().createPageAsync(context, futureResponse);
return ApiFutures.transform(
futurePage,
input -> new ListFeaturestoresPagedResponse(input),
MoreExecutors.directExecutor());
}
private ListFeaturestoresPagedResponse(ListFeaturestoresPage page) {
super(page, ListFeaturestoresFixedSizeCollection.createEmptyCollection());
}
}
public static class ListFeaturestoresPage
extends AbstractPage<
ListFeaturestoresRequest,
ListFeaturestoresResponse,
Featurestore,
ListFeaturestoresPage> {
private ListFeaturestoresPage(
PageContext context,
ListFeaturestoresResponse response) {
super(context, response);
}
private static ListFeaturestoresPage createEmptyPage() {
return new ListFeaturestoresPage(null, null);
}
@Override
protected ListFeaturestoresPage createPage(
PageContext context,
ListFeaturestoresResponse response) {
return new ListFeaturestoresPage(context, response);
}
@Override
public ApiFuture createPageAsync(
PageContext context,
ApiFuture futureResponse) {
return super.createPageAsync(context, futureResponse);
}
}
public static class ListFeaturestoresFixedSizeCollection
extends AbstractFixedSizeCollection<
ListFeaturestoresRequest,
ListFeaturestoresResponse,
Featurestore,
ListFeaturestoresPage,
ListFeaturestoresFixedSizeCollection> {
private ListFeaturestoresFixedSizeCollection(
List pages, int collectionSize) {
super(pages, collectionSize);
}
private static ListFeaturestoresFixedSizeCollection createEmptyCollection() {
return new ListFeaturestoresFixedSizeCollection(null, 0);
}
@Override
protected ListFeaturestoresFixedSizeCollection createCollection(
List pages, int collectionSize) {
return new ListFeaturestoresFixedSizeCollection(pages, collectionSize);
}
}
public static class ListEntityTypesPagedResponse
extends AbstractPagedListResponse<
ListEntityTypesRequest,
ListEntityTypesResponse,
EntityType,
ListEntityTypesPage,
ListEntityTypesFixedSizeCollection> {
public static ApiFuture createAsync(
PageContext context,
ApiFuture futureResponse) {
ApiFuture futurePage =
ListEntityTypesPage.createEmptyPage().createPageAsync(context, futureResponse);
return ApiFutures.transform(
futurePage,
input -> new ListEntityTypesPagedResponse(input),
MoreExecutors.directExecutor());
}
private ListEntityTypesPagedResponse(ListEntityTypesPage page) {
super(page, ListEntityTypesFixedSizeCollection.createEmptyCollection());
}
}
public static class ListEntityTypesPage
extends AbstractPage<
ListEntityTypesRequest, ListEntityTypesResponse, EntityType, ListEntityTypesPage> {
private ListEntityTypesPage(
PageContext context,
ListEntityTypesResponse response) {
super(context, response);
}
private static ListEntityTypesPage createEmptyPage() {
return new ListEntityTypesPage(null, null);
}
@Override
protected ListEntityTypesPage createPage(
PageContext context,
ListEntityTypesResponse response) {
return new ListEntityTypesPage(context, response);
}
@Override
public ApiFuture createPageAsync(
PageContext context,
ApiFuture futureResponse) {
return super.createPageAsync(context, futureResponse);
}
}
public static class ListEntityTypesFixedSizeCollection
extends AbstractFixedSizeCollection<
ListEntityTypesRequest,
ListEntityTypesResponse,
EntityType,
ListEntityTypesPage,
ListEntityTypesFixedSizeCollection> {
private ListEntityTypesFixedSizeCollection(
List pages, int collectionSize) {
super(pages, collectionSize);
}
private static ListEntityTypesFixedSizeCollection createEmptyCollection() {
return new ListEntityTypesFixedSizeCollection(null, 0);
}
@Override
protected ListEntityTypesFixedSizeCollection createCollection(
List pages, int collectionSize) {
return new ListEntityTypesFixedSizeCollection(pages, collectionSize);
}
}
public static class ListFeaturesPagedResponse
extends AbstractPagedListResponse<
ListFeaturesRequest,
ListFeaturesResponse,
Feature,
ListFeaturesPage,
ListFeaturesFixedSizeCollection> {
public static ApiFuture createAsync(
PageContext context,
ApiFuture futureResponse) {
ApiFuture futurePage =
ListFeaturesPage.createEmptyPage().createPageAsync(context, futureResponse);
return ApiFutures.transform(
futurePage,
input -> new ListFeaturesPagedResponse(input),
MoreExecutors.directExecutor());
}
private ListFeaturesPagedResponse(ListFeaturesPage page) {
super(page, ListFeaturesFixedSizeCollection.createEmptyCollection());
}
}
public static class ListFeaturesPage
extends AbstractPage {
private ListFeaturesPage(
PageContext context,
ListFeaturesResponse response) {
super(context, response);
}
private static ListFeaturesPage createEmptyPage() {
return new ListFeaturesPage(null, null);
}
@Override
protected ListFeaturesPage createPage(
PageContext context,
ListFeaturesResponse response) {
return new ListFeaturesPage(context, response);
}
@Override
public ApiFuture createPageAsync(
PageContext context,
ApiFuture futureResponse) {
return super.createPageAsync(context, futureResponse);
}
}
public static class ListFeaturesFixedSizeCollection
extends AbstractFixedSizeCollection<
ListFeaturesRequest,
ListFeaturesResponse,
Feature,
ListFeaturesPage,
ListFeaturesFixedSizeCollection> {
private ListFeaturesFixedSizeCollection(List pages, int collectionSize) {
super(pages, collectionSize);
}
private static ListFeaturesFixedSizeCollection createEmptyCollection() {
return new ListFeaturesFixedSizeCollection(null, 0);
}
@Override
protected ListFeaturesFixedSizeCollection createCollection(
List pages, int collectionSize) {
return new ListFeaturesFixedSizeCollection(pages, collectionSize);
}
}
public static class SearchFeaturesPagedResponse
extends AbstractPagedListResponse<
SearchFeaturesRequest,
SearchFeaturesResponse,
Feature,
SearchFeaturesPage,
SearchFeaturesFixedSizeCollection> {
public static ApiFuture createAsync(
PageContext context,
ApiFuture futureResponse) {
ApiFuture futurePage =
SearchFeaturesPage.createEmptyPage().createPageAsync(context, futureResponse);
return ApiFutures.transform(
futurePage,
input -> new SearchFeaturesPagedResponse(input),
MoreExecutors.directExecutor());
}
private SearchFeaturesPagedResponse(SearchFeaturesPage page) {
super(page, SearchFeaturesFixedSizeCollection.createEmptyCollection());
}
}
public static class SearchFeaturesPage
extends AbstractPage<
SearchFeaturesRequest, SearchFeaturesResponse, Feature, SearchFeaturesPage> {
private SearchFeaturesPage(
PageContext context,
SearchFeaturesResponse response) {
super(context, response);
}
private static SearchFeaturesPage createEmptyPage() {
return new SearchFeaturesPage(null, null);
}
@Override
protected SearchFeaturesPage createPage(
PageContext context,
SearchFeaturesResponse response) {
return new SearchFeaturesPage(context, response);
}
@Override
public ApiFuture createPageAsync(
PageContext context,
ApiFuture futureResponse) {
return super.createPageAsync(context, futureResponse);
}
}
public static class SearchFeaturesFixedSizeCollection
extends AbstractFixedSizeCollection<
SearchFeaturesRequest,
SearchFeaturesResponse,
Feature,
SearchFeaturesPage,
SearchFeaturesFixedSizeCollection> {
private SearchFeaturesFixedSizeCollection(List pages, int collectionSize) {
super(pages, collectionSize);
}
private static SearchFeaturesFixedSizeCollection createEmptyCollection() {
return new SearchFeaturesFixedSizeCollection(null, 0);
}
@Override
protected SearchFeaturesFixedSizeCollection createCollection(
List pages, int collectionSize) {
return new SearchFeaturesFixedSizeCollection(pages, collectionSize);
}
}
public static class ListLocationsPagedResponse
extends AbstractPagedListResponse<
ListLocationsRequest,
ListLocationsResponse,
Location,
ListLocationsPage,
ListLocationsFixedSizeCollection> {
public static ApiFuture createAsync(
PageContext context,
ApiFuture futureResponse) {
ApiFuture futurePage =
ListLocationsPage.createEmptyPage().createPageAsync(context, futureResponse);
return ApiFutures.transform(
futurePage,
input -> new ListLocationsPagedResponse(input),
MoreExecutors.directExecutor());
}
private ListLocationsPagedResponse(ListLocationsPage page) {
super(page, ListLocationsFixedSizeCollection.createEmptyCollection());
}
}
public static class ListLocationsPage
extends AbstractPage<
ListLocationsRequest, ListLocationsResponse, Location, ListLocationsPage> {
private ListLocationsPage(
PageContext context,
ListLocationsResponse response) {
super(context, response);
}
private static ListLocationsPage createEmptyPage() {
return new ListLocationsPage(null, null);
}
@Override
protected ListLocationsPage createPage(
PageContext context,
ListLocationsResponse response) {
return new ListLocationsPage(context, response);
}
@Override
public ApiFuture createPageAsync(
PageContext context,
ApiFuture futureResponse) {
return super.createPageAsync(context, futureResponse);
}
}
public static class ListLocationsFixedSizeCollection
extends AbstractFixedSizeCollection<
ListLocationsRequest,
ListLocationsResponse,
Location,
ListLocationsPage,
ListLocationsFixedSizeCollection> {
private ListLocationsFixedSizeCollection(List pages, int collectionSize) {
super(pages, collectionSize);
}
private static ListLocationsFixedSizeCollection createEmptyCollection() {
return new ListLocationsFixedSizeCollection(null, 0);
}
@Override
protected ListLocationsFixedSizeCollection createCollection(
List pages, int collectionSize) {
return new ListLocationsFixedSizeCollection(pages, collectionSize);
}
}
}