Class StorageControlClient (3.10.0-rc)

3.10.0-rc 3.9.0 (latest) 3.8.0 3.7.0 3.6.0 3.5.0 3.4.0 3.3.0 3.2.0 2.48.0-rc 2.47.1 2.46.0 2.45.0 2.44.0 2.43.0 2.42.0 2.41.0 2.40.0 2.39.0 2.38.0 2.37.0 2.36.0 2.35.0 2.34.0 2.33.0 2.32.0 2.31.0 2.30.0 2.29.0 2.28.0 2.27.0 2.26.0 2.25.1 2.24.0 2.23.0 2.22.1 2.21.0

StorageControl service includes selected control plane operations.

Equality

Instances of this class created via copy-construction or copy-assignment always compare equal. Instances created with equal std::shared_ptr<*Connection> objects compare equal. Objects that compare equal share the same underlying resources.

Performance

Creating a new instance of this class is a relatively expensive operation, new objects establish new connections to the service. In contrast, copy-construction, move-construction, and the corresponding assignment operations are relatively efficient as the copies share all underlying resources.

Thread Safety

Concurrent access to different instances of this class, even if they compare equal, is guaranteed to work. Two or more threads operating on the same instance of this class is not guaranteed to work. Since copy-construction and move-construction is a relatively efficient operation, consider using such a copy when using this class from multiple threads.

Constructors

StorageControlClient(StorageControlClient const &)

Copy and move support

Parameter
Name	Description
	StorageControlClient const &

StorageControlClient(StorageControlClient &&)

Copy and move support

Parameter
Name	Description
	StorageControlClient &&

StorageControlClient(std::shared_ptr< StorageControlConnection >, Options)

Parameters
Name	Description
connection	std::shared_ptr< StorageControlConnection >
opts	Options

Operators

operator=(StorageControlClient const &)

Copy and move support

Parameter
Name	Description
	StorageControlClient const &

Returns
Type	Description
StorageControlClient &

operator=(StorageControlClient &&)

Copy and move support

Parameter
Name	Description
	StorageControlClient &&

Returns
Type	Description
StorageControlClient &

Functions

CreateFolder(std::string const &, google::storage::control::v2::Folder const &, std::string const &, Options)

Creates a new folder.

This operation is only applicable to a hierarchical namespace enabled bucket.

Parameters
Name	Description
parent	std::string const & Required. Name of the bucket in which the folder will reside. The bucket must be a hierarchical namespace enabled bucket.
folder	google::storage::control::v2::Folder const & 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.
folder_id	std::string const & 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.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::Folder >	the result of the RPC. The response message type (google.storage.control.v2.Folder) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

CreateFolder(google::storage::control::v2::CreateFolderRequest const &, Options)

Creates a new folder.

This operation is only applicable to a hierarchical namespace enabled bucket.

Parameters
Name	Description
request	google::storage::control::v2::CreateFolderRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.CreateFolderRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::Folder >	the result of the RPC. The response message type (google.storage.control.v2.Folder) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

DeleteFolder(std::string const &, Options)

Permanently deletes an empty folder.

This operation is only applicable to a hierarchical namespace enabled bucket.

Parameters
Name	Description
name	std::string const & Required. Name of the folder. Format: projects/{project}/buckets/{bucket}/folders/{folder}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
Status	a Status object. If the request failed, the status contains the details of the failure.

DeleteFolder(google::storage::control::v2::DeleteFolderRequest const &, Options)

Permanently deletes an empty folder.

This operation is only applicable to a hierarchical namespace enabled bucket.

Parameters
Name	Description
request	google::storage::control::v2::DeleteFolderRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.DeleteFolderRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
Status	a Status object. If the request failed, the status contains the details of the failure.

GetFolder(std::string const &, Options)

Returns metadata for the specified folder.

This operation is only applicable to a hierarchical namespace enabled bucket.

Parameters
Name	Description
name	std::string const & Required. Name of the folder. Format: projects/{project}/buckets/{bucket}/folders/{folder}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::Folder >	the result of the RPC. The response message type (google.storage.control.v2.Folder) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetFolder(google::storage::control::v2::GetFolderRequest const &, Options)

Returns metadata for the specified folder.

This operation is only applicable to a hierarchical namespace enabled bucket.

Parameters
Name	Description
request	google::storage::control::v2::GetFolderRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.GetFolderRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::Folder >	the result of the RPC. The response message type (google.storage.control.v2.Folder) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListFolders(std::string const &, Options)

Retrieves a list of folders.

This operation is only applicable to a hierarchical namespace enabled bucket.

Parameters
Name	Description
parent	std::string const & Required. Name of the bucket in which to look for folders. The bucket must be a hierarchical namespace enabled bucket.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::Folder >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.Folder, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListFolders(google::storage::control::v2::ListFoldersRequest, Options)

Retrieves a list of folders.

This operation is only applicable to a hierarchical namespace enabled bucket.

