Package com.google.cloud.filestore.v1beta1

Class CloudFilestoreManagerClient

java.lang.Object

com.google.cloud.filestore.v1beta1.CloudFilestoreManagerClient

All Implemented Interfaces:

BackgroundResource, AutoCloseable

@BetaApi
@Generated("by gapic-generator-java")
public class CloudFilestoreManagerClient
extends Object
implements BackgroundResource

Service Description: Configures and manages Filestore resources.

Filestore Manager v1beta1.

The `file.googleapis.com` service implements the Filestore API and defines the following model for managing resources:

• The service works with a collection of cloud projects, named: `/projects/*`
• Each project has a collection of available locations, named: `/locations/*`
• Each location has a collection of instances and backups, named: `/instances/*` and `/backups/*` respectively.
• As such, Filestore instances are resources of the form: `/projects/{project_id}/locations/{location_id}/instances/{instance_id}` backups are resources of the form: `/projects/{project_id}/locations/{location_id}/backup/{backup_id}`

Note that location_id can represent a Google Cloud `zone` or `region` depending on the resource. for example: A zonal Filestore instance:

• `projects/my-project/locations/us-central1-c/instances/my-basic-tier-filer` A regional Filestore instance:
• `projects/my-project/locations/us-central1/instances/my-enterprise-filer`

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:

 // 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   InstanceName name = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]");
   Instance response = cloudFilestoreManagerClient.getInstance(name);
 }
 

