Class StorageControlClient
- All Implemented Interfaces:
com.google.api.gax.core.BackgroundResource,AutoCloseable
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 (StorageControlClient storageControlClient = StorageControlClient.create()) {
BucketName parent = BucketName.of("[PROJECT]", "[BUCKET]");
Folder folder = Folder.newBuilder().build();
String folderId = "folderId294109737";
Folder response = storageControlClient.createFolder(parent, folder, folderId);
}
Note: close() needs to be called on the StorageControlClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().
| Method | Description | Method Variants |
|---|---|---|
CreateFolder |
Creates a new folder. This operation is only applicable to a hierarchical namespace enabled bucket. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
DeleteFolder |
Permanently deletes an empty folder. This operation is only applicable to a hierarchical namespace enabled bucket. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetFolder |
Returns metadata for the specified folder. This operation is only applicable to a hierarchical namespace enabled bucket. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
ListFolders |
Retrieves a list of folders. This operation is only applicable to a hierarchical namespace enabled bucket. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
RenameFolder |
Renames a source folder to a destination folder. This operation is only applicable to a hierarchical namespace enabled bucket. During a rename, the source and destination folders are locked until the long running operation completes. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetStorageLayout |
Returns the storage layout configuration for a given bucket. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
CreateManagedFolder |
Creates a new managed folder. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
DeleteManagedFolder |
Permanently deletes an empty managed folder. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetManagedFolder |
Returns metadata for the specified managed folder. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
ListManagedFolders |
Retrieves a list of managed folders for a given bucket. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
CreateAnywhereCache |
Creates an Anywhere Cache instance. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
UpdateAnywhereCache |
Updates an Anywhere Cache instance. Mutable fields include `ttl` and `admission_policy`. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
DisableAnywhereCache |
Disables an Anywhere Cache instance. A disabled instance is read-only. The disablement could be revoked by calling ResumeAnywhereCache. The cache instance will be deleted automatically if it remains in the disabled state for at least one hour. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
PauseAnywhereCache |
Pauses an Anywhere Cache instance. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
ResumeAnywhereCache |
Resumes a disabled or paused Anywhere Cache instance. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetAnywhereCache |
Gets an Anywhere Cache instance. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
ListAnywhereCaches |
Lists Anywhere Cache instances for a given bucket. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetProjectIntelligenceConfig |
Returns the Project scoped singleton IntelligenceConfig resource. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
UpdateProjectIntelligenceConfig |
Updates the Project scoped singleton IntelligenceConfig resource. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetFolderIntelligenceConfig |
Returns the Folder scoped singleton IntelligenceConfig resource. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
UpdateFolderIntelligenceConfig |
Updates the Folder scoped singleton IntelligenceConfig resource. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
GetOrganizationIntelligenceConfig |
Returns the Organization scoped singleton IntelligenceConfig resource. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
UpdateOrganizationIntelligenceConfig |
Updates the Organization scoped singleton IntelligenceConfig resource. |
Request object method variants only take one parameter, a request object, which must be constructed before the call.
"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
|
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 StorageControlSettings 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
StorageControlSettings storageControlSettings =
StorageControlSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
.build();
StorageControlClient storageControlClient = StorageControlClient.create(storageControlSettings);
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
StorageControlSettings storageControlSettings =
StorageControlSettings.newBuilder().setEndpoint(myEndpoint).build();
StorageControlClient storageControlClient = StorageControlClient.create(storageControlSettings);
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
StorageControlSettings storageControlSettings =
StorageControlSettings.newHttpJsonBuilder().build();
StorageControlClient storageControlClient = StorageControlClient.create(storageControlSettings);
Please refer to the GitHub repository's samples for more quickstart code snippets.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic classstatic classstatic classstatic classstatic classstatic classstatic classstatic classstatic class -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedStorageControlClient(StorageControlSettings settings) Constructs an instance of StorageControlClient, using the given settings.protected -
Method Summary
Modifier and TypeMethodDescriptionbooleanawaitTermination(long duration, TimeUnit unit) final voidclose()static final StorageControlClientcreate()Constructs an instance of StorageControlClient with default settings.static final StorageControlClientcreate(StorageControlSettings settings) Constructs an instance of StorageControlClient, using the given settings.static final StorageControlClientcreate(StorageControlStub stub) Constructs an instance of StorageControlClient, using the given stub for making calls.final com.google.api.gax.longrunning.OperationFuture<AnywhereCache,CreateAnywhereCacheMetadata> createAnywhereCacheAsync(BucketName parent, AnywhereCache anywhereCache) Creates an Anywhere Cache instance.final com.google.api.gax.longrunning.OperationFuture<AnywhereCache,CreateAnywhereCacheMetadata> Creates an Anywhere Cache instance.final com.google.api.gax.longrunning.OperationFuture<AnywhereCache,CreateAnywhereCacheMetadata> createAnywhereCacheAsync(String parent, AnywhereCache anywhereCache) Creates an Anywhere Cache instance.final com.google.api.gax.rpc.UnaryCallable<CreateAnywhereCacheRequest,com.google.longrunning.Operation> Creates an Anywhere Cache instance.final com.google.api.gax.rpc.OperationCallable<CreateAnywhereCacheRequest,AnywhereCache, CreateAnywhereCacheMetadata> Creates an Anywhere Cache instance.final FoldercreateFolder(BucketName parent, Folder folder, String folderId) Creates a new folder.final FoldercreateFolder(CreateFolderRequest request) Creates a new folder.final FoldercreateFolder(String parent, Folder folder, String folderId) Creates a new folder.final com.google.api.gax.rpc.UnaryCallable<CreateFolderRequest,Folder> Creates a new folder.final ManagedFoldercreateManagedFolder(BucketName parent, ManagedFolder managedFolder, String managedFolderId) Creates a new managed folder.final ManagedFolderCreates a new managed folder.final ManagedFoldercreateManagedFolder(String parent, ManagedFolder managedFolder, String managedFolderId) Creates a new managed folder.final com.google.api.gax.rpc.UnaryCallable<CreateManagedFolderRequest,ManagedFolder> Creates a new managed folder.final voiddeleteFolder(DeleteFolderRequest request) Permanently deletes an empty folder.final voiddeleteFolder(FolderName name) Permanently deletes an empty folder.final voiddeleteFolder(String name) Permanently deletes an empty folder.final com.google.api.gax.rpc.UnaryCallable<DeleteFolderRequest,com.google.protobuf.Empty> Permanently deletes an empty folder.final voidPermanently deletes an empty managed folder.final voidPermanently deletes an empty managed folder.final voiddeleteManagedFolder(String name) Permanently deletes an empty managed folder.final com.google.api.gax.rpc.UnaryCallable<DeleteManagedFolderRequest,com.google.protobuf.Empty> Permanently deletes an empty managed folder.final AnywhereCacheDisables an Anywhere Cache instance.final AnywhereCacheDisables an Anywhere Cache instance.final AnywhereCachedisableAnywhereCache(String name) Disables an Anywhere Cache instance.final com.google.api.gax.rpc.UnaryCallable<DisableAnywhereCacheRequest,AnywhereCache> Disables an Anywhere Cache instance.final AnywhereCacheGets an Anywhere Cache instance.final AnywhereCachegetAnywhereCache(GetAnywhereCacheRequest request) Gets an Anywhere Cache instance.final AnywhereCachegetAnywhereCache(String name) Gets an Anywhere Cache instance.final com.google.api.gax.rpc.UnaryCallable<GetAnywhereCacheRequest,AnywhereCache> Gets an Anywhere Cache instance.final FoldergetFolder(FolderName name) Returns metadata for the specified folder.final FoldergetFolder(GetFolderRequest request) Returns metadata for the specified folder.final FolderReturns metadata for the specified folder.final com.google.api.gax.rpc.UnaryCallable<GetFolderRequest,Folder> Returns metadata for the specified folder.final IntelligenceConfigReturns the Folder scoped singleton IntelligenceConfig resource.final IntelligenceConfigReturns the Folder scoped singleton IntelligenceConfig resource.final IntelligenceConfigReturns the Folder scoped singleton IntelligenceConfig resource.final com.google.api.gax.rpc.UnaryCallable<GetFolderIntelligenceConfigRequest,IntelligenceConfig> Returns the Folder scoped singleton IntelligenceConfig resource.final com.google.api.gax.httpjson.longrunning.OperationsClientReturns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.final ManagedFoldergetManagedFolder(GetManagedFolderRequest request) Returns metadata for the specified managed folder.final ManagedFolderReturns metadata for the specified managed folder.final ManagedFoldergetManagedFolder(String name) Returns metadata for the specified managed folder.final com.google.api.gax.rpc.UnaryCallable<GetManagedFolderRequest,ManagedFolder> Returns metadata for the specified managed folder.final com.google.longrunning.OperationsClientReturns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.final IntelligenceConfigReturns the Organization scoped singleton IntelligenceConfig resource.final IntelligenceConfigReturns the Organization scoped singleton IntelligenceConfig resource.final IntelligenceConfigReturns the Organization scoped singleton IntelligenceConfig resource.final com.google.api.gax.rpc.UnaryCallable<GetOrganizationIntelligenceConfigRequest,IntelligenceConfig> Returns the Organization scoped singleton IntelligenceConfig resource.final IntelligenceConfigReturns the Project scoped singleton IntelligenceConfig resource.final IntelligenceConfigReturns the Project scoped singleton IntelligenceConfig resource.final IntelligenceConfigReturns the Project scoped singleton IntelligenceConfig resource.final com.google.api.gax.rpc.UnaryCallable<GetProjectIntelligenceConfigRequest,IntelligenceConfig> Returns the Project scoped singleton IntelligenceConfig resource.final StorageControlSettingsfinal StorageLayoutgetStorageLayout(GetStorageLayoutRequest request) Returns the storage layout configuration for a given bucket.final StorageLayoutReturns the storage layout configuration for a given bucket.final StorageLayoutgetStorageLayout(String name) Returns the storage layout configuration for a given bucket.final com.google.api.gax.rpc.UnaryCallable<GetStorageLayoutRequest,StorageLayout> Returns the storage layout configuration for a given bucket.getStub()booleanbooleanlistAnywhereCaches(BucketName parent) Lists Anywhere Cache instances for a given bucket.Lists Anywhere Cache instances for a given bucket.listAnywhereCaches(String parent) Lists Anywhere Cache instances for a given bucket.final com.google.api.gax.rpc.UnaryCallable<ListAnywhereCachesRequest,ListAnywhereCachesResponse> Lists Anywhere Cache instances for a given bucket.final com.google.api.gax.rpc.UnaryCallable<ListAnywhereCachesRequest,StorageControlClient.ListAnywhereCachesPagedResponse> Lists Anywhere Cache instances for a given bucket.listFolders(BucketName parent) Retrieves a list of folders.listFolders(ListFoldersRequest request) Retrieves a list of folders.listFolders(String parent) Retrieves a list of folders.final com.google.api.gax.rpc.UnaryCallable<ListFoldersRequest,ListFoldersResponse> Retrieves a list of folders.final com.google.api.gax.rpc.UnaryCallable<ListFoldersRequest,StorageControlClient.ListFoldersPagedResponse> Retrieves a list of folders.listManagedFolders(BucketName parent) Retrieves a list of managed folders for a given bucket.Retrieves a list of managed folders for a given bucket.listManagedFolders(String parent) Retrieves a list of managed folders for a given bucket.final com.google.api.gax.rpc.UnaryCallable<ListManagedFoldersRequest,ListManagedFoldersResponse> Retrieves a list of managed folders for a given bucket.final com.google.api.gax.rpc.UnaryCallable<ListManagedFoldersRequest,StorageControlClient.ListManagedFoldersPagedResponse> Retrieves a list of managed folders for a given bucket.final AnywhereCachePauses an Anywhere Cache instance.final AnywhereCachePauses an Anywhere Cache instance.final AnywhereCachepauseAnywhereCache(String name) Pauses an Anywhere Cache instance.final com.google.api.gax.rpc.UnaryCallable<PauseAnywhereCacheRequest,AnywhereCache> Pauses an Anywhere Cache instance.final com.google.api.gax.longrunning.OperationFuture<Folder,RenameFolderMetadata> renameFolderAsync(FolderName name, String destinationFolderId) Renames a source folder to a destination folder.final com.google.api.gax.longrunning.OperationFuture<Folder,RenameFolderMetadata> renameFolderAsync(RenameFolderRequest request) Renames a source folder to a destination folder.final com.google.api.gax.longrunning.OperationFuture<Folder,RenameFolderMetadata> renameFolderAsync(String name, String destinationFolderId) Renames a source folder to a destination folder.final com.google.api.gax.rpc.UnaryCallable<RenameFolderRequest,com.google.longrunning.Operation> Renames a source folder to a destination folder.final com.google.api.gax.rpc.OperationCallable<RenameFolderRequest,Folder, RenameFolderMetadata> Renames a source folder to a destination folder.final AnywhereCacheResumes a disabled or paused Anywhere Cache instance.final AnywhereCacheResumes a disabled or paused Anywhere Cache instance.final AnywhereCacheresumeAnywhereCache(String name) Resumes a disabled or paused Anywhere Cache instance.final com.google.api.gax.rpc.UnaryCallable<ResumeAnywhereCacheRequest,AnywhereCache> Resumes a disabled or paused Anywhere Cache instance.voidshutdown()voidfinal com.google.api.gax.longrunning.OperationFuture<AnywhereCache,UpdateAnywhereCacheMetadata> updateAnywhereCacheAsync(AnywhereCache anywhereCache, com.google.protobuf.FieldMask updateMask) Updates an Anywhere Cache instance.final com.google.api.gax.longrunning.OperationFuture<AnywhereCache,UpdateAnywhereCacheMetadata> Updates an Anywhere Cache instance.final com.google.api.gax.rpc.UnaryCallable<UpdateAnywhereCacheRequest,com.google.longrunning.Operation> Updates an Anywhere Cache instance.final com.google.api.gax.rpc.OperationCallable<UpdateAnywhereCacheRequest,AnywhereCache, UpdateAnywhereCacheMetadata> Updates an Anywhere Cache instance.final IntelligenceConfigupdateFolderIntelligenceConfig(IntelligenceConfig intelligenceConfig, com.google.protobuf.FieldMask updateMask) Updates the Folder scoped singleton IntelligenceConfig resource.final IntelligenceConfigUpdates the Folder scoped singleton IntelligenceConfig resource.final com.google.api.gax.rpc.UnaryCallable<UpdateFolderIntelligenceConfigRequest,IntelligenceConfig> Updates the Folder scoped singleton IntelligenceConfig resource.final IntelligenceConfigupdateOrganizationIntelligenceConfig(IntelligenceConfig intelligenceConfig, com.google.protobuf.FieldMask updateMask) Updates the Organization scoped singleton IntelligenceConfig resource.final IntelligenceConfigUpdates the Organization scoped singleton IntelligenceConfig resource.final com.google.api.gax.rpc.UnaryCallable<UpdateOrganizationIntelligenceConfigRequest,IntelligenceConfig> Updates the Organization scoped singleton IntelligenceConfig resource.final IntelligenceConfigupdateProjectIntelligenceConfig(IntelligenceConfig intelligenceConfig, com.google.protobuf.FieldMask updateMask) Updates the Project scoped singleton IntelligenceConfig resource.final IntelligenceConfigUpdates the Project scoped singleton IntelligenceConfig resource.final com.google.api.gax.rpc.UnaryCallable<UpdateProjectIntelligenceConfigRequest,IntelligenceConfig> Updates the Project scoped singleton IntelligenceConfig resource.
-
Constructor Details
-
StorageControlClient
Constructs an instance of StorageControlClient, 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
-
StorageControlClient
-
-
Method Details
-
create
Constructs an instance of StorageControlClient with default settings.- Throws:
IOException
-
create
Constructs an instance of StorageControlClient, 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
Constructs an instance of StorageControlClient, using the given stub for making calls. This is for advanced usage - prefer using create(StorageControlSettings). -
getSettings
-
getStub
-
getOperationsClient
public final com.google.longrunning.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 com.google.api.gax.httpjson.longrunning.OperationsClient getHttpJsonOperationsClient()Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call. -
createFolder
Creates a new folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { BucketName parent = BucketName.of("[PROJECT]", "[BUCKET]"); Folder folder = Folder.newBuilder().build(); String folderId = "folderId294109737"; Folder response = storageControlClient.createFolder(parent, folder, folderId); }- Parameters:
parent- Required. Name of the bucket in which the folder will reside. The bucket must be a hierarchical namespace enabled bucket.folder- Required. Properties of the new folder being created. The bucket and name of the folder are specified in the parent and folder_id fields, respectively. Populating those fields in `folder` will result in an error.folderId- Required. The full name of a folder, including all its parent folders. Folders use single '/' characters as a delimiter. The folder_id must end with a slash. For example, the folder_id of "books/biographies/" would create a new "biographies/" folder under the "books/" folder.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
createFolder
Creates a new folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String parent = BucketName.of("[PROJECT]", "[BUCKET]").toString(); Folder folder = Folder.newBuilder().build(); String folderId = "folderId294109737"; Folder response = storageControlClient.createFolder(parent, folder, folderId); }- Parameters:
parent- Required. Name of the bucket in which the folder will reside. The bucket must be a hierarchical namespace enabled bucket.folder- Required. Properties of the new folder being created. The bucket and name of the folder are specified in the parent and folder_id fields, respectively. Populating those fields in `folder` will result in an error.folderId- Required. The full name of a folder, including all its parent folders. Folders use single '/' characters as a delimiter. The folder_id must end with a slash. For example, the folder_id of "books/biographies/" would create a new "biographies/" folder under the "books/" folder.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
createFolder
Creates a new folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { CreateFolderRequest request = CreateFolderRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setFolder(Folder.newBuilder().build()) .setFolderId("folderId294109737") .setRecursive(true) .setRequestId("requestId693933066") .build(); Folder response = storageControlClient.createFolder(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
createFolderCallable
public final com.google.api.gax.rpc.UnaryCallable<CreateFolderRequest,Folder> createFolderCallable()Creates a new folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { CreateFolderRequest request = CreateFolderRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setFolder(Folder.newBuilder().build()) .setFolderId("folderId294109737") .setRecursive(true) .setRequestId("requestId693933066") .build(); ApiFuture<Folder> future = storageControlClient.createFolderCallable().futureCall(request); // Do something. Folder response = future.get(); } -
deleteFolder
Permanently deletes an empty folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { FolderName name = FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]"); storageControlClient.deleteFolder(name); }- Parameters:
name- Required. Name of the folder. Format: `projects/{project}/buckets/{bucket}/folders/{folder}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
deleteFolder
Permanently deletes an empty folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]").toString(); storageControlClient.deleteFolder(name); }- Parameters:
name- Required. Name of the folder. Format: `projects/{project}/buckets/{bucket}/folders/{folder}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
deleteFolder
Permanently deletes an empty folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { DeleteFolderRequest request = DeleteFolderRequest.newBuilder() .setName(FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]").toString()) .setIfMetagenerationMatch(1043427781) .setIfMetagenerationNotMatch(1025430873) .setRequestId("requestId693933066") .build(); storageControlClient.deleteFolder(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
deleteFolderCallable
public final com.google.api.gax.rpc.UnaryCallable<DeleteFolderRequest,com.google.protobuf.Empty> deleteFolderCallable()Permanently deletes an empty folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { DeleteFolderRequest request = DeleteFolderRequest.newBuilder() .setName(FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]").toString()) .setIfMetagenerationMatch(1043427781) .setIfMetagenerationNotMatch(1025430873) .setRequestId("requestId693933066") .build(); ApiFuture<Empty> future = storageControlClient.deleteFolderCallable().futureCall(request); // Do something. future.get(); } -
getFolder
Returns metadata for the specified folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { FolderName name = FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]"); Folder response = storageControlClient.getFolder(name); }- Parameters:
name- Required. Name of the folder. Format: `projects/{project}/buckets/{bucket}/folders/{folder}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getFolder
Returns metadata for the specified folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]").toString(); Folder response = storageControlClient.getFolder(name); }- Parameters:
name- Required. Name of the folder. Format: `projects/{project}/buckets/{bucket}/folders/{folder}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getFolder
Returns metadata for the specified folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetFolderRequest request = GetFolderRequest.newBuilder() .setName(FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]").toString()) .setIfMetagenerationMatch(1043427781) .setIfMetagenerationNotMatch(1025430873) .setRequestId("requestId693933066") .build(); Folder response = storageControlClient.getFolder(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getFolderCallable
Returns metadata for the specified folder. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetFolderRequest request = GetFolderRequest.newBuilder() .setName(FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]").toString()) .setIfMetagenerationMatch(1043427781) .setIfMetagenerationNotMatch(1025430873) .setRequestId("requestId693933066") .build(); ApiFuture<Folder> future = storageControlClient.getFolderCallable().futureCall(request); // Do something. Folder response = future.get(); } -
listFolders
Retrieves a list of folders. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { BucketName parent = BucketName.of("[PROJECT]", "[BUCKET]"); for (Folder element : storageControlClient.listFolders(parent).iterateAll()) { // doThingsWith(element); } }- Parameters:
parent- Required. Name of the bucket in which to look for folders. The bucket must be a hierarchical namespace enabled bucket.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
listFolders
Retrieves a list of folders. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String parent = BucketName.of("[PROJECT]", "[BUCKET]").toString(); for (Folder element : storageControlClient.listFolders(parent).iterateAll()) { // doThingsWith(element); } }- Parameters:
parent- Required. Name of the bucket in which to look for folders. The bucket must be a hierarchical namespace enabled bucket.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
listFolders
Retrieves a list of folders. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ListFoldersRequest request = ListFoldersRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setPageSize(883849137) .setPageToken("pageToken873572522") .setPrefix("prefix-980110702") .setDelimiter("delimiter-250518009") .setLexicographicStart("lexicographicStart-2093413008") .setLexicographicEnd("lexicographicEnd1646968169") .setRequestId("requestId693933066") .build(); for (Folder element : storageControlClient.listFolders(request).iterateAll()) { // doThingsWith(element); } }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
listFoldersPagedCallable
public final com.google.api.gax.rpc.UnaryCallable<ListFoldersRequest,StorageControlClient.ListFoldersPagedResponse> listFoldersPagedCallable()Retrieves a list of folders. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ListFoldersRequest request = ListFoldersRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setPageSize(883849137) .setPageToken("pageToken873572522") .setPrefix("prefix-980110702") .setDelimiter("delimiter-250518009") .setLexicographicStart("lexicographicStart-2093413008") .setLexicographicEnd("lexicographicEnd1646968169") .setRequestId("requestId693933066") .build(); ApiFuture<Folder> future = storageControlClient.listFoldersPagedCallable().futureCall(request); // Do something. for (Folder element : future.get().iterateAll()) { // doThingsWith(element); } } -
listFoldersCallable
public final com.google.api.gax.rpc.UnaryCallable<ListFoldersRequest,ListFoldersResponse> listFoldersCallable()Retrieves a list of folders. This operation is only applicable to a hierarchical namespace enabled bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ListFoldersRequest request = ListFoldersRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setPageSize(883849137) .setPageToken("pageToken873572522") .setPrefix("prefix-980110702") .setDelimiter("delimiter-250518009") .setLexicographicStart("lexicographicStart-2093413008") .setLexicographicEnd("lexicographicEnd1646968169") .setRequestId("requestId693933066") .build(); while (true) { ListFoldersResponse response = storageControlClient.listFoldersCallable().call(request); for (Folder element : response.getFoldersList()) { // doThingsWith(element); } String nextPageToken = response.getNextPageToken(); if (!Strings.isNullOrEmpty(nextPageToken)) { request = request.toBuilder().setPageToken(nextPageToken).build(); } else { break; } } } -
renameFolderAsync
public final com.google.api.gax.longrunning.OperationFuture<Folder,RenameFolderMetadata> renameFolderAsync(FolderName name, String destinationFolderId) Renames a source folder to a destination folder. This operation is only applicable to a hierarchical namespace enabled bucket. During a rename, the source and destination folders are locked until the long running operation completes.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { FolderName name = FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]"); String destinationFolderId = "destinationFolderId-480084905"; Folder response = storageControlClient.renameFolderAsync(name, destinationFolderId).get(); }- Parameters:
name- Required. Name of the source folder being renamed. Format: `projects/{project}/buckets/{bucket}/folders/{folder}`destinationFolderId- Required. The destination folder ID, e.g. `foo/bar/`.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
renameFolderAsync
public final com.google.api.gax.longrunning.OperationFuture<Folder,RenameFolderMetadata> renameFolderAsync(String name, String destinationFolderId) Renames a source folder to a destination folder. This operation is only applicable to a hierarchical namespace enabled bucket. During a rename, the source and destination folders are locked until the long running operation completes.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]").toString(); String destinationFolderId = "destinationFolderId-480084905"; Folder response = storageControlClient.renameFolderAsync(name, destinationFolderId).get(); }- Parameters:
name- Required. Name of the source folder being renamed. Format: `projects/{project}/buckets/{bucket}/folders/{folder}`destinationFolderId- Required. The destination folder ID, e.g. `foo/bar/`.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
renameFolderAsync
public final com.google.api.gax.longrunning.OperationFuture<Folder,RenameFolderMetadata> renameFolderAsync(RenameFolderRequest request) Renames a source folder to a destination folder. This operation is only applicable to a hierarchical namespace enabled bucket. During a rename, the source and destination folders are locked until the long running operation completes.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { RenameFolderRequest request = RenameFolderRequest.newBuilder() .setName(FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]").toString()) .setDestinationFolderId("destinationFolderId-480084905") .setIfMetagenerationMatch(1043427781) .setIfMetagenerationNotMatch(1025430873) .setRequestId("requestId693933066") .build(); Folder response = storageControlClient.renameFolderAsync(request).get(); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
renameFolderOperationCallable
public final com.google.api.gax.rpc.OperationCallable<RenameFolderRequest,Folder, renameFolderOperationCallable()RenameFolderMetadata> Renames a source folder to a destination folder. This operation is only applicable to a hierarchical namespace enabled bucket. During a rename, the source and destination folders are locked until the long running operation completes.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { RenameFolderRequest request = RenameFolderRequest.newBuilder() .setName(FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]").toString()) .setDestinationFolderId("destinationFolderId-480084905") .setIfMetagenerationMatch(1043427781) .setIfMetagenerationNotMatch(1025430873) .setRequestId("requestId693933066") .build(); OperationFuture<Folder, RenameFolderMetadata> future = storageControlClient.renameFolderOperationCallable().futureCall(request); // Do something. Folder response = future.get(); } -
renameFolderCallable
public final com.google.api.gax.rpc.UnaryCallable<RenameFolderRequest,com.google.longrunning.Operation> renameFolderCallable()Renames a source folder to a destination folder. This operation is only applicable to a hierarchical namespace enabled bucket. During a rename, the source and destination folders are locked until the long running operation completes.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { RenameFolderRequest request = RenameFolderRequest.newBuilder() .setName(FolderName.of("[PROJECT]", "[BUCKET]", "[FOLDER]").toString()) .setDestinationFolderId("destinationFolderId-480084905") .setIfMetagenerationMatch(1043427781) .setIfMetagenerationNotMatch(1025430873) .setRequestId("requestId693933066") .build(); ApiFuture<Operation> future = storageControlClient.renameFolderCallable().futureCall(request); // Do something. Operation response = future.get(); } -
getStorageLayout
Returns the storage layout configuration for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { StorageLayoutName name = StorageLayoutName.of("[PROJECT]", "[BUCKET]"); StorageLayout response = storageControlClient.getStorageLayout(name); }- Parameters:
name- Required. The name of the StorageLayout resource. Format: `projects/{project}/buckets/{bucket}/storageLayout`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getStorageLayout
Returns the storage layout configuration for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = StorageLayoutName.of("[PROJECT]", "[BUCKET]").toString(); StorageLayout response = storageControlClient.getStorageLayout(name); }- Parameters:
name- Required. The name of the StorageLayout resource. Format: `projects/{project}/buckets/{bucket}/storageLayout`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getStorageLayout
Returns the storage layout configuration for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetStorageLayoutRequest request = GetStorageLayoutRequest.newBuilder() .setName(StorageLayoutName.of("[PROJECT]", "[BUCKET]").toString()) .setPrefix("prefix-980110702") .setRequestId("requestId693933066") .build(); StorageLayout response = storageControlClient.getStorageLayout(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getStorageLayoutCallable
public final com.google.api.gax.rpc.UnaryCallable<GetStorageLayoutRequest,StorageLayout> getStorageLayoutCallable()Returns the storage layout configuration for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetStorageLayoutRequest request = GetStorageLayoutRequest.newBuilder() .setName(StorageLayoutName.of("[PROJECT]", "[BUCKET]").toString()) .setPrefix("prefix-980110702") .setRequestId("requestId693933066") .build(); ApiFuture<StorageLayout> future = storageControlClient.getStorageLayoutCallable().futureCall(request); // Do something. StorageLayout response = future.get(); } -
createManagedFolder
public final ManagedFolder createManagedFolder(BucketName parent, ManagedFolder managedFolder, String managedFolderId) Creates a new managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { BucketName parent = BucketName.of("[PROJECT]", "[BUCKET]"); ManagedFolder managedFolder = ManagedFolder.newBuilder().build(); String managedFolderId = "managedFolderId-2027084056"; ManagedFolder response = storageControlClient.createManagedFolder(parent, managedFolder, managedFolderId); }- Parameters:
parent- Required. Name of the bucket this managed folder belongs to.managedFolder- Required. Properties of the managed folder being created. The bucket and managed folder names are specified in the `parent` and `managed_folder_id` fields. Populating these fields in `managed_folder` will result in an error.managedFolderId- Required. The name of the managed folder. It uses a single `/` as delimiter and leading and trailing `/` are allowed.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
createManagedFolder
public final ManagedFolder createManagedFolder(String parent, ManagedFolder managedFolder, String managedFolderId) Creates a new managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String parent = BucketName.of("[PROJECT]", "[BUCKET]").toString(); ManagedFolder managedFolder = ManagedFolder.newBuilder().build(); String managedFolderId = "managedFolderId-2027084056"; ManagedFolder response = storageControlClient.createManagedFolder(parent, managedFolder, managedFolderId); }- Parameters:
parent- Required. Name of the bucket this managed folder belongs to.managedFolder- Required. Properties of the managed folder being created. The bucket and managed folder names are specified in the `parent` and `managed_folder_id` fields. Populating these fields in `managed_folder` will result in an error.managedFolderId- Required. The name of the managed folder. It uses a single `/` as delimiter and leading and trailing `/` are allowed.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
createManagedFolder
Creates a new managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { CreateManagedFolderRequest request = CreateManagedFolderRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setManagedFolder(ManagedFolder.newBuilder().build()) .setManagedFolderId("managedFolderId-2027084056") .setRequestId("requestId693933066") .build(); ManagedFolder response = storageControlClient.createManagedFolder(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
createManagedFolderCallable
public final com.google.api.gax.rpc.UnaryCallable<CreateManagedFolderRequest,ManagedFolder> createManagedFolderCallable()Creates a new managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { CreateManagedFolderRequest request = CreateManagedFolderRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setManagedFolder(ManagedFolder.newBuilder().build()) .setManagedFolderId("managedFolderId-2027084056") .setRequestId("requestId693933066") .build(); ApiFuture<ManagedFolder> future = storageControlClient.createManagedFolderCallable().futureCall(request); // Do something. ManagedFolder response = future.get(); } -
deleteManagedFolder
Permanently deletes an empty managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ManagedFolderName name = ManagedFolderName.of("[PROJECT]", "[BUCKET]", "[MANAGED_FOLDER]"); storageControlClient.deleteManagedFolder(name); }- Parameters:
name- Required. Name of the managed folder. Format: `projects/{project}/buckets/{bucket}/managedFolders/{managedFolder}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
deleteManagedFolder
Permanently deletes an empty managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = ManagedFolderName.of("[PROJECT]", "[BUCKET]", "[MANAGED_FOLDER]").toString(); storageControlClient.deleteManagedFolder(name); }- Parameters:
name- Required. Name of the managed folder. Format: `projects/{project}/buckets/{bucket}/managedFolders/{managedFolder}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
deleteManagedFolder
Permanently deletes an empty managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { DeleteManagedFolderRequest request = DeleteManagedFolderRequest.newBuilder() .setName(ManagedFolderName.of("[PROJECT]", "[BUCKET]", "[MANAGED_FOLDER]").toString()) .setIfMetagenerationMatch(1043427781) .setIfMetagenerationNotMatch(1025430873) .setAllowNonEmpty(true) .setRequestId("requestId693933066") .build(); storageControlClient.deleteManagedFolder(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
deleteManagedFolderCallable
public final com.google.api.gax.rpc.UnaryCallable<DeleteManagedFolderRequest,com.google.protobuf.Empty> deleteManagedFolderCallable()Permanently deletes an empty managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { DeleteManagedFolderRequest request = DeleteManagedFolderRequest.newBuilder() .setName(ManagedFolderName.of("[PROJECT]", "[BUCKET]", "[MANAGED_FOLDER]").toString()) .setIfMetagenerationMatch(1043427781) .setIfMetagenerationNotMatch(1025430873) .setAllowNonEmpty(true) .setRequestId("requestId693933066") .build(); ApiFuture<Empty> future = storageControlClient.deleteManagedFolderCallable().futureCall(request); // Do something. future.get(); } -
getManagedFolder
Returns metadata for the specified managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ManagedFolderName name = ManagedFolderName.of("[PROJECT]", "[BUCKET]", "[MANAGED_FOLDER]"); ManagedFolder response = storageControlClient.getManagedFolder(name); }- Parameters:
name- Required. Name of the managed folder. Format: `projects/{project}/buckets/{bucket}/managedFolders/{managedFolder}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getManagedFolder
Returns metadata for the specified managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = ManagedFolderName.of("[PROJECT]", "[BUCKET]", "[MANAGED_FOLDER]").toString(); ManagedFolder response = storageControlClient.getManagedFolder(name); }- Parameters:
name- Required. Name of the managed folder. Format: `projects/{project}/buckets/{bucket}/managedFolders/{managedFolder}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getManagedFolder
Returns metadata for the specified managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetManagedFolderRequest request = GetManagedFolderRequest.newBuilder() .setName(ManagedFolderName.of("[PROJECT]", "[BUCKET]", "[MANAGED_FOLDER]").toString()) .setIfMetagenerationMatch(1043427781) .setIfMetagenerationNotMatch(1025430873) .setRequestId("requestId693933066") .build(); ManagedFolder response = storageControlClient.getManagedFolder(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getManagedFolderCallable
public final com.google.api.gax.rpc.UnaryCallable<GetManagedFolderRequest,ManagedFolder> getManagedFolderCallable()Returns metadata for the specified managed folder.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetManagedFolderRequest request = GetManagedFolderRequest.newBuilder() .setName(ManagedFolderName.of("[PROJECT]", "[BUCKET]", "[MANAGED_FOLDER]").toString()) .setIfMetagenerationMatch(1043427781) .setIfMetagenerationNotMatch(1025430873) .setRequestId("requestId693933066") .build(); ApiFuture<ManagedFolder> future = storageControlClient.getManagedFolderCallable().futureCall(request); // Do something. ManagedFolder response = future.get(); } -
listManagedFolders
public final StorageControlClient.ListManagedFoldersPagedResponse listManagedFolders(BucketName parent) Retrieves a list of managed folders for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { BucketName parent = BucketName.of("[PROJECT]", "[BUCKET]"); for (ManagedFolder element : storageControlClient.listManagedFolders(parent).iterateAll()) { // doThingsWith(element); } }- Parameters:
parent- Required. Name of the bucket this managed folder belongs to.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
listManagedFolders
Retrieves a list of managed folders for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String parent = BucketName.of("[PROJECT]", "[BUCKET]").toString(); for (ManagedFolder element : storageControlClient.listManagedFolders(parent).iterateAll()) { // doThingsWith(element); } }- Parameters:
parent- Required. Name of the bucket this managed folder belongs to.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
listManagedFolders
public final StorageControlClient.ListManagedFoldersPagedResponse listManagedFolders(ListManagedFoldersRequest request) Retrieves a list of managed folders for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ListManagedFoldersRequest request = ListManagedFoldersRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setPageSize(883849137) .setPageToken("pageToken873572522") .setPrefix("prefix-980110702") .setRequestId("requestId693933066") .build(); for (ManagedFolder element : storageControlClient.listManagedFolders(request).iterateAll()) { // doThingsWith(element); } }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
listManagedFoldersPagedCallable
public final com.google.api.gax.rpc.UnaryCallable<ListManagedFoldersRequest,StorageControlClient.ListManagedFoldersPagedResponse> listManagedFoldersPagedCallable()Retrieves a list of managed folders for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ListManagedFoldersRequest request = ListManagedFoldersRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setPageSize(883849137) .setPageToken("pageToken873572522") .setPrefix("prefix-980110702") .setRequestId("requestId693933066") .build(); ApiFuture<ManagedFolder> future = storageControlClient.listManagedFoldersPagedCallable().futureCall(request); // Do something. for (ManagedFolder element : future.get().iterateAll()) { // doThingsWith(element); } } -
listManagedFoldersCallable
public final com.google.api.gax.rpc.UnaryCallable<ListManagedFoldersRequest,ListManagedFoldersResponse> listManagedFoldersCallable()Retrieves a list of managed folders for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ListManagedFoldersRequest request = ListManagedFoldersRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setPageSize(883849137) .setPageToken("pageToken873572522") .setPrefix("prefix-980110702") .setRequestId("requestId693933066") .build(); while (true) { ListManagedFoldersResponse response = storageControlClient.listManagedFoldersCallable().call(request); for (ManagedFolder element : response.getManagedFoldersList()) { // doThingsWith(element); } String nextPageToken = response.getNextPageToken(); if (!Strings.isNullOrEmpty(nextPageToken)) { request = request.toBuilder().setPageToken(nextPageToken).build(); } else { break; } } } -
createAnywhereCacheAsync
public final com.google.api.gax.longrunning.OperationFuture<AnywhereCache,CreateAnywhereCacheMetadata> createAnywhereCacheAsync(BucketName parent, AnywhereCache anywhereCache) Creates an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { BucketName parent = BucketName.of("[PROJECT]", "[BUCKET]"); AnywhereCache anywhereCache = AnywhereCache.newBuilder().build(); AnywhereCache response = storageControlClient.createAnywhereCacheAsync(parent, anywhereCache).get(); }- Parameters:
parent- Required. The bucket to which this cache belongs. Format: `projects/{project}/buckets/{bucket}`anywhereCache- Required. Properties of the Anywhere Cache instance being created. The parent bucket name is specified in the `parent` field. Server uses the default value of `ttl` or `admission_policy` if not specified in request.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
createAnywhereCacheAsync
public final com.google.api.gax.longrunning.OperationFuture<AnywhereCache,CreateAnywhereCacheMetadata> createAnywhereCacheAsync(String parent, AnywhereCache anywhereCache) Creates an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String parent = BucketName.of("[PROJECT]", "[BUCKET]").toString(); AnywhereCache anywhereCache = AnywhereCache.newBuilder().build(); AnywhereCache response = storageControlClient.createAnywhereCacheAsync(parent, anywhereCache).get(); }- Parameters:
parent- Required. The bucket to which this cache belongs. Format: `projects/{project}/buckets/{bucket}`anywhereCache- Required. Properties of the Anywhere Cache instance being created. The parent bucket name is specified in the `parent` field. Server uses the default value of `ttl` or `admission_policy` if not specified in request.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
createAnywhereCacheAsync
public final com.google.api.gax.longrunning.OperationFuture<AnywhereCache,CreateAnywhereCacheMetadata> createAnywhereCacheAsync(CreateAnywhereCacheRequest request) Creates an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { CreateAnywhereCacheRequest request = CreateAnywhereCacheRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setAnywhereCache(AnywhereCache.newBuilder().build()) .setRequestId("requestId693933066") .build(); AnywhereCache response = storageControlClient.createAnywhereCacheAsync(request).get(); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
createAnywhereCacheOperationCallable
public final com.google.api.gax.rpc.OperationCallable<CreateAnywhereCacheRequest,AnywhereCache, createAnywhereCacheOperationCallable()CreateAnywhereCacheMetadata> Creates an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { CreateAnywhereCacheRequest request = CreateAnywhereCacheRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setAnywhereCache(AnywhereCache.newBuilder().build()) .setRequestId("requestId693933066") .build(); OperationFuture<AnywhereCache, CreateAnywhereCacheMetadata> future = storageControlClient.createAnywhereCacheOperationCallable().futureCall(request); // Do something. AnywhereCache response = future.get(); } -
createAnywhereCacheCallable
public final com.google.api.gax.rpc.UnaryCallable<CreateAnywhereCacheRequest,com.google.longrunning.Operation> createAnywhereCacheCallable()Creates an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { CreateAnywhereCacheRequest request = CreateAnywhereCacheRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setAnywhereCache(AnywhereCache.newBuilder().build()) .setRequestId("requestId693933066") .build(); ApiFuture<Operation> future = storageControlClient.createAnywhereCacheCallable().futureCall(request); // Do something. Operation response = future.get(); } -
updateAnywhereCacheAsync
public final com.google.api.gax.longrunning.OperationFuture<AnywhereCache,UpdateAnywhereCacheMetadata> updateAnywhereCacheAsync(AnywhereCache anywhereCache, com.google.protobuf.FieldMask updateMask) Updates an Anywhere Cache instance. Mutable fields include `ttl` and `admission_policy`.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { AnywhereCache anywhereCache = AnywhereCache.newBuilder().build(); FieldMask updateMask = FieldMask.newBuilder().build(); AnywhereCache response = storageControlClient.updateAnywhereCacheAsync(anywhereCache, updateMask).get(); }- Parameters:
anywhereCache- Required. The Anywhere Cache instance to be updated.updateMask- Required. List of fields to be updated. Mutable fields of AnywhereCache include `ttl` and `admission_policy`.To specify ALL fields, specify a single field with the value `*`. Note: We recommend against doing this. If a new field is introduced at a later time, an older client updating with the `*` may accidentally reset the new field's value.
Not specifying any fields is an error.
- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
updateAnywhereCacheAsync
public final com.google.api.gax.longrunning.OperationFuture<AnywhereCache,UpdateAnywhereCacheMetadata> updateAnywhereCacheAsync(UpdateAnywhereCacheRequest request) Updates an Anywhere Cache instance. Mutable fields include `ttl` and `admission_policy`.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { UpdateAnywhereCacheRequest request = UpdateAnywhereCacheRequest.newBuilder() .setAnywhereCache(AnywhereCache.newBuilder().build()) .setUpdateMask(FieldMask.newBuilder().build()) .setRequestId("requestId693933066") .build(); AnywhereCache response = storageControlClient.updateAnywhereCacheAsync(request).get(); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
updateAnywhereCacheOperationCallable
public final com.google.api.gax.rpc.OperationCallable<UpdateAnywhereCacheRequest,AnywhereCache, updateAnywhereCacheOperationCallable()UpdateAnywhereCacheMetadata> Updates an Anywhere Cache instance. Mutable fields include `ttl` and `admission_policy`.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { UpdateAnywhereCacheRequest request = UpdateAnywhereCacheRequest.newBuilder() .setAnywhereCache(AnywhereCache.newBuilder().build()) .setUpdateMask(FieldMask.newBuilder().build()) .setRequestId("requestId693933066") .build(); OperationFuture<AnywhereCache, UpdateAnywhereCacheMetadata> future = storageControlClient.updateAnywhereCacheOperationCallable().futureCall(request); // Do something. AnywhereCache response = future.get(); } -
updateAnywhereCacheCallable
public final com.google.api.gax.rpc.UnaryCallable<UpdateAnywhereCacheRequest,com.google.longrunning.Operation> updateAnywhereCacheCallable()Updates an Anywhere Cache instance. Mutable fields include `ttl` and `admission_policy`.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { UpdateAnywhereCacheRequest request = UpdateAnywhereCacheRequest.newBuilder() .setAnywhereCache(AnywhereCache.newBuilder().build()) .setUpdateMask(FieldMask.newBuilder().build()) .setRequestId("requestId693933066") .build(); ApiFuture<Operation> future = storageControlClient.updateAnywhereCacheCallable().futureCall(request); // Do something. Operation response = future.get(); } -
disableAnywhereCache
Disables an Anywhere Cache instance. A disabled instance is read-only. The disablement could be revoked by calling ResumeAnywhereCache. The cache instance will be deleted automatically if it remains in the disabled state for at least one hour.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { AnywhereCacheName name = AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]"); AnywhereCache response = storageControlClient.disableAnywhereCache(name); }- Parameters:
name- Required. The name field in the request should be: `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
disableAnywhereCache
Disables an Anywhere Cache instance. A disabled instance is read-only. The disablement could be revoked by calling ResumeAnywhereCache. The cache instance will be deleted automatically if it remains in the disabled state for at least one hour.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString(); AnywhereCache response = storageControlClient.disableAnywhereCache(name); }- Parameters:
name- Required. The name field in the request should be: `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
disableAnywhereCache
Disables an Anywhere Cache instance. A disabled instance is read-only. The disablement could be revoked by calling ResumeAnywhereCache. The cache instance will be deleted automatically if it remains in the disabled state for at least one hour.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { DisableAnywhereCacheRequest request = DisableAnywhereCacheRequest.newBuilder() .setName(AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString()) .setRequestId("requestId693933066") .build(); AnywhereCache response = storageControlClient.disableAnywhereCache(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
disableAnywhereCacheCallable
public final com.google.api.gax.rpc.UnaryCallable<DisableAnywhereCacheRequest,AnywhereCache> disableAnywhereCacheCallable()Disables an Anywhere Cache instance. A disabled instance is read-only. The disablement could be revoked by calling ResumeAnywhereCache. The cache instance will be deleted automatically if it remains in the disabled state for at least one hour.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { DisableAnywhereCacheRequest request = DisableAnywhereCacheRequest.newBuilder() .setName(AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString()) .setRequestId("requestId693933066") .build(); ApiFuture<AnywhereCache> future = storageControlClient.disableAnywhereCacheCallable().futureCall(request); // Do something. AnywhereCache response = future.get(); } -
pauseAnywhereCache
Pauses an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { AnywhereCacheName name = AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]"); AnywhereCache response = storageControlClient.pauseAnywhereCache(name); }- Parameters:
name- Required. The name field in the request should be: `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
pauseAnywhereCache
Pauses an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString(); AnywhereCache response = storageControlClient.pauseAnywhereCache(name); }- Parameters:
name- Required. The name field in the request should be: `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
pauseAnywhereCache
Pauses an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { PauseAnywhereCacheRequest request = PauseAnywhereCacheRequest.newBuilder() .setName(AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString()) .setRequestId("requestId693933066") .build(); AnywhereCache response = storageControlClient.pauseAnywhereCache(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
pauseAnywhereCacheCallable
public final com.google.api.gax.rpc.UnaryCallable<PauseAnywhereCacheRequest,AnywhereCache> pauseAnywhereCacheCallable()Pauses an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { PauseAnywhereCacheRequest request = PauseAnywhereCacheRequest.newBuilder() .setName(AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString()) .setRequestId("requestId693933066") .build(); ApiFuture<AnywhereCache> future = storageControlClient.pauseAnywhereCacheCallable().futureCall(request); // Do something. AnywhereCache response = future.get(); } -
resumeAnywhereCache
Resumes a disabled or paused Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { AnywhereCacheName name = AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]"); AnywhereCache response = storageControlClient.resumeAnywhereCache(name); }- Parameters:
name- Required. The name field in the request should be: `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
resumeAnywhereCache
Resumes a disabled or paused Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString(); AnywhereCache response = storageControlClient.resumeAnywhereCache(name); }- Parameters:
name- Required. The name field in the request should be: `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
resumeAnywhereCache
Resumes a disabled or paused Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ResumeAnywhereCacheRequest request = ResumeAnywhereCacheRequest.newBuilder() .setName(AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString()) .setRequestId("requestId693933066") .build(); AnywhereCache response = storageControlClient.resumeAnywhereCache(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
resumeAnywhereCacheCallable
public final com.google.api.gax.rpc.UnaryCallable<ResumeAnywhereCacheRequest,AnywhereCache> resumeAnywhereCacheCallable()Resumes a disabled or paused Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ResumeAnywhereCacheRequest request = ResumeAnywhereCacheRequest.newBuilder() .setName(AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString()) .setRequestId("requestId693933066") .build(); ApiFuture<AnywhereCache> future = storageControlClient.resumeAnywhereCacheCallable().futureCall(request); // Do something. AnywhereCache response = future.get(); } -
getAnywhereCache
Gets an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { AnywhereCacheName name = AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]"); AnywhereCache response = storageControlClient.getAnywhereCache(name); }- Parameters:
name- Required. The name field in the request should be: `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getAnywhereCache
Gets an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString(); AnywhereCache response = storageControlClient.getAnywhereCache(name); }- Parameters:
name- Required. The name field in the request should be: `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getAnywhereCache
Gets an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetAnywhereCacheRequest request = GetAnywhereCacheRequest.newBuilder() .setName(AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString()) .setRequestId("requestId693933066") .build(); AnywhereCache response = storageControlClient.getAnywhereCache(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getAnywhereCacheCallable
public final com.google.api.gax.rpc.UnaryCallable<GetAnywhereCacheRequest,AnywhereCache> getAnywhereCacheCallable()Gets an Anywhere Cache 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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetAnywhereCacheRequest request = GetAnywhereCacheRequest.newBuilder() .setName(AnywhereCacheName.of("[PROJECT]", "[BUCKET]", "[ANYWHERE_CACHE]").toString()) .setRequestId("requestId693933066") .build(); ApiFuture<AnywhereCache> future = storageControlClient.getAnywhereCacheCallable().futureCall(request); // Do something. AnywhereCache response = future.get(); } -
listAnywhereCaches
public final StorageControlClient.ListAnywhereCachesPagedResponse listAnywhereCaches(BucketName parent) Lists Anywhere Cache instances for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { BucketName parent = BucketName.of("[PROJECT]", "[BUCKET]"); for (AnywhereCache element : storageControlClient.listAnywhereCaches(parent).iterateAll()) { // doThingsWith(element); } }- Parameters:
parent- Required. The bucket to which this cache belongs.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
listAnywhereCaches
Lists Anywhere Cache instances for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String parent = BucketName.of("[PROJECT]", "[BUCKET]").toString(); for (AnywhereCache element : storageControlClient.listAnywhereCaches(parent).iterateAll()) { // doThingsWith(element); } }- Parameters:
parent- Required. The bucket to which this cache belongs.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
listAnywhereCaches
public final StorageControlClient.ListAnywhereCachesPagedResponse listAnywhereCaches(ListAnywhereCachesRequest request) Lists Anywhere Cache instances for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ListAnywhereCachesRequest request = ListAnywhereCachesRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setPageSize(883849137) .setPageToken("pageToken873572522") .setRequestId("requestId693933066") .build(); for (AnywhereCache element : storageControlClient.listAnywhereCaches(request).iterateAll()) { // doThingsWith(element); } }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
listAnywhereCachesPagedCallable
public final com.google.api.gax.rpc.UnaryCallable<ListAnywhereCachesRequest,StorageControlClient.ListAnywhereCachesPagedResponse> listAnywhereCachesPagedCallable()Lists Anywhere Cache instances for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ListAnywhereCachesRequest request = ListAnywhereCachesRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setPageSize(883849137) .setPageToken("pageToken873572522") .setRequestId("requestId693933066") .build(); ApiFuture<AnywhereCache> future = storageControlClient.listAnywhereCachesPagedCallable().futureCall(request); // Do something. for (AnywhereCache element : future.get().iterateAll()) { // doThingsWith(element); } } -
listAnywhereCachesCallable
public final com.google.api.gax.rpc.UnaryCallable<ListAnywhereCachesRequest,ListAnywhereCachesResponse> listAnywhereCachesCallable()Lists Anywhere Cache instances for a given bucket.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { ListAnywhereCachesRequest request = ListAnywhereCachesRequest.newBuilder() .setParent(BucketName.of("[PROJECT]", "[BUCKET]").toString()) .setPageSize(883849137) .setPageToken("pageToken873572522") .setRequestId("requestId693933066") .build(); while (true) { ListAnywhereCachesResponse response = storageControlClient.listAnywhereCachesCallable().call(request); for (AnywhereCache element : response.getAnywhereCachesList()) { // doThingsWith(element); } String nextPageToken = response.getNextPageToken(); if (!Strings.isNullOrEmpty(nextPageToken)) { request = request.toBuilder().setPageToken(nextPageToken).build(); } else { break; } } } -
getProjectIntelligenceConfig
Returns the Project scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { IntelligenceConfigName name = IntelligenceConfigName.ofProjectLocationName("[PROJECT]", "[LOCATION]"); IntelligenceConfig response = storageControlClient.getProjectIntelligenceConfig(name); }- Parameters:
name- Required. The name of the `IntelligenceConfig` resource associated with your project.Format: `projects/{id}/locations/global/intelligenceConfig`
- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getProjectIntelligenceConfig
Returns the Project scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = IntelligenceConfigName.ofFolderLocationName("[FOLDER]", "[LOCATION]").toString(); IntelligenceConfig response = storageControlClient.getProjectIntelligenceConfig(name); }- Parameters:
name- Required. The name of the `IntelligenceConfig` resource associated with your project.Format: `projects/{id}/locations/global/intelligenceConfig`
- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getProjectIntelligenceConfig
public final IntelligenceConfig getProjectIntelligenceConfig(GetProjectIntelligenceConfigRequest request) Returns the Project scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetProjectIntelligenceConfigRequest request = GetProjectIntelligenceConfigRequest.newBuilder() .setName( IntelligenceConfigName.ofProjectLocationName("[PROJECT]", "[LOCATION]") .toString()) .build(); IntelligenceConfig response = storageControlClient.getProjectIntelligenceConfig(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getProjectIntelligenceConfigCallable
public final com.google.api.gax.rpc.UnaryCallable<GetProjectIntelligenceConfigRequest,IntelligenceConfig> getProjectIntelligenceConfigCallable()Returns the Project scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetProjectIntelligenceConfigRequest request = GetProjectIntelligenceConfigRequest.newBuilder() .setName( IntelligenceConfigName.ofProjectLocationName("[PROJECT]", "[LOCATION]") .toString()) .build(); ApiFuture<IntelligenceConfig> future = storageControlClient.getProjectIntelligenceConfigCallable().futureCall(request); // Do something. IntelligenceConfig response = future.get(); } -
updateProjectIntelligenceConfig
public final IntelligenceConfig updateProjectIntelligenceConfig(IntelligenceConfig intelligenceConfig, com.google.protobuf.FieldMask updateMask) Updates the Project scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { IntelligenceConfig intelligenceConfig = IntelligenceConfig.newBuilder().build(); FieldMask updateMask = FieldMask.newBuilder().build(); IntelligenceConfig response = storageControlClient.updateProjectIntelligenceConfig(intelligenceConfig, updateMask); }- Parameters:
intelligenceConfig- Required. The `IntelligenceConfig` resource to be updated.updateMask- Required. The `update_mask` that specifies the fields within the `IntelligenceConfig` resource that should be modified by this update. Only the listed fields are updated.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
updateProjectIntelligenceConfig
public final IntelligenceConfig updateProjectIntelligenceConfig(UpdateProjectIntelligenceConfigRequest request) Updates the Project scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { UpdateProjectIntelligenceConfigRequest request = UpdateProjectIntelligenceConfigRequest.newBuilder() .setIntelligenceConfig(IntelligenceConfig.newBuilder().build()) .setUpdateMask(FieldMask.newBuilder().build()) .setRequestId("requestId693933066") .build(); IntelligenceConfig response = storageControlClient.updateProjectIntelligenceConfig(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
updateProjectIntelligenceConfigCallable
public final com.google.api.gax.rpc.UnaryCallable<UpdateProjectIntelligenceConfigRequest,IntelligenceConfig> updateProjectIntelligenceConfigCallable()Updates the Project scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { UpdateProjectIntelligenceConfigRequest request = UpdateProjectIntelligenceConfigRequest.newBuilder() .setIntelligenceConfig(IntelligenceConfig.newBuilder().build()) .setUpdateMask(FieldMask.newBuilder().build()) .setRequestId("requestId693933066") .build(); ApiFuture<IntelligenceConfig> future = storageControlClient.updateProjectIntelligenceConfigCallable().futureCall(request); // Do something. IntelligenceConfig response = future.get(); } -
getFolderIntelligenceConfig
Returns the Folder scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { IntelligenceConfigName name = IntelligenceConfigName.ofFolderLocationName("[FOLDER]", "[LOCATION]"); IntelligenceConfig response = storageControlClient.getFolderIntelligenceConfig(name); }- Parameters:
name- Required. The name of the `IntelligenceConfig` resource associated with your folder.Format: `folders/{id}/locations/global/intelligenceConfig`
- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getFolderIntelligenceConfig
Returns the Folder scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = IntelligenceConfigName.ofFolderLocationName("[FOLDER]", "[LOCATION]").toString(); IntelligenceConfig response = storageControlClient.getFolderIntelligenceConfig(name); }- Parameters:
name- Required. The name of the `IntelligenceConfig` resource associated with your folder.Format: `folders/{id}/locations/global/intelligenceConfig`
- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getFolderIntelligenceConfig
public final IntelligenceConfig getFolderIntelligenceConfig(GetFolderIntelligenceConfigRequest request) Returns the Folder scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetFolderIntelligenceConfigRequest request = GetFolderIntelligenceConfigRequest.newBuilder() .setName( IntelligenceConfigName.ofFolderLocationName("[FOLDER]", "[LOCATION]").toString()) .build(); IntelligenceConfig response = storageControlClient.getFolderIntelligenceConfig(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getFolderIntelligenceConfigCallable
public final com.google.api.gax.rpc.UnaryCallable<GetFolderIntelligenceConfigRequest,IntelligenceConfig> getFolderIntelligenceConfigCallable()Returns the Folder scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetFolderIntelligenceConfigRequest request = GetFolderIntelligenceConfigRequest.newBuilder() .setName( IntelligenceConfigName.ofFolderLocationName("[FOLDER]", "[LOCATION]").toString()) .build(); ApiFuture<IntelligenceConfig> future = storageControlClient.getFolderIntelligenceConfigCallable().futureCall(request); // Do something. IntelligenceConfig response = future.get(); } -
updateFolderIntelligenceConfig
public final IntelligenceConfig updateFolderIntelligenceConfig(IntelligenceConfig intelligenceConfig, com.google.protobuf.FieldMask updateMask) Updates the Folder scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { IntelligenceConfig intelligenceConfig = IntelligenceConfig.newBuilder().build(); FieldMask updateMask = FieldMask.newBuilder().build(); IntelligenceConfig response = storageControlClient.updateFolderIntelligenceConfig(intelligenceConfig, updateMask); }- Parameters:
intelligenceConfig- Required. The `IntelligenceConfig` resource to be updated.updateMask- Required. The `update_mask` that specifies the fields within the `IntelligenceConfig` resource that should be modified by this update. Only the listed fields are updated.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
updateFolderIntelligenceConfig
public final IntelligenceConfig updateFolderIntelligenceConfig(UpdateFolderIntelligenceConfigRequest request) Updates the Folder scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { UpdateFolderIntelligenceConfigRequest request = UpdateFolderIntelligenceConfigRequest.newBuilder() .setIntelligenceConfig(IntelligenceConfig.newBuilder().build()) .setUpdateMask(FieldMask.newBuilder().build()) .setRequestId("requestId693933066") .build(); IntelligenceConfig response = storageControlClient.updateFolderIntelligenceConfig(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
updateFolderIntelligenceConfigCallable
public final com.google.api.gax.rpc.UnaryCallable<UpdateFolderIntelligenceConfigRequest,IntelligenceConfig> updateFolderIntelligenceConfigCallable()Updates the Folder scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { UpdateFolderIntelligenceConfigRequest request = UpdateFolderIntelligenceConfigRequest.newBuilder() .setIntelligenceConfig(IntelligenceConfig.newBuilder().build()) .setUpdateMask(FieldMask.newBuilder().build()) .setRequestId("requestId693933066") .build(); ApiFuture<IntelligenceConfig> future = storageControlClient.updateFolderIntelligenceConfigCallable().futureCall(request); // Do something. IntelligenceConfig response = future.get(); } -
getOrganizationIntelligenceConfig
Returns the Organization scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { IntelligenceConfigName name = IntelligenceConfigName.ofOrgLocationName("[ORG]", "[LOCATION]"); IntelligenceConfig response = storageControlClient.getOrganizationIntelligenceConfig(name); }- Parameters:
name- Required. The name of the `IntelligenceConfig` resource associated with your organization.Format: `organizations/{org_id}/locations/global/intelligenceConfig`
- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getOrganizationIntelligenceConfig
Returns the Organization scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { String name = IntelligenceConfigName.ofFolderLocationName("[FOLDER]", "[LOCATION]").toString(); IntelligenceConfig response = storageControlClient.getOrganizationIntelligenceConfig(name); }- Parameters:
name- Required. The name of the `IntelligenceConfig` resource associated with your organization.Format: `organizations/{org_id}/locations/global/intelligenceConfig`
- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getOrganizationIntelligenceConfig
public final IntelligenceConfig getOrganizationIntelligenceConfig(GetOrganizationIntelligenceConfigRequest request) Returns the Organization scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetOrganizationIntelligenceConfigRequest request = GetOrganizationIntelligenceConfigRequest.newBuilder() .setName(IntelligenceConfigName.ofOrgLocationName("[ORG]", "[LOCATION]").toString()) .build(); IntelligenceConfig response = storageControlClient.getOrganizationIntelligenceConfig(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
getOrganizationIntelligenceConfigCallable
public final com.google.api.gax.rpc.UnaryCallable<GetOrganizationIntelligenceConfigRequest,IntelligenceConfig> getOrganizationIntelligenceConfigCallable()Returns the Organization scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { GetOrganizationIntelligenceConfigRequest request = GetOrganizationIntelligenceConfigRequest.newBuilder() .setName(IntelligenceConfigName.ofOrgLocationName("[ORG]", "[LOCATION]").toString()) .build(); ApiFuture<IntelligenceConfig> future = storageControlClient.getOrganizationIntelligenceConfigCallable().futureCall(request); // Do something. IntelligenceConfig response = future.get(); } -
updateOrganizationIntelligenceConfig
public final IntelligenceConfig updateOrganizationIntelligenceConfig(IntelligenceConfig intelligenceConfig, com.google.protobuf.FieldMask updateMask) Updates the Organization scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { IntelligenceConfig intelligenceConfig = IntelligenceConfig.newBuilder().build(); FieldMask updateMask = FieldMask.newBuilder().build(); IntelligenceConfig response = storageControlClient.updateOrganizationIntelligenceConfig(intelligenceConfig, updateMask); }- Parameters:
intelligenceConfig- Required. The `IntelligenceConfig` resource to be updated.updateMask- Required. The `update_mask` that specifies the fields within the `IntelligenceConfig` resource that should be modified by this update. Only the listed fields are updated.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
updateOrganizationIntelligenceConfig
public final IntelligenceConfig updateOrganizationIntelligenceConfig(UpdateOrganizationIntelligenceConfigRequest request) Updates the Organization scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { UpdateOrganizationIntelligenceConfigRequest request = UpdateOrganizationIntelligenceConfigRequest.newBuilder() .setIntelligenceConfig(IntelligenceConfig.newBuilder().build()) .setUpdateMask(FieldMask.newBuilder().build()) .setRequestId("requestId693933066") .build(); IntelligenceConfig response = storageControlClient.updateOrganizationIntelligenceConfig(request); }- Parameters:
request- The request object containing all of the parameters for the API call.- Throws:
com.google.api.gax.rpc.ApiException- if the remote call fails
-
updateOrganizationIntelligenceConfigCallable
public final com.google.api.gax.rpc.UnaryCallable<UpdateOrganizationIntelligenceConfigRequest,IntelligenceConfig> updateOrganizationIntelligenceConfigCallable()Updates the Organization scoped singleton IntelligenceConfig resource.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 (StorageControlClient storageControlClient = StorageControlClient.create()) { UpdateOrganizationIntelligenceConfigRequest request = UpdateOrganizationIntelligenceConfigRequest.newBuilder() .setIntelligenceConfig(IntelligenceConfig.newBuilder().build()) .setUpdateMask(FieldMask.newBuilder().build()) .setRequestId("requestId693933066") .build(); ApiFuture<IntelligenceConfig> future = storageControlClient.updateOrganizationIntelligenceConfigCallable().futureCall(request); // Do something. IntelligenceConfig response = future.get(); } -
close
public final void close()- Specified by:
closein interfaceAutoCloseable
-
shutdown
public void shutdown()- Specified by:
shutdownin interfacecom.google.api.gax.core.BackgroundResource
-
isShutdown
public boolean isShutdown()- Specified by:
isShutdownin interfacecom.google.api.gax.core.BackgroundResource
-
isTerminated
public boolean isTerminated()- Specified by:
isTerminatedin interfacecom.google.api.gax.core.BackgroundResource
-
shutdownNow
public void shutdownNow()- Specified by:
shutdownNowin interfacecom.google.api.gax.core.BackgroundResource
-
awaitTermination
- Specified by:
awaitTerminationin interfacecom.google.api.gax.core.BackgroundResource- Throws:
InterruptedException
-