Parameters
Name	Description
request	google::storage::control::v2::ListFoldersRequest Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.ListFoldersRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::Folder >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.Folder, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

RenameFolder(std::string const &, std::string const &, Options)

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.

Parameters
Name	Description
name	std::string const & Required. Name of the source folder being renamed. Format: projects/{project}/buckets/{bucket}/folders/{folder}
destination_folder_id	std::string const & Required. The destination folder ID, e.g. foo/bar/.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::Folder > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.Folder proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

RenameFolder(NoAwaitTag, std::string const &, std::string const &, Options)

Renames a source folder to a destination folder.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
name	std::string const &
destination_folder_id	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

RenameFolder(google::storage::control::v2::RenameFolderRequest const &, Options)

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.

Parameters
Name	Description
request	google::storage::control::v2::RenameFolderRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.RenameFolderRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::Folder > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.Folder proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

RenameFolder(NoAwaitTag, google::storage::control::v2::RenameFolderRequest const &, Options)

Renames a source folder to a destination folder.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
request	google::storage::control::v2::RenameFolderRequest const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

RenameFolder(google::longrunning::Operation const &, Options)

Renames a source folder to a destination folder.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

Returns
Type	Description
future< StatusOr< google::storage::control::v2::Folder > >

DeleteFolderRecursive(std::string const &, Options)

Deletes a folder recursively.

This operation is only applicable to a hierarchical namespace enabled bucket.

Parameters
Name	Description
name	std::string const & Required. Name of the folder being deleted, however all of its contents will be deleted too. Format: projects/{project}/buckets/{bucket}/folders/{folder}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::DeleteFolderRecursiveMetadata > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.DeleteFolderRecursiveMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteFolderRecursive(NoAwaitTag, std::string const &, Options)

Deletes a folder recursively.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
name	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

DeleteFolderRecursive(google::storage::control::v2::DeleteFolderRecursiveRequest const &, Options)

Deletes a folder recursively.

This operation is only applicable to a hierarchical namespace enabled bucket.

Parameters
Name	Description
request	google::storage::control::v2::DeleteFolderRecursiveRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.DeleteFolderRecursiveRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::DeleteFolderRecursiveMetadata > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.DeleteFolderRecursiveMetadata proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DeleteFolderRecursive(NoAwaitTag, google::storage::control::v2::DeleteFolderRecursiveRequest const &, Options)

Deletes a folder recursively.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
request	google::storage::control::v2::DeleteFolderRecursiveRequest const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

DeleteFolderRecursive(google::longrunning::Operation const &, Options)

Deletes a folder recursively.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

Returns
Type	Description
future< StatusOr< google::storage::control::v2::DeleteFolderRecursiveMetadata > >

GetStorageLayout(std::string const &, Options)

Returns the storage layout configuration for a given bucket.

Parameters
Name	Description
name	std::string const & Required. The name of the StorageLayout resource. Format: projects/{project}/buckets/{bucket}/storageLayout
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::StorageLayout >	the result of the RPC. The response message type (google.storage.control.v2.StorageLayout) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetStorageLayout(google::storage::control::v2::GetStorageLayoutRequest const &, Options)

Returns the storage layout configuration for a given bucket.

Parameters
Name	Description
request	google::storage::control::v2::GetStorageLayoutRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.GetStorageLayoutRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::StorageLayout >	the result of the RPC. The response message type (google.storage.control.v2.StorageLayout) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

CreateManagedFolder(std::string const &, google::storage::control::v2::ManagedFolder const &, std::string const &, Options)

Creates a new managed folder.

Parameters
Name	Description
parent	std::string const & Required. Name of the bucket this managed folder belongs to.
managed_folder	google::storage::control::v2::ManagedFolder const & 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.
managed_folder_id	std::string const & Required. The name of the managed folder. It uses a single / as delimiter and leading and trailing / are allowed.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::ManagedFolder >	the result of the RPC. The response message type (google.storage.control.v2.ManagedFolder) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

CreateManagedFolder(google::storage::control::v2::CreateManagedFolderRequest const &, Options)

Creates a new managed folder.

Parameters
Name	Description
request	google::storage::control::v2::CreateManagedFolderRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.CreateManagedFolderRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::ManagedFolder >	the result of the RPC. The response message type (google.storage.control.v2.ManagedFolder) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

DeleteManagedFolder(std::string const &, Options)

Permanently deletes an empty managed folder.

Parameters
Name	Description
name	std::string const & Required. Name of the managed folder. Format: projects/{project}/buckets/{bucket}/managedFolders/{managedFolder}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
Status	a Status object. If the request failed, the status contains the details of the failure.

DeleteManagedFolder(google::storage::control::v2::DeleteManagedFolderRequest const &, Options)

Permanently deletes an empty managed folder.