Note: close() needs to be called on the CloudFilestoreManagerClient 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
ListInstances	Lists all instances in a project for either a specified location or for all locations.	Request object method variants only take one parameter, a request object, which must be constructed before the call. listInstances(ListInstancesRequest request) "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. listInstances(LocationName parent) listInstances(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. listInstancesPagedCallable() listInstancesCallable()
GetInstance	Gets the details of a specific instance.	Request object method variants only take one parameter, a request object, which must be constructed before the call. getInstance(GetInstanceRequest request) "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. getInstance(InstanceName name) getInstance(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. getInstanceCallable()
CreateInstance	Creates an instance. When creating from a backup, the capacity of the new instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).	Request object method variants only take one parameter, a request object, which must be constructed before the call. createInstanceAsync(CreateInstanceRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. createInstanceAsync(LocationName parent, Instance instance, String instanceId) createInstanceAsync(String parent, Instance instance, String instanceId) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. createInstanceOperationCallable() createInstanceCallable()
UpdateInstance	Updates the settings of a specific instance.	Request object method variants only take one parameter, a request object, which must be constructed before the call. updateInstanceAsync(UpdateInstanceRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. updateInstanceAsync(Instance instance, 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. updateInstanceOperationCallable() updateInstanceCallable()
RestoreInstance	Restores an existing instance's file share from a backup. The capacity of the instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).	Request object method variants only take one parameter, a request object, which must be constructed before the call. restoreInstanceAsync(RestoreInstanceRequest request) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. restoreInstanceOperationCallable() restoreInstanceCallable()
RevertInstance	Revert an existing instance's file system to a specified snapshot.	Request object method variants only take one parameter, a request object, which must be constructed before the call. revertInstanceAsync(RevertInstanceRequest request) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. revertInstanceOperationCallable() revertInstanceCallable()
PromoteReplica	Promote the standby instance (replica).	Request object method variants only take one parameter, a request object, which must be constructed before the call. promoteReplicaAsync(PromoteReplicaRequest request) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. promoteReplicaOperationCallable() promoteReplicaCallable()
DeleteInstance	Deletes an instance.	Request object method variants only take one parameter, a request object, which must be constructed before the call. deleteInstanceAsync(DeleteInstanceRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. deleteInstanceAsync(InstanceName name) deleteInstanceAsync(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. deleteInstanceOperationCallable() deleteInstanceCallable()
ListSnapshots	Lists all snapshots in a project for either a specified location or for all locations.	Request object method variants only take one parameter, a request object, which must be constructed before the call. listSnapshots(ListSnapshotsRequest request) "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. listSnapshots(InstanceName parent) listSnapshots(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. listSnapshotsPagedCallable() listSnapshotsCallable()
GetSnapshot	Gets the details of a specific snapshot.	Request object method variants only take one parameter, a request object, which must be constructed before the call. getSnapshot(GetSnapshotRequest request) "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. getSnapshot(SnapshotName name) getSnapshot(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. getSnapshotCallable()
CreateSnapshot	Creates a snapshot.	Request object method variants only take one parameter, a request object, which must be constructed before the call. createSnapshotAsync(CreateSnapshotRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. createSnapshotAsync(InstanceName parent, Snapshot snapshot, String snapshotId) createSnapshotAsync(String parent, Snapshot snapshot, String snapshotId) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. createSnapshotOperationCallable() createSnapshotCallable()
DeleteSnapshot	Deletes a snapshot.	Request object method variants only take one parameter, a request object, which must be constructed before the call. deleteSnapshotAsync(DeleteSnapshotRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. deleteSnapshotAsync(SnapshotName name) deleteSnapshotAsync(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. deleteSnapshotOperationCallable() deleteSnapshotCallable()
UpdateSnapshot	Updates the settings of a specific snapshot.	Request object method variants only take one parameter, a request object, which must be constructed before the call. updateSnapshotAsync(UpdateSnapshotRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. updateSnapshotAsync(Snapshot snapshot, 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. updateSnapshotOperationCallable() updateSnapshotCallable()
ListBackups	Lists all backups in a project for either a specified location or for all locations.	Request object method variants only take one parameter, a request object, which must be constructed before the call. listBackups(ListBackupsRequest request) "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. listBackups(LocationName parent) listBackups(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. listBackupsPagedCallable() listBackupsCallable()
GetBackup	Gets the details of a specific backup.	Request object method variants only take one parameter, a request object, which must be constructed before the call. getBackup(GetBackupRequest request) "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. getBackup(BackupName name) getBackup(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. getBackupCallable()
CreateBackup	Creates a backup.	Request object method variants only take one parameter, a request object, which must be constructed before the call. createBackupAsync(CreateBackupRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. createBackupAsync(LocationName parent, Backup backup, String backupId) createBackupAsync(String parent, Backup backup, String backupId) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. createBackupOperationCallable() createBackupCallable()
DeleteBackup	Deletes a backup.	Request object method variants only take one parameter, a request object, which must be constructed before the call. deleteBackupAsync(DeleteBackupRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. deleteBackupAsync(BackupName name) deleteBackupAsync(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. deleteBackupOperationCallable() deleteBackupCallable()
UpdateBackup	Updates the settings of a specific backup.	Request object method variants only take one parameter, a request object, which must be constructed before the call. updateBackupAsync(UpdateBackupRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. updateBackupAsync(Backup backup, 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. updateBackupOperationCallable() updateBackupCallable()
ListShares	Lists all shares for a specified instance.	Request object method variants only take one parameter, a request object, which must be constructed before the call. listShares(ListSharesRequest request) "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. listShares(InstanceName parent) listShares(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. listSharesPagedCallable() listSharesCallable()
GetShare	Gets the details of a specific share.	Request object method variants only take one parameter, a request object, which must be constructed before the call. getShare(GetShareRequest request) "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. getShare(ShareName name) getShare(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. getShareCallable()
CreateShare	Creates a share.	Request object method variants only take one parameter, a request object, which must be constructed before the call. createShareAsync(CreateShareRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. createShareAsync(InstanceName parent, Share share, String shareId) createShareAsync(String parent, Share share, String shareId) Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. createShareOperationCallable() createShareCallable()
DeleteShare	Deletes a share.	Request object method variants only take one parameter, a request object, which must be constructed before the call. deleteShareAsync(DeleteShareRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. deleteShareAsync(ShareName name) deleteShareAsync(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. deleteShareOperationCallable() deleteShareCallable()
UpdateShare	Updates the settings of a specific share.	Request object method variants only take one parameter, a request object, which must be constructed before the call. updateShareAsync(UpdateShareRequest request) Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. updateShareAsync(Share share, 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. updateShareOperationCallable() updateShareCallable()

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 CloudFilestoreManagerSettings to create(). For example:

To customize credentials:

 // 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
 CloudFilestoreManagerSettings cloudFilestoreManagerSettings =
     CloudFilestoreManagerSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create(cloudFilestoreManagerSettings);
 

To customize the endpoint:

 // 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
 CloudFilestoreManagerSettings cloudFilestoreManagerSettings =
     CloudFilestoreManagerSettings.newBuilder().setEndpoint(myEndpoint).build();
 CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create(cloudFilestoreManagerSettings);
 

To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over the wire:

 // 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
 CloudFilestoreManagerSettings cloudFilestoreManagerSettings =
     CloudFilestoreManagerSettings.newHttpJsonBuilder().build();
 CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create(cloudFilestoreManagerSettings);
 

Please refer to the GitHub repository's samples for more quickstart code snippets.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	CloudFilestoreManagerClient.ListBackupsFixedSizeCollection
static class	CloudFilestoreManagerClient.ListBackupsPage
static class	CloudFilestoreManagerClient.ListBackupsPagedResponse
static class	CloudFilestoreManagerClient.ListInstancesFixedSizeCollection
static class	CloudFilestoreManagerClient.ListInstancesPage
static class	CloudFilestoreManagerClient.ListInstancesPagedResponse
static class	CloudFilestoreManagerClient.ListSharesFixedSizeCollection
static class	CloudFilestoreManagerClient.ListSharesPage
static class	CloudFilestoreManagerClient.ListSharesPagedResponse
static class	CloudFilestoreManagerClient.ListSnapshotsFixedSizeCollection
static class	CloudFilestoreManagerClient.ListSnapshotsPage
static class	CloudFilestoreManagerClient.ListSnapshotsPagedResponse

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CloudFilestoreManagerClient(CloudFilestoreManagerSettings settings)	Constructs an instance of CloudFilestoreManagerClient, using the given settings.
protected	CloudFilestoreManagerClient(CloudFilestoreManagerStub stub)

Method Summary

Modifier and Type	Method	Description
boolean	awaitTermination(long duration, TimeUnit unit)
final void	close()
static final CloudFilestoreManagerClient	create()	Constructs an instance of CloudFilestoreManagerClient with default settings.
static final CloudFilestoreManagerClient	create(CloudFilestoreManagerSettings settings)	Constructs an instance of CloudFilestoreManagerClient, using the given settings.
static final CloudFilestoreManagerClient	create(CloudFilestoreManagerStub stub)	Constructs an instance of CloudFilestoreManagerClient, using the given stub for making calls.
final OperationFuture<Backup,OperationMetadata>	createBackupAsync(CreateBackupRequest request)	Creates a backup.
final OperationFuture<Backup,OperationMetadata>	createBackupAsync(LocationName parent, Backup backup, String backupId)	Creates a backup.
final OperationFuture<Backup,OperationMetadata>	createBackupAsync(String parent, Backup backup, String backupId)	Creates a backup.
final UnaryCallable<CreateBackupRequest,Operation>	createBackupCallable()	Creates a backup.
final OperationCallable<CreateBackupRequest,Backup,OperationMetadata>	createBackupOperationCallable()	Creates a backup.
final OperationFuture<Instance,OperationMetadata>	createInstanceAsync(CreateInstanceRequest request)	Creates an instance.
final OperationFuture<Instance,OperationMetadata>	createInstanceAsync(LocationName parent, Instance instance, String instanceId)	Creates an instance.
final OperationFuture<Instance,OperationMetadata>	createInstanceAsync(String parent, Instance instance, String instanceId)	Creates an instance.
final UnaryCallable<CreateInstanceRequest,Operation>	createInstanceCallable()	Creates an instance.
final OperationCallable<CreateInstanceRequest,Instance,OperationMetadata>	createInstanceOperationCallable()	Creates an instance.
final OperationFuture<Share,OperationMetadata>	createShareAsync(CreateShareRequest request)	Creates a share.
final OperationFuture<Share,OperationMetadata>	createShareAsync(InstanceName parent, Share share, String shareId)	Creates a share.
final OperationFuture<Share,OperationMetadata>	createShareAsync(String parent, Share share, String shareId)	Creates a share.
final UnaryCallable<CreateShareRequest,Operation>	createShareCallable()	Creates a share.
final OperationCallable<CreateShareRequest,Share,OperationMetadata>	createShareOperationCallable()	Creates a share.
final OperationFuture<Snapshot,OperationMetadata>	createSnapshotAsync(CreateSnapshotRequest request)	Creates a snapshot.
final OperationFuture<Snapshot,OperationMetadata>	createSnapshotAsync(InstanceName parent, Snapshot snapshot, String snapshotId)	Creates a snapshot.
final OperationFuture<Snapshot,OperationMetadata>	createSnapshotAsync(String parent, Snapshot snapshot, String snapshotId)	Creates a snapshot.
final UnaryCallable<CreateSnapshotRequest,Operation>	createSnapshotCallable()	Creates a snapshot.
final OperationCallable<CreateSnapshotRequest,Snapshot,OperationMetadata>	createSnapshotOperationCallable()	Creates a snapshot.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteBackupAsync(BackupName name)	Deletes a backup.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteBackupAsync(DeleteBackupRequest request)	Deletes a backup.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteBackupAsync(String name)	Deletes a backup.
final UnaryCallable<DeleteBackupRequest,Operation>	deleteBackupCallable()	Deletes a backup.
final OperationCallable<DeleteBackupRequest,com.google.protobuf.Empty,OperationMetadata>	deleteBackupOperationCallable()	Deletes a backup.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteInstanceAsync(DeleteInstanceRequest request)	Deletes an instance.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteInstanceAsync(InstanceName name)	Deletes an instance.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteInstanceAsync(String name)	Deletes an instance.
final UnaryCallable<DeleteInstanceRequest,Operation>	deleteInstanceCallable()	Deletes an instance.
final OperationCallable<DeleteInstanceRequest,com.google.protobuf.Empty,OperationMetadata>	deleteInstanceOperationCallable()	Deletes an instance.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteShareAsync(DeleteShareRequest request)	Deletes a share.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteShareAsync(ShareName name)	Deletes a share.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteShareAsync(String name)	Deletes a share.
final UnaryCallable<DeleteShareRequest,Operation>	deleteShareCallable()	Deletes a share.
final OperationCallable<DeleteShareRequest,com.google.protobuf.Empty,OperationMetadata>	deleteShareOperationCallable()	Deletes a share.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteSnapshotAsync(DeleteSnapshotRequest request)	Deletes a snapshot.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteSnapshotAsync(SnapshotName name)	Deletes a snapshot.
final OperationFuture<com.google.protobuf.Empty,OperationMetadata>	deleteSnapshotAsync(String name)	Deletes a snapshot.
final UnaryCallable<DeleteSnapshotRequest,Operation>	deleteSnapshotCallable()	Deletes a snapshot.
final OperationCallable<DeleteSnapshotRequest,com.google.protobuf.Empty,OperationMetadata>	deleteSnapshotOperationCallable()	Deletes a snapshot.
final Backup	getBackup(BackupName name)	Gets the details of a specific backup.
final Backup	getBackup(GetBackupRequest request)	Gets the details of a specific backup.
final Backup	getBackup(String name)	Gets the details of a specific backup.
final UnaryCallable<GetBackupRequest,Backup>	getBackupCallable()	Gets the details of a specific backup.
final OperationsClient	getHttpJsonOperationsClient()	Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.
final Instance	getInstance(GetInstanceRequest request)	Gets the details of a specific instance.
final Instance	getInstance(InstanceName name)	Gets the details of a specific instance.
final Instance	getInstance(String name)	Gets the details of a specific instance.
final UnaryCallable<GetInstanceRequest,Instance>	getInstanceCallable()	Gets the details of a specific instance.
final OperationsClient	getOperationsClient()	Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.
final CloudFilestoreManagerSettings	getSettings()
final Share	getShare(GetShareRequest request)	Gets the details of a specific share.
final Share	getShare(ShareName name)	Gets the details of a specific share.
final Share	getShare(String name)	Gets the details of a specific share.
final UnaryCallable<GetShareRequest,Share>	getShareCallable()	Gets the details of a specific share.
final Snapshot	getSnapshot(GetSnapshotRequest request)	Gets the details of a specific snapshot.
final Snapshot	getSnapshot(SnapshotName name)	Gets the details of a specific snapshot.
final Snapshot	getSnapshot(String name)	Gets the details of a specific snapshot.
final UnaryCallable<GetSnapshotRequest,Snapshot>	getSnapshotCallable()	Gets the details of a specific snapshot.
CloudFilestoreManagerStub	getStub()
boolean	isShutdown()
boolean	isTerminated()
final CloudFilestoreManagerClient.ListBackupsPagedResponse	listBackups(ListBackupsRequest request)	Lists all backups in a project for either a specified location or for all locations.
final CloudFilestoreManagerClient.ListBackupsPagedResponse	listBackups(LocationName parent)	Lists all backups in a project for either a specified location or for all locations.
final CloudFilestoreManagerClient.ListBackupsPagedResponse	listBackups(String parent)	Lists all backups in a project for either a specified location or for all locations.
final UnaryCallable<ListBackupsRequest,ListBackupsResponse>	listBackupsCallable()	Lists all backups in a project for either a specified location or for all locations.
final UnaryCallable<ListBackupsRequest,CloudFilestoreManagerClient.ListBackupsPagedResponse>	listBackupsPagedCallable()	Lists all backups in a project for either a specified location or for all locations.
final CloudFilestoreManagerClient.ListInstancesPagedResponse	listInstances(ListInstancesRequest request)	Lists all instances in a project for either a specified location or for all locations.
final CloudFilestoreManagerClient.ListInstancesPagedResponse	listInstances(LocationName parent)	Lists all instances in a project for either a specified location or for all locations.
final CloudFilestoreManagerClient.ListInstancesPagedResponse	listInstances(String parent)	Lists all instances in a project for either a specified location or for all locations.
final UnaryCallable<ListInstancesRequest,ListInstancesResponse>	listInstancesCallable()	Lists all instances in a project for either a specified location or for all locations.
final UnaryCallable<ListInstancesRequest,CloudFilestoreManagerClient.ListInstancesPagedResponse>	listInstancesPagedCallable()	Lists all instances in a project for either a specified location or for all locations.
final CloudFilestoreManagerClient.ListSharesPagedResponse	listShares(InstanceName parent)	Lists all shares for a specified instance.
final CloudFilestoreManagerClient.ListSharesPagedResponse	listShares(ListSharesRequest request)	Lists all shares for a specified instance.
final CloudFilestoreManagerClient.ListSharesPagedResponse	listShares(String parent)	Lists all shares for a specified instance.
final UnaryCallable<ListSharesRequest,ListSharesResponse>	listSharesCallable()	Lists all shares for a specified instance.
final UnaryCallable<ListSharesRequest,CloudFilestoreManagerClient.ListSharesPagedResponse>	listSharesPagedCallable()	Lists all shares for a specified instance.
final CloudFilestoreManagerClient.ListSnapshotsPagedResponse	listSnapshots(InstanceName parent)	Lists all snapshots in a project for either a specified location or for all locations.
final CloudFilestoreManagerClient.ListSnapshotsPagedResponse	listSnapshots(ListSnapshotsRequest request)	Lists all snapshots in a project for either a specified location or for all locations.
final CloudFilestoreManagerClient.ListSnapshotsPagedResponse	listSnapshots(String parent)	Lists all snapshots in a project for either a specified location or for all locations.
final UnaryCallable<ListSnapshotsRequest,ListSnapshotsResponse>	listSnapshotsCallable()	Lists all snapshots in a project for either a specified location or for all locations.
final UnaryCallable<ListSnapshotsRequest,CloudFilestoreManagerClient.ListSnapshotsPagedResponse>	listSnapshotsPagedCallable()	Lists all snapshots in a project for either a specified location or for all locations.
final OperationFuture<Instance,OperationMetadata>	promoteReplicaAsync(PromoteReplicaRequest request)	Promote the standby instance (replica).
final UnaryCallable<PromoteReplicaRequest,Operation>	promoteReplicaCallable()	Promote the standby instance (replica).
final OperationCallable<PromoteReplicaRequest,Instance,OperationMetadata>	promoteReplicaOperationCallable()	Promote the standby instance (replica).
final OperationFuture<Instance,OperationMetadata>	restoreInstanceAsync(RestoreInstanceRequest request)	Restores an existing instance's file share from a backup.
final UnaryCallable<RestoreInstanceRequest,Operation>	restoreInstanceCallable()	Restores an existing instance's file share from a backup.
final OperationCallable<RestoreInstanceRequest,Instance,OperationMetadata>	restoreInstanceOperationCallable()	Restores an existing instance's file share from a backup.
final OperationFuture<Instance,OperationMetadata>	revertInstanceAsync(RevertInstanceRequest request)	Revert an existing instance's file system to a specified snapshot.
final UnaryCallable<RevertInstanceRequest,Operation>	revertInstanceCallable()	Revert an existing instance's file system to a specified snapshot.
final OperationCallable<RevertInstanceRequest,Instance,OperationMetadata>	revertInstanceOperationCallable()	Revert an existing instance's file system to a specified snapshot.
void	shutdown()
void	shutdownNow()
final OperationFuture<Backup,OperationMetadata>	updateBackupAsync(Backup backup, com.google.protobuf.FieldMask updateMask)	Updates the settings of a specific backup.
final OperationFuture<Backup,OperationMetadata>	updateBackupAsync(UpdateBackupRequest request)	Updates the settings of a specific backup.
final UnaryCallable<UpdateBackupRequest,Operation>	updateBackupCallable()	Updates the settings of a specific backup.
final OperationCallable<UpdateBackupRequest,Backup,OperationMetadata>	updateBackupOperationCallable()	Updates the settings of a specific backup.
final OperationFuture<Instance,OperationMetadata>	updateInstanceAsync(Instance instance, com.google.protobuf.FieldMask updateMask)	Updates the settings of a specific instance.
final OperationFuture<Instance,OperationMetadata>	updateInstanceAsync(UpdateInstanceRequest request)	Updates the settings of a specific instance.
final UnaryCallable<UpdateInstanceRequest,Operation>	updateInstanceCallable()	Updates the settings of a specific instance.
final OperationCallable<UpdateInstanceRequest,Instance,OperationMetadata>	updateInstanceOperationCallable()	Updates the settings of a specific instance.
final OperationFuture<Share,OperationMetadata>	updateShareAsync(Share share, com.google.protobuf.FieldMask updateMask)	Updates the settings of a specific share.
final OperationFuture<Share,OperationMetadata>	updateShareAsync(UpdateShareRequest request)	Updates the settings of a specific share.
final UnaryCallable<UpdateShareRequest,Operation>	updateShareCallable()	Updates the settings of a specific share.
final OperationCallable<UpdateShareRequest,Share,OperationMetadata>	updateShareOperationCallable()	Updates the settings of a specific share.
final OperationFuture<Snapshot,OperationMetadata>	updateSnapshotAsync(Snapshot snapshot, com.google.protobuf.FieldMask updateMask)	Updates the settings of a specific snapshot.
final OperationFuture<Snapshot,OperationMetadata>	updateSnapshotAsync(UpdateSnapshotRequest request)	Updates the settings of a specific snapshot.
final UnaryCallable<UpdateSnapshotRequest,Operation>	updateSnapshotCallable()	Updates the settings of a specific snapshot.
final OperationCallable<UpdateSnapshotRequest,Snapshot,OperationMetadata>	updateSnapshotOperationCallable()	Updates the settings of a specific snapshot.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

CloudFilestoreManagerClient

protected CloudFilestoreManagerClient(CloudFilestoreManagerSettings settings)
                               throws IOException

Constructs an instance of CloudFilestoreManagerClient, 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.

Throws:

IOException

CloudFilestoreManagerClient

protected CloudFilestoreManagerClient(CloudFilestoreManagerStub stub)

Method Details

create

public static final CloudFilestoreManagerClient create()
                                                throws IOException

Constructs an instance of CloudFilestoreManagerClient with default settings.

Throws:

IOException

create

public static final CloudFilestoreManagerClient create(CloudFilestoreManagerSettings settings)
                                                throws IOException

Constructs an instance of CloudFilestoreManagerClient, using the given settings. The channels are created based on the settings passed in, or defaults for any settings that are not set.

Throws:

IOException

create

public static final CloudFilestoreManagerClient create(CloudFilestoreManagerStub stub)

Constructs an instance of CloudFilestoreManagerClient, using the given stub for making calls. This is for advanced usage - prefer using create(CloudFilestoreManagerSettings).

getSettings

public final CloudFilestoreManagerSettings getSettings()

getStub

public CloudFilestoreManagerStub getStub()

getOperationsClient

public final OperationsClient getOperationsClient()

Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.

getHttpJsonOperationsClient

@BetaApi
public final OperationsClient getHttpJsonOperationsClient()

Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.

listInstances

public final CloudFilestoreManagerClient.ListInstancesPagedResponse listInstances(LocationName parent)

Lists all instances in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   for (Instance element : cloudFilestoreManagerClient.listInstances(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

parent - Required. The project and location for which to retrieve instance information, in the format `projects/{project_id}/locations/{location}`. In Cloud Filestore, locations map to Google Cloud zones, for example

• *us-west1-b**. To retrieve instance information for all locations, use "-" for the `{location}` value.

Throws:

ApiException - if the remote call fails

listInstances

public final CloudFilestoreManagerClient.ListInstancesPagedResponse listInstances(String parent)

Lists all instances in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   for (Instance element : cloudFilestoreManagerClient.listInstances(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

parent - Required. The project and location for which to retrieve instance information, in the format `projects/{project_id}/locations/{location}`. In Cloud Filestore, locations map to Google Cloud zones, for example

• *us-west1-b**. To retrieve instance information for all locations, use "-" for the `{location}` value.

Throws:

ApiException - if the remote call fails

listInstances

public final CloudFilestoreManagerClient.ListInstancesPagedResponse listInstances(ListInstancesRequest request)

Lists all instances in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListInstancesRequest request =
       ListInstancesRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .build();
   for (Instance element : cloudFilestoreManagerClient.listInstances(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

listInstancesPagedCallable

public final UnaryCallable<ListInstancesRequest,CloudFilestoreManagerClient.ListInstancesPagedResponse> listInstancesPagedCallable()

Lists all instances in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListInstancesRequest request =
       ListInstancesRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .build();
   ApiFuture<Instance> future =
       cloudFilestoreManagerClient.listInstancesPagedCallable().futureCall(request);
   // Do something.
   for (Instance element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 

listInstancesCallable

public final UnaryCallable<ListInstancesRequest,ListInstancesResponse> listInstancesCallable()

Lists all instances in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListInstancesRequest request =
       ListInstancesRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .build();
   while (true) {
     ListInstancesResponse response =
         cloudFilestoreManagerClient.listInstancesCallable().call(request);
     for (Instance element : response.getInstancesList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

getInstance

public final Instance getInstance(InstanceName name)

Gets the details of a specific instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   InstanceName name = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]");
   Instance response = cloudFilestoreManagerClient.getInstance(name);
 }
 

Parameters:

name - Required. The instance resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`.

Throws:

ApiException - if the remote call fails

getInstance

public final Instance getInstance(String name)

Gets the details of a specific instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String name = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString();
   Instance response = cloudFilestoreManagerClient.getInstance(name);
 }
 

Parameters:

name - Required. The instance resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`.

Throws:

ApiException - if the remote call fails

getInstance

public final Instance getInstance(GetInstanceRequest request)

Gets the details of a specific instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   GetInstanceRequest request =
       GetInstanceRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .build();
   Instance response = cloudFilestoreManagerClient.getInstance(request);
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

getInstanceCallable

public final UnaryCallable<GetInstanceRequest,Instance> getInstanceCallable()

Gets the details of a specific instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   GetInstanceRequest request =
       GetInstanceRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .build();
   ApiFuture<Instance> future =
       cloudFilestoreManagerClient.getInstanceCallable().futureCall(request);
   // Do something.
   Instance response = future.get();
 }
 

createInstanceAsync

public final OperationFuture<Instance,OperationMetadata> createInstanceAsync(LocationName parent,
 Instance instance,
 String instanceId)

Creates an instance. When creating from a backup, the capacity of the new instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   Instance instance = Instance.newBuilder().build();
   String instanceId = "instanceId902024336";
   Instance response =
       cloudFilestoreManagerClient.createInstanceAsync(parent, instance, instanceId).get();
 }
 

Parameters:

parent - Required. The instance's project and location, in the format `projects/{project_id}/locations/{location}`. In Filestore, locations map to Google Cloud zones, for example **us-west1-b**.

instance - Required. An [instance resource][google.cloud.filestore.v1beta1.Instance]

instanceId - Required. The ID of the instance to create. The ID must be unique within the specified project and location.

This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.

Throws:

ApiException - if the remote call fails

createInstanceAsync

public final OperationFuture<Instance,OperationMetadata> createInstanceAsync(String parent,
 Instance instance,
 String instanceId)

Creates an instance. When creating from a backup, the capacity of the new instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   Instance instance = Instance.newBuilder().build();
   String instanceId = "instanceId902024336";
   Instance response =
       cloudFilestoreManagerClient.createInstanceAsync(parent, instance, instanceId).get();
 }
 

Parameters:

parent - Required. The instance's project and location, in the format `projects/{project_id}/locations/{location}`. In Filestore, locations map to Google Cloud zones, for example **us-west1-b**.

instance - Required. An [instance resource][google.cloud.filestore.v1beta1.Instance]

instanceId - Required. The ID of the instance to create. The ID must be unique within the specified project and location.

This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.

Throws:

ApiException - if the remote call fails

createInstanceAsync

public final OperationFuture<Instance,OperationMetadata> createInstanceAsync(CreateInstanceRequest request)

Creates an instance. When creating from a backup, the capacity of the new instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateInstanceRequest request =
       CreateInstanceRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setInstanceId("instanceId902024336")
           .setInstance(Instance.newBuilder().build())
           .build();
   Instance response = cloudFilestoreManagerClient.createInstanceAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

createInstanceOperationCallable

public final OperationCallable<CreateInstanceRequest,Instance,OperationMetadata> createInstanceOperationCallable()

Creates an instance. When creating from a backup, the capacity of the new instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateInstanceRequest request =
       CreateInstanceRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setInstanceId("instanceId902024336")
           .setInstance(Instance.newBuilder().build())
           .build();
   OperationFuture<Instance, OperationMetadata> future =
       cloudFilestoreManagerClient.createInstanceOperationCallable().futureCall(request);
   // Do something.
   Instance response = future.get();
 }
 

createInstanceCallable

public final UnaryCallable<CreateInstanceRequest,Operation> createInstanceCallable()

Creates an instance. When creating from a backup, the capacity of the new instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateInstanceRequest request =
       CreateInstanceRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setInstanceId("instanceId902024336")
           .setInstance(Instance.newBuilder().build())
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.createInstanceCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

updateInstanceAsync

public final OperationFuture<Instance,OperationMetadata> updateInstanceAsync(Instance instance,
 com.google.protobuf.FieldMask updateMask)

Updates the settings of a specific instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   Instance instance = Instance.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   Instance response =
       cloudFilestoreManagerClient.updateInstanceAsync(instance, updateMask).get();
 }
 

Parameters:

instance - Required. Only fields specified in update_mask are updated.

updateMask - Required. Mask of fields to update. At least one path must be supplied in this field. The elements of the repeated paths field may only include these fields:

• "description"
• "directory_services"
• "file_shares"
• "labels"
• "performance_config"
• "deletion_protection_enabled"
• "deletion_protection_reason"

Throws:

ApiException - if the remote call fails

updateInstanceAsync

public final OperationFuture<Instance,OperationMetadata> updateInstanceAsync(UpdateInstanceRequest request)

Updates the settings of a specific instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateInstanceRequest request =
       UpdateInstanceRequest.newBuilder()
           .setUpdateMask(FieldMask.newBuilder().build())
           .setInstance(Instance.newBuilder().build())
           .build();
   Instance response = cloudFilestoreManagerClient.updateInstanceAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

updateInstanceOperationCallable

public final OperationCallable<UpdateInstanceRequest,Instance,OperationMetadata> updateInstanceOperationCallable()

Updates the settings of a specific instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateInstanceRequest request =
       UpdateInstanceRequest.newBuilder()
           .setUpdateMask(FieldMask.newBuilder().build())
           .setInstance(Instance.newBuilder().build())
           .build();
   OperationFuture<Instance, OperationMetadata> future =
       cloudFilestoreManagerClient.updateInstanceOperationCallable().futureCall(request);
   // Do something.
   Instance response = future.get();
 }
 

updateInstanceCallable

public final UnaryCallable<UpdateInstanceRequest,Operation> updateInstanceCallable()

Updates the settings of a specific instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateInstanceRequest request =
       UpdateInstanceRequest.newBuilder()
           .setUpdateMask(FieldMask.newBuilder().build())
           .setInstance(Instance.newBuilder().build())
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.updateInstanceCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

restoreInstanceAsync

public final OperationFuture<Instance,OperationMetadata> restoreInstanceAsync(RestoreInstanceRequest request)

Restores an existing instance's file share from a backup.

The capacity of the instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   RestoreInstanceRequest request =
       RestoreInstanceRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setFileShare("fileShare-1327728701")
           .build();
   Instance response = cloudFilestoreManagerClient.restoreInstanceAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

restoreInstanceOperationCallable

public final OperationCallable<RestoreInstanceRequest,Instance,OperationMetadata> restoreInstanceOperationCallable()

Restores an existing instance's file share from a backup.

The capacity of the instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   RestoreInstanceRequest request =
       RestoreInstanceRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setFileShare("fileShare-1327728701")
           .build();
   OperationFuture<Instance, OperationMetadata> future =
       cloudFilestoreManagerClient.restoreInstanceOperationCallable().futureCall(request);
   // Do something.
   Instance response = future.get();
 }
 

restoreInstanceCallable

public final UnaryCallable<RestoreInstanceRequest,Operation> restoreInstanceCallable()

Restores an existing instance's file share from a backup.

The capacity of the instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   RestoreInstanceRequest request =
       RestoreInstanceRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setFileShare("fileShare-1327728701")
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.restoreInstanceCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

revertInstanceAsync

public final OperationFuture<Instance,OperationMetadata> revertInstanceAsync(RevertInstanceRequest request)

Revert an existing instance's file system to a specified snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   RevertInstanceRequest request =
       RevertInstanceRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setTargetSnapshotId("targetSnapshotId-2099459472")
           .build();
   Instance response = cloudFilestoreManagerClient.revertInstanceAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

revertInstanceOperationCallable

public final OperationCallable<RevertInstanceRequest,Instance,OperationMetadata> revertInstanceOperationCallable()

Revert an existing instance's file system to a specified snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   RevertInstanceRequest request =
       RevertInstanceRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setTargetSnapshotId("targetSnapshotId-2099459472")
           .build();
   OperationFuture<Instance, OperationMetadata> future =
       cloudFilestoreManagerClient.revertInstanceOperationCallable().futureCall(request);
   // Do something.
   Instance response = future.get();
 }
 

revertInstanceCallable

public final UnaryCallable<RevertInstanceRequest,Operation> revertInstanceCallable()

Revert an existing instance's file system to a specified snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   RevertInstanceRequest request =
       RevertInstanceRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setTargetSnapshotId("targetSnapshotId-2099459472")
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.revertInstanceCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

promoteReplicaAsync

public final OperationFuture<Instance,OperationMetadata> promoteReplicaAsync(PromoteReplicaRequest request)

Promote the standby instance (replica).

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   PromoteReplicaRequest request =
       PromoteReplicaRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setPeerInstance(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .build();
   Instance response = cloudFilestoreManagerClient.promoteReplicaAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

promoteReplicaOperationCallable

public final OperationCallable<PromoteReplicaRequest,Instance,OperationMetadata> promoteReplicaOperationCallable()

Promote the standby instance (replica).

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   PromoteReplicaRequest request =
       PromoteReplicaRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setPeerInstance(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .build();
   OperationFuture<Instance, OperationMetadata> future =
       cloudFilestoreManagerClient.promoteReplicaOperationCallable().futureCall(request);
   // Do something.
   Instance response = future.get();
 }
 

promoteReplicaCallable

public final UnaryCallable<PromoteReplicaRequest,Operation> promoteReplicaCallable()

Promote the standby instance (replica).

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   PromoteReplicaRequest request =
       PromoteReplicaRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setPeerInstance(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.promoteReplicaCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

deleteInstanceAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteInstanceAsync(InstanceName name)

Deletes an instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   InstanceName name = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]");
   cloudFilestoreManagerClient.deleteInstanceAsync(name).get();
 }
 

Parameters:

name - Required. The instance resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`

Throws:

ApiException - if the remote call fails

deleteInstanceAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteInstanceAsync(String name)

Deletes an instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String name = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString();
   cloudFilestoreManagerClient.deleteInstanceAsync(name).get();
 }
 

Parameters:

name - Required. The instance resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`

Throws:

ApiException - if the remote call fails

deleteInstanceAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteInstanceAsync(DeleteInstanceRequest request)

Deletes an instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteInstanceRequest request =
       DeleteInstanceRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setForce(true)
           .build();
   cloudFilestoreManagerClient.deleteInstanceAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

deleteInstanceOperationCallable

public final OperationCallable<DeleteInstanceRequest,com.google.protobuf.Empty,OperationMetadata> deleteInstanceOperationCallable()

Deletes an instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteInstanceRequest request =
       DeleteInstanceRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setForce(true)
           .build();
   OperationFuture<Empty, OperationMetadata> future =
       cloudFilestoreManagerClient.deleteInstanceOperationCallable().futureCall(request);
   // Do something.
   future.get();
 }
 

deleteInstanceCallable

public final UnaryCallable<DeleteInstanceRequest,Operation> deleteInstanceCallable()

Deletes an instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteInstanceRequest request =
       DeleteInstanceRequest.newBuilder()
           .setName(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setForce(true)
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.deleteInstanceCallable().futureCall(request);
   // Do something.
   future.get();
 }
 

listSnapshots

public final CloudFilestoreManagerClient.ListSnapshotsPagedResponse listSnapshots(InstanceName parent)

Lists all snapshots in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   InstanceName parent = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]");
   for (Snapshot element : cloudFilestoreManagerClient.listSnapshots(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

parent - Required. The instance for which to retrieve snapshot information, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`.

Throws:

ApiException - if the remote call fails

listSnapshots

public final CloudFilestoreManagerClient.ListSnapshotsPagedResponse listSnapshots(String parent)

Lists all snapshots in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String parent = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString();
   for (Snapshot element : cloudFilestoreManagerClient.listSnapshots(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

parent - Required. The instance for which to retrieve snapshot information, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`.

Throws:

ApiException - if the remote call fails

listSnapshots

public final CloudFilestoreManagerClient.ListSnapshotsPagedResponse listSnapshots(ListSnapshotsRequest request)

Lists all snapshots in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListSnapshotsRequest request =
       ListSnapshotsRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .setReturnPartialSuccess(true)
           .build();
   for (Snapshot element : cloudFilestoreManagerClient.listSnapshots(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

listSnapshotsPagedCallable

public final UnaryCallable<ListSnapshotsRequest,CloudFilestoreManagerClient.ListSnapshotsPagedResponse> listSnapshotsPagedCallable()

Lists all snapshots in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListSnapshotsRequest request =
       ListSnapshotsRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .setReturnPartialSuccess(true)
           .build();
   ApiFuture<Snapshot> future =
       cloudFilestoreManagerClient.listSnapshotsPagedCallable().futureCall(request);
   // Do something.
   for (Snapshot element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 

listSnapshotsCallable

public final UnaryCallable<ListSnapshotsRequest,ListSnapshotsResponse> listSnapshotsCallable()

Lists all snapshots in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListSnapshotsRequest request =
       ListSnapshotsRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .setReturnPartialSuccess(true)
           .build();
   while (true) {
     ListSnapshotsResponse response =
         cloudFilestoreManagerClient.listSnapshotsCallable().call(request);
     for (Snapshot element : response.getSnapshotsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

getSnapshot

public final Snapshot getSnapshot(SnapshotName name)

Gets the details of a specific snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   SnapshotName name = SnapshotName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SNAPSHOT]");
   Snapshot response = cloudFilestoreManagerClient.getSnapshot(name);
 }
 

Parameters:

name - Required. The snapshot resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}/snapshots/{snapshot_id}`

Throws:

ApiException - if the remote call fails

getSnapshot

public final Snapshot getSnapshot(String name)

Gets the details of a specific snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String name =
       SnapshotName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SNAPSHOT]").toString();
   Snapshot response = cloudFilestoreManagerClient.getSnapshot(name);
 }
 

Parameters:

name - Required. The snapshot resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}/snapshots/{snapshot_id}`

Throws:

ApiException - if the remote call fails

getSnapshot

public final Snapshot getSnapshot(GetSnapshotRequest request)

Gets the details of a specific snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   GetSnapshotRequest request =
       GetSnapshotRequest.newBuilder()
           .setName(
               SnapshotName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SNAPSHOT]").toString())
           .build();
   Snapshot response = cloudFilestoreManagerClient.getSnapshot(request);
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

getSnapshotCallable

public final UnaryCallable<GetSnapshotRequest,Snapshot> getSnapshotCallable()

Gets the details of a specific snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   GetSnapshotRequest request =
       GetSnapshotRequest.newBuilder()
           .setName(
               SnapshotName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SNAPSHOT]").toString())
           .build();
   ApiFuture<Snapshot> future =
       cloudFilestoreManagerClient.getSnapshotCallable().futureCall(request);
   // Do something.
   Snapshot response = future.get();
 }
 

createSnapshotAsync

public final OperationFuture<Snapshot,OperationMetadata> createSnapshotAsync(InstanceName parent,
 Snapshot snapshot,
 String snapshotId)

Creates a snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   InstanceName parent = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]");
   Snapshot snapshot = Snapshot.newBuilder().build();
   String snapshotId = "snapshotId-1113817601";
   Snapshot response =
       cloudFilestoreManagerClient.createSnapshotAsync(parent, snapshot, snapshotId).get();
 }
 

Parameters:

parent - Required. The Filestore Instance to create the snapshots of, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`

snapshot - Required. A snapshot resource

snapshotId - Required. The ID to use for the snapshot. The ID must be unique within the specified instance.

This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.

Throws:

ApiException - if the remote call fails

createSnapshotAsync

public final OperationFuture<Snapshot,OperationMetadata> createSnapshotAsync(String parent,
 Snapshot snapshot,
 String snapshotId)

Creates a snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String parent = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString();
   Snapshot snapshot = Snapshot.newBuilder().build();
   String snapshotId = "snapshotId-1113817601";
   Snapshot response =
       cloudFilestoreManagerClient.createSnapshotAsync(parent, snapshot, snapshotId).get();
 }
 

Parameters:

parent - Required. The Filestore Instance to create the snapshots of, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`

snapshot - Required. A snapshot resource

snapshotId - Required. The ID to use for the snapshot. The ID must be unique within the specified instance.

This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.

Throws:

ApiException - if the remote call fails

createSnapshotAsync

public final OperationFuture<Snapshot,OperationMetadata> createSnapshotAsync(CreateSnapshotRequest request)

Creates a snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateSnapshotRequest request =
       CreateSnapshotRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setSnapshotId("snapshotId-1113817601")
           .setSnapshot(Snapshot.newBuilder().build())
           .build();
   Snapshot response = cloudFilestoreManagerClient.createSnapshotAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

createSnapshotOperationCallable

public final OperationCallable<CreateSnapshotRequest,Snapshot,OperationMetadata> createSnapshotOperationCallable()

Creates a snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateSnapshotRequest request =
       CreateSnapshotRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setSnapshotId("snapshotId-1113817601")
           .setSnapshot(Snapshot.newBuilder().build())
           .build();
   OperationFuture<Snapshot, OperationMetadata> future =
       cloudFilestoreManagerClient.createSnapshotOperationCallable().futureCall(request);
   // Do something.
   Snapshot response = future.get();
 }
 

createSnapshotCallable

public final UnaryCallable<CreateSnapshotRequest,Operation> createSnapshotCallable()

Creates a snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateSnapshotRequest request =
       CreateSnapshotRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setSnapshotId("snapshotId-1113817601")
           .setSnapshot(Snapshot.newBuilder().build())
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.createSnapshotCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

deleteSnapshotAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteSnapshotAsync(SnapshotName name)

Deletes a snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   SnapshotName name = SnapshotName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SNAPSHOT]");
   cloudFilestoreManagerClient.deleteSnapshotAsync(name).get();
 }
 

Parameters:

name - Required. The snapshot resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}/snapshots/{snapshot_id}`

Throws:

ApiException - if the remote call fails

deleteSnapshotAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteSnapshotAsync(String name)

Deletes a snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String name =
       SnapshotName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SNAPSHOT]").toString();
   cloudFilestoreManagerClient.deleteSnapshotAsync(name).get();
 }
 

Parameters:

name - Required. The snapshot resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}/snapshots/{snapshot_id}`

Throws:

ApiException - if the remote call fails

deleteSnapshotAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteSnapshotAsync(DeleteSnapshotRequest request)

Deletes a snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteSnapshotRequest request =
       DeleteSnapshotRequest.newBuilder()
           .setName(
               SnapshotName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SNAPSHOT]").toString())
           .build();
   cloudFilestoreManagerClient.deleteSnapshotAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

deleteSnapshotOperationCallable

public final OperationCallable<DeleteSnapshotRequest,com.google.protobuf.Empty,OperationMetadata> deleteSnapshotOperationCallable()

Deletes a snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteSnapshotRequest request =
       DeleteSnapshotRequest.newBuilder()
           .setName(
               SnapshotName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SNAPSHOT]").toString())
           .build();
   OperationFuture<Empty, OperationMetadata> future =
       cloudFilestoreManagerClient.deleteSnapshotOperationCallable().futureCall(request);
   // Do something.
   future.get();
 }
 

deleteSnapshotCallable

public final UnaryCallable<DeleteSnapshotRequest,Operation> deleteSnapshotCallable()

Deletes a snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteSnapshotRequest request =
       DeleteSnapshotRequest.newBuilder()
           .setName(
               SnapshotName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SNAPSHOT]").toString())
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.deleteSnapshotCallable().futureCall(request);
   // Do something.
   future.get();
 }
 

updateSnapshotAsync

public final OperationFuture<Snapshot,OperationMetadata> updateSnapshotAsync(Snapshot snapshot,
 com.google.protobuf.FieldMask updateMask)

Updates the settings of a specific snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   Snapshot snapshot = Snapshot.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   Snapshot response =
       cloudFilestoreManagerClient.updateSnapshotAsync(snapshot, updateMask).get();
 }
 

Parameters:

snapshot - Required. A snapshot resource

updateMask - Required. Mask of fields to update. At least one path must be supplied in this field.

Throws:

ApiException - if the remote call fails

updateSnapshotAsync

public final OperationFuture<Snapshot,OperationMetadata> updateSnapshotAsync(UpdateSnapshotRequest request)

Updates the settings of a specific snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateSnapshotRequest request =
       UpdateSnapshotRequest.newBuilder()
           .setUpdateMask(FieldMask.newBuilder().build())
           .setSnapshot(Snapshot.newBuilder().build())
           .build();
   Snapshot response = cloudFilestoreManagerClient.updateSnapshotAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

updateSnapshotOperationCallable

public final OperationCallable<UpdateSnapshotRequest,Snapshot,OperationMetadata> updateSnapshotOperationCallable()

Updates the settings of a specific snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateSnapshotRequest request =
       UpdateSnapshotRequest.newBuilder()
           .setUpdateMask(FieldMask.newBuilder().build())
           .setSnapshot(Snapshot.newBuilder().build())
           .build();
   OperationFuture<Snapshot, OperationMetadata> future =
       cloudFilestoreManagerClient.updateSnapshotOperationCallable().futureCall(request);
   // Do something.
   Snapshot response = future.get();
 }
 

updateSnapshotCallable

public final UnaryCallable<UpdateSnapshotRequest,Operation> updateSnapshotCallable()

Updates the settings of a specific snapshot.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateSnapshotRequest request =
       UpdateSnapshotRequest.newBuilder()
           .setUpdateMask(FieldMask.newBuilder().build())
           .setSnapshot(Snapshot.newBuilder().build())
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.updateSnapshotCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

listBackups

public final CloudFilestoreManagerClient.ListBackupsPagedResponse listBackups(LocationName parent)

Lists all backups in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   for (Backup element : cloudFilestoreManagerClient.listBackups(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

parent - Required. The project and location for which to retrieve backup information, in the format `projects/{project_id}/locations/{location}`. In Filestore, backup locations map to Google Cloud regions, for example

• *us-west1**. To retrieve backup information for all locations, use "-" for the `{location}` value.

Throws:

ApiException - if the remote call fails

listBackups

public final CloudFilestoreManagerClient.ListBackupsPagedResponse listBackups(String parent)

Lists all backups in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   for (Backup element : cloudFilestoreManagerClient.listBackups(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

parent - Required. The project and location for which to retrieve backup information, in the format `projects/{project_id}/locations/{location}`. In Filestore, backup locations map to Google Cloud regions, for example

• *us-west1**. To retrieve backup information for all locations, use "-" for the `{location}` value.

Throws:

ApiException - if the remote call fails

listBackups

public final CloudFilestoreManagerClient.ListBackupsPagedResponse listBackups(ListBackupsRequest request)

Lists all backups in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListBackupsRequest request =
       ListBackupsRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .build();
   for (Backup element : cloudFilestoreManagerClient.listBackups(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

listBackupsPagedCallable

public final UnaryCallable<ListBackupsRequest,CloudFilestoreManagerClient.ListBackupsPagedResponse> listBackupsPagedCallable()

Lists all backups in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListBackupsRequest request =
       ListBackupsRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .build();
   ApiFuture<Backup> future =
       cloudFilestoreManagerClient.listBackupsPagedCallable().futureCall(request);
   // Do something.
   for (Backup element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 

listBackupsCallable

public final UnaryCallable<ListBackupsRequest,ListBackupsResponse> listBackupsCallable()

Lists all backups in a project for either a specified location or for all locations.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListBackupsRequest request =
       ListBackupsRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .build();
   while (true) {
     ListBackupsResponse response =
         cloudFilestoreManagerClient.listBackupsCallable().call(request);
     for (Backup element : response.getBackupsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

getBackup

public final Backup getBackup(BackupName name)

Gets the details of a specific backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   BackupName name = BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]");
   Backup response = cloudFilestoreManagerClient.getBackup(name);
 }
 

Parameters:

name - Required. The backup resource name, in the format `projects/{project_id}/locations/{location}/backups/{backup_id}`.

Throws:

ApiException - if the remote call fails

getBackup

public final Backup getBackup(String name)

Gets the details of a specific backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String name = BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]").toString();
   Backup response = cloudFilestoreManagerClient.getBackup(name);
 }
 

Parameters:

name - Required. The backup resource name, in the format `projects/{project_id}/locations/{location}/backups/{backup_id}`.

Throws:

ApiException - if the remote call fails

getBackup

public final Backup getBackup(GetBackupRequest request)

Gets the details of a specific backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   GetBackupRequest request =
       GetBackupRequest.newBuilder()
           .setName(BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]").toString())
           .build();
   Backup response = cloudFilestoreManagerClient.getBackup(request);
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

getBackupCallable

public final UnaryCallable<GetBackupRequest,Backup> getBackupCallable()

Gets the details of a specific backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   GetBackupRequest request =
       GetBackupRequest.newBuilder()
           .setName(BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]").toString())
           .build();
   ApiFuture<Backup> future =
       cloudFilestoreManagerClient.getBackupCallable().futureCall(request);
   // Do something.
   Backup response = future.get();
 }
 

createBackupAsync

public final OperationFuture<Backup,OperationMetadata> createBackupAsync(LocationName parent,
 Backup backup,
 String backupId)

Creates a backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   Backup backup = Backup.newBuilder().build();
   String backupId = "backupId2121930365";
   Backup response =
       cloudFilestoreManagerClient.createBackupAsync(parent, backup, backupId).get();
 }
 

Parameters:

parent - Required. The backup's project and location, in the format `projects/{project_id}/locations/{location}`. In Filestore, backup locations map to Google Cloud regions, for example **us-west1**.

backup - Required. A [backup resource][google.cloud.filestore.v1beta1.Backup]

backupId - Required. The ID to use for the backup. The ID must be unique within the specified project and location.

This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.

Throws:

ApiException - if the remote call fails

createBackupAsync

public final OperationFuture<Backup,OperationMetadata> createBackupAsync(String parent,
 Backup backup,
 String backupId)

Creates a backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   Backup backup = Backup.newBuilder().build();
   String backupId = "backupId2121930365";
   Backup response =
       cloudFilestoreManagerClient.createBackupAsync(parent, backup, backupId).get();
 }
 

Parameters:

parent - Required. The backup's project and location, in the format `projects/{project_id}/locations/{location}`. In Filestore, backup locations map to Google Cloud regions, for example **us-west1**.

backup - Required. A [backup resource][google.cloud.filestore.v1beta1.Backup]

backupId - Required. The ID to use for the backup. The ID must be unique within the specified project and location.

This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.

Throws:

ApiException - if the remote call fails

createBackupAsync

public final OperationFuture<Backup,OperationMetadata> createBackupAsync(CreateBackupRequest request)

Creates a backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateBackupRequest request =
       CreateBackupRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setBackup(Backup.newBuilder().build())
           .setBackupId("backupId2121930365")
           .build();
   Backup response = cloudFilestoreManagerClient.createBackupAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

createBackupOperationCallable

public final OperationCallable<CreateBackupRequest,Backup,OperationMetadata> createBackupOperationCallable()

Creates a backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateBackupRequest request =
       CreateBackupRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setBackup(Backup.newBuilder().build())
           .setBackupId("backupId2121930365")
           .build();
   OperationFuture<Backup, OperationMetadata> future =
       cloudFilestoreManagerClient.createBackupOperationCallable().futureCall(request);
   // Do something.
   Backup response = future.get();
 }
 

createBackupCallable

public final UnaryCallable<CreateBackupRequest,Operation> createBackupCallable()

Creates a backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateBackupRequest request =
       CreateBackupRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setBackup(Backup.newBuilder().build())
           .setBackupId("backupId2121930365")
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.createBackupCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

deleteBackupAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteBackupAsync(BackupName name)

Deletes a backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   BackupName name = BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]");
   cloudFilestoreManagerClient.deleteBackupAsync(name).get();
 }
 

Parameters:

name - Required. The backup resource name, in the format `projects/{project_id}/locations/{location}/backups/{backup_id}`

Throws:

ApiException - if the remote call fails

deleteBackupAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteBackupAsync(String name)

Deletes a backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String name = BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]").toString();
   cloudFilestoreManagerClient.deleteBackupAsync(name).get();
 }
 

Parameters:

name - Required. The backup resource name, in the format `projects/{project_id}/locations/{location}/backups/{backup_id}`

Throws:

ApiException - if the remote call fails

deleteBackupAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteBackupAsync(DeleteBackupRequest request)

Deletes a backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteBackupRequest request =
       DeleteBackupRequest.newBuilder()
           .setName(BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]").toString())
           .build();
   cloudFilestoreManagerClient.deleteBackupAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

deleteBackupOperationCallable

public final OperationCallable<DeleteBackupRequest,com.google.protobuf.Empty,OperationMetadata> deleteBackupOperationCallable()

Deletes a backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteBackupRequest request =
       DeleteBackupRequest.newBuilder()
           .setName(BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]").toString())
           .build();
   OperationFuture<Empty, OperationMetadata> future =
       cloudFilestoreManagerClient.deleteBackupOperationCallable().futureCall(request);
   // Do something.
   future.get();
 }
 

deleteBackupCallable

public final UnaryCallable<DeleteBackupRequest,Operation> deleteBackupCallable()

Deletes a backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteBackupRequest request =
       DeleteBackupRequest.newBuilder()
           .setName(BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]").toString())
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.deleteBackupCallable().futureCall(request);
   // Do something.
   future.get();
 }
 

updateBackupAsync

public final OperationFuture<Backup,OperationMetadata> updateBackupAsync(Backup backup,
 com.google.protobuf.FieldMask updateMask)

Updates the settings of a specific backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   Backup backup = Backup.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   Backup response = cloudFilestoreManagerClient.updateBackupAsync(backup, updateMask).get();
 }
 

Parameters:

backup - Required. A [backup resource][google.cloud.filestore.v1beta1.Backup]

updateMask - Required. Mask of fields to update. At least one path must be supplied in this field.

Throws:

ApiException - if the remote call fails

updateBackupAsync

public final OperationFuture<Backup,OperationMetadata> updateBackupAsync(UpdateBackupRequest request)

Updates the settings of a specific backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateBackupRequest request =
       UpdateBackupRequest.newBuilder()
           .setBackup(Backup.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   Backup response = cloudFilestoreManagerClient.updateBackupAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

updateBackupOperationCallable

public final OperationCallable<UpdateBackupRequest,Backup,OperationMetadata> updateBackupOperationCallable()

Updates the settings of a specific backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateBackupRequest request =
       UpdateBackupRequest.newBuilder()
           .setBackup(Backup.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   OperationFuture<Backup, OperationMetadata> future =
       cloudFilestoreManagerClient.updateBackupOperationCallable().futureCall(request);
   // Do something.
   Backup response = future.get();
 }
 

updateBackupCallable

public final UnaryCallable<UpdateBackupRequest,Operation> updateBackupCallable()

Updates the settings of a specific backup.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateBackupRequest request =
       UpdateBackupRequest.newBuilder()
           .setBackup(Backup.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.updateBackupCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

listShares

public final CloudFilestoreManagerClient.ListSharesPagedResponse listShares(InstanceName parent)

Lists all shares for a specified instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   InstanceName parent = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]");
   for (Share element : cloudFilestoreManagerClient.listShares(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

parent - Required. The instance for which to retrieve share information, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`.

Throws:

ApiException - if the remote call fails

listShares

public final CloudFilestoreManagerClient.ListSharesPagedResponse listShares(String parent)

Lists all shares for a specified instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String parent = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString();
   for (Share element : cloudFilestoreManagerClient.listShares(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

parent - Required. The instance for which to retrieve share information, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`.

Throws:

ApiException - if the remote call fails

listShares

public final CloudFilestoreManagerClient.ListSharesPagedResponse listShares(ListSharesRequest request)

Lists all shares for a specified instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListSharesRequest request =
       ListSharesRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .build();
   for (Share element : cloudFilestoreManagerClient.listShares(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

listSharesPagedCallable

public final UnaryCallable<ListSharesRequest,CloudFilestoreManagerClient.ListSharesPagedResponse> listSharesPagedCallable()

Lists all shares for a specified instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListSharesRequest request =
       ListSharesRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .build();
   ApiFuture<Share> future =
       cloudFilestoreManagerClient.listSharesPagedCallable().futureCall(request);
   // Do something.
   for (Share element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 

listSharesCallable

public final UnaryCallable<ListSharesRequest,ListSharesResponse> listSharesCallable()

Lists all shares for a specified instance.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ListSharesRequest request =
       ListSharesRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOrderBy("orderBy-1207110587")
           .setFilter("filter-1274492040")
           .build();
   while (true) {
     ListSharesResponse response =
         cloudFilestoreManagerClient.listSharesCallable().call(request);
     for (Share element : response.getSharesList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

getShare

public final Share getShare(ShareName name)

Gets the details of a specific share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ShareName name = ShareName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SHARE]");
   Share response = cloudFilestoreManagerClient.getShare(name);
 }
 

Parameters:

name - Required. The share resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}/shares/{share_id}`

Throws:

ApiException - if the remote call fails

getShare

public final Share getShare(String name)

Gets the details of a specific share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String name = ShareName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SHARE]").toString();
   Share response = cloudFilestoreManagerClient.getShare(name);
 }
 

Parameters:

name - Required. The share resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}/shares/{share_id}`

Throws:

ApiException - if the remote call fails

getShare

public final Share getShare(GetShareRequest request)

Gets the details of a specific share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   GetShareRequest request =
       GetShareRequest.newBuilder()
           .setName(ShareName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SHARE]").toString())
           .build();
   Share response = cloudFilestoreManagerClient.getShare(request);
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

getShareCallable

public final UnaryCallable<GetShareRequest,Share> getShareCallable()

Gets the details of a specific share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   GetShareRequest request =
       GetShareRequest.newBuilder()
           .setName(ShareName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SHARE]").toString())
           .build();
   ApiFuture<Share> future = cloudFilestoreManagerClient.getShareCallable().futureCall(request);
   // Do something.
   Share response = future.get();
 }
 

createShareAsync

public final OperationFuture<Share,OperationMetadata> createShareAsync(InstanceName parent,
 Share share,
 String shareId)

Creates a share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   InstanceName parent = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]");
   Share share = Share.newBuilder().build();
   String shareId = "shareId2054217050";
   Share response = cloudFilestoreManagerClient.createShareAsync(parent, share, shareId).get();
 }
 

Parameters:

parent - Required. The Filestore Instance to create the share for, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`

share - Required. A share resource

shareId - Required. The ID to use for the share. The ID must be unique within the specified instance.

This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.

Throws:

ApiException - if the remote call fails

createShareAsync

public final OperationFuture<Share,OperationMetadata> createShareAsync(String parent,
 Share share,
 String shareId)

Creates a share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String parent = InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString();
   Share share = Share.newBuilder().build();
   String shareId = "shareId2054217050";
   Share response = cloudFilestoreManagerClient.createShareAsync(parent, share, shareId).get();
 }
 

Parameters:

parent - Required. The Filestore Instance to create the share for, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}`

share - Required. A share resource

shareId - Required. The ID to use for the share. The ID must be unique within the specified instance.

This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.

Throws:

ApiException - if the remote call fails

createShareAsync

public final OperationFuture<Share,OperationMetadata> createShareAsync(CreateShareRequest request)

Creates a share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateShareRequest request =
       CreateShareRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setShareId("shareId2054217050")
           .setShare(Share.newBuilder().build())
           .build();
   Share response = cloudFilestoreManagerClient.createShareAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

createShareOperationCallable

public final OperationCallable<CreateShareRequest,Share,OperationMetadata> createShareOperationCallable()

Creates a share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateShareRequest request =
       CreateShareRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setShareId("shareId2054217050")
           .setShare(Share.newBuilder().build())
           .build();
   OperationFuture<Share, OperationMetadata> future =
       cloudFilestoreManagerClient.createShareOperationCallable().futureCall(request);
   // Do something.
   Share response = future.get();
 }
 

createShareCallable

public final UnaryCallable<CreateShareRequest,Operation> createShareCallable()

Creates a share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   CreateShareRequest request =
       CreateShareRequest.newBuilder()
           .setParent(InstanceName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]").toString())
           .setShareId("shareId2054217050")
           .setShare(Share.newBuilder().build())
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.createShareCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

deleteShareAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteShareAsync(ShareName name)

Deletes a share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   ShareName name = ShareName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SHARE]");
   cloudFilestoreManagerClient.deleteShareAsync(name).get();
 }
 

Parameters:

name - Required. The share resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}/share/{share_id}`

Throws:

ApiException - if the remote call fails

deleteShareAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteShareAsync(String name)

Deletes a share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   String name = ShareName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SHARE]").toString();
   cloudFilestoreManagerClient.deleteShareAsync(name).get();
 }
 

Parameters:

name - Required. The share resource name, in the format `projects/{project_id}/locations/{location}/instances/{instance_id}/share/{share_id}`

Throws:

ApiException - if the remote call fails

deleteShareAsync

public final OperationFuture<com.google.protobuf.Empty,OperationMetadata> deleteShareAsync(DeleteShareRequest request)

Deletes a share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteShareRequest request =
       DeleteShareRequest.newBuilder()
           .setName(ShareName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SHARE]").toString())
           .build();
   cloudFilestoreManagerClient.deleteShareAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

deleteShareOperationCallable

public final OperationCallable<DeleteShareRequest,com.google.protobuf.Empty,OperationMetadata> deleteShareOperationCallable()

Deletes a share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteShareRequest request =
       DeleteShareRequest.newBuilder()
           .setName(ShareName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SHARE]").toString())
           .build();
   OperationFuture<Empty, OperationMetadata> future =
       cloudFilestoreManagerClient.deleteShareOperationCallable().futureCall(request);
   // Do something.
   future.get();
 }
 

deleteShareCallable

public final UnaryCallable<DeleteShareRequest,Operation> deleteShareCallable()

Deletes a share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   DeleteShareRequest request =
       DeleteShareRequest.newBuilder()
           .setName(ShareName.of("[PROJECT]", "[LOCATION]", "[INSTANCE]", "[SHARE]").toString())
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.deleteShareCallable().futureCall(request);
   // Do something.
   future.get();
 }
 

updateShareAsync

public final OperationFuture<Share,OperationMetadata> updateShareAsync(Share share,
 com.google.protobuf.FieldMask updateMask)

Updates the settings of a specific share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   Share share = Share.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   Share response = cloudFilestoreManagerClient.updateShareAsync(share, updateMask).get();
 }
 

Parameters:

share - Required. A share resource. Only fields specified in update_mask are updated.

updateMask - Required. Mask of fields to update. At least one path must be supplied in this field. The elements of the repeated paths field may only include these fields:

• "description"
• "capacity_gb"
• "labels"
• "nfs_export_options"

Throws:

ApiException - if the remote call fails

updateShareAsync

public final OperationFuture<Share,OperationMetadata> updateShareAsync(UpdateShareRequest request)

Updates the settings of a specific share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateShareRequest request =
       UpdateShareRequest.newBuilder()
           .setShare(Share.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   Share response = cloudFilestoreManagerClient.updateShareAsync(request).get();
 }
 

Parameters:

request - The request object containing all of the parameters for the API call.

Throws:

ApiException - if the remote call fails

updateShareOperationCallable

public final OperationCallable<UpdateShareRequest,Share,OperationMetadata> updateShareOperationCallable()

Updates the settings of a specific share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateShareRequest request =
       UpdateShareRequest.newBuilder()
           .setShare(Share.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   OperationFuture<Share, OperationMetadata> future =
       cloudFilestoreManagerClient.updateShareOperationCallable().futureCall(request);
   // Do something.
   Share response = future.get();
 }
 

updateShareCallable

public final UnaryCallable<UpdateShareRequest,Operation> updateShareCallable()

Updates the settings of a specific share.

Sample 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 (CloudFilestoreManagerClient cloudFilestoreManagerClient =
     CloudFilestoreManagerClient.create()) {
   UpdateShareRequest request =
       UpdateShareRequest.newBuilder()
           .setShare(Share.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   ApiFuture<Operation> future =
       cloudFilestoreManagerClient.updateShareCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 

close

public final void close()

Specified by:

close in interface AutoCloseable

shutdown

public void shutdown()

Specified by:

shutdown in interface BackgroundResource

isShutdown

public boolean isShutdown()

Specified by:

isShutdown in interface BackgroundResource

isTerminated

public boolean isTerminated()

Specified by:

isTerminated in interface BackgroundResource

shutdownNow

public void shutdownNow()

Specified by:

shutdownNow in interface BackgroundResource

awaitTermination

public boolean awaitTermination(long duration,
 TimeUnit unit)
                         throws InterruptedException

Specified by:

awaitTermination in interface BackgroundResource

Throws:

InterruptedException