Parameters
Name	Description
request	google::storage::control::v2::DeleteManagedFolderRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.DeleteManagedFolderRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
Status	a Status object. If the request failed, the status contains the details of the failure.

GetManagedFolder(std::string const &, Options)

Returns metadata for the specified managed folder.

Parameters
Name	Description
name	std::string const & Required. Name of the managed folder. Format: projects/{project}/buckets/{bucket}/managedFolders/{managedFolder}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::ManagedFolder >	the result of the RPC. The response message type (google.storage.control.v2.ManagedFolder) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetManagedFolder(google::storage::control::v2::GetManagedFolderRequest const &, Options)

Returns metadata for the specified managed folder.

Parameters
Name	Description
request	google::storage::control::v2::GetManagedFolderRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.GetManagedFolderRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::ManagedFolder >	the result of the RPC. The response message type (google.storage.control.v2.ManagedFolder) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListManagedFolders(std::string const &, Options)

Retrieves a list of managed folders for a given bucket.

Parameters
Name	Description
parent	std::string const & Required. Name of the bucket this managed folder belongs to.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::ManagedFolder >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.ManagedFolder, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListManagedFolders(google::storage::control::v2::ListManagedFoldersRequest, Options)

Retrieves a list of managed folders for a given bucket.

Parameters
Name	Description
request	google::storage::control::v2::ListManagedFoldersRequest Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.ListManagedFoldersRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::ManagedFolder >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.ManagedFolder, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

UpdateManagedFolder(google::storage::control::v2::ManagedFolder const &, google::protobuf::FieldMask const &, Options)

Updates a managed folder.

Currently, this RPC only supports updating the rapid_cache_config field.

Parameters
Name	Description
managed_folder	google::storage::control::v2::ManagedFolder const & Required. Properties of the managed folder being updated. Currently, this RPC only supports updating the rapid_cache_config field in managed_folder.
update_mask	google::protobuf::FieldMask const & Optional. Update mask for managed_folder. Currently, this RPC only supports updating the rapid_cache_config field in managed_folder. This field also supports update mask for the subfields in the map of rapid_cache_config. The user can specify the update mask for rapid_cache_config.policies and rapid_cache_config.policies.<key>, but patching is not supported for a field within RapidCachePolicy.policies.<key>, like rapid_cache_config.policies.[key].ingest_on_write.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::ManagedFolder >	the result of the RPC. The response message type (google.storage.control.v2.ManagedFolder) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

UpdateManagedFolder(google::storage::control::v2::UpdateManagedFolderRequest const &, Options)

Updates a managed folder.

Currently, this RPC only supports updating the rapid_cache_config field.

Parameters
Name	Description
request	google::storage::control::v2::UpdateManagedFolderRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.UpdateManagedFolderRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::ManagedFolder >	the result of the RPC. The response message type (google.storage.control.v2.ManagedFolder) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

CreateAnywhereCache(std::string const &, google::storage::control::v2::AnywhereCache const &, Options)

Creates an Anywhere Cache instance.

Parameters
Name	Description
parent	std::string const & Required. The bucket to which this cache belongs. Format: projects/{project}/buckets/{bucket}
anywhere_cache	google::storage::control::v2::AnywhereCache const & 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.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::AnywhereCache > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.AnywhereCache proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateAnywhereCache(NoAwaitTag, std::string const &, google::storage::control::v2::AnywhereCache const &, Options)

Creates an Anywhere Cache instance.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
parent	std::string const &
anywhere_cache	google::storage::control::v2::AnywhereCache const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

CreateAnywhereCache(google::storage::control::v2::CreateAnywhereCacheRequest const &, Options)

Creates an Anywhere Cache instance.

Parameters
Name	Description
request	google::storage::control::v2::CreateAnywhereCacheRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.CreateAnywhereCacheRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::AnywhereCache > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.AnywhereCache proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateAnywhereCache(NoAwaitTag, google::storage::control::v2::CreateAnywhereCacheRequest const &, Options)

Creates an Anywhere Cache instance.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
request	google::storage::control::v2::CreateAnywhereCacheRequest const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

CreateAnywhereCache(google::longrunning::Operation const &, Options)

Creates an Anywhere Cache instance.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

Returns
Type	Description
future< StatusOr< google::storage::control::v2::AnywhereCache > >

UpdateAnywhereCache(google::storage::control::v2::AnywhereCache const &, google::protobuf::FieldMask const &, Options)

Updates an Anywhere Cache instance.

Mutable fields include ttl and admission_policy.

Parameters
Name	Description
anywhere_cache	google::storage::control::v2::AnywhereCache const & Required. The Anywhere Cache instance to be updated.
update_mask	google::protobuf::FieldMask const & 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.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::AnywhereCache > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.AnywhereCache proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateAnywhereCache(NoAwaitTag, google::storage::control::v2::AnywhereCache const &, google::protobuf::FieldMask const &, Options)

Updates an Anywhere Cache instance.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
anywhere_cache	google::storage::control::v2::AnywhereCache const &
update_mask	google::protobuf::FieldMask const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

UpdateAnywhereCache(google::storage::control::v2::UpdateAnywhereCacheRequest const &, Options)

Updates an Anywhere Cache instance.

Mutable fields include ttl and admission_policy.

Parameters
Name	Description
request	google::storage::control::v2::UpdateAnywhereCacheRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.UpdateAnywhereCacheRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::AnywhereCache > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.AnywhereCache proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateAnywhereCache(NoAwaitTag, google::storage::control::v2::UpdateAnywhereCacheRequest const &, Options)

Updates an Anywhere Cache instance.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
request	google::storage::control::v2::UpdateAnywhereCacheRequest const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

UpdateAnywhereCache(google::longrunning::Operation const &, Options)

Updates an Anywhere Cache instance.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

Returns
Type	Description
future< StatusOr< google::storage::control::v2::AnywhereCache > >

DisableAnywhereCache(std::string const &, Options)

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.

Parameters
Name	Description
name	std::string const & Required. The name field in the request should be: projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::AnywhereCache >	the result of the RPC. The response message type (google.storage.control.v2.AnywhereCache) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

DisableAnywhereCache(google::storage::control::v2::DisableAnywhereCacheRequest const &, Options)

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.

Parameters
Name	Description
request	google::storage::control::v2::DisableAnywhereCacheRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.DisableAnywhereCacheRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::AnywhereCache >	the result of the RPC. The response message type (google.storage.control.v2.AnywhereCache) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

PauseAnywhereCache(std::string const &, Options)

Pauses an Anywhere Cache instance.

Parameters
Name	Description
name	std::string const & Required. The name field in the request should be: projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::AnywhereCache >	the result of the RPC. The response message type (google.storage.control.v2.AnywhereCache) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

PauseAnywhereCache(google::storage::control::v2::PauseAnywhereCacheRequest const &, Options)

Pauses an Anywhere Cache instance.

Parameters
Name	Description
request	google::storage::control::v2::PauseAnywhereCacheRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.PauseAnywhereCacheRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::AnywhereCache >	the result of the RPC. The response message type (google.storage.control.v2.AnywhereCache) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ResumeAnywhereCache(std::string const &, Options)

Resumes a disabled or paused Anywhere Cache instance.

Parameters
Name	Description
name	std::string const & Required. The name field in the request should be: projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::AnywhereCache >	the result of the RPC. The response message type (google.storage.control.v2.AnywhereCache) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ResumeAnywhereCache(google::storage::control::v2::ResumeAnywhereCacheRequest const &, Options)

Resumes a disabled or paused Anywhere Cache instance.

Parameters
Name	Description
request	google::storage::control::v2::ResumeAnywhereCacheRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.ResumeAnywhereCacheRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::AnywhereCache >	the result of the RPC. The response message type (google.storage.control.v2.AnywhereCache) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetAnywhereCache(std::string const &, Options)

Gets an Anywhere Cache instance.

Parameters
Name	Description
name	std::string const & Required. The name field in the request should be: projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::AnywhereCache >	the result of the RPC. The response message type (google.storage.control.v2.AnywhereCache) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetAnywhereCache(google::storage::control::v2::GetAnywhereCacheRequest const &, Options)

Gets an Anywhere Cache instance.

Parameters
Name	Description
request	google::storage::control::v2::GetAnywhereCacheRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.GetAnywhereCacheRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::AnywhereCache >	the result of the RPC. The response message type (google.storage.control.v2.AnywhereCache) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListAnywhereCaches(std::string const &, Options)

Lists Anywhere Cache instances for a given bucket.

Parameters
Name	Description
parent	std::string const & Required. The bucket to which this cache belongs.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::AnywhereCache >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.AnywhereCache, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListAnywhereCaches(google::storage::control::v2::ListAnywhereCachesRequest, Options)

Lists Anywhere Cache instances for a given bucket.

Parameters
Name	Description
request	google::storage::control::v2::ListAnywhereCachesRequest Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.ListAnywhereCachesRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::AnywhereCache >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.AnywhereCache, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

CreateRapidCache(std::string const &, google::storage::control::v2::RapidCache const &, Options)

Creates a Rapid Cache instance.

Parameters
Name	Description
parent	std::string const & Required. The bucket to which this cache belongs. Format: projects/{project}/buckets/{bucket}
rapid_cache	google::storage::control::v2::RapidCache const & Required. The RapidCache to create. Default values for ingest_on_write, ttl and admission_policy will be applied if not specified in the request.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::RapidCache > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.RapidCache proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateRapidCache(NoAwaitTag, std::string const &, google::storage::control::v2::RapidCache const &, Options)

Creates a Rapid Cache instance.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
parent	std::string const &
rapid_cache	google::storage::control::v2::RapidCache const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

CreateRapidCache(google::storage::control::v2::CreateRapidCacheRequest const &, Options)

Creates a Rapid Cache instance.

Parameters
Name	Description
request	google::storage::control::v2::CreateRapidCacheRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.CreateRapidCacheRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::RapidCache > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.RapidCache proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

CreateRapidCache(NoAwaitTag, google::storage::control::v2::CreateRapidCacheRequest const &, Options)

Creates a Rapid Cache instance.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
request	google::storage::control::v2::CreateRapidCacheRequest const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

CreateRapidCache(google::longrunning::Operation const &, Options)

Creates a Rapid Cache instance.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

Returns
Type	Description
future< StatusOr< google::storage::control::v2::RapidCache > >

UpdateRapidCache(google::storage::control::v2::RapidCache const &, google::protobuf::FieldMask const &, Options)

Updates a Rapid Cache instance.

Parameters
Name	Description
rapid_cache	google::storage::control::v2::RapidCache const & Required. The RapidCache to update.
update_mask	google::protobuf::FieldMask const & Required. List of fields to be updated. Mutable fields of RapidCache include ttl, admission_policy and ingest_on_write. 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.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::RapidCache > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.RapidCache proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateRapidCache(NoAwaitTag, google::storage::control::v2::RapidCache const &, google::protobuf::FieldMask const &, Options)

Updates a Rapid Cache instance.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
rapid_cache	google::storage::control::v2::RapidCache const &
update_mask	google::protobuf::FieldMask const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

UpdateRapidCache(google::storage::control::v2::UpdateRapidCacheRequest const &, Options)

Updates a Rapid Cache instance.

Parameters
Name	Description
request	google::storage::control::v2::UpdateRapidCacheRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.UpdateRapidCacheRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::RapidCache > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.RapidCache proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

UpdateRapidCache(NoAwaitTag, google::storage::control::v2::UpdateRapidCacheRequest const &, Options)

Updates a Rapid Cache instance.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
request	google::storage::control::v2::UpdateRapidCacheRequest const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

UpdateRapidCache(google::longrunning::Operation const &, Options)

Updates a Rapid Cache instance.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

Returns
Type	Description
future< StatusOr< google::storage::control::v2::RapidCache > >

DisableRapidCache(std::string const &, Options)

Disables a Rapid Cache instance.

Parameters
Name	Description
name	std::string const & Required. The name field in the request should be: projects/{project}/buckets/{bucket}/rapidCaches/{rapid_cache}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::RapidCache > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.RapidCache proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DisableRapidCache(NoAwaitTag, std::string const &, Options)

Disables a Rapid Cache instance.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
name	std::string const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

DisableRapidCache(google::storage::control::v2::DisableRapidCacheRequest const &, Options)

Disables a Rapid Cache instance.

Parameters
Name	Description
request	google::storage::control::v2::DisableRapidCacheRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.DisableRapidCacheRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
future< StatusOr< google::storage::control::v2::RapidCache > >	A future that becomes satisfied when the LRO (Long Running Operation) completes or the polling policy in effect for this call is exhausted. The future is satisfied with an error if the LRO completes with an error or the polling policy is exhausted. In this case the StatusOr returned by the future contains the error. If the LRO completes successfully the value of the future contains the LRO's result. For this RPC the result is a google.storage.control.v2.RapidCache proto message. The C++ class representing this message is created by Protobuf, using the Protobuf mapping rules.

DisableRapidCache(NoAwaitTag, google::storage::control::v2::DisableRapidCacheRequest const &, Options)

Disables a Rapid Cache instance.

Specifying the NoAwaitTag immediately returns the [google::longrunning::Operation] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.

Parameters
Name	Description
	NoAwaitTag
request	google::storage::control::v2::DisableRapidCacheRequest const &
opts	Options

Returns
Type	Description
StatusOr< google::longrunning::Operation >

DisableRapidCache(google::longrunning::Operation const &, Options)

Disables a Rapid Cache instance.

This method accepts a google::longrunning::Operation that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.

Parameters
Name	Description
operation	google::longrunning::Operation const &
opts	Options

Returns
Type	Description
future< StatusOr< google::storage::control::v2::RapidCache > >

GetRapidCache(std::string const &, Options)

Gets a Rapid Cache instance.

Parameters
Name	Description
name	std::string const & Required. The name field in the request should be: projects/{project}/buckets/{bucket}/rapidCaches/{rapid_cache}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::RapidCache >	the result of the RPC. The response message type (google.storage.control.v2.RapidCache) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetRapidCache(google::storage::control::v2::GetRapidCacheRequest const &, Options)

Gets a Rapid Cache instance.

Parameters
Name	Description
request	google::storage::control::v2::GetRapidCacheRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.GetRapidCacheRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::RapidCache >	the result of the RPC. The response message type (google.storage.control.v2.RapidCache) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListRapidCaches(std::string const &, Options)

Lists Rapid Cache instances for a given bucket.

Parameters
Name	Description
parent	std::string const & Required. The bucket to which this cache belongs.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::RapidCache >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.RapidCache, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListRapidCaches(google::storage::control::v2::ListRapidCachesRequest, Options)

Lists Rapid Cache instances for a given bucket.

Parameters
Name	Description
request	google::storage::control::v2::ListRapidCachesRequest Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.ListRapidCachesRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::RapidCache >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.RapidCache, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetProjectIntelligenceConfig(std::string const &, Options)

Returns the Project scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
name	std::string const & Required. The name of the IntelligenceConfig resource associated with your project. Format: projects/{id}/locations/global/intelligenceConfig
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetProjectIntelligenceConfig(google::storage::control::v2::GetProjectIntelligenceConfigRequest const &, Options)

Returns the Project scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
request	google::storage::control::v2::GetProjectIntelligenceConfigRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.GetProjectIntelligenceConfigRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

UpdateProjectIntelligenceConfig(google::storage::control::v2::IntelligenceConfig const &, google::protobuf::FieldMask const &, Options)

Updates the Project scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
intelligence_config	google::storage::control::v2::IntelligenceConfig const & Required. The IntelligenceConfig resource to be updated.
update_mask	google::protobuf::FieldMask const & 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.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

UpdateProjectIntelligenceConfig(google::storage::control::v2::UpdateProjectIntelligenceConfigRequest const &, Options)

Updates the Project scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
request	google::storage::control::v2::UpdateProjectIntelligenceConfigRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.UpdateProjectIntelligenceConfigRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetFolderIntelligenceConfig(std::string const &, Options)

Returns the Folder scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
name	std::string const & Required. The name of the IntelligenceConfig resource associated with your folder. Format: folders/{id}/locations/global/intelligenceConfig
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetFolderIntelligenceConfig(google::storage::control::v2::GetFolderIntelligenceConfigRequest const &, Options)

Returns the Folder scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
request	google::storage::control::v2::GetFolderIntelligenceConfigRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.GetFolderIntelligenceConfigRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

UpdateFolderIntelligenceConfig(google::storage::control::v2::IntelligenceConfig const &, google::protobuf::FieldMask const &, Options)

Updates the Folder scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
intelligence_config	google::storage::control::v2::IntelligenceConfig const & Required. The IntelligenceConfig resource to be updated.
update_mask	google::protobuf::FieldMask const & 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.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

UpdateFolderIntelligenceConfig(google::storage::control::v2::UpdateFolderIntelligenceConfigRequest const &, Options)

Updates the Folder scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
request	google::storage::control::v2::UpdateFolderIntelligenceConfigRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.UpdateFolderIntelligenceConfigRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetOrganizationIntelligenceConfig(std::string const &, Options)

Returns the Organization scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
name	std::string const & Required. The name of the IntelligenceConfig resource associated with your organization. Format: organizations/{org_id}/locations/global/intelligenceConfig
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetOrganizationIntelligenceConfig(google::storage::control::v2::GetOrganizationIntelligenceConfigRequest const &, Options)

Returns the Organization scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
request	google::storage::control::v2::GetOrganizationIntelligenceConfigRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.GetOrganizationIntelligenceConfigRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

UpdateOrganizationIntelligenceConfig(google::storage::control::v2::IntelligenceConfig const &, google::protobuf::FieldMask const &, Options)

Updates the Organization scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
intelligence_config	google::storage::control::v2::IntelligenceConfig const & Required. The IntelligenceConfig resource to be updated.
update_mask	google::protobuf::FieldMask const & 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.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

UpdateOrganizationIntelligenceConfig(google::storage::control::v2::UpdateOrganizationIntelligenceConfigRequest const &, Options)

Updates the Organization scoped singleton IntelligenceConfig resource.

Parameters
Name	Description
request	google::storage::control::v2::UpdateOrganizationIntelligenceConfigRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.UpdateOrganizationIntelligenceConfigRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceConfig >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceConfig) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetIamPolicy(std::string const &, Options)

Gets the IAM policy for a specified bucket.

The resource field in the request should be projects/_/buckets/{bucket} for a bucket, or projects/_/buckets/{bucket}/managedFolders/{managedFolder} for a managed folder.

Parameters
Name	Description
resource	std::string const & REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::iam::v1::Policy >	the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetIamPolicy(google::iam::v1::GetIamPolicyRequest const &, Options)

Gets the IAM policy for a specified bucket.

The resource field in the request should be projects/_/buckets/{bucket} for a bucket, or projects/_/buckets/{bucket}/managedFolders/{managedFolder} for a managed folder.

Parameters
Name	Description
request	google::iam::v1::GetIamPolicyRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.iam.v1.GetIamPolicyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::iam::v1::Policy >	the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

SetIamPolicy(std::string const &, google::iam::v1::Policy const &, Options)

Updates an IAM policy for the specified bucket.

The resource field in the request should be projects/_/buckets/{bucket} for a bucket, or projects/_/buckets/{bucket}/managedFolders/{managedFolder} for a managed folder.

Parameters
Name	Description
resource	std::string const & REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.
policy	google::iam::v1::Policy const & REQUIRED: The complete policy to be applied to the resource. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::iam::v1::Policy >	the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

SetIamPolicy(std::string const &, IamUpdater const &, Options)

Updates the IAM policy for resource using an optimistic concurrency control loop.

The loop fetches the current policy for resource, and passes it to updater, which should return the new policy. This new policy should use the current etag so that the read-modify-write cycle can detect races and rerun the update when there is a mismatch. If the new policy does not have an etag, the existing policy will be blindly overwritten. If updater does not yield a policy, the control loop is terminated and kCancelled is returned.

Parameters
Name	Description
resource	std::string const & Required. The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.
updater	IamUpdater const & Required. Functor to map the current policy to a new one.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::iam::v1::Policy >	google::iam::v1::Policy

SetIamPolicy(google::iam::v1::SetIamPolicyRequest const &, Options)

Updates an IAM policy for the specified bucket.

The resource field in the request should be projects/_/buckets/{bucket} for a bucket, or projects/_/buckets/{bucket}/managedFolders/{managedFolder} for a managed folder.

Parameters
Name	Description
request	google::iam::v1::SetIamPolicyRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.iam.v1.SetIamPolicyRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::iam::v1::Policy >	the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

TestIamPermissions(std::string const &, std::vector< std::string > const &, Options)

Tests a set of permissions on the given bucket, object, or managed folder to see which, if any, are held by the caller.

The resource field in the request should be projects/_/buckets/{bucket} for a bucket, projects/_/buckets/{bucket}/objects/{object} for an object, or projects/_/buckets/{bucket}/managedFolders/{managedFolder} for a managed folder.

Parameters
Name	Description
resource	std::string const & REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.
permissions	std::vector< std::string > const & The set of permissions to check for the resource. Permissions with wildcards (such as '' or 'storage.') are not allowed. For more information see IAM Overview.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::iam::v1::TestIamPermissionsResponse >	the result of the RPC. The response message type (google.iam.v1.TestIamPermissionsResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

TestIamPermissions(google::iam::v1::TestIamPermissionsRequest const &, Options)

Tests a set of permissions on the given bucket, object, or managed folder to see which, if any, are held by the caller.

The resource field in the request should be projects/_/buckets/{bucket} for a bucket, projects/_/buckets/{bucket}/objects/{object} for an object, or projects/_/buckets/{bucket}/managedFolders/{managedFolder} for a managed folder.

Parameters
Name	Description
request	google::iam::v1::TestIamPermissionsRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.iam.v1.TestIamPermissionsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::iam::v1::TestIamPermissionsResponse >	the result of the RPC. The response message type (google.iam.v1.TestIamPermissionsResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetIntelligenceFinding(std::string const &, Options)

Gets the IntelligenceFinding for a project.

Parameters
Name	Description
name	std::string const & Required. The name of the IntelligenceFinding resource. Format: projects/{project}/locations/{location}/intelligenceFindings/{intelligence_finding}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceFinding >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceFinding) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetIntelligenceFinding(google::storage::control::v2::GetIntelligenceFindingRequest const &, Options)

Gets the IntelligenceFinding for a project.

Parameters
Name	Description
request	google::storage::control::v2::GetIntelligenceFindingRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.GetIntelligenceFindingRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceFinding >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceFinding) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListIntelligenceFindings(std::string const &, Options)

Lists the IntelligenceFinding resources for the specified the project.

Parameters
Name	Description
parent	std::string const & Required. The parent of the IntelligenceFinding resource. Format: projects/{project}/locations/{location}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::IntelligenceFinding >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.IntelligenceFinding, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListIntelligenceFindings(google::storage::control::v2::ListIntelligenceFindingsRequest, Options)

Lists the IntelligenceFinding resources for the specified the project.

Parameters
Name	Description
request	google::storage::control::v2::ListIntelligenceFindingsRequest Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.ListIntelligenceFindingsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::IntelligenceFinding >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.IntelligenceFinding, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

SummarizeIntelligenceFindings(std::string const &, Options)

Summarizes the intelligence findings for the specified scope (organization, folder or project).

Parameters
Name	Description
parent	std::string const & Required. The scope to summarize the findings for. Format: organizations/{organization}/locations/{location} folders/{folder}/locations/{location} projects/{project}/locations/{location}
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::FindingSummary >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.FindingSummary, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

SummarizeIntelligenceFindings(google::storage::control::v2::SummarizeIntelligenceFindingsRequest, Options)

Summarizes the intelligence findings for the specified scope (organization, folder or project).

Parameters
Name	Description
request	google::storage::control::v2::SummarizeIntelligenceFindingsRequest Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.SummarizeIntelligenceFindingsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::FindingSummary >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.FindingSummary, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

GetIntelligenceFindingRevision(std::string const &, Options)

Gets the IntelligenceFindingRevision resource.

Format:

projects/{project}/locations/{location}/intelligenceFindings/{intelligence_finding}/revisions/{revision}

Parameters
Name	Description
name	std::string const & Required. The name of the IntelligenceFindingRevision resource.
opts	Options

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceFindingRevision >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceFindingRevision) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

GetIntelligenceFindingRevision(google::storage::control::v2::GetIntelligenceFindingRevisionRequest const &, Options)

Gets the IntelligenceFindingRevision resource.

Parameters
Name	Description
request	google::storage::control::v2::GetIntelligenceFindingRevisionRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.GetIntelligenceFindingRevisionRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::IntelligenceFindingRevision >	the result of the RPC. The response message type (google.storage.control.v2.IntelligenceFindingRevision) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ListIntelligenceFindingRevisions(std::string const &, Options)

Lists all the revisions of an IntelligenceFinding resource.

Format:

projects/{project}/locations/{location}/intelligenceFindings/{intelligence_finding}

Parameters
Name	Description
parent	std::string const & Required. The parent of the IntelligenceFindingRevision resource.
opts	Options

Returns
Type	Description
StreamRange< google::storage::control::v2::IntelligenceFindingRevision >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.IntelligenceFindingRevision, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ListIntelligenceFindingRevisions(google::storage::control::v2::ListIntelligenceFindingRevisionsRequest, Options)

Lists all the revisions of an IntelligenceFinding resource.

Parameters
Name	Description
request	google::storage::control::v2::ListIntelligenceFindingRevisionsRequest Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.ListIntelligenceFindingRevisionsRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StreamRange< google::storage::control::v2::IntelligenceFindingRevision >	a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has begin() and end() member functions returning a iterator class meeting the input iterator requirements. The value type for this iterator is a StatusOr as the iteration may fail even after some values are retrieved successfully, for example, if there is a network disconnect. An empty set of results does not indicate an error, it indicates that there are no resources meeting the request criteria. On a successful iteration the StatusOr<T> contains elements of type google.storage.control.v2.IntelligenceFindingRevision, or rather, the C++ class generated by Protobuf from that type. Please consult the Protobuf documentation for details on the Protobuf mapping rules.

ViewObjectFullContext(std::string const &, std::string const &, Options)

Retrieves the full content of an object context, including its key, value, and any associated extended data for a given context key.

Object contexts can optionally contain extended data. If an object context contains extended data, the metadata payload structure will contain only its type URL. To retrieve the full extended data, call this method.

Returns the complete representation of the context as an ObjectFullContext.

Parameters
Name	Description
name	std::string const & Required. The name of the object. Format: projects/{project}/buckets/{bucket}/objects/{object}
context_key	std::string const & Required. The key of the object context to retrieve.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::ObjectFullContext >	the result of the RPC. The response message type (google.storage.control.v2.ObjectFullContext) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ViewObjectFullContext(std::string const &, std::int64_t, std::string const &, Options)

Retrieves the full content of an object context, including its key, value, and any associated extended data for a given context key.

Object contexts can optionally contain extended data. If an object context contains extended data, the metadata payload structure will contain only its type URL. To retrieve the full extended data, call this method.

Returns the complete representation of the context as an ObjectFullContext.

Parameters
Name	Description
name	std::string const & Required. The name of the object. Format: projects/{project}/buckets/{bucket}/objects/{object}
generation	std::int64_t Optional. If present, selects a specific revision of this object (as opposed to the latest version, the default).
context_key	std::string const & Required. The key of the object context to retrieve.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::ObjectFullContext >	the result of the RPC. The response message type (google.storage.control.v2.ObjectFullContext) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.

ViewObjectFullContext(google::storage::control::v2::ViewObjectFullContextRequest const &, Options)

Retrieves the full content of an object context, including its key, value, and any associated extended data for a given context key.

Object contexts can optionally contain extended data. If an object context contains extended data, the metadata payload structure will contain only its type URL. To retrieve the full extended data, call this method.

Returns the complete representation of the context as an ObjectFullContext.

Parameters
Name	Description
request	google::storage::control::v2::ViewObjectFullContextRequest const & Unary RPCs, such as the one wrapped by this function, receive a single request proto message which includes all the inputs for the RPC. In this case, the proto message is a google.storage.control.v2.ViewObjectFullContextRequest. Proto messages are converted to C++ classes by Protobuf, using the Protobuf mapping rules.
opts	Options Optional. Override the class-level options, such as retry and backoff policies.

Returns
Type	Description
StatusOr< google::storage::control::v2::ObjectFullContext >	the result of the RPC. The response message type (google.storage.control.v2.ObjectFullContext) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the StatusOr contains the error details.