The Cloud Storage gRPC API allows applications to read and write data through the abstractions - * of buckets and objects. For a description of these abstractions please see - * https://cloud.google.com/storage/docs. + * of buckets and objects. For a description of these abstractions please see [Cloud Storage + * documentation](https://cloud.google.com/storage/docs). * - *
Resources are named as follows: - Projects are referred to as they are defined by the Resource - * Manager API, using strings like `projects/123456` or `projects/my-string-id`. - Buckets are named - * using string names of the form: `projects/{project}/buckets/{bucket}` For globally unique - * buckets, `_` may be substituted for the project. - Objects are uniquely identified by their name - * along with the name of the bucket they belong to, as separate strings in this API. For example: + *
Resources are named as follows: * - *
ReadObjectRequest { bucket: 'projects/_/buckets/my-bucket' object: 'my-object' } Note that - * object names can contain `/` characters, which are treated as any other character (no special - * directory semantics). + *
- Projects are referred to as they are defined by the Resource Manager API, using strings like + * `projects/123456` or `projects/my-string-id`. - Buckets are named using string names of the form: + * `projects/{project}/buckets/{bucket}`. For globally unique buckets, `_` might be substituted for + * the project. - Objects are uniquely identified by their name along with the name of the bucket + * they belong to, as separate strings in this API. For example: + * + *
``` ReadObjectRequest { bucket: 'projects/_/buckets/my-bucket' object: 'my-object' } ``` + * + *
Note that object names can contain `/` characters, which are treated as any other character + * (no special directory semantics). * *
This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: @@ -88,7 +91,11 @@ * *
DeleteBucket
Permanently deletes an empty bucket.
Permanently deletes an empty bucket. The request fails if there are any live or noncurrent objects in the bucket, but the request succeeds if the bucket only contains soft-deleted objects or incomplete uploads, such as ongoing XML API multipart uploads. Does not permanently delete soft-deleted objects. + *
When this API is used to delete a bucket containing an object that has a soft delete policy enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set on the object. + *
Objects and multipart uploads that were in the bucket at the time of deletion are also retained for the specified retention duration. When a soft-deleted bucket reaches the end of its retention duration, it is permanently deleted. The `hardDeleteTime` of the bucket always equals or exceeds the expiration time of the last soft-deleted object in the bucket. + *
**IAM Permissions**: + *
Requires `storage.buckets.delete` IAM permission on the bucket.
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*GetBucket
Returns metadata for the specified bucket.
Returns metadata for the specified bucket. + *
**IAM Permissions**: + *
Requires `storage.buckets.get` IAM permission on the bucket. Additionally, to return specific bucket metadata, the authenticated user must have the following permissions: + *
- To return the IAM policies: `storage.buckets.getIamPolicy` - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*CreateBucket
Creates a new bucket.
Creates a new bucket. + *
**IAM Permissions**: + *
Requires `storage.buckets.create` IAM permission on the bucket. Additionally, to enable specific bucket features, the authenticated user must have the following permissions: + *
- To enable object retention using the `enableObjectRetention` query parameter: `storage.buckets.enableObjectRetention` - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*ListBuckets
Retrieves a list of buckets for a given project.
Retrieves a list of buckets for a given project, ordered lexicographically by name. + *
**IAM Permissions**: + *
Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable specific bucket features, the authenticated user must have the following permissions: + *
- To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*LockBucketRetentionPolicy
Locks retention policy on a bucket.
Permanently locks the retention policy that is currently applied to the specified bucket. + *
Caution: Locking a bucket is an irreversible action. Once you lock a bucket: + *
- You cannot remove the retention policy from the bucket. - You cannot decrease the retention period for the policy. + *
Once locked, you must delete the entire bucket in order to remove the bucket's retention policy. However, before you can delete the bucket, you must delete all the objects in the bucket, which is only possible if all the objects have reached the retention period set by the retention policy. + *
**IAM Permissions**: + *
Requires `storage.buckets.update` IAM permission on the bucket.
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*GetIamPolicy
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.
Gets the IAM policy for a specified bucket or managed folder. The `resource` field in the request should be `projects/_/buckets/{bucket}` for a bucket, or `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder. + *
**IAM Permissions**: + *
Requires `storage.buckets.getIamPolicy` on the bucket or `storage.managedFolders.getIamPolicy` IAM permission on the managed folder.
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*SetIamPolicy
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.
Updates an IAM policy for the specified bucket or managed folder. The `resource` field in the request should be `projects/_/buckets/{bucket}` for a bucket, or `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*UpdateBucket
Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
Updates a bucket. Changes to the bucket are readable immediately after writing, but configuration changes might take time to propagate. This method supports `patch` semantics. + *
**IAM Permissions**: + *
Requires `storage.buckets.update` IAM permission on the bucket. Additionally, to enable specific bucket features, the authenticated user must have the following permissions: + *
- To set bucket IP filtering rules: `storage.buckets.setIpFilter` - To update public access prevention policies or access control lists (ACLs): `storage.buckets.setIamPolicy`
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*ComposeObject
Concatenates a list of existing objects into a new object in the same bucket.
Concatenates a list of existing objects into a new object in the same bucket. The existing source objects are unaffected by this operation. + *
**IAM Permissions**: + *
Requires the `storage.objects.create` and `storage.objects.get` IAM permissions to use this method. If the new composite object overwrites an existing object, the authenticated user must also have the `storage.objects.delete` permission. If the request body includes the retention property, the authenticated user must also have the `storage.objects.setRetention` IAM permission.
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*DeleteObject
Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for the bucket, or if the generation parameter is used, or if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When this API is used to delete an object from a bucket that has soft delete policy enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`. + *
Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for the bucket, or if the generation parameter is used, or if soft delete is not enabled for the bucket. When this API is used to delete an object from a bucket that has soft delete policy enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`. *
You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore soft-deleted objects until the soft delete retention period has passed. *
**IAM Permissions**: - *
Requires `storage.objects.delete` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
Requires `storage.objects.delete` IAM permission on the bucket. *
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*RestoreObject
Restores a soft-deleted object.
Restores a soft-deleted object. When a soft-deleted object is restored, a new copy of that object is created in the same bucket and inherits the same metadata as the soft-deleted object. The inherited metadata is the metadata that existed when the original object became soft deleted, with the following exceptions: + *
- The `createTime` of the new object is set to the time at which the soft-deleted object was restored. - The `softDeleteTime` and `hardDeleteTime` values are cleared. - A new generation is assigned and the metageneration is reset to 1. - If the soft-deleted object was in a bucket that had Autoclass enabled, the new object is restored to Standard storage. - The restored object inherits the bucket's default object ACL, unless `copySourceAcl` is `true`. + *
If a live object using the same name already exists in the bucket and becomes overwritten, the live object becomes a noncurrent object if Object Versioning is enabled on the bucket. If Object Versioning is not enabled, the live object becomes soft deleted. + *
**IAM Permissions**: + *
Requires the following IAM permissions to use this method: + *
- `storage.objects.restore` - `storage.objects.create` - `storage.objects.delete` (only required if overwriting an existing object) - `storage.objects.getIamPolicy` (only required if `projection` is `full` and the relevant bucket has uniform bucket-level access disabled) - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is `true` and the relevant bucket has uniform bucket-level access disabled)
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*CancelResumableWrite
Cancels an in-progress resumable upload. - *
Any attempts to write to the resumable upload after cancelling the upload will fail. - *
The behavior for currently in progress write operations is not guaranteed - they could either complete before the cancellation or fail if the cancellation completes first.
Any attempts to write to the resumable upload after cancelling the upload fail. + *
The behavior for any in-progress write operations is not guaranteed; they could either complete before the cancellation or fail if the cancellation completes first. *
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*GetObject
Retrieves object metadata. *
**IAM Permissions**: - *
Requires `storage.objects.get` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy` permission.
Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy` permission.
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*ReadObject
Retrieves object data. *
**IAM Permissions**: - *
Requires `storage.objects.get` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
Requires `storage.objects.get` IAM permission on the bucket.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*BidiReadObject
Reads an object's data. - *
This is a bi-directional API with the added support for reading multiple ranges within one stream both within and across multiple messages. If the server encountered an error for any of the inputs, the stream will be closed with the relevant error code. Because the API allows for multiple outstanding requests, when the stream is closed the error response will contain a BidiReadObjectRangesError proto in the error extension describing the error for each outstanding read_id. + *
This bi-directional API reads data from an object, allowing you to request multiple data ranges within a single stream, even across several messages. If an error occurs with any request, the stream closes with a relevant error code. Since you can have multiple outstanding requests, the error response includes a `BidiReadObjectRangesError` field detailing the specific error for each pending `read_id`. *
**IAM Permissions**: - *
Requires `storage.objects.get` - *
[IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. - *
This API is currently in preview and is not yet available for general use.
Requires `storage.objects.get` IAM permission on the bucket. *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*UpdateObject
Updates an object's metadata. Equivalent to JSON API's storage.objects.patch.
Updates an object's metadata. Equivalent to JSON API's `storage.objects.patch` method. + *
**IAM Permissions**: + *
Requires `storage.objects.update` IAM permission on the bucket.
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*WriteObject
Stores a new object and metadata. *
An object can be written either in a single message stream or in a resumable sequence of message streams. To write using a single stream, the client should include in the first message of the stream an `WriteObjectSpec` describing the destination bucket, object, and any preconditions. Additionally, the final message must set 'finish_write' to true, or else it is an error. - *
For a resumable write, the client should instead call `StartResumableWrite()`, populating a `WriteObjectSpec` into that request. They should then attach the returned `upload_id` to the first message of each following call to `WriteObject`. If the stream is closed before finishing the upload (either explicitly by the client or due to a network error or an error response from the server), the client should do as follows: - Check the result Status of the stream, to determine if writing can be resumed on this stream or must be restarted from scratch (by calling `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED, INTERNAL, and UNAVAILABLE. For each case, the client should use binary exponential backoff before retrying. Additionally, writes can be resumed after RESOURCE_EXHAUSTED errors, but only after taking appropriate measures, which may include reducing aggregate send rate across clients and/or requesting a quota increase for your project. - If the call to `WriteObject` returns `ABORTED`, that indicates concurrent attempts to update the resumable write, caused either by multiple racing clients or by a single client where the previous request was timed out on the client side but nonetheless reached the server. In this case the client should take steps to prevent further concurrent writes (e.g., increase the timeouts, stop using more than one process to perform the upload, etc.), and then should follow the steps below for resuming the upload. - For resumable errors, the client should call `QueryWriteStatus()` and then continue writing from the returned `persisted_size`. This may be less than the amount of data the client previously sent. Note also that it is acceptable to send data starting at an offset earlier than the returned `persisted_size`; in this case, the service will skip data at offsets that were already persisted (without checking that it matches the previously written data), and write only the data starting from the persisted offset. Even though the data isn't written, it may still incur a performance cost over resuming at the correct write offset. This behavior can make client-side handling simpler in some cases. - Clients must only send data that is a multiple of 256 KiB per message, unless the object is being finished with `finish_write` set to `true`. - *
The service will not view the object as complete until the client has sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any requests on a stream after sending a request with `finish_write` set to `true` will cause an error. The client **should** check the response it receives to determine how much data the service was able to commit and whether the service views the object as complete. - *
Attempting to resume an already finalized object will result in an OK status, with a `WriteObjectResponse` containing the finalized object's metadata. - *
Alternatively, the BidiWriteObject operation may be used to write an object with controls over flushing and the ability to fetch the ability to determine the current persisted size. + *
For a resumable write, the client should instead call `StartResumableWrite()`, populating a `WriteObjectSpec` into that request. They should then attach the returned `upload_id` to the first message of each following call to `WriteObject`. If the stream is closed before finishing the upload (either explicitly by the client or due to a network error or an error response from the server), the client should do as follows: + *
- Check the result Status of the stream, to determine if writing can be resumed on this stream or must be restarted from scratch (by calling `StartResumableWrite()`). The resumable errors are `DEADLINE_EXCEEDED`, `INTERNAL`, and `UNAVAILABLE`. For each case, the client should use binary exponential backoff before retrying. Additionally, writes can be resumed after `RESOURCE_EXHAUSTED` errors, but only after taking appropriate measures, which might include reducing aggregate send rate across clients and/or requesting a quota increase for your project. - If the call to `WriteObject` returns `ABORTED`, that indicates concurrent attempts to update the resumable write, caused either by multiple racing clients or by a single client where the previous request was timed out on the client side but nonetheless reached the server. In this case the client should take steps to prevent further concurrent writes. For example, increase the timeouts and stop using more than one process to perform the upload. Follow the steps below for resuming the upload. - For resumable errors, the client should call `QueryWriteStatus()` and then continue writing from the returned `persisted_size`. This might be less than the amount of data the client previously sent. Note also that it is acceptable to send data starting at an offset earlier than the returned `persisted_size`; in this case, the service skips data at offsets that were already persisted (without checking that it matches the previously written data), and write only the data starting from the persisted offset. Even though the data isn't written, it might still incur a performance cost over resuming at the correct write offset. This behavior can make client-side handling simpler in some cases. - Clients must only send data that is a multiple of 256 KiB per message, unless the object is being finished with `finish_write` set to `true`. + *
The service does not view the object as complete until the client has sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any requests on a stream after sending a request with `finish_write` set to `true` causes an error. The client must check the response it receives to determine how much data the service is able to commit and whether the service views the object as complete. + *
Attempting to resume an already finalized object results in an `OK` status, with a `WriteObjectResponse` containing the finalized object's metadata. + *
Alternatively, you can use the `BidiWriteObject` operation to write an object with controls over flushing and the ability to fetch the ability to determine the current persisted size. *
**IAM Permissions**: - *
Requires `storage.objects.create` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
Requires `storage.objects.create` IAM permission on the bucket.
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*BidiWriteObject
Stores a new object and metadata. - *
This is similar to the WriteObject call with the added support for manual flushing of persisted state, and the ability to determine current persisted size without closing the stream. - *
The client may specify one or both of the `state_lookup` and `flush` fields in each BidiWriteObjectRequest. If `flush` is specified, the data written so far will be persisted to storage. If `state_lookup` is specified, the service will respond with a BidiWriteObjectResponse that contains the persisted size. If both `flush` and `state_lookup` are specified, the flush will always occur before a `state_lookup`, so that both may be set in the same request and the returned state will be the state of the object post-flush. When the stream is closed, a BidiWriteObjectResponse will always be sent to the client, regardless of the value of `state_lookup`.
This is similar to the `WriteObject` call with the added support for manual flushing of persisted state, and the ability to determine current persisted size without closing the stream. + *
The client might specify one or both of the `state_lookup` and `flush` fields in each `BidiWriteObjectRequest`. If `flush` is specified, the data written so far is persisted to storage. If `state_lookup` is specified, the service responds with a `BidiWriteObjectResponse` that contains the persisted size. If both `flush` and `state_lookup` are specified, the flush always occurs before a `state_lookup`, so that both might be set in the same request and the returned state is the state of the object post-flush. When the stream is closed, a `BidiWriteObjectResponse` is always sent to the client, regardless of the value of `state_lookup`. *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
*ListObjects
Retrieves a list of objects matching the criteria. *
**IAM Permissions**: - *
The authenticated user requires `storage.objects.list` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy` permission.
The authenticated user requires `storage.objects.list` IAM permission to use this method. To return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy` permission.
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*StartResumableWrite
Starts a resumable write operation. This method is part of the [Resumable upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. This allows you to upload large objects in multiple chunks, which is more resilient to network interruptions than a single upload. The validity duration of the write operation, and the consequences of it becoming invalid, are service-dependent. + *
Starts a resumable write operation. This method is part of the Resumable upload feature. This allows you to upload large objects in multiple chunks, which is more resilient to network interruptions than a single upload. The validity duration of the write operation, and the consequences of it becoming invalid, are service-dependent. *
**IAM Permissions**: - *
Requires `storage.objects.create` [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
Requires `storage.objects.create` IAM permission on the bucket. *
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*QueryWriteStatus
Determines the `persisted_size` of an object that is being written. This method is part of the [resumable upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. The returned value is the size of the object that has been persisted so far. The value can be used as the `write_offset` for the next `Write()` call. + *
Determines the `persisted_size` of an object that is being written. This method is part of the resumable upload feature. The returned value is the size of the object that has been persisted so far. The value can be used as the `write_offset` for the next `Write()` call. *
If the object does not exist, meaning if it was deleted, or the first `Write()` has not yet reached the service, this method returns the error `NOT_FOUND`. *
This method is useful for clients that buffer data and need to know which data can be safely evicted. The client can call `QueryWriteStatus()` at any time to determine how much data has been logged for this object. For any sequence of `QueryWriteStatus()` calls for a given object name, the sequence of returned `persisted_size` values are non-decreasing.
MoveObject
Moves the source object to the destination object in the same bucket.
Moves the source object to the destination object in the same bucket. This operation moves a source object to a destination object in the same bucket by renaming the object. The move itself is an atomic transaction, ensuring all steps either complete successfully or no changes are made. + *
**IAM Permissions**: + *
Requires the following IAM permissions to use this method: + *
- `storage.objects.move` - `storage.objects.create` - `storage.objects.delete` (only required if overwriting an existing object)
Request object method variants only take one parameter, a request object, which must be constructed before the call.
*When this API is used to delete a bucket containing an object that has a soft delete policy + * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` + * properties are set on the object. + * + *
Objects and multipart uploads that were in the bucket at the time of deletion are also + * retained for the specified retention duration. When a soft-deleted bucket reaches the end of + * its retention duration, it is permanently deleted. The `hardDeleteTime` of the bucket always + * equals or exceeds the expiration time of the last soft-deleted object in the bucket. + * + *
**IAM Permissions**: + * + *
Requires `storage.buckets.delete` IAM permission on the bucket. * *
Sample code: * @@ -639,7 +692,23 @@ public final void deleteBucket(BucketName name) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Permanently deletes an empty bucket. + * Permanently deletes an empty bucket. The request fails if there are any live or noncurrent + * objects in the bucket, but the request succeeds if the bucket only contains soft-deleted + * objects or incomplete uploads, such as ongoing XML API multipart uploads. Does not permanently + * delete soft-deleted objects. + * + *
When this API is used to delete a bucket containing an object that has a soft delete policy + * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` + * properties are set on the object. + * + *
Objects and multipart uploads that were in the bucket at the time of deletion are also + * retained for the specified retention duration. When a soft-deleted bucket reaches the end of + * its retention duration, it is permanently deleted. The `hardDeleteTime` of the bucket always + * equals or exceeds the expiration time of the last soft-deleted object in the bucket. + * + *
**IAM Permissions**: + * + *
Requires `storage.buckets.delete` IAM permission on the bucket. * *
Sample code: * @@ -665,7 +734,23 @@ public final void deleteBucket(String name) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Permanently deletes an empty bucket. + * Permanently deletes an empty bucket. The request fails if there are any live or noncurrent + * objects in the bucket, but the request succeeds if the bucket only contains soft-deleted + * objects or incomplete uploads, such as ongoing XML API multipart uploads. Does not permanently + * delete soft-deleted objects. + * + *
When this API is used to delete a bucket containing an object that has a soft delete policy + * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` + * properties are set on the object. + * + *
Objects and multipart uploads that were in the bucket at the time of deletion are also + * retained for the specified retention duration. When a soft-deleted bucket reaches the end of + * its retention duration, it is permanently deleted. The `hardDeleteTime` of the bucket always + * equals or exceeds the expiration time of the last soft-deleted object in the bucket. + * + *
**IAM Permissions**: + * + *
Requires `storage.buckets.delete` IAM permission on the bucket. * *
Sample code: * @@ -695,7 +780,23 @@ public final void deleteBucket(DeleteBucketRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Permanently deletes an empty bucket. + * Permanently deletes an empty bucket. The request fails if there are any live or noncurrent + * objects in the bucket, but the request succeeds if the bucket only contains soft-deleted + * objects or incomplete uploads, such as ongoing XML API multipart uploads. Does not permanently + * delete soft-deleted objects. + * + *
When this API is used to delete a bucket containing an object that has a soft delete policy + * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` + * properties are set on the object. + * + *
Objects and multipart uploads that were in the bucket at the time of deletion are also + * retained for the specified retention duration. When a soft-deleted bucket reaches the end of + * its retention duration, it is permanently deleted. The `hardDeleteTime` of the bucket always + * equals or exceeds the expiration time of the last soft-deleted object in the bucket. + * + *
**IAM Permissions**: + * + *
Requires `storage.buckets.delete` IAM permission on the bucket. * *
Sample code:
*
@@ -726,6 +827,14 @@ public final UnaryCallable **IAM Permissions**:
+ *
+ * Requires `storage.buckets.get` IAM permission on the bucket. Additionally, to return
+ * specific bucket metadata, the authenticated user must have the following permissions:
+ *
+ * - To return the IAM policies: `storage.buckets.getIamPolicy` - To return the bucket IP
+ * filtering rules: `storage.buckets.getIpFilter`
+ *
* Sample code:
*
* **IAM Permissions**:
+ *
+ * Requires `storage.buckets.get` IAM permission on the bucket. Additionally, to return
+ * specific bucket metadata, the authenticated user must have the following permissions:
+ *
+ * - To return the IAM policies: `storage.buckets.getIamPolicy` - To return the bucket IP
+ * filtering rules: `storage.buckets.getIpFilter`
+ *
* Sample code:
*
* **IAM Permissions**:
+ *
+ * Requires `storage.buckets.get` IAM permission on the bucket. Additionally, to return
+ * specific bucket metadata, the authenticated user must have the following permissions:
+ *
+ * - To return the IAM policies: `storage.buckets.getIamPolicy` - To return the bucket IP
+ * filtering rules: `storage.buckets.getIpFilter`
+ *
* Sample code:
*
* **IAM Permissions**:
+ *
+ * Requires `storage.buckets.get` IAM permission on the bucket. Additionally, to return
+ * specific bucket metadata, the authenticated user must have the following permissions:
+ *
+ * - To return the IAM policies: `storage.buckets.getIamPolicy` - To return the bucket IP
+ * filtering rules: `storage.buckets.getIpFilter`
+ *
* Sample code:
*
* **IAM Permissions**:
+ *
+ * Requires `storage.buckets.create` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To enable object retention using the `enableObjectRetention` query parameter:
+ * `storage.buckets.enableObjectRetention` - To set the bucket IP filtering rules:
+ * `storage.buckets.setIpFilter`
+ *
* Sample code:
*
* **IAM Permissions**:
+ *
+ * Requires `storage.buckets.create` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To enable object retention using the `enableObjectRetention` query parameter:
+ * `storage.buckets.enableObjectRetention` - To set the bucket IP filtering rules:
+ * `storage.buckets.setIpFilter`
+ *
* Sample code:
*
* **IAM Permissions**:
+ *
+ * Requires `storage.buckets.create` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To enable object retention using the `enableObjectRetention` query parameter:
+ * `storage.buckets.enableObjectRetention` - To set the bucket IP filtering rules:
+ * `storage.buckets.setIpFilter`
+ *
* Sample code:
*
* **IAM Permissions**:
+ *
+ * Requires `storage.buckets.create` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To enable object retention using the `enableObjectRetention` query parameter:
+ * `storage.buckets.enableObjectRetention` - To set the bucket IP filtering rules:
+ * `storage.buckets.setIpFilter`
+ *
* Sample code:
*
* **IAM Permissions**:
+ *
+ * Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering
+ * rules: `storage.buckets.getIpFilter`
*
* Sample code:
*
@@ -1020,7 +1197,15 @@ public final ListBucketsPagedResponse listBuckets(ProjectName parent) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Retrieves a list of buckets for a given project.
+ * Retrieves a list of buckets for a given project, ordered lexicographically by name.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering
+ * rules: `storage.buckets.getIpFilter`
*
* Sample code:
*
@@ -1048,7 +1233,15 @@ public final ListBucketsPagedResponse listBuckets(String parent) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Retrieves a list of buckets for a given project.
+ * Retrieves a list of buckets for a given project, ordered lexicographically by name.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering
+ * rules: `storage.buckets.getIpFilter`
*
* Sample code:
*
@@ -1066,6 +1259,7 @@ public final ListBucketsPagedResponse listBuckets(String parent) {
* .setPageToken("pageToken873572522")
* .setPrefix("prefix-980110702")
* .setReadMask(FieldMask.newBuilder().build())
+ * .setReturnPartialSuccess(true)
* .build();
* for (Bucket element : storageClient.listBuckets(request).iterateAll()) {
* // doThingsWith(element);
@@ -1082,7 +1276,15 @@ public final ListBucketsPagedResponse listBuckets(ListBucketsRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Retrieves a list of buckets for a given project.
+ * Retrieves a list of buckets for a given project, ordered lexicographically by name.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering
+ * rules: `storage.buckets.getIpFilter`
*
* Sample code:
*
@@ -1100,6 +1302,7 @@ public final ListBucketsPagedResponse listBuckets(ListBucketsRequest request) {
* .setPageToken("pageToken873572522")
* .setPrefix("prefix-980110702")
* .setReadMask(FieldMask.newBuilder().build())
+ * .setReturnPartialSuccess(true)
* .build();
* ApiFuture **IAM Permissions**:
+ *
+ * Requires `storage.buckets.list` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To list the IAM policies: `storage.buckets.getIamPolicy` - To list the bucket IP filtering
+ * rules: `storage.buckets.getIpFilter`
*
* Sample code:
*
@@ -1134,6 +1345,7 @@ public final ListBucketsPagedResponse listBuckets(ListBucketsRequest request) {
* .setPageToken("pageToken873572522")
* .setPrefix("prefix-980110702")
* .setReadMask(FieldMask.newBuilder().build())
+ * .setReturnPartialSuccess(true)
* .build();
* while (true) {
* ListBucketsResponse response = storageClient.listBucketsCallable().call(request);
@@ -1156,7 +1368,21 @@ public final UnaryCallable Caution: Locking a bucket is an irreversible action. Once you lock a bucket:
+ *
+ * - You cannot remove the retention policy from the bucket. - You cannot decrease the
+ * retention period for the policy.
+ *
+ * Once locked, you must delete the entire bucket in order to remove the bucket's retention
+ * policy. However, before you can delete the bucket, you must delete all the objects in the
+ * bucket, which is only possible if all the objects have reached the retention period set by the
+ * retention policy.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.buckets.update` IAM permission on the bucket.
*
* Sample code:
*
@@ -1185,7 +1411,21 @@ public final Bucket lockBucketRetentionPolicy(BucketName bucket) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Locks retention policy on a bucket.
+ * Permanently locks the retention policy that is currently applied to the specified bucket.
+ *
+ * Caution: Locking a bucket is an irreversible action. Once you lock a bucket:
+ *
+ * - You cannot remove the retention policy from the bucket. - You cannot decrease the
+ * retention period for the policy.
+ *
+ * Once locked, you must delete the entire bucket in order to remove the bucket's retention
+ * policy. However, before you can delete the bucket, you must delete all the objects in the
+ * bucket, which is only possible if all the objects have reached the retention period set by the
+ * retention policy.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.buckets.update` IAM permission on the bucket.
*
* Sample code:
*
@@ -1212,7 +1452,21 @@ public final Bucket lockBucketRetentionPolicy(String bucket) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Locks retention policy on a bucket.
+ * Permanently locks the retention policy that is currently applied to the specified bucket.
+ *
+ * Caution: Locking a bucket is an irreversible action. Once you lock a bucket:
+ *
+ * - You cannot remove the retention policy from the bucket. - You cannot decrease the
+ * retention period for the policy.
+ *
+ * Once locked, you must delete the entire bucket in order to remove the bucket's retention
+ * policy. However, before you can delete the bucket, you must delete all the objects in the
+ * bucket, which is only possible if all the objects have reached the retention period set by the
+ * retention policy.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.buckets.update` IAM permission on the bucket.
*
* Sample code:
*
@@ -1241,7 +1495,21 @@ public final Bucket lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest r
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Locks retention policy on a bucket.
+ * Permanently locks the retention policy that is currently applied to the specified bucket.
+ *
+ * Caution: Locking a bucket is an irreversible action. Once you lock a bucket:
+ *
+ * - You cannot remove the retention policy from the bucket. - You cannot decrease the
+ * retention period for the policy.
+ *
+ * Once locked, you must delete the entire bucket in order to remove the bucket's retention
+ * policy. However, before you can delete the bucket, you must delete all the objects in the
+ * bucket, which is only possible if all the objects have reached the retention period set by the
+ * retention policy.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.buckets.update` IAM permission on the bucket.
*
* Sample code:
*
@@ -1271,10 +1539,15 @@ public final Bucket lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest r
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Gets the IAM policy for a specified bucket. The `resource` field in the request should be
- * `projects/_/buckets/{bucket}` for a bucket, or
+ * Gets the IAM policy for a specified bucket or managed folder. The `resource` field in the
+ * request should be `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
*
+ * **IAM Permissions**:
+ *
+ * Requires `storage.buckets.getIamPolicy` on the bucket or
+ * `storage.managedFolders.getIamPolicy` IAM permission on the managed folder.
+ *
* Sample code:
*
* **IAM Permissions**:
+ *
+ * Requires `storage.buckets.getIamPolicy` on the bucket or
+ * `storage.managedFolders.getIamPolicy` IAM permission on the managed folder.
+ *
* Sample code:
*
* **IAM Permissions**:
+ *
+ * Requires `storage.buckets.getIamPolicy` on the bucket or
+ * `storage.managedFolders.getIamPolicy` IAM permission on the managed folder.
+ *
* Sample code:
*
* **IAM Permissions**:
+ *
+ * Requires `storage.buckets.getIamPolicy` on the bucket or
+ * `storage.managedFolders.getIamPolicy` IAM permission on the managed folder.
+ *
* Sample code:
*
* Sample code:
@@ -1437,8 +1725,8 @@ public final Policy setIamPolicy(ResourceName resource, Policy policy) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Updates an IAM policy for the specified bucket. The `resource` field in the request should be
- * `projects/_/buckets/{bucket}` for a bucket, or
+ * Updates an IAM policy for the specified bucket or managed folder. The `resource` field in the
+ * request should be `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
*
* Sample code:
@@ -1472,8 +1760,8 @@ public final Policy setIamPolicy(String resource, Policy policy) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Updates an IAM policy for the specified bucket. The `resource` field in the request should be
- * `projects/_/buckets/{bucket}` for a bucket, or
+ * Updates an IAM policy for the specified bucket or managed folder. The `resource` field in the
+ * request should be `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
*
* Sample code:
@@ -1506,8 +1794,8 @@ public final Policy setIamPolicy(SetIamPolicyRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Updates an IAM policy for the specified bucket. The `resource` field in the request should be
- * `projects/_/buckets/{bucket}` for a bucket, or
+ * Updates an IAM policy for the specified bucket or managed folder. The `resource` field in the
+ * request should be `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
*
* Sample code:
@@ -1692,7 +1980,16 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+ * Updates a bucket. Changes to the bucket are readable immediately after writing, but
+ * configuration changes might take time to propagate. This method supports `patch` semantics.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.buckets.update` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To set bucket IP filtering rules: `storage.buckets.setIpFilter` - To update public access
+ * prevention policies or access control lists (ACLs): `storage.buckets.setIamPolicy`
*
* Sample code:
*
@@ -1709,12 +2006,12 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
* }
* } To specify ALL fields, equivalent to the JSON API's "update" function, specify a single
* field with the value `*`. Note: not recommended. If a new field is introduced at a
- * later time, an older client updating with the `*` may accidentally reset the new
+ * later time, an older client updating with the `*` might accidentally reset the new
* field's value.
* Not specifying any fields is an error.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -1727,7 +2024,16 @@ public final Bucket updateBucket(Bucket bucket, FieldMask updateMask) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+ * Updates a bucket. Changes to the bucket are readable immediately after writing, but
+ * configuration changes might take time to propagate. This method supports `patch` semantics.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.buckets.update` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To set bucket IP filtering rules: `storage.buckets.setIpFilter` - To update public access
+ * prevention policies or access control lists (ACLs): `storage.buckets.setIamPolicy`
*
* Sample code:
*
@@ -1760,7 +2066,16 @@ public final Bucket updateBucket(UpdateBucketRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+ * Updates a bucket. Changes to the bucket are readable immediately after writing, but
+ * configuration changes might take time to propagate. This method supports `patch` semantics.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.buckets.update` IAM permission on the bucket. Additionally, to enable
+ * specific bucket features, the authenticated user must have the following permissions:
+ *
+ * - To set bucket IP filtering rules: `storage.buckets.setIpFilter` - To update public access
+ * prevention policies or access control lists (ACLs): `storage.buckets.setIamPolicy`
*
* Sample code:
*
@@ -1792,7 +2107,16 @@ public final UnaryCallable **IAM Permissions**:
+ *
+ * Requires the `storage.objects.create` and `storage.objects.get` IAM permissions to use this
+ * method. If the new composite object overwrites an existing object, the authenticated user must
+ * also have the `storage.objects.delete` permission. If the request body includes the retention
+ * property, the authenticated user must also have the `storage.objects.setRetention` IAM
+ * permission.
*
* Sample code:
*
@@ -1829,7 +2153,16 @@ public final Object composeObject(ComposeObjectRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Concatenates a list of existing objects into a new object in the same bucket.
+ * Concatenates a list of existing objects into a new object in the same bucket. The existing
+ * source objects are unaffected by this operation.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires the `storage.objects.create` and `storage.objects.get` IAM permissions to use this
+ * method. If the new composite object overwrites an existing object, the authenticated user must
+ * also have the `storage.objects.delete` permission. If the request body includes the retention
+ * property, the authenticated user must also have the `storage.objects.setRetention` IAM
+ * permission.
*
* Sample code:
*
@@ -1866,20 +2199,18 @@ public final UnaryCallable You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
* soft-deleted objects until the soft delete retention period has passed.
*
* **IAM Permissions**:
*
- * Requires `storage.objects.delete` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+ * Requires `storage.objects.delete` IAM permission on the bucket.
*
* Sample code:
*
@@ -1913,20 +2244,18 @@ public final void deleteObject(BucketName bucket, String object) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
- * the bucket, or if the generation parameter is used, or if [soft
- * delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When
- * this API is used to delete an object from a bucket that has soft delete policy enabled, the
- * object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set
- * on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted
- * objects are permanently deleted according to their `hardDeleteTime`.
+ * the bucket, or if the generation parameter is used, or if soft delete is not enabled for the
+ * bucket. When this API is used to delete an object from a bucket that has soft delete policy
+ * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime`
+ * properties are set on the object. This API cannot be used to permanently delete soft-deleted
+ * objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`.
*
* You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
* soft-deleted objects until the soft delete retention period has passed.
*
* **IAM Permissions**:
*
- * Requires `storage.objects.delete` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+ * Requires `storage.objects.delete` IAM permission on the bucket.
*
* Sample code:
*
@@ -1957,20 +2286,18 @@ public final void deleteObject(String bucket, String object) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
- * the bucket, or if the generation parameter is used, or if [soft
- * delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When
- * this API is used to delete an object from a bucket that has soft delete policy enabled, the
- * object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set
- * on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted
- * objects are permanently deleted according to their `hardDeleteTime`.
+ * the bucket, or if the generation parameter is used, or if soft delete is not enabled for the
+ * bucket. When this API is used to delete an object from a bucket that has soft delete policy
+ * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime`
+ * properties are set on the object. This API cannot be used to permanently delete soft-deleted
+ * objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`.
*
* You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
* soft-deleted objects until the soft delete retention period has passed.
*
* **IAM Permissions**:
*
- * Requires `storage.objects.delete` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+ * Requires `storage.objects.delete` IAM permission on the bucket.
*
* Sample code:
*
@@ -2008,20 +2335,18 @@ public final void deleteObject(BucketName bucket, String object, long generation
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
- * the bucket, or if the generation parameter is used, or if [soft
- * delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When
- * this API is used to delete an object from a bucket that has soft delete policy enabled, the
- * object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set
- * on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted
- * objects are permanently deleted according to their `hardDeleteTime`.
+ * the bucket, or if the generation parameter is used, or if soft delete is not enabled for the
+ * bucket. When this API is used to delete an object from a bucket that has soft delete policy
+ * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime`
+ * properties are set on the object. This API cannot be used to permanently delete soft-deleted
+ * objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`.
*
* You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
* soft-deleted objects until the soft delete retention period has passed.
*
* **IAM Permissions**:
*
- * Requires `storage.objects.delete` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+ * Requires `storage.objects.delete` IAM permission on the bucket.
*
* Sample code:
*
@@ -2059,20 +2384,18 @@ public final void deleteObject(String bucket, String object, long generation) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
- * the bucket, or if the generation parameter is used, or if [soft
- * delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When
- * this API is used to delete an object from a bucket that has soft delete policy enabled, the
- * object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set
- * on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted
- * objects are permanently deleted according to their `hardDeleteTime`.
+ * the bucket, or if the generation parameter is used, or if soft delete is not enabled for the
+ * bucket. When this API is used to delete an object from a bucket that has soft delete policy
+ * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime`
+ * properties are set on the object. This API cannot be used to permanently delete soft-deleted
+ * objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`.
*
* You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
* soft-deleted objects until the soft delete retention period has passed.
*
* **IAM Permissions**:
*
- * Requires `storage.objects.delete` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+ * Requires `storage.objects.delete` IAM permission on the bucket.
*
* Sample code:
*
@@ -2108,20 +2431,18 @@ public final void deleteObject(DeleteObjectRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for
- * the bucket, or if the generation parameter is used, or if [soft
- * delete](https://cloud.google.com/storage/docs/soft-delete) is not enabled for the bucket. When
- * this API is used to delete an object from a bucket that has soft delete policy enabled, the
- * object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime` properties are set
- * on the object. This API cannot be used to permanently delete soft-deleted objects. Soft-deleted
- * objects are permanently deleted according to their `hardDeleteTime`.
+ * the bucket, or if the generation parameter is used, or if soft delete is not enabled for the
+ * bucket. When this API is used to delete an object from a bucket that has soft delete policy
+ * enabled, the object becomes soft deleted, and the `softDeleteTime` and `hardDeleteTime`
+ * properties are set on the object. This API cannot be used to permanently delete soft-deleted
+ * objects. Soft-deleted objects are permanently deleted according to their `hardDeleteTime`.
*
* You can use the [`RestoreObject`][google.storage.v2.Storage.RestoreObject] API to restore
* soft-deleted objects until the soft delete retention period has passed.
*
* **IAM Permissions**:
*
- * Requires `storage.objects.delete` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+ * Requires `storage.objects.delete` IAM permission on the bucket.
*
* Sample code:
*
@@ -2155,7 +2476,30 @@ public final UnaryCallable - The `createTime` of the new object is set to the time at which the soft-deleted object was
+ * restored. - The `softDeleteTime` and `hardDeleteTime` values are cleared. - A new generation is
+ * assigned and the metageneration is reset to 1. - If the soft-deleted object was in a bucket
+ * that had Autoclass enabled, the new object is restored to Standard storage. - The restored
+ * object inherits the bucket's default object ACL, unless `copySourceAcl` is `true`.
+ *
+ * If a live object using the same name already exists in the bucket and becomes overwritten,
+ * the live object becomes a noncurrent object if Object Versioning is enabled on the bucket. If
+ * Object Versioning is not enabled, the live object becomes soft deleted.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires the following IAM permissions to use this method:
+ *
+ * - `storage.objects.restore` - `storage.objects.create` - `storage.objects.delete` (only
+ * required if overwriting an existing object) - `storage.objects.getIamPolicy` (only required if
+ * `projection` is `full` and the relevant bucket has uniform bucket-level access disabled) -
+ * `storage.objects.setIamPolicy` (only required if `copySourceAcl` is `true` and the relevant
+ * bucket has uniform bucket-level access disabled)
*
* Sample code:
*
@@ -2190,7 +2534,30 @@ public final Object restoreObject(BucketName bucket, String object, long generat
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Restores a soft-deleted object.
+ * Restores a soft-deleted object. When a soft-deleted object is restored, a new copy of that
+ * object is created in the same bucket and inherits the same metadata as the soft-deleted object.
+ * The inherited metadata is the metadata that existed when the original object became soft
+ * deleted, with the following exceptions:
+ *
+ * - The `createTime` of the new object is set to the time at which the soft-deleted object was
+ * restored. - The `softDeleteTime` and `hardDeleteTime` values are cleared. - A new generation is
+ * assigned and the metageneration is reset to 1. - If the soft-deleted object was in a bucket
+ * that had Autoclass enabled, the new object is restored to Standard storage. - The restored
+ * object inherits the bucket's default object ACL, unless `copySourceAcl` is `true`.
+ *
+ * If a live object using the same name already exists in the bucket and becomes overwritten,
+ * the live object becomes a noncurrent object if Object Versioning is enabled on the bucket. If
+ * Object Versioning is not enabled, the live object becomes soft deleted.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires the following IAM permissions to use this method:
+ *
+ * - `storage.objects.restore` - `storage.objects.create` - `storage.objects.delete` (only
+ * required if overwriting an existing object) - `storage.objects.getIamPolicy` (only required if
+ * `projection` is `full` and the relevant bucket has uniform bucket-level access disabled) -
+ * `storage.objects.setIamPolicy` (only required if `copySourceAcl` is `true` and the relevant
+ * bucket has uniform bucket-level access disabled)
*
* Sample code:
*
@@ -2225,7 +2592,30 @@ public final Object restoreObject(String bucket, String object, long generation)
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Restores a soft-deleted object.
+ * Restores a soft-deleted object. When a soft-deleted object is restored, a new copy of that
+ * object is created in the same bucket and inherits the same metadata as the soft-deleted object.
+ * The inherited metadata is the metadata that existed when the original object became soft
+ * deleted, with the following exceptions:
+ *
+ * - The `createTime` of the new object is set to the time at which the soft-deleted object was
+ * restored. - The `softDeleteTime` and `hardDeleteTime` values are cleared. - A new generation is
+ * assigned and the metageneration is reset to 1. - If the soft-deleted object was in a bucket
+ * that had Autoclass enabled, the new object is restored to Standard storage. - The restored
+ * object inherits the bucket's default object ACL, unless `copySourceAcl` is `true`.
+ *
+ * If a live object using the same name already exists in the bucket and becomes overwritten,
+ * the live object becomes a noncurrent object if Object Versioning is enabled on the bucket. If
+ * Object Versioning is not enabled, the live object becomes soft deleted.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires the following IAM permissions to use this method:
+ *
+ * - `storage.objects.restore` - `storage.objects.create` - `storage.objects.delete` (only
+ * required if overwriting an existing object) - `storage.objects.getIamPolicy` (only required if
+ * `projection` is `full` and the relevant bucket has uniform bucket-level access disabled) -
+ * `storage.objects.setIamPolicy` (only required if `copySourceAcl` is `true` and the relevant
+ * bucket has uniform bucket-level access disabled)
*
* Sample code:
*
@@ -2262,7 +2652,30 @@ public final Object restoreObject(RestoreObjectRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Restores a soft-deleted object.
+ * Restores a soft-deleted object. When a soft-deleted object is restored, a new copy of that
+ * object is created in the same bucket and inherits the same metadata as the soft-deleted object.
+ * The inherited metadata is the metadata that existed when the original object became soft
+ * deleted, with the following exceptions:
+ *
+ * - The `createTime` of the new object is set to the time at which the soft-deleted object was
+ * restored. - The `softDeleteTime` and `hardDeleteTime` values are cleared. - A new generation is
+ * assigned and the metageneration is reset to 1. - If the soft-deleted object was in a bucket
+ * that had Autoclass enabled, the new object is restored to Standard storage. - The restored
+ * object inherits the bucket's default object ACL, unless `copySourceAcl` is `true`.
+ *
+ * If a live object using the same name already exists in the bucket and becomes overwritten,
+ * the live object becomes a noncurrent object if Object Versioning is enabled on the bucket. If
+ * Object Versioning is not enabled, the live object becomes soft deleted.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires the following IAM permissions to use this method:
+ *
+ * - `storage.objects.restore` - `storage.objects.create` - `storage.objects.delete` (only
+ * required if overwriting an existing object) - `storage.objects.getIamPolicy` (only required if
+ * `projection` is `full` and the relevant bucket has uniform bucket-level access disabled) -
+ * `storage.objects.setIamPolicy` (only required if `copySourceAcl` is `true` and the relevant
+ * bucket has uniform bucket-level access disabled)
*
* Sample code:
*
@@ -2300,10 +2713,10 @@ public final UnaryCallable Any attempts to write to the resumable upload after cancelling the upload will fail.
+ * Any attempts to write to the resumable upload after cancelling the upload fail.
*
- * The behavior for currently in progress write operations is not guaranteed - they could
- * either complete before the cancellation or fail if the cancellation completes first.
+ * The behavior for any in-progress write operations is not guaranteed; they could either
+ * complete before the cancellation or fail if the cancellation completes first.
*
* Sample code:
*
@@ -2333,10 +2746,10 @@ public final CancelResumableWriteResponse cancelResumableWrite(String uploadId)
/**
* Cancels an in-progress resumable upload.
*
- * Any attempts to write to the resumable upload after cancelling the upload will fail.
+ * Any attempts to write to the resumable upload after cancelling the upload fail.
*
- * The behavior for currently in progress write operations is not guaranteed - they could
- * either complete before the cancellation or fail if the cancellation completes first.
+ * The behavior for any in-progress write operations is not guaranteed; they could either
+ * complete before the cancellation or fail if the cancellation completes first.
*
* Sample code:
*
@@ -2365,10 +2778,10 @@ public final CancelResumableWriteResponse cancelResumableWrite(
/**
* Cancels an in-progress resumable upload.
*
- * Any attempts to write to the resumable upload after cancelling the upload will fail.
+ * Any attempts to write to the resumable upload after cancelling the upload fail.
*
- * The behavior for currently in progress write operations is not guaranteed - they could
- * either complete before the cancellation or fail if the cancellation completes first.
+ * The behavior for any in-progress write operations is not guaranteed; they could either
+ * complete before the cancellation or fail if the cancellation completes first.
*
* Sample code:
*
@@ -2399,10 +2812,8 @@ public final CancelResumableWriteResponse cancelResumableWrite(
*
* **IAM Permissions**:
*
- * Requires `storage.objects.get` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
- * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
- * permission.
+ * Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+ * authenticated user must also have the `storage.objects.getIamPolicy` permission.
*
* Sample code:
*
@@ -2438,10 +2849,8 @@ public final Object getObject(BucketName bucket, String object) {
*
* **IAM Permissions**:
*
- * Requires `storage.objects.get` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
- * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
- * permission.
+ * Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+ * authenticated user must also have the `storage.objects.getIamPolicy` permission.
*
* Sample code:
*
@@ -2474,10 +2883,8 @@ public final Object getObject(String bucket, String object) {
*
* **IAM Permissions**:
*
- * Requires `storage.objects.get` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
- * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
- * permission.
+ * Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+ * authenticated user must also have the `storage.objects.getIamPolicy` permission.
*
* Sample code:
*
@@ -2517,10 +2924,8 @@ public final Object getObject(BucketName bucket, String object, long generation)
*
* **IAM Permissions**:
*
- * Requires `storage.objects.get` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
- * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
- * permission.
+ * Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+ * authenticated user must also have the `storage.objects.getIamPolicy` permission.
*
* Sample code:
*
@@ -2560,10 +2965,8 @@ public final Object getObject(String bucket, String object, long generation) {
*
* **IAM Permissions**:
*
- * Requires `storage.objects.get` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
- * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
- * permission.
+ * Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+ * authenticated user must also have the `storage.objects.getIamPolicy` permission.
*
* Sample code:
*
@@ -2605,10 +3008,8 @@ public final Object getObject(GetObjectRequest request) {
*
* **IAM Permissions**:
*
- * Requires `storage.objects.get` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket. To return
- * object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
- * permission.
+ * Requires `storage.objects.get` IAM permission on the bucket. To return object ACLs, the
+ * authenticated user must also have the `storage.objects.getIamPolicy` permission.
*
* Sample code:
*
@@ -2649,8 +3050,7 @@ public final UnaryCallable **IAM Permissions**:
*
- * Requires `storage.objects.get` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+ * Requires `storage.objects.get` IAM permission on the bucket.
*
* Sample code:
*
@@ -2690,20 +3090,15 @@ public final ServerStreamingCallable This is a bi-directional API with the added support for reading multiple ranges within one
- * stream both within and across multiple messages. If the server encountered an error for any of
- * the inputs, the stream will be closed with the relevant error code. Because the API allows for
- * multiple outstanding requests, when the stream is closed the error response will contain a
- * BidiReadObjectRangesError proto in the error extension describing the error for each
- * outstanding read_id.
+ * This bi-directional API reads data from an object, allowing you to request multiple data
+ * ranges within a single stream, even across several messages. If an error occurs with any
+ * request, the stream closes with a relevant error code. Since you can have multiple outstanding
+ * requests, the error response includes a `BidiReadObjectRangesError` field detailing the
+ * specific error for each pending `read_id`.
*
* **IAM Permissions**:
*
- * Requires `storage.objects.get`
- *
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
- *
- * This API is currently in preview and is not yet available for general use.
+ * Requires `storage.objects.get` IAM permission on the bucket.
*
* Sample code:
*
@@ -2735,7 +3130,11 @@ public final ServerStreamingCallable **IAM Permissions**:
+ *
+ * Requires `storage.objects.update` IAM permission on the bucket.
*
* Sample code:
*
@@ -2759,7 +3158,7 @@ public final ServerStreamingCallable To specify ALL fields, equivalent to the JSON API's "update" function, specify a single
* field with the value `*`. Note: not recommended. If a new field is introduced at a
- * later time, an older client updating with the `*` may accidentally reset the new
+ * later time, an older client updating with the `*` might accidentally reset the new
* field's value.
* Not specifying any fields is an error.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -2772,7 +3171,11 @@ public final Object updateObject(Object object, FieldMask updateMask) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Updates an object's metadata. Equivalent to JSON API's storage.objects.patch.
+ * Updates an object's metadata. Equivalent to JSON API's `storage.objects.patch` method.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.objects.update` IAM permission on the bucket.
*
* Sample code:
*
@@ -2808,7 +3211,11 @@ public final Object updateObject(UpdateObjectRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Updates an object's metadata. Equivalent to JSON API's storage.objects.patch.
+ * Updates an object's metadata. Equivalent to JSON API's `storage.objects.patch` method.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires `storage.objects.update` IAM permission on the bucket.
*
* Sample code:
*
@@ -2855,45 +3262,45 @@ public final UnaryCallable The service will not view the object as complete until the client has sent a
+ * the server), the client should do as follows:
+ *
+ * - Check the result Status of the stream, to determine if writing can be resumed on this
+ * stream or must be restarted from scratch (by calling `StartResumableWrite()`). The resumable
+ * errors are `DEADLINE_EXCEEDED`, `INTERNAL`, and `UNAVAILABLE`. For each case, the client should
+ * use binary exponential backoff before retrying. Additionally, writes can be resumed after
+ * `RESOURCE_EXHAUSTED` errors, but only after taking appropriate measures, which might include
+ * reducing aggregate send rate across clients and/or requesting a quota increase for your
+ * project. - If the call to `WriteObject` returns `ABORTED`, that indicates concurrent attempts
+ * to update the resumable write, caused either by multiple racing clients or by a single client
+ * where the previous request was timed out on the client side but nonetheless reached the server.
+ * In this case the client should take steps to prevent further concurrent writes. For example,
+ * increase the timeouts and stop using more than one process to perform the upload. Follow the
+ * steps below for resuming the upload. - For resumable errors, the client should call
+ * `QueryWriteStatus()` and then continue writing from the returned `persisted_size`. This might
+ * be less than the amount of data the client previously sent. Note also that it is acceptable to
+ * send data starting at an offset earlier than the returned `persisted_size`; in this case, the
+ * service skips data at offsets that were already persisted (without checking that it matches the
+ * previously written data), and write only the data starting from the persisted offset. Even
+ * though the data isn't written, it might still incur a performance cost over resuming at the
+ * correct write offset. This behavior can make client-side handling simpler in some cases. -
+ * Clients must only send data that is a multiple of 256 KiB per message, unless the object is
+ * being finished with `finish_write` set to `true`.
+ *
+ * The service does not view the object as complete until the client has sent a
* `WriteObjectRequest` with `finish_write` set to `true`. Sending any requests on a stream after
- * sending a request with `finish_write` set to `true` will cause an error. The client
- * **should** check the response it receives to determine how much data the
- * service was able to commit and whether the service views the object as complete.
+ * sending a request with `finish_write` set to `true` causes an error. The client must check the
+ * response it receives to determine how much data the service is able to commit and whether the
+ * service views the object as complete.
*
- * Attempting to resume an already finalized object will result in an OK status, with a
+ * Attempting to resume an already finalized object results in an `OK` status, with a
* `WriteObjectResponse` containing the finalized object's metadata.
*
- * Alternatively, the BidiWriteObject operation may be used to write an object with controls
+ * Alternatively, you can use the `BidiWriteObject` operation to write an object with controls
* over flushing and the ability to fetch the ability to determine the current persisted size.
*
* **IAM Permissions**:
*
- * Requires `storage.objects.create` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+ * Requires `storage.objects.create` IAM permission on the bucket.
*
* Sample code:
*
@@ -2943,18 +3350,18 @@ public final UnaryCallable This is similar to the WriteObject call with the added support for manual flushing of
+ * This is similar to the `WriteObject` call with the added support for manual flushing of
* persisted state, and the ability to determine current persisted size without closing the
* stream.
*
- * The client may specify one or both of the `state_lookup` and `flush` fields in each
- * BidiWriteObjectRequest. If `flush` is specified, the data written so far will be persisted to
- * storage. If `state_lookup` is specified, the service will respond with a
- * BidiWriteObjectResponse that contains the persisted size. If both `flush` and `state_lookup`
- * are specified, the flush will always occur before a `state_lookup`, so that both may be set in
- * the same request and the returned state will be the state of the object post-flush. When the
- * stream is closed, a BidiWriteObjectResponse will always be sent to the client, regardless of
- * the value of `state_lookup`.
+ * The client might specify one or both of the `state_lookup` and `flush` fields in each
+ * `BidiWriteObjectRequest`. If `flush` is specified, the data written so far is persisted to
+ * storage. If `state_lookup` is specified, the service responds with a `BidiWriteObjectResponse`
+ * that contains the persisted size. If both `flush` and `state_lookup` are specified, the flush
+ * always occurs before a `state_lookup`, so that both might be set in the same request and the
+ * returned state is the state of the object post-flush. When the stream is closed, a
+ * `BidiWriteObjectResponse` is always sent to the client, regardless of the value of
+ * `state_lookup`.
*
* Sample code:
*
@@ -2994,8 +3401,7 @@ public final UnaryCallable **IAM Permissions**:
*
- * The authenticated user requires `storage.objects.list` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To
+ * The authenticated user requires `storage.objects.list` IAM permission to use this method. To
* return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
* permission.
*
@@ -3032,8 +3438,7 @@ public final ListObjectsPagedResponse listObjects(BucketName parent) {
*
* **IAM Permissions**:
*
- * The authenticated user requires `storage.objects.list` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To
+ * The authenticated user requires `storage.objects.list` IAM permission to use this method. To
* return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
* permission.
*
@@ -3067,8 +3472,7 @@ public final ListObjectsPagedResponse listObjects(String parent) {
*
* **IAM Permissions**:
*
- * The authenticated user requires `storage.objects.list` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To
+ * The authenticated user requires `storage.objects.list` IAM permission to use this method. To
* return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
* permission.
*
@@ -3117,8 +3521,7 @@ public final ListObjectsPagedResponse listObjects(ListObjectsRequest request) {
*
* **IAM Permissions**:
*
- * The authenticated user requires `storage.objects.list` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To
+ * The authenticated user requires `storage.objects.list` IAM permission to use this method. To
* return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
* permission.
*
@@ -3167,8 +3570,7 @@ public final ListObjectsPagedResponse listObjects(ListObjectsRequest request) {
*
* **IAM Permissions**:
*
- * The authenticated user requires `storage.objects.list` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) to use this method. To
+ * The authenticated user requires `storage.objects.list` IAM permission to use this method. To
* return object ACLs, the authenticated user must also have the `storage.objects.getIamPolicy`
* permission.
*
@@ -3322,16 +3724,14 @@ public final UnaryCallable **IAM Permissions**:
*
- * Requires `storage.objects.create` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+ * Requires `storage.objects.create` IAM permission on the bucket.
*
* Sample code:
*
@@ -3361,16 +3761,14 @@ public final StartResumableWriteResponse startResumableWrite(StartResumableWrite
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Starts a resumable write operation. This method is part of the [Resumable
- * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. This allows you to
- * upload large objects in multiple chunks, which is more resilient to network interruptions than
- * a single upload. The validity duration of the write operation, and the consequences of it
- * becoming invalid, are service-dependent.
+ * Starts a resumable write operation. This method is part of the Resumable upload feature. This
+ * allows you to upload large objects in multiple chunks, which is more resilient to network
+ * interruptions than a single upload. The validity duration of the write operation, and the
+ * consequences of it becoming invalid, are service-dependent.
*
* **IAM Permissions**:
*
- * Requires `storage.objects.create` [IAM
- * permission](https://cloud.google.com/iam/docs/overview#permissions) on the bucket.
+ * Requires `storage.objects.create` IAM permission on the bucket.
*
* Sample code:
*
@@ -3402,9 +3800,8 @@ public final StartResumableWriteResponse startResumableWrite(StartResumableWrite
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Determines the `persisted_size` of an object that is being written. This method is part of the
- * [resumable upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. The
- * returned value is the size of the object that has been persisted so far. The value can be used
- * as the `write_offset` for the next `Write()` call.
+ * resumable upload feature. The returned value is the size of the object that has been persisted
+ * so far. The value can be used as the `write_offset` for the next `Write()` call.
*
* If the object does not exist, meaning if it was deleted, or the first `Write()` has not yet
* reached the service, this method returns the error `NOT_FOUND`.
@@ -3441,9 +3838,8 @@ public final QueryWriteStatusResponse queryWriteStatus(String uploadId) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Determines the `persisted_size` of an object that is being written. This method is part of the
- * [resumable upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. The
- * returned value is the size of the object that has been persisted so far. The value can be used
- * as the `write_offset` for the next `Write()` call.
+ * resumable upload feature. The returned value is the size of the object that has been persisted
+ * so far. The value can be used as the `write_offset` for the next `Write()` call.
*
* If the object does not exist, meaning if it was deleted, or the first `Write()` has not yet
* reached the service, this method returns the error `NOT_FOUND`.
@@ -3481,9 +3877,8 @@ public final QueryWriteStatusResponse queryWriteStatus(QueryWriteStatusRequest r
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Determines the `persisted_size` of an object that is being written. This method is part of the
- * [resumable upload](https://cloud.google.com/storage/docs/resumable-uploads) feature. The
- * returned value is the size of the object that has been persisted so far. The value can be used
- * as the `write_offset` for the next `Write()` call.
+ * resumable upload feature. The returned value is the size of the object that has been persisted
+ * so far. The value can be used as the `write_offset` for the next `Write()` call.
*
* If the object does not exist, meaning if it was deleted, or the first `Write()` has not yet
* reached the service, this method returns the error `NOT_FOUND`.
@@ -3521,7 +3916,17 @@ public final QueryWriteStatusResponse queryWriteStatus(QueryWriteStatusRequest r
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Moves the source object to the destination object in the same bucket.
+ * Moves the source object to the destination object in the same bucket. This operation moves a
+ * source object to a destination object in the same bucket by renaming the object. The move
+ * itself is an atomic transaction, ensuring all steps either complete successfully or no changes
+ * are made.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires the following IAM permissions to use this method:
+ *
+ * - `storage.objects.move` - `storage.objects.create` - `storage.objects.delete` (only
+ * required if overwriting an existing object)
*
* Sample code:
*
@@ -3556,7 +3961,17 @@ public final Object moveObject(BucketName bucket, String sourceObject, String de
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Moves the source object to the destination object in the same bucket.
+ * Moves the source object to the destination object in the same bucket. This operation moves a
+ * source object to a destination object in the same bucket by renaming the object. The move
+ * itself is an atomic transaction, ensuring all steps either complete successfully or no changes
+ * are made.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires the following IAM permissions to use this method:
+ *
+ * - `storage.objects.move` - `storage.objects.create` - `storage.objects.delete` (only
+ * required if overwriting an existing object)
*
* Sample code:
*
@@ -3591,7 +4006,17 @@ public final Object moveObject(String bucket, String sourceObject, String destin
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Moves the source object to the destination object in the same bucket.
+ * Moves the source object to the destination object in the same bucket. This operation moves a
+ * source object to a destination object in the same bucket by renaming the object. The move
+ * itself is an atomic transaction, ensuring all steps either complete successfully or no changes
+ * are made.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires the following IAM permissions to use this method:
+ *
+ * - `storage.objects.move` - `storage.objects.create` - `storage.objects.delete` (only
+ * required if overwriting an existing object)
*
* Sample code:
*
@@ -3629,7 +4054,17 @@ public final Object moveObject(MoveObjectRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Moves the source object to the destination object in the same bucket.
+ * Moves the source object to the destination object in the same bucket. This operation moves a
+ * source object to a destination object in the same bucket by renaming the object. The move
+ * itself is an atomic transaction, ensuring all steps either complete successfully or no changes
+ * are made.
+ *
+ * **IAM Permissions**:
+ *
+ * Requires the following IAM permissions to use this method:
+ *
+ * - `storage.objects.move` - `storage.objects.create` - `storage.objects.delete` (only
+ * required if overwriting an existing object)
*
* Sample code:
*
diff --git a/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/package-info.java b/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/package-info.java
index c250e90f8c..cd43b211c7 100644
--- a/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/package-info.java
+++ b/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/package-info.java
@@ -24,18 +24,21 @@
* Service Description: ## API Overview and Naming Syntax
*
* The Cloud Storage gRPC API allows applications to read and write data through the abstractions
- * of buckets and objects. For a description of these abstractions please see
- * https://cloud.google.com/storage/docs.
- *
- * Resources are named as follows: - Projects are referred to as they are defined by the Resource
- * Manager API, using strings like `projects/123456` or `projects/my-string-id`. - Buckets are named
- * using string names of the form: `projects/{project}/buckets/{bucket}` For globally unique
- * buckets, `_` may be substituted for the project. - Objects are uniquely identified by their name
- * along with the name of the bucket they belong to, as separate strings in this API. For example:
- *
- * ReadObjectRequest { bucket: 'projects/_/buckets/my-bucket' object: 'my-object' } Note that
- * object names can contain `/` characters, which are treated as any other character (no special
- * directory semantics).
+ * of buckets and objects. For a description of these abstractions please see [Cloud Storage
+ * documentation](https://cloud.google.com/storage/docs).
+ *
+ * Resources are named as follows:
+ *
+ * - Projects are referred to as they are defined by the Resource Manager API, using strings like
+ * `projects/123456` or `projects/my-string-id`. - Buckets are named using string names of the form:
+ * `projects/{project}/buckets/{bucket}`. For globally unique buckets, `_` might be substituted for
+ * the project. - Objects are uniquely identified by their name along with the name of the bucket
+ * they belong to, as separate strings in this API. For example:
+ *
+ * ``` ReadObjectRequest { bucket: 'projects/_/buckets/my-bucket' object: 'my-object' } ```
+ *
+ * Note that object names can contain `/` characters, which are treated as any other character
+ * (no special directory semantics).
*
* Sample for StorageClient:
*
diff --git a/generation_config.yaml b/generation_config.yaml
index 80b7630256..4cc603a6f5 100644
--- a/generation_config.yaml
+++ b/generation_config.yaml
@@ -1,5 +1,5 @@
-gapic_generator_version: 2.63.0
-googleapis_commitish: 72e7439c8e7e9986cf1865e337fc7c64ca5bda1f
+gapic_generator_version: 2.64.1
+googleapis_commitish: 1b5f8632487bce889ce05366647addc6ef5ee36d
libraries_bom_version: 26.71.0
libraries:
- api_shortname: storage
diff --git a/grpc-google-cloud-storage-control-v2/src/main/java/com/google/storage/control/v2/StorageControlGrpc.java b/grpc-google-cloud-storage-control-v2/src/main/java/com/google/storage/control/v2/StorageControlGrpc.java
index a96d0106b1..ca0f2beb42 100644
--- a/grpc-google-cloud-storage-control-v2/src/main/java/com/google/storage/control/v2/StorageControlGrpc.java
+++ b/grpc-google-cloud-storage-control-v2/src/main/java/com/google/storage/control/v2/StorageControlGrpc.java
@@ -24,9 +24,6 @@
* StorageControl service includes selected control plane operations.
* {@code
@@ -753,6 +862,14 @@ public final Bucket getBucket(BucketName name) {
/**
* Returns metadata for the specified bucket.
*
+ *
*/
public com.google.protobuf.Empty deleteManagedFolder(
- com.google.storage.control.v2.DeleteManagedFolderRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.DeleteManagedFolderRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getDeleteManagedFolderMethod(), getCallOptions(), request);
}
@@ -2344,8 +2344,9 @@ public com.google.protobuf.Empty deleteManagedFolder(
*
*/
public com.google.storage.control.v2.ManagedFolder getManagedFolder(
- com.google.storage.control.v2.GetManagedFolderRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.GetManagedFolderRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getGetManagedFolderMethod(), getCallOptions(), request);
}
@@ -2357,8 +2358,9 @@ public com.google.storage.control.v2.ManagedFolder getManagedFolder(
*
*/
public com.google.storage.control.v2.ListManagedFoldersResponse listManagedFolders(
- com.google.storage.control.v2.ListManagedFoldersRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.ListManagedFoldersRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getListManagedFoldersMethod(), getCallOptions(), request);
}
@@ -2370,8 +2372,9 @@ public com.google.storage.control.v2.ListManagedFoldersResponse listManagedFolde
*
*/
public com.google.longrunning.Operation createAnywhereCache(
- com.google.storage.control.v2.CreateAnywhereCacheRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.CreateAnywhereCacheRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getCreateAnywhereCacheMethod(), getCallOptions(), request);
}
@@ -2384,8 +2387,9 @@ public com.google.longrunning.Operation createAnywhereCache(
*
*/
public com.google.longrunning.Operation updateAnywhereCache(
- com.google.storage.control.v2.UpdateAnywhereCacheRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.UpdateAnywhereCacheRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getUpdateAnywhereCacheMethod(), getCallOptions(), request);
}
@@ -2400,8 +2404,9 @@ public com.google.longrunning.Operation updateAnywhereCache(
*
*/
public com.google.storage.control.v2.AnywhereCache disableAnywhereCache(
- com.google.storage.control.v2.DisableAnywhereCacheRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.DisableAnywhereCacheRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getDisableAnywhereCacheMethod(), getCallOptions(), request);
}
@@ -2413,8 +2418,9 @@ public com.google.storage.control.v2.AnywhereCache disableAnywhereCache(
*
*/
public com.google.storage.control.v2.AnywhereCache pauseAnywhereCache(
- com.google.storage.control.v2.PauseAnywhereCacheRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.PauseAnywhereCacheRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getPauseAnywhereCacheMethod(), getCallOptions(), request);
}
@@ -2426,8 +2432,9 @@ public com.google.storage.control.v2.AnywhereCache pauseAnywhereCache(
*
*/
public com.google.storage.control.v2.AnywhereCache resumeAnywhereCache(
- com.google.storage.control.v2.ResumeAnywhereCacheRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.ResumeAnywhereCacheRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getResumeAnywhereCacheMethod(), getCallOptions(), request);
}
@@ -2439,8 +2446,9 @@ public com.google.storage.control.v2.AnywhereCache resumeAnywhereCache(
*
*/
public com.google.storage.control.v2.AnywhereCache getAnywhereCache(
- com.google.storage.control.v2.GetAnywhereCacheRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.GetAnywhereCacheRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getGetAnywhereCacheMethod(), getCallOptions(), request);
}
@@ -2452,8 +2460,9 @@ public com.google.storage.control.v2.AnywhereCache getAnywhereCache(
*
*/
public com.google.storage.control.v2.ListAnywhereCachesResponse listAnywhereCaches(
- com.google.storage.control.v2.ListAnywhereCachesRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.ListAnywhereCachesRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getListAnywhereCachesMethod(), getCallOptions(), request);
}
@@ -2465,8 +2474,9 @@ public com.google.storage.control.v2.ListAnywhereCachesResponse listAnywhereCach
*
*/
public com.google.storage.control.v2.IntelligenceConfig getProjectIntelligenceConfig(
- com.google.storage.control.v2.GetProjectIntelligenceConfigRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.GetProjectIntelligenceConfigRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getGetProjectIntelligenceConfigMethod(), getCallOptions(), request);
}
@@ -2478,8 +2488,9 @@ public com.google.storage.control.v2.IntelligenceConfig getProjectIntelligenceCo
*
*/
public com.google.storage.control.v2.IntelligenceConfig updateProjectIntelligenceConfig(
- com.google.storage.control.v2.UpdateProjectIntelligenceConfigRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.UpdateProjectIntelligenceConfigRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getUpdateProjectIntelligenceConfigMethod(), getCallOptions(), request);
}
@@ -2491,8 +2502,9 @@ public com.google.storage.control.v2.IntelligenceConfig updateProjectIntelligenc
*
*/
public com.google.storage.control.v2.IntelligenceConfig getFolderIntelligenceConfig(
- com.google.storage.control.v2.GetFolderIntelligenceConfigRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.GetFolderIntelligenceConfigRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getGetFolderIntelligenceConfigMethod(), getCallOptions(), request);
}
@@ -2504,8 +2516,9 @@ public com.google.storage.control.v2.IntelligenceConfig getFolderIntelligenceCon
*
*/
public com.google.storage.control.v2.IntelligenceConfig updateFolderIntelligenceConfig(
- com.google.storage.control.v2.UpdateFolderIntelligenceConfigRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.UpdateFolderIntelligenceConfigRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getUpdateFolderIntelligenceConfigMethod(), getCallOptions(), request);
}
@@ -2517,8 +2530,9 @@ public com.google.storage.control.v2.IntelligenceConfig updateFolderIntelligence
*
*/
public com.google.storage.control.v2.IntelligenceConfig getOrganizationIntelligenceConfig(
- com.google.storage.control.v2.GetOrganizationIntelligenceConfigRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.GetOrganizationIntelligenceConfigRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getGetOrganizationIntelligenceConfigMethod(), getCallOptions(), request);
}
@@ -2530,8 +2544,9 @@ public com.google.storage.control.v2.IntelligenceConfig getOrganizationIntellige
*
*/
public com.google.storage.control.v2.IntelligenceConfig updateOrganizationIntelligenceConfig(
- com.google.storage.control.v2.UpdateOrganizationIntelligenceConfigRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.UpdateOrganizationIntelligenceConfigRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getUpdateOrganizationIntelligenceConfigMethod(), getCallOptions(), request);
}
@@ -2546,8 +2561,9 @@ public com.google.storage.control.v2.IntelligenceConfig updateOrganizationIntell
* for a managed folder.
*
*/
- public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getGetIamPolicyMethod(), getCallOptions(), request);
}
@@ -2562,8 +2578,9 @@ public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyReque
* for a managed folder.
*
*/
- public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getSetIamPolicyMethod(), getCallOptions(), request);
}
@@ -2581,8 +2598,8 @@ public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyReque
*
*/
public com.google.iam.v1.TestIamPermissionsResponse testIamPermissions(
- com.google.iam.v1.TestIamPermissionsRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.iam.v1.TestIamPermissionsRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getTestIamPermissionsMethod(), getCallOptions(), request);
}
}
diff --git a/grpc-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageGrpc.java b/grpc-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageGrpc.java
index b68ebe1294..bdccd24c96 100644
--- a/grpc-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageGrpc.java
+++ b/grpc-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageGrpc.java
@@ -24,26 +24,26 @@
* ## API Overview and Naming Syntax
* The Cloud Storage gRPC API allows applications to read and write data through
* the abstractions of buckets and objects. For a description of these
- * abstractions please see https://cloud.google.com/storage/docs.
+ * abstractions please see [Cloud Storage
+ * documentation](https://cloud.google.com/storage/docs).
* Resources are named as follows:
* - Projects are referred to as they are defined by the Resource Manager API,
* using strings like `projects/123456` or `projects/my-string-id`.
* - Buckets are named using string names of the form:
- * `projects/{project}/buckets/{bucket}`
- * For globally unique buckets, `_` may be substituted for the project.
+ * `projects/{project}/buckets/{bucket}`.
+ * For globally unique buckets, `_` might be substituted for the project.
* - Objects are uniquely identified by their name along with the name of the
* bucket they belong to, as separate strings in this API. For example:
- * ReadObjectRequest {
+ * ```
+ * ReadObjectRequest {
* bucket: 'projects/_/buckets/my-bucket'
* object: 'my-object'
- * }
- * Note that object names can contain `/` characters, which are treated as
- * any other character (no special directory semantics).
+ * }
+ * ```
+ * Note that object names can contain `/` characters, which are treated as
+ * any other character (no special directory semantics).
*
*/
-@javax.annotation.Generated(
- value = "by gRPC proto compiler",
- comments = "Source: google/storage/v2/storage.proto")
@io.grpc.stub.annotations.GrpcGenerated
public final class StorageGrpc {
@@ -1103,21 +1103,24 @@ public StorageFutureStub newStub(
* ## API Overview and Naming Syntax
* The Cloud Storage gRPC API allows applications to read and write data through
* the abstractions of buckets and objects. For a description of these
- * abstractions please see https://cloud.google.com/storage/docs.
+ * abstractions please see [Cloud Storage
+ * documentation](https://cloud.google.com/storage/docs).
* Resources are named as follows:
* - Projects are referred to as they are defined by the Resource Manager API,
* using strings like `projects/123456` or `projects/my-string-id`.
* - Buckets are named using string names of the form:
- * `projects/{project}/buckets/{bucket}`
- * For globally unique buckets, `_` may be substituted for the project.
+ * `projects/{project}/buckets/{bucket}`.
+ * For globally unique buckets, `_` might be substituted for the project.
* - Objects are uniquely identified by their name along with the name of the
* bucket they belong to, as separate strings in this API. For example:
- * ReadObjectRequest {
+ * ```
+ * ReadObjectRequest {
* bucket: 'projects/_/buckets/my-bucket'
* object: 'my-object'
- * }
- * Note that object names can contain `/` characters, which are treated as
- * any other character (no special directory semantics).
+ * }
+ * ```
+ * Note that object names can contain `/` characters, which are treated as
+ * any other character (no special directory semantics).
*
*/
public interface AsyncService {
@@ -1127,6 +1130,25 @@ public interface AsyncService {
*
* {@code
@@ -779,6 +896,14 @@ public final Bucket getBucket(String name) {
/**
* Returns metadata for the specified bucket.
*
+ *
*/
public com.google.storage.control.v2.ManagedFolder createManagedFolder(
- com.google.storage.control.v2.CreateManagedFolderRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.CreateManagedFolderRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getCreateManagedFolderMethod(), getCallOptions(), request);
}
@@ -2331,8 +2330,9 @@ public com.google.storage.control.v2.ManagedFolder createManagedFolder(
* {@code
@@ -810,6 +935,14 @@ public final Bucket getBucket(GetBucketRequest request) {
/**
* Returns metadata for the specified bucket.
*
+ *
*/
public com.google.storage.control.v2.StorageLayout getStorageLayout(
- com.google.storage.control.v2.GetStorageLayoutRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.GetStorageLayoutRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getGetStorageLayoutMethod(), getCallOptions(), request);
}
@@ -2318,8 +2316,9 @@ public com.google.storage.control.v2.StorageLayout getStorageLayout(
* {@code
@@ -840,6 +973,15 @@ public final UnaryCallable
*/
public com.google.longrunning.Operation renameFolder(
- com.google.storage.control.v2.RenameFolderRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.RenameFolderRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getRenameFolderMethod(), getCallOptions(), request);
}
@@ -2305,8 +2302,9 @@ public com.google.longrunning.Operation renameFolder(
* {@code
@@ -856,17 +998,17 @@ public final UnaryCallable
*
- * @param parent Required. The project to which this bucket will belong. This field must either be
+ * @param parent Required. The project to which this bucket belongs. This field must either be
* empty or `projects/_`. The project ID that owns this bucket should be specified in the
* `bucket.project` field.
* @param bucket Optional. Properties of the new bucket being inserted. The name of the bucket is
- * specified in the `bucket_id` field. Populating `bucket.name` field will result in an error.
- * The project of the bucket must be specified in the `bucket.project` field. This field must
- * be in `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or
+ * specified in the `bucket_id` field. Populating `bucket.name` field results in an error. The
+ * project of the bucket must be specified in the `bucket.project` field. This field must be
+ * in `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or
* project number. The `parent` field must be either empty or `projects/_`.
- * @param bucketId Required. The ID to use for this bucket, which will become the final component
- * of the bucket's resource name. For example, the value `foo` might result in a bucket with
- * the name `projects/123456/buckets/foo`.
+ * @param bucketId Required. The ID to use for this bucket, which becomes the final component of
+ * the bucket's resource name. For example, the value `foo` might result in a bucket with the
+ * name `projects/123456/buckets/foo`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Bucket createBucket(ProjectName parent, Bucket bucket, String bucketId) {
@@ -883,6 +1025,15 @@ public final Bucket createBucket(ProjectName parent, Bucket bucket, String bucke
/**
* Creates a new bucket.
*
+ * {@code
@@ -899,17 +1050,17 @@ public final Bucket createBucket(ProjectName parent, Bucket bucket, String bucke
* }
* }
*
- * @param parent Required. The project to which this bucket will belong. This field must either be
+ * @param parent Required. The project to which this bucket belongs. This field must either be
* empty or `projects/_`. The project ID that owns this bucket should be specified in the
* `bucket.project` field.
* @param bucket Optional. Properties of the new bucket being inserted. The name of the bucket is
- * specified in the `bucket_id` field. Populating `bucket.name` field will result in an error.
- * The project of the bucket must be specified in the `bucket.project` field. This field must
- * be in `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or
+ * specified in the `bucket_id` field. Populating `bucket.name` field results in an error. The
+ * project of the bucket must be specified in the `bucket.project` field. This field must be
+ * in `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or
* project number. The `parent` field must be either empty or `projects/_`.
- * @param bucketId Required. The ID to use for this bucket, which will become the final component
- * of the bucket's resource name. For example, the value `foo` might result in a bucket with
- * the name `projects/123456/buckets/foo`.
+ * @param bucketId Required. The ID to use for this bucket, which becomes the final component of
+ * the bucket's resource name. For example, the value `foo` might result in a bucket with the
+ * name `projects/123456/buckets/foo`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Bucket createBucket(String parent, Bucket bucket, String bucketId) {
@@ -926,6 +1077,15 @@ public final Bucket createBucket(String parent, Bucket bucket, String bucketId)
/**
* Creates a new bucket.
*
+ * {@code
@@ -959,6 +1119,15 @@ public final Bucket createBucket(CreateBucketRequest request) {
/**
* Creates a new bucket.
*
+ *
*/
public com.google.storage.control.v2.ListFoldersResponse listFolders(
- com.google.storage.control.v2.ListFoldersRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.ListFoldersRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getListFoldersMethod(), getCallOptions(), request);
}
@@ -2292,8 +2289,8 @@ public com.google.storage.control.v2.ListFoldersResponse listFolders(
* {@code
@@ -989,7 +1158,15 @@ public final UnaryCallable
*/
public com.google.storage.control.v2.Folder getFolder(
- com.google.storage.control.v2.GetFolderRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.GetFolderRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getGetFolderMethod(), getCallOptions(), request);
}
@@ -2276,8 +2273,8 @@ public com.google.storage.control.v2.Folder getFolder(
* {@code
@@ -1304,10 +1577,15 @@ public final Policy getIamPolicy(ResourceName resource) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Gets the IAM policy for a specified bucket. The `resource` field in the request should be
- * `projects/_/buckets/{bucket}` for a bucket, or
+ * Gets the IAM policy for a specified bucket or managed folder. The `resource` field in the
+ * request should be `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
*
+ *
*/
public com.google.protobuf.Empty deleteFolder(
- com.google.storage.control.v2.DeleteFolderRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.DeleteFolderRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getDeleteFolderMethod(), getCallOptions(), request);
}
@@ -2262,8 +2259,8 @@ public com.google.protobuf.Empty deleteFolder(
* {@code
@@ -1334,10 +1612,15 @@ public final Policy getIamPolicy(String resource) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Gets the IAM policy for a specified bucket. The `resource` field in the request should be
- * `projects/_/buckets/{bucket}` for a bucket, or
+ * Gets the IAM policy for a specified bucket or managed folder. The `resource` field in the
+ * request should be `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
*
+ *
*/
public com.google.storage.control.v2.Folder createFolder(
- com.google.storage.control.v2.CreateFolderRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.control.v2.CreateFolderRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getCreateFolderMethod(), getCallOptions(), request);
}
@@ -2248,8 +2245,8 @@ public com.google.storage.control.v2.Folder createFolder(
* {@code
@@ -1367,10 +1650,15 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
- * Gets the IAM policy for a specified bucket. The `resource` field in the request should be
- * `projects/_/buckets/{bucket}` for a bucket, or
+ * Gets the IAM policy for a specified bucket or managed folder. The `resource` field in the
+ * request should be `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}` for a managed folder.
*
+ *
*/
-@javax.annotation.Generated(
- value = "by gRPC proto compiler",
- comments = "Source: google/storage/control/v2/storage_control.proto")
@io.grpc.stub.annotations.GrpcGenerated
public final class StorageControlGrpc {
@@ -2234,8 +2231,8 @@ protected StorageControlBlockingV2Stub build(
* {@code
@@ -1399,8 +1687,8 @@ public final UnaryCallable
*
- * @param bucket Required. The bucket to update. The bucket's `name` field will be used to
- * identify the bucket.
+ * @param bucket Required. The bucket to update. The bucket's `name` field is used to identify the
+ * bucket.
* @param updateMask Required. List of fields to be updated.
*
* Permanently deletes an empty bucket.
+ * The request fails if there are any live or
+ * noncurrent objects in the bucket, but the request succeeds if the
+ * bucket only contains soft-deleted objects or incomplete uploads, such
+ * as ongoing XML API multipart uploads. Does not permanently delete
+ * soft-deleted objects.
+ * When this API is used to delete a bucket containing an object that has a
+ * soft delete policy
+ * enabled, the object becomes soft deleted, and the
+ * `softDeleteTime` and `hardDeleteTime` properties are set on the
+ * object.
+ * Objects and multipart uploads that were in the bucket at the time of
+ * deletion are also retained for the specified retention duration. When
+ * a soft-deleted bucket reaches the end of its retention duration, it
+ * is permanently deleted. The `hardDeleteTime` of the bucket always
+ * equals
+ * or exceeds the expiration time of the last soft-deleted object in the
+ * bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.delete` IAM permission on the bucket.
*
*/
default void deleteBucket(
@@ -1141,6 +1163,13 @@ default void deleteBucket(
*
*
* Returns metadata for the specified bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.get`
+ * IAM permission on
+ * the bucket. Additionally, to return specific bucket metadata, the
+ * authenticated user must have the following permissions:
+ * - To return the IAM policies: `storage.buckets.getIamPolicy`
+ * - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
*
*/
default void getBucket(
@@ -1154,6 +1183,13 @@ default void getBucket(
*
*
* Creates a new bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.create` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated user
+ * must have the following permissions:
+ * - To enable object retention using the `enableObjectRetention` query
+ * parameter: `storage.buckets.enableObjectRetention`
+ * - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
*
*/
default void createBucket(
@@ -1167,7 +1203,14 @@ default void createBucket(
*
*
*
- * Retrieves a list of buckets for a given project.
+ * Retrieves a list of buckets for a given project, ordered
+ * lexicographically by name.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.list` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated
+ * user must have the following permissions:
+ * - To list the IAM policies: `storage.buckets.getIamPolicy`
+ * - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
*
*/
default void listBuckets(
@@ -1181,7 +1224,20 @@ default void listBuckets(
*
*
*
- * Locks retention policy on a bucket.
+ * Permanently locks the retention
+ * policy that is
+ * currently applied to the specified bucket.
+ * Caution: Locking a bucket is an
+ * irreversible action. Once you lock a bucket:
+ * - You cannot remove the retention policy from the bucket.
+ * - You cannot decrease the retention period for the policy.
+ * Once locked, you must delete the entire bucket in order to remove the
+ * bucket's retention policy. However, before you can delete the bucket, you
+ * must delete all the objects in the bucket, which is only
+ * possible if all the objects have reached the retention period set by the
+ * retention policy.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.update` IAM permission on the bucket.
*
*/
default void lockBucketRetentionPolicy(
@@ -1195,11 +1251,15 @@ default void lockBucketRetentionPolicy(
*
*
*
- * Gets the IAM policy for a specified bucket.
+ * Gets the IAM policy for a specified bucket or managed folder.
* The `resource` field in the request should be
* `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
* for a managed folder.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.getIamPolicy` on the bucket or
+ * `storage.managedFolders.getIamPolicy` IAM permission on the
+ * managed folder.
*
*/
default void getIamPolicy(
@@ -1213,7 +1273,7 @@ default void getIamPolicy(
*
*
*
- * Updates an IAM policy for the specified bucket.
+ * Updates an IAM policy for the specified bucket or managed folder.
* The `resource` field in the request should be
* `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
@@ -1232,9 +1292,8 @@ default void setIamPolicy(
*
*
*/
@@ -1554,16 +1653,14 @@ default void rewriteObject(
*
*
* 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,
+ * 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.
@@ -1252,7 +1311,16 @@ default void testIamPermissions(
*
*
*
*/
@@ -1493,18 +1592,18 @@ default io.grpc.stub.StreamObserver
- * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+ * Updates a bucket. Changes to the bucket are readable immediately after
+ * writing, but configuration changes might take time to propagate. This
+ * method supports `patch` semantics.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.update` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated user
+ * must have the following permissions:
+ * - To set bucket IP filtering rules: `storage.buckets.setIpFilter`
+ * - To update public access prevention policies or access control lists
+ * (ACLs): `storage.buckets.setIamPolicy`
*
*/
default void updateBucket(
@@ -1267,7 +1335,14 @@ default void updateBucket(
*
*
* Concatenates a list of existing objects into a new object in the same
- * bucket.
+ * bucket. The existing source objects are unaffected by this operation.
+ * **IAM Permissions**:
+ * Requires the `storage.objects.create` and `storage.objects.get` IAM
+ * permissions to use this method. If the new composite object
+ * overwrites an existing object, the authenticated user must also have
+ * the `storage.objects.delete` permission. If the request body includes
+ * the retention property, the authenticated user must also have the
+ * `storage.objects.setRetention` IAM permission.
*
*/
default void composeObject(
@@ -1283,7 +1358,7 @@ default void composeObject(
*
* Deletes an object and its metadata. Deletions are permanent if versioning
* is not enabled for the bucket, or if the generation parameter is used, or
- * if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not
+ * if soft delete is not
* enabled for the bucket.
* When this API is used to delete an object from a bucket that has soft
* delete policy enabled, the object becomes soft deleted, and the
@@ -1295,9 +1370,7 @@ default void composeObject(
* API to restore soft-deleted objects until the soft delete retention period
* has passed.
* **IAM Permissions**:
- * Requires `storage.objects.delete`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.delete` IAM permission on the bucket.
*
*/
default void deleteObject(
@@ -1311,7 +1384,38 @@ default void deleteObject(
*
*
*
- * Restores a soft-deleted object.
+ * Restores a
+ * soft-deleted object.
+ * When a soft-deleted object is restored, a new copy of that object is
+ * created in the same bucket and inherits the same metadata as the
+ * soft-deleted object. The inherited metadata is the metadata that existed
+ * when the original object became soft deleted, with the following
+ * exceptions:
+ * - The `createTime` of the new object is set to the time at which the
+ * soft-deleted object was restored.
+ * - The `softDeleteTime` and `hardDeleteTime` values are cleared.
+ * - A new generation is assigned and the metageneration is reset to 1.
+ * - If the soft-deleted object was in a bucket that had Autoclass enabled,
+ * the new object is
+ * restored to Standard storage.
+ * - The restored object inherits the bucket's default object ACL, unless
+ * `copySourceAcl` is `true`.
+ * If a live object using the same name already exists in the bucket and
+ * becomes overwritten, the live object becomes a noncurrent object if Object
+ * Versioning is enabled on the bucket. If Object Versioning is not enabled,
+ * the live object becomes soft deleted.
+ * **IAM Permissions**:
+ * Requires the following IAM permissions to use this method:
+ * - `storage.objects.restore`
+ * - `storage.objects.create`
+ * - `storage.objects.delete` (only required if overwriting an existing
+ * object)
+ * - `storage.objects.getIamPolicy` (only required if `projection` is `full`
+ * and the relevant bucket
+ * has uniform bucket-level access disabled)
+ * - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is
+ * `true` and the relevant
+ * bucket has uniform bucket-level access disabled)
*
*/
default void restoreObject(
@@ -1327,8 +1431,8 @@ default void restoreObject(
*
* Cancels an in-progress resumable upload.
* Any attempts to write to the resumable upload after cancelling the upload
- * will fail.
- * The behavior for currently in progress write operations is not guaranteed -
+ * fail.
+ * The behavior for any in-progress write operations is not guaranteed;
* they could either complete before the cancellation or fail if the
* cancellation completes first.
*
@@ -1347,9 +1451,8 @@ default void cancelResumableWrite(
*
* Retrieves object metadata.
* **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket. To return object ACLs, the authenticated user must also have
+ * Requires `storage.objects.get` IAM permission on the bucket.
+ * To return object ACLs, the authenticated user must also have
* the `storage.objects.getIamPolicy` permission.
*
*/
@@ -1365,9 +1468,7 @@ default void getObject(
*
* Retrieves object data.
* **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.get` IAM permission on the bucket.
*
*/
default void readObject(
@@ -1381,19 +1482,15 @@ default void readObject(
*
*
* Reads an object's data.
- * This is a bi-directional API with the added support for reading multiple
- * ranges within one stream both within and across multiple messages.
- * If the server encountered an error for any of the inputs, the stream will
- * be closed with the relevant error code.
- * Because the API allows for multiple outstanding requests, when the stream
- * is closed the error response will contain a BidiReadObjectRangesError proto
- * in the error extension describing the error for each outstanding read_id.
- * **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
- * This API is currently in preview and is not yet available for general
- * use.
+ * This bi-directional API reads data from an object, allowing you to
+ * request multiple data ranges within a single stream, even across
+ * several messages. If an error occurs with any request, the stream
+ * closes with a relevant error code. Since you can have multiple
+ * outstanding requests, the error response includes a
+ * `BidiReadObjectRangesError` field detailing the specific error for
+ * each pending `read_id`.
+ * **IAM Permissions**:
+ * Requires `storage.objects.get` IAM permission on the bucket.
*
*/
default io.grpc.stub.StreamObserver
* Updates an object's metadata.
- * Equivalent to JSON API's storage.objects.patch.
+ * Equivalent to JSON API's `storage.objects.patch` method.
+ * **IAM Permissions**:
+ * Requires `storage.objects.update` IAM permission on the bucket.
*
*/
default void updateObject(
@@ -1438,47 +1537,47 @@ default void updateObject(
* follows:
* - Check the result Status of the stream, to determine if writing can be
* resumed on this stream or must be restarted from scratch (by calling
- * `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED,
- * INTERNAL, and UNAVAILABLE. For each case, the client should use binary
- * exponential backoff before retrying. Additionally, writes can be
- * resumed after RESOURCE_EXHAUSTED errors, but only after taking
- * appropriate measures, which may include reducing aggregate send rate
+ * `StartResumableWrite()`). The resumable errors are `DEADLINE_EXCEEDED`,
+ * `INTERNAL`, and `UNAVAILABLE`. For each case, the client should use
+ * binary exponential backoff before retrying. Additionally, writes can
+ * be resumed after `RESOURCE_EXHAUSTED` errors, but only after taking
+ * appropriate measures, which might include reducing aggregate send rate
* across clients and/or requesting a quota increase for your project.
* - If the call to `WriteObject` returns `ABORTED`, that indicates
* concurrent attempts to update the resumable write, caused either by
* multiple racing clients or by a single client where the previous
* request was timed out on the client side but nonetheless reached the
* server. In this case the client should take steps to prevent further
- * concurrent writes (e.g., increase the timeouts, stop using more than
- * one process to perform the upload, etc.), and then should follow the
- * steps below for resuming the upload.
+ * concurrent writes. For example, increase the timeouts and stop using
+ * more than one process to perform the upload. Follow the steps below for
+ * resuming the upload.
* - For resumable errors, the client should call `QueryWriteStatus()` and
- * then continue writing from the returned `persisted_size`. This may be
+ * then continue writing from the returned `persisted_size`. This might be
* less than the amount of data the client previously sent. Note also that
* it is acceptable to send data starting at an offset earlier than the
- * returned `persisted_size`; in this case, the service will skip data at
+ * returned `persisted_size`; in this case, the service skips data at
* offsets that were already persisted (without checking that it matches
* the previously written data), and write only the data starting from the
- * persisted offset. Even though the data isn't written, it may still
+ * persisted offset. Even though the data isn't written, it might still
* incur a performance cost over resuming at the correct write offset.
* This behavior can make client-side handling simpler in some cases.
* - Clients must only send data that is a multiple of 256 KiB per message,
* unless the object is being finished with `finish_write` set to `true`.
- * The service will not view the object as complete until the client has
+ * The service does not view the object as complete until the client has
* sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any
* requests on a stream after sending a request with `finish_write` set to
- * `true` will cause an error. The client **should** check the response it
- * receives to determine how much data the service was able to commit and
+ * `true` causes an error. The client must check the response it
+ * receives to determine how much data the service is able to commit and
* whether the service views the object as complete.
- * Attempting to resume an already finalized object will result in an OK
+ * Attempting to resume an already finalized object results in an `OK`
* status, with a `WriteObjectResponse` containing the finalized object's
* metadata.
- * Alternatively, the BidiWriteObject operation may be used to write an
+ * Alternatively, you can use the `BidiWriteObject` operation to write an
* object with controls over flushing and the ability to fetch the ability to
* determine the current persisted size.
* **IAM Permissions**:
* Requires `storage.objects.create`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
+ * IAM permission on
* the bucket.
*
* Stores a new object and metadata.
- * This is similar to the WriteObject call with the added support for
+ * This is similar to the `WriteObject` call with the added support for
* manual flushing of persisted state, and the ability to determine current
* persisted size without closing the stream.
- * The client may specify one or both of the `state_lookup` and `flush` fields
- * in each BidiWriteObjectRequest. If `flush` is specified, the data written
- * so far will be persisted to storage. If `state_lookup` is specified, the
- * service will respond with a BidiWriteObjectResponse that contains the
+ * The client might specify one or both of the `state_lookup` and `flush`
+ * fields in each `BidiWriteObjectRequest`. If `flush` is specified, the data
+ * written so far is persisted to storage. If `state_lookup` is specified, the
+ * service responds with a `BidiWriteObjectResponse` that contains the
* persisted size. If both `flush` and `state_lookup` are specified, the flush
- * will always occur before a `state_lookup`, so that both may be set in the
- * same request and the returned state will be the state of the object
- * post-flush. When the stream is closed, a BidiWriteObjectResponse will
- * always be sent to the client, regardless of the value of `state_lookup`.
+ * always occurs before a `state_lookup`, so that both might be set in the
+ * same request and the returned state is the state of the object
+ * post-flush. When the stream is closed, a `BidiWriteObjectResponse`
+ * is always sent to the client, regardless of the value of `state_lookup`.
*
*/
default io.grpc.stub.StreamObserver
* Starts a resumable write operation. This
- * method is part of the [Resumable
- * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+ * method is part of the Resumable
+ * upload feature.
* This allows you to upload large objects in multiple chunks, which is more
* resilient to network interruptions than a single upload. The validity
* duration of the write operation, and the consequences of it becoming
* invalid, are service-dependent.
* **IAM Permissions**:
- * Requires `storage.objects.create`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.create` IAM permission on the bucket.
*
*/
default void startResumableWrite(
@@ -1579,8 +1676,8 @@ default void startResumableWrite(
*
*
* Determines the `persisted_size` of an object that is being written. This
- * method is part of the [resumable
- * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+ * method is part of the resumable
+ * upload feature.
* The returned value is the size of the object that has been persisted so
* far. The value can be used as the `write_offset` for the next `Write()`
* call.
@@ -1608,6 +1705,16 @@ default void queryWriteStatus(
*
*
*/
public abstract static class StorageImplBase implements io.grpc.BindableService, AsyncService {
@@ -1656,21 +1766,24 @@ public final io.grpc.ServerServiceDefinition bindService() {
* ## API Overview and Naming Syntax
* The Cloud Storage gRPC API allows applications to read and write data through
* the abstractions of buckets and objects. For a description of these
- * abstractions please see https://cloud.google.com/storage/docs.
+ * abstractions please see [Cloud Storage
+ * documentation](https://cloud.google.com/storage/docs).
* Resources are named as follows:
* - Projects are referred to as they are defined by the Resource Manager API,
* using strings like `projects/123456` or `projects/my-string-id`.
* - Buckets are named using string names of the form:
- * `projects/{project}/buckets/{bucket}`
- * For globally unique buckets, `_` may be substituted for the project.
+ * `projects/{project}/buckets/{bucket}`.
+ * For globally unique buckets, `_` might be substituted for the project.
* - Objects are uniquely identified by their name along with the name of the
* bucket they belong to, as separate strings in this API. For example:
- * ReadObjectRequest {
+ * ```
+ * ReadObjectRequest {
* bucket: 'projects/_/buckets/my-bucket'
* object: 'my-object'
- * }
- * Note that object names can contain `/` characters, which are treated as
- * any other character (no special directory semantics).
+ * }
+ * ```
+ * Note that object names can contain `/` characters, which are treated as
+ * any other character (no special directory semantics).
*
*/
public static final class StorageStub extends io.grpc.stub.AbstractAsyncStub
* Moves the source object to the destination object in the same bucket.
+ * This operation moves a source object to a destination object in the
+ * same bucket by renaming the object. The move itself is an atomic
+ * transaction, ensuring all steps either complete successfully or no
+ * changes are made.
+ * **IAM Permissions**:
+ * Requires the following IAM permissions to use this method:
+ * - `storage.objects.move`
+ * - `storage.objects.create`
+ * - `storage.objects.delete` (only required if overwriting an existing
+ * object)
*
*/
default void moveObject(
@@ -1624,21 +1731,24 @@ default void moveObject(
* ## API Overview and Naming Syntax
* The Cloud Storage gRPC API allows applications to read and write data through
* the abstractions of buckets and objects. For a description of these
- * abstractions please see https://cloud.google.com/storage/docs.
+ * abstractions please see [Cloud Storage
+ * documentation](https://cloud.google.com/storage/docs).
* Resources are named as follows:
* - Projects are referred to as they are defined by the Resource Manager API,
* using strings like `projects/123456` or `projects/my-string-id`.
* - Buckets are named using string names of the form:
- * `projects/{project}/buckets/{bucket}`
- * For globally unique buckets, `_` may be substituted for the project.
+ * `projects/{project}/buckets/{bucket}`.
+ * For globally unique buckets, `_` might be substituted for the project.
* - Objects are uniquely identified by their name along with the name of the
* bucket they belong to, as separate strings in this API. For example:
- * ReadObjectRequest {
+ * ```
+ * ReadObjectRequest {
* bucket: 'projects/_/buckets/my-bucket'
* object: 'my-object'
- * }
- * Note that object names can contain `/` characters, which are treated as
- * any other character (no special directory semantics).
+ * }
+ * ```
+ * Note that object names can contain `/` characters, which are treated as
+ * any other character (no special directory semantics).
*
* Permanently deletes an empty bucket.
+ * The request fails if there are any live or
+ * noncurrent objects in the bucket, but the request succeeds if the
+ * bucket only contains soft-deleted objects or incomplete uploads, such
+ * as ongoing XML API multipart uploads. Does not permanently delete
+ * soft-deleted objects.
+ * When this API is used to delete a bucket containing an object that has a
+ * soft delete policy
+ * enabled, the object becomes soft deleted, and the
+ * `softDeleteTime` and `hardDeleteTime` properties are set on the
+ * object.
+ * Objects and multipart uploads that were in the bucket at the time of
+ * deletion are also retained for the specified retention duration. When
+ * a soft-deleted bucket reaches the end of its retention duration, it
+ * is permanently deleted. The `hardDeleteTime` of the bucket always
+ * equals
+ * or exceeds the expiration time of the last soft-deleted object in the
+ * bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.delete` IAM permission on the bucket.
*
*/
public void deleteBucket(
@@ -1704,6 +1836,13 @@ public void deleteBucket(
*
*
* Returns metadata for the specified bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.get`
+ * IAM permission on
+ * the bucket. Additionally, to return specific bucket metadata, the
+ * authenticated user must have the following permissions:
+ * - To return the IAM policies: `storage.buckets.getIamPolicy`
+ * - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
*
*/
public void getBucket(
@@ -1718,6 +1857,13 @@ public void getBucket(
*
*
* Creates a new bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.create` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated user
+ * must have the following permissions:
+ * - To enable object retention using the `enableObjectRetention` query
+ * parameter: `storage.buckets.enableObjectRetention`
+ * - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
*
*/
public void createBucket(
@@ -1733,7 +1879,14 @@ public void createBucket(
*
*
*
- * Retrieves a list of buckets for a given project.
+ * Retrieves a list of buckets for a given project, ordered
+ * lexicographically by name.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.list` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated
+ * user must have the following permissions:
+ * - To list the IAM policies: `storage.buckets.getIamPolicy`
+ * - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
*
*/
public void listBuckets(
@@ -1749,7 +1902,20 @@ public void listBuckets(
*
*
*
- * Locks retention policy on a bucket.
+ * Permanently locks the retention
+ * policy that is
+ * currently applied to the specified bucket.
+ * Caution: Locking a bucket is an
+ * irreversible action. Once you lock a bucket:
+ * - You cannot remove the retention policy from the bucket.
+ * - You cannot decrease the retention period for the policy.
+ * Once locked, you must delete the entire bucket in order to remove the
+ * bucket's retention policy. However, before you can delete the bucket, you
+ * must delete all the objects in the bucket, which is only
+ * possible if all the objects have reached the retention period set by the
+ * retention policy.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.update` IAM permission on the bucket.
*
*/
public void lockBucketRetentionPolicy(
@@ -1765,11 +1931,15 @@ public void lockBucketRetentionPolicy(
*
*
*
- * Gets the IAM policy for a specified bucket.
+ * Gets the IAM policy for a specified bucket or managed folder.
* The `resource` field in the request should be
* `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
* for a managed folder.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.getIamPolicy` on the bucket or
+ * `storage.managedFolders.getIamPolicy` IAM permission on the
+ * managed folder.
*
*/
public void getIamPolicy(
@@ -1785,7 +1955,7 @@ public void getIamPolicy(
*
*
*
- * Updates an IAM policy for the specified bucket.
+ * Updates an IAM policy for the specified bucket or managed folder.
* The `resource` field in the request should be
* `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
@@ -1806,9 +1976,8 @@ public void setIamPolicy(
*
*
*/
@@ -2148,16 +2357,14 @@ public void rewriteObject(
*
*
* 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,
+ * 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.
@@ -1828,7 +1997,16 @@ public void testIamPermissions(
*
*
*
*/
@@ -2083,18 +2292,18 @@ public io.grpc.stub.StreamObserver
- * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+ * Updates a bucket. Changes to the bucket are readable immediately after
+ * writing, but configuration changes might take time to propagate. This
+ * method supports `patch` semantics.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.update` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated user
+ * must have the following permissions:
+ * - To set bucket IP filtering rules: `storage.buckets.setIpFilter`
+ * - To update public access prevention policies or access control lists
+ * (ACLs): `storage.buckets.setIamPolicy`
*
*/
public void updateBucket(
@@ -1845,7 +2023,14 @@ public void updateBucket(
*
*
* Concatenates a list of existing objects into a new object in the same
- * bucket.
+ * bucket. The existing source objects are unaffected by this operation.
+ * **IAM Permissions**:
+ * Requires the `storage.objects.create` and `storage.objects.get` IAM
+ * permissions to use this method. If the new composite object
+ * overwrites an existing object, the authenticated user must also have
+ * the `storage.objects.delete` permission. If the request body includes
+ * the retention property, the authenticated user must also have the
+ * `storage.objects.setRetention` IAM permission.
*
*/
public void composeObject(
@@ -1863,7 +2048,7 @@ public void composeObject(
*
* Deletes an object and its metadata. Deletions are permanent if versioning
* is not enabled for the bucket, or if the generation parameter is used, or
- * if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not
+ * if soft delete is not
* enabled for the bucket.
* When this API is used to delete an object from a bucket that has soft
* delete policy enabled, the object becomes soft deleted, and the
@@ -1875,9 +2060,7 @@ public void composeObject(
* API to restore soft-deleted objects until the soft delete retention period
* has passed.
* **IAM Permissions**:
- * Requires `storage.objects.delete`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.delete` IAM permission on the bucket.
*
*/
public void deleteObject(
@@ -1893,7 +2076,38 @@ public void deleteObject(
*
*
*
- * Restores a soft-deleted object.
+ * Restores a
+ * soft-deleted object.
+ * When a soft-deleted object is restored, a new copy of that object is
+ * created in the same bucket and inherits the same metadata as the
+ * soft-deleted object. The inherited metadata is the metadata that existed
+ * when the original object became soft deleted, with the following
+ * exceptions:
+ * - The `createTime` of the new object is set to the time at which the
+ * soft-deleted object was restored.
+ * - The `softDeleteTime` and `hardDeleteTime` values are cleared.
+ * - A new generation is assigned and the metageneration is reset to 1.
+ * - If the soft-deleted object was in a bucket that had Autoclass enabled,
+ * the new object is
+ * restored to Standard storage.
+ * - The restored object inherits the bucket's default object ACL, unless
+ * `copySourceAcl` is `true`.
+ * If a live object using the same name already exists in the bucket and
+ * becomes overwritten, the live object becomes a noncurrent object if Object
+ * Versioning is enabled on the bucket. If Object Versioning is not enabled,
+ * the live object becomes soft deleted.
+ * **IAM Permissions**:
+ * Requires the following IAM permissions to use this method:
+ * - `storage.objects.restore`
+ * - `storage.objects.create`
+ * - `storage.objects.delete` (only required if overwriting an existing
+ * object)
+ * - `storage.objects.getIamPolicy` (only required if `projection` is `full`
+ * and the relevant bucket
+ * has uniform bucket-level access disabled)
+ * - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is
+ * `true` and the relevant
+ * bucket has uniform bucket-level access disabled)
*
*/
public void restoreObject(
@@ -1911,8 +2125,8 @@ public void restoreObject(
*
* Cancels an in-progress resumable upload.
* Any attempts to write to the resumable upload after cancelling the upload
- * will fail.
- * The behavior for currently in progress write operations is not guaranteed -
+ * fail.
+ * The behavior for any in-progress write operations is not guaranteed;
* they could either complete before the cancellation or fail if the
* cancellation completes first.
*
@@ -1933,9 +2147,8 @@ public void cancelResumableWrite(
*
* Retrieves object metadata.
* **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket. To return object ACLs, the authenticated user must also have
+ * Requires `storage.objects.get` IAM permission on the bucket.
+ * To return object ACLs, the authenticated user must also have
* the `storage.objects.getIamPolicy` permission.
*
*/
@@ -1952,9 +2165,7 @@ public void getObject(
*
* Retrieves object data.
* **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.get` IAM permission on the bucket.
*
*/
public void readObject(
@@ -1969,19 +2180,15 @@ public void readObject(
*
*
* Reads an object's data.
- * This is a bi-directional API with the added support for reading multiple
- * ranges within one stream both within and across multiple messages.
- * If the server encountered an error for any of the inputs, the stream will
- * be closed with the relevant error code.
- * Because the API allows for multiple outstanding requests, when the stream
- * is closed the error response will contain a BidiReadObjectRangesError proto
- * in the error extension describing the error for each outstanding read_id.
- * **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
- * This API is currently in preview and is not yet available for general
- * use.
+ * This bi-directional API reads data from an object, allowing you to
+ * request multiple data ranges within a single stream, even across
+ * several messages. If an error occurs with any request, the stream
+ * closes with a relevant error code. Since you can have multiple
+ * outstanding requests, the error response includes a
+ * `BidiReadObjectRangesError` field detailing the specific error for
+ * each pending `read_id`.
+ * **IAM Permissions**:
+ * Requires `storage.objects.get` IAM permission on the bucket.
*
*/
public io.grpc.stub.StreamObserver
* Updates an object's metadata.
- * Equivalent to JSON API's storage.objects.patch.
+ * Equivalent to JSON API's `storage.objects.patch` method.
+ * **IAM Permissions**:
+ * Requires `storage.objects.update` IAM permission on the bucket.
*
*/
public void updateObject(
@@ -2028,47 +2237,47 @@ public void updateObject(
* follows:
* - Check the result Status of the stream, to determine if writing can be
* resumed on this stream or must be restarted from scratch (by calling
- * `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED,
- * INTERNAL, and UNAVAILABLE. For each case, the client should use binary
- * exponential backoff before retrying. Additionally, writes can be
- * resumed after RESOURCE_EXHAUSTED errors, but only after taking
- * appropriate measures, which may include reducing aggregate send rate
+ * `StartResumableWrite()`). The resumable errors are `DEADLINE_EXCEEDED`,
+ * `INTERNAL`, and `UNAVAILABLE`. For each case, the client should use
+ * binary exponential backoff before retrying. Additionally, writes can
+ * be resumed after `RESOURCE_EXHAUSTED` errors, but only after taking
+ * appropriate measures, which might include reducing aggregate send rate
* across clients and/or requesting a quota increase for your project.
* - If the call to `WriteObject` returns `ABORTED`, that indicates
* concurrent attempts to update the resumable write, caused either by
* multiple racing clients or by a single client where the previous
* request was timed out on the client side but nonetheless reached the
* server. In this case the client should take steps to prevent further
- * concurrent writes (e.g., increase the timeouts, stop using more than
- * one process to perform the upload, etc.), and then should follow the
- * steps below for resuming the upload.
+ * concurrent writes. For example, increase the timeouts and stop using
+ * more than one process to perform the upload. Follow the steps below for
+ * resuming the upload.
* - For resumable errors, the client should call `QueryWriteStatus()` and
- * then continue writing from the returned `persisted_size`. This may be
+ * then continue writing from the returned `persisted_size`. This might be
* less than the amount of data the client previously sent. Note also that
* it is acceptable to send data starting at an offset earlier than the
- * returned `persisted_size`; in this case, the service will skip data at
+ * returned `persisted_size`; in this case, the service skips data at
* offsets that were already persisted (without checking that it matches
* the previously written data), and write only the data starting from the
- * persisted offset. Even though the data isn't written, it may still
+ * persisted offset. Even though the data isn't written, it might still
* incur a performance cost over resuming at the correct write offset.
* This behavior can make client-side handling simpler in some cases.
* - Clients must only send data that is a multiple of 256 KiB per message,
* unless the object is being finished with `finish_write` set to `true`.
- * The service will not view the object as complete until the client has
+ * The service does not view the object as complete until the client has
* sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any
* requests on a stream after sending a request with `finish_write` set to
- * `true` will cause an error. The client **should** check the response it
- * receives to determine how much data the service was able to commit and
+ * `true` causes an error. The client must check the response it
+ * receives to determine how much data the service is able to commit and
* whether the service views the object as complete.
- * Attempting to resume an already finalized object will result in an OK
+ * Attempting to resume an already finalized object results in an `OK`
* status, with a `WriteObjectResponse` containing the finalized object's
* metadata.
- * Alternatively, the BidiWriteObject operation may be used to write an
+ * Alternatively, you can use the `BidiWriteObject` operation to write an
* object with controls over flushing and the ability to fetch the ability to
* determine the current persisted size.
* **IAM Permissions**:
* Requires `storage.objects.create`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
+ * IAM permission on
* the bucket.
*
* Stores a new object and metadata.
- * This is similar to the WriteObject call with the added support for
+ * This is similar to the `WriteObject` call with the added support for
* manual flushing of persisted state, and the ability to determine current
* persisted size without closing the stream.
- * The client may specify one or both of the `state_lookup` and `flush` fields
- * in each BidiWriteObjectRequest. If `flush` is specified, the data written
- * so far will be persisted to storage. If `state_lookup` is specified, the
- * service will respond with a BidiWriteObjectResponse that contains the
+ * The client might specify one or both of the `state_lookup` and `flush`
+ * fields in each `BidiWriteObjectRequest`. If `flush` is specified, the data
+ * written so far is persisted to storage. If `state_lookup` is specified, the
+ * service responds with a `BidiWriteObjectResponse` that contains the
* persisted size. If both `flush` and `state_lookup` are specified, the flush
- * will always occur before a `state_lookup`, so that both may be set in the
- * same request and the returned state will be the state of the object
- * post-flush. When the stream is closed, a BidiWriteObjectResponse will
- * always be sent to the client, regardless of the value of `state_lookup`.
+ * always occurs before a `state_lookup`, so that both might be set in the
+ * same request and the returned state is the state of the object
+ * post-flush. When the stream is closed, a `BidiWriteObjectResponse`
+ * is always sent to the client, regardless of the value of `state_lookup`.
*
*/
public io.grpc.stub.StreamObserver
* Starts a resumable write operation. This
- * method is part of the [Resumable
- * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+ * method is part of the Resumable
+ * upload feature.
* This allows you to upload large objects in multiple chunks, which is more
* resilient to network interruptions than a single upload. The validity
* duration of the write operation, and the consequences of it becoming
* invalid, are service-dependent.
* **IAM Permissions**:
- * Requires `storage.objects.create`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.create` IAM permission on the bucket.
*
*/
public void startResumableWrite(
@@ -2175,8 +2382,8 @@ public void startResumableWrite(
*
*
* Determines the `persisted_size` of an object that is being written. This
- * method is part of the [resumable
- * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+ * method is part of the resumable
+ * upload feature.
* The returned value is the size of the object that has been persisted so
* far. The value can be used as the `write_offset` for the next `Write()`
* call.
@@ -2206,6 +2413,16 @@ public void queryWriteStatus(
*
*
*/
public static final class StorageBlockingV2Stub
@@ -2257,11 +2477,30 @@ protected StorageBlockingV2Stub build(
*
*
* Moves the source object to the destination object in the same bucket.
+ * This operation moves a source object to a destination object in the
+ * same bucket by renaming the object. The move itself is an atomic
+ * transaction, ensuring all steps either complete successfully or no
+ * changes are made.
+ * **IAM Permissions**:
+ * Requires the following IAM permissions to use this method:
+ * - `storage.objects.move`
+ * - `storage.objects.create`
+ * - `storage.objects.delete` (only required if overwriting an existing
+ * object)
*
*/
public void moveObject(
@@ -2223,21 +2440,24 @@ public void moveObject(
* ## API Overview and Naming Syntax
* The Cloud Storage gRPC API allows applications to read and write data through
* the abstractions of buckets and objects. For a description of these
- * abstractions please see https://cloud.google.com/storage/docs.
+ * abstractions please see [Cloud Storage
+ * documentation](https://cloud.google.com/storage/docs).
* Resources are named as follows:
* - Projects are referred to as they are defined by the Resource Manager API,
* using strings like `projects/123456` or `projects/my-string-id`.
* - Buckets are named using string names of the form:
- * `projects/{project}/buckets/{bucket}`
- * For globally unique buckets, `_` may be substituted for the project.
+ * `projects/{project}/buckets/{bucket}`.
+ * For globally unique buckets, `_` might be substituted for the project.
* - Objects are uniquely identified by their name along with the name of the
* bucket they belong to, as separate strings in this API. For example:
- * ReadObjectRequest {
+ * ```
+ * ReadObjectRequest {
* bucket: 'projects/_/buckets/my-bucket'
* object: 'my-object'
- * }
- * Note that object names can contain `/` characters, which are treated as
- * any other character (no special directory semantics).
+ * }
+ * ```
+ * Note that object names can contain `/` characters, which are treated as
+ * any other character (no special directory semantics).
*
* Permanently deletes an empty bucket.
+ * The request fails if there are any live or
+ * noncurrent objects in the bucket, but the request succeeds if the
+ * bucket only contains soft-deleted objects or incomplete uploads, such
+ * as ongoing XML API multipart uploads. Does not permanently delete
+ * soft-deleted objects.
+ * When this API is used to delete a bucket containing an object that has a
+ * soft delete policy
+ * enabled, the object becomes soft deleted, and the
+ * `softDeleteTime` and `hardDeleteTime` properties are set on the
+ * object.
+ * Objects and multipart uploads that were in the bucket at the time of
+ * deletion are also retained for the specified retention duration. When
+ * a soft-deleted bucket reaches the end of its retention duration, it
+ * is permanently deleted. The `hardDeleteTime` of the bucket always
+ * equals
+ * or exceeds the expiration time of the last soft-deleted object in the
+ * bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.delete` IAM permission on the bucket.
*
*/
- public com.google.protobuf.Empty deleteBucket(
- com.google.storage.v2.DeleteBucketRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ public com.google.protobuf.Empty deleteBucket(com.google.storage.v2.DeleteBucketRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getDeleteBucketMethod(), getCallOptions(), request);
}
@@ -2270,10 +2509,18 @@ public com.google.protobuf.Empty deleteBucket(
*
*
* Returns metadata for the specified bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.get`
+ * IAM permission on
+ * the bucket. Additionally, to return specific bucket metadata, the
+ * authenticated user must have the following permissions:
+ * - To return the IAM policies: `storage.buckets.getIamPolicy`
+ * - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
*
*/
- public com.google.storage.v2.Bucket getBucket(com.google.storage.v2.GetBucketRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ public com.google.storage.v2.Bucket getBucket(com.google.storage.v2.GetBucketRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getGetBucketMethod(), getCallOptions(), request);
}
@@ -2282,11 +2529,18 @@ public com.google.storage.v2.Bucket getBucket(com.google.storage.v2.GetBucketReq
*
*
* Creates a new bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.create` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated user
+ * must have the following permissions:
+ * - To enable object retention using the `enableObjectRetention` query
+ * parameter: `storage.buckets.enableObjectRetention`
+ * - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
*
*/
public com.google.storage.v2.Bucket createBucket(
- com.google.storage.v2.CreateBucketRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.CreateBucketRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getCreateBucketMethod(), getCallOptions(), request);
}
@@ -2294,12 +2548,19 @@ public com.google.storage.v2.Bucket createBucket(
*
*
*
- * Retrieves a list of buckets for a given project.
+ * Retrieves a list of buckets for a given project, ordered
+ * lexicographically by name.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.list` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated
+ * user must have the following permissions:
+ * - To list the IAM policies: `storage.buckets.getIamPolicy`
+ * - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
*
*/
public com.google.storage.v2.ListBucketsResponse listBuckets(
- com.google.storage.v2.ListBucketsRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.ListBucketsRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getListBucketsMethod(), getCallOptions(), request);
}
@@ -2307,12 +2568,26 @@ public com.google.storage.v2.ListBucketsResponse listBuckets(
*
*
*
- * Locks retention policy on a bucket.
+ * Permanently locks the retention
+ * policy that is
+ * currently applied to the specified bucket.
+ * Caution: Locking a bucket is an
+ * irreversible action. Once you lock a bucket:
+ * - You cannot remove the retention policy from the bucket.
+ * - You cannot decrease the retention period for the policy.
+ * Once locked, you must delete the entire bucket in order to remove the
+ * bucket's retention policy. However, before you can delete the bucket, you
+ * must delete all the objects in the bucket, which is only
+ * possible if all the objects have reached the retention period set by the
+ * retention policy.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.update` IAM permission on the bucket.
*
*/
public com.google.storage.v2.Bucket lockBucketRetentionPolicy(
- com.google.storage.v2.LockBucketRetentionPolicyRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.LockBucketRetentionPolicyRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getLockBucketRetentionPolicyMethod(), getCallOptions(), request);
}
@@ -2320,15 +2595,20 @@ public com.google.storage.v2.Bucket lockBucketRetentionPolicy(
*
*
*
- * Gets the IAM policy for a specified bucket.
+ * Gets the IAM policy for a specified bucket or managed folder.
* The `resource` field in the request should be
* `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
* for a managed folder.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.getIamPolicy` on the bucket or
+ * `storage.managedFolders.getIamPolicy` IAM permission on the
+ * managed folder.
*
*/
- public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getGetIamPolicyMethod(), getCallOptions(), request);
}
@@ -2336,15 +2616,16 @@ public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyReque
*
*
*
- * Updates an IAM policy for the specified bucket.
+ * Updates an IAM policy for the specified bucket or managed folder.
* The `resource` field in the request should be
* `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
* for a managed folder.
*
*/
- public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getSetIamPolicyMethod(), getCallOptions(), request);
}
@@ -2353,17 +2634,16 @@ public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyReque
*
*
* 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,
+ * 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.
*
*/
public com.google.iam.v1.TestIamPermissionsResponse testIamPermissions(
- com.google.iam.v1.TestIamPermissionsRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.iam.v1.TestIamPermissionsRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getTestIamPermissionsMethod(), getCallOptions(), request);
}
@@ -2371,12 +2651,21 @@ public com.google.iam.v1.TestIamPermissionsResponse testIamPermissions(
*
*
*
- * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+ * Updates a bucket. Changes to the bucket are readable immediately after
+ * writing, but configuration changes might take time to propagate. This
+ * method supports `patch` semantics.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.update` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated user
+ * must have the following permissions:
+ * - To set bucket IP filtering rules: `storage.buckets.setIpFilter`
+ * - To update public access prevention policies or access control lists
+ * (ACLs): `storage.buckets.setIamPolicy`
*
*/
public com.google.storage.v2.Bucket updateBucket(
- com.google.storage.v2.UpdateBucketRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.UpdateBucketRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getUpdateBucketMethod(), getCallOptions(), request);
}
@@ -2385,12 +2674,19 @@ public com.google.storage.v2.Bucket updateBucket(
*
*
* Concatenates a list of existing objects into a new object in the same
- * bucket.
+ * bucket. The existing source objects are unaffected by this operation.
+ * **IAM Permissions**:
+ * Requires the `storage.objects.create` and `storage.objects.get` IAM
+ * permissions to use this method. If the new composite object
+ * overwrites an existing object, the authenticated user must also have
+ * the `storage.objects.delete` permission. If the request body includes
+ * the retention property, the authenticated user must also have the
+ * `storage.objects.setRetention` IAM permission.
*
*/
public com.google.storage.v2.Object composeObject(
- com.google.storage.v2.ComposeObjectRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.ComposeObjectRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getComposeObjectMethod(), getCallOptions(), request);
}
@@ -2400,7 +2696,7 @@ public com.google.storage.v2.Object composeObject(
*
* Deletes an object and its metadata. Deletions are permanent if versioning
* is not enabled for the bucket, or if the generation parameter is used, or
- * if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not
+ * if soft delete is not
* enabled for the bucket.
* When this API is used to delete an object from a bucket that has soft
* delete policy enabled, the object becomes soft deleted, and the
@@ -2412,14 +2708,12 @@ public com.google.storage.v2.Object composeObject(
* API to restore soft-deleted objects until the soft delete retention period
* has passed.
* **IAM Permissions**:
- * Requires `storage.objects.delete`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.delete` IAM permission on the bucket.
*
*/
- public com.google.protobuf.Empty deleteObject(
- com.google.storage.v2.DeleteObjectRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ public com.google.protobuf.Empty deleteObject(com.google.storage.v2.DeleteObjectRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getDeleteObjectMethod(), getCallOptions(), request);
}
@@ -2427,12 +2721,43 @@ public com.google.protobuf.Empty deleteObject(
*
*
*
- * Restores a soft-deleted object.
+ * Restores a
+ * soft-deleted object.
+ * When a soft-deleted object is restored, a new copy of that object is
+ * created in the same bucket and inherits the same metadata as the
+ * soft-deleted object. The inherited metadata is the metadata that existed
+ * when the original object became soft deleted, with the following
+ * exceptions:
+ * - The `createTime` of the new object is set to the time at which the
+ * soft-deleted object was restored.
+ * - The `softDeleteTime` and `hardDeleteTime` values are cleared.
+ * - A new generation is assigned and the metageneration is reset to 1.
+ * - If the soft-deleted object was in a bucket that had Autoclass enabled,
+ * the new object is
+ * restored to Standard storage.
+ * - The restored object inherits the bucket's default object ACL, unless
+ * `copySourceAcl` is `true`.
+ * If a live object using the same name already exists in the bucket and
+ * becomes overwritten, the live object becomes a noncurrent object if Object
+ * Versioning is enabled on the bucket. If Object Versioning is not enabled,
+ * the live object becomes soft deleted.
+ * **IAM Permissions**:
+ * Requires the following IAM permissions to use this method:
+ * - `storage.objects.restore`
+ * - `storage.objects.create`
+ * - `storage.objects.delete` (only required if overwriting an existing
+ * object)
+ * - `storage.objects.getIamPolicy` (only required if `projection` is `full`
+ * and the relevant bucket
+ * has uniform bucket-level access disabled)
+ * - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is
+ * `true` and the relevant
+ * bucket has uniform bucket-level access disabled)
*
*/
public com.google.storage.v2.Object restoreObject(
- com.google.storage.v2.RestoreObjectRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.RestoreObjectRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getRestoreObjectMethod(), getCallOptions(), request);
}
@@ -2442,15 +2767,15 @@ public com.google.storage.v2.Object restoreObject(
*
* Cancels an in-progress resumable upload.
* Any attempts to write to the resumable upload after cancelling the upload
- * will fail.
- * The behavior for currently in progress write operations is not guaranteed -
+ * fail.
+ * The behavior for any in-progress write operations is not guaranteed;
* they could either complete before the cancellation or fail if the
* cancellation completes first.
*
*/
public com.google.storage.v2.CancelResumableWriteResponse cancelResumableWrite(
- com.google.storage.v2.CancelResumableWriteRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.CancelResumableWriteRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getCancelResumableWriteMethod(), getCallOptions(), request);
}
@@ -2460,14 +2785,14 @@ public com.google.storage.v2.CancelResumableWriteResponse cancelResumableWrite(
*
* Retrieves object metadata.
* **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket. To return object ACLs, the authenticated user must also have
+ * Requires `storage.objects.get` IAM permission on the bucket.
+ * To return object ACLs, the authenticated user must also have
* the `storage.objects.getIamPolicy` permission.
*
*/
- public com.google.storage.v2.Object getObject(com.google.storage.v2.GetObjectRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ public com.google.storage.v2.Object getObject(com.google.storage.v2.GetObjectRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getGetObjectMethod(), getCallOptions(), request);
}
@@ -2477,9 +2802,7 @@ public com.google.storage.v2.Object getObject(com.google.storage.v2.GetObjectReq
*
* Retrieves object data.
* **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.get` IAM permission on the bucket.
*
*/
@io.grpc.ExperimentalApi("https://github.com/grpc/grpc-java/issues/10918")
@@ -2494,19 +2817,15 @@ public io.grpc.stub.BlockingClientCall
* Reads an object's data.
- * This is a bi-directional API with the added support for reading multiple
- * ranges within one stream both within and across multiple messages.
- * If the server encountered an error for any of the inputs, the stream will
- * be closed with the relevant error code.
- * Because the API allows for multiple outstanding requests, when the stream
- * is closed the error response will contain a BidiReadObjectRangesError proto
- * in the error extension describing the error for each outstanding read_id.
- * **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
- * This API is currently in preview and is not yet available for general
- * use.
+ * This bi-directional API reads data from an object, allowing you to
+ * request multiple data ranges within a single stream, even across
+ * several messages. If an error occurs with any request, the stream
+ * closes with a relevant error code. Since you can have multiple
+ * outstanding requests, the error response includes a
+ * `BidiReadObjectRangesError` field detailing the specific error for
+ * each pending `read_id`.
+ * **IAM Permissions**:
+ * Requires `storage.objects.get` IAM permission on the bucket.
*
*/
@io.grpc.ExperimentalApi("https://github.com/grpc/grpc-java/issues/10918")
@@ -2523,12 +2842,14 @@ public io.grpc.stub.BlockingClientCall
* Updates an object's metadata.
- * Equivalent to JSON API's storage.objects.patch.
+ * Equivalent to JSON API's `storage.objects.patch` method.
+ * **IAM Permissions**:
+ * Requires `storage.objects.update` IAM permission on the bucket.
*
*/
public com.google.storage.v2.Object updateObject(
- com.google.storage.v2.UpdateObjectRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.UpdateObjectRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getUpdateObjectMethod(), getCallOptions(), request);
}
@@ -2552,47 +2873,47 @@ public com.google.storage.v2.Object updateObject(
* follows:
* - Check the result Status of the stream, to determine if writing can be
* resumed on this stream or must be restarted from scratch (by calling
- * `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED,
- * INTERNAL, and UNAVAILABLE. For each case, the client should use binary
- * exponential backoff before retrying. Additionally, writes can be
- * resumed after RESOURCE_EXHAUSTED errors, but only after taking
- * appropriate measures, which may include reducing aggregate send rate
+ * `StartResumableWrite()`). The resumable errors are `DEADLINE_EXCEEDED`,
+ * `INTERNAL`, and `UNAVAILABLE`. For each case, the client should use
+ * binary exponential backoff before retrying. Additionally, writes can
+ * be resumed after `RESOURCE_EXHAUSTED` errors, but only after taking
+ * appropriate measures, which might include reducing aggregate send rate
* across clients and/or requesting a quota increase for your project.
* - If the call to `WriteObject` returns `ABORTED`, that indicates
* concurrent attempts to update the resumable write, caused either by
* multiple racing clients or by a single client where the previous
* request was timed out on the client side but nonetheless reached the
* server. In this case the client should take steps to prevent further
- * concurrent writes (e.g., increase the timeouts, stop using more than
- * one process to perform the upload, etc.), and then should follow the
- * steps below for resuming the upload.
+ * concurrent writes. For example, increase the timeouts and stop using
+ * more than one process to perform the upload. Follow the steps below for
+ * resuming the upload.
* - For resumable errors, the client should call `QueryWriteStatus()` and
- * then continue writing from the returned `persisted_size`. This may be
+ * then continue writing from the returned `persisted_size`. This might be
* less than the amount of data the client previously sent. Note also that
* it is acceptable to send data starting at an offset earlier than the
- * returned `persisted_size`; in this case, the service will skip data at
+ * returned `persisted_size`; in this case, the service skips data at
* offsets that were already persisted (without checking that it matches
* the previously written data), and write only the data starting from the
- * persisted offset. Even though the data isn't written, it may still
+ * persisted offset. Even though the data isn't written, it might still
* incur a performance cost over resuming at the correct write offset.
* This behavior can make client-side handling simpler in some cases.
* - Clients must only send data that is a multiple of 256 KiB per message,
* unless the object is being finished with `finish_write` set to `true`.
- * The service will not view the object as complete until the client has
+ * The service does not view the object as complete until the client has
* sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any
* requests on a stream after sending a request with `finish_write` set to
- * `true` will cause an error. The client **should** check the response it
- * receives to determine how much data the service was able to commit and
+ * `true` causes an error. The client must check the response it
+ * receives to determine how much data the service is able to commit and
* whether the service views the object as complete.
- * Attempting to resume an already finalized object will result in an OK
+ * Attempting to resume an already finalized object results in an `OK`
* status, with a `WriteObjectResponse` containing the finalized object's
* metadata.
- * Alternatively, the BidiWriteObject operation may be used to write an
+ * Alternatively, you can use the `BidiWriteObject` operation to write an
* object with controls over flushing and the ability to fetch the ability to
* determine the current persisted size.
* **IAM Permissions**:
* Requires `storage.objects.create`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
+ * IAM permission on
* the bucket.
*
*/
@@ -2609,18 +2930,18 @@ public com.google.storage.v2.Object updateObject(
*
*
* Stores a new object and metadata.
- * This is similar to the WriteObject call with the added support for
+ * This is similar to the `WriteObject` call with the added support for
* manual flushing of persisted state, and the ability to determine current
* persisted size without closing the stream.
- * The client may specify one or both of the `state_lookup` and `flush` fields
- * in each BidiWriteObjectRequest. If `flush` is specified, the data written
- * so far will be persisted to storage. If `state_lookup` is specified, the
- * service will respond with a BidiWriteObjectResponse that contains the
+ * The client might specify one or both of the `state_lookup` and `flush`
+ * fields in each `BidiWriteObjectRequest`. If `flush` is specified, the data
+ * written so far is persisted to storage. If `state_lookup` is specified, the
+ * service responds with a `BidiWriteObjectResponse` that contains the
* persisted size. If both `flush` and `state_lookup` are specified, the flush
- * will always occur before a `state_lookup`, so that both may be set in the
- * same request and the returned state will be the state of the object
- * post-flush. When the stream is closed, a BidiWriteObjectResponse will
- * always be sent to the client, regardless of the value of `state_lookup`.
+ * always occurs before a `state_lookup`, so that both might be set in the
+ * same request and the returned state is the state of the object
+ * post-flush. When the stream is closed, a `BidiWriteObjectResponse`
+ * is always sent to the client, regardless of the value of `state_lookup`.
*
*/
@io.grpc.ExperimentalApi("https://github.com/grpc/grpc-java/issues/10918")
@@ -2639,14 +2960,14 @@ public com.google.storage.v2.Object updateObject(
* Retrieves a list of objects matching the criteria.
* **IAM Permissions**:
* The authenticated user requires `storage.objects.list`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions)
- * to use this method. To return object ACLs, the authenticated user must also
+ * IAM permission to use this method. To return object ACLs, the
+ * authenticated user must also
* have the `storage.objects.getIamPolicy` permission.
*
*/
public com.google.storage.v2.ListObjectsResponse listObjects(
- com.google.storage.v2.ListObjectsRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.ListObjectsRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getListObjectsMethod(), getCallOptions(), request);
}
@@ -2659,8 +2980,8 @@ public com.google.storage.v2.ListObjectsResponse listObjects(
*
*/
public com.google.storage.v2.RewriteResponse rewriteObject(
- com.google.storage.v2.RewriteObjectRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.RewriteObjectRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getRewriteObjectMethod(), getCallOptions(), request);
}
@@ -2669,21 +2990,19 @@ public com.google.storage.v2.RewriteResponse rewriteObject(
*
*
* Starts a resumable write operation. This
- * method is part of the [Resumable
- * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+ * method is part of the Resumable
+ * upload feature.
* This allows you to upload large objects in multiple chunks, which is more
* resilient to network interruptions than a single upload. The validity
* duration of the write operation, and the consequences of it becoming
* invalid, are service-dependent.
* **IAM Permissions**:
- * Requires `storage.objects.create`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.create` IAM permission on the bucket.
*
*/
public com.google.storage.v2.StartResumableWriteResponse startResumableWrite(
- com.google.storage.v2.StartResumableWriteRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.StartResumableWriteRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getStartResumableWriteMethod(), getCallOptions(), request);
}
@@ -2692,8 +3011,8 @@ public com.google.storage.v2.StartResumableWriteResponse startResumableWrite(
*
*
* Determines the `persisted_size` of an object that is being written. This
- * method is part of the [resumable
- * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+ * method is part of the resumable
+ * upload feature.
* The returned value is the size of the object that has been persisted so
* far. The value can be used as the `write_offset` for the next `Write()`
* call.
@@ -2709,8 +3028,8 @@ public com.google.storage.v2.StartResumableWriteResponse startResumableWrite(
*
*/
public com.google.storage.v2.QueryWriteStatusResponse queryWriteStatus(
- com.google.storage.v2.QueryWriteStatusRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ com.google.storage.v2.QueryWriteStatusRequest request) throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getQueryWriteStatusMethod(), getCallOptions(), request);
}
@@ -2719,11 +3038,21 @@ public com.google.storage.v2.QueryWriteStatusResponse queryWriteStatus(
*
*
* Moves the source object to the destination object in the same bucket.
+ * This operation moves a source object to a destination object in the
+ * same bucket by renaming the object. The move itself is an atomic
+ * transaction, ensuring all steps either complete successfully or no
+ * changes are made.
+ * **IAM Permissions**:
+ * Requires the following IAM permissions to use this method:
+ * - `storage.objects.move`
+ * - `storage.objects.create`
+ * - `storage.objects.delete` (only required if overwriting an existing
+ * object)
*
*/
- public com.google.storage.v2.Object moveObject(
- com.google.storage.v2.MoveObjectRequest request) {
- return io.grpc.stub.ClientCalls.blockingUnaryCall(
+ public com.google.storage.v2.Object moveObject(com.google.storage.v2.MoveObjectRequest request)
+ throws io.grpc.StatusException {
+ return io.grpc.stub.ClientCalls.blockingV2UnaryCall(
getChannel(), getMoveObjectMethod(), getCallOptions(), request);
}
}
@@ -2735,21 +3064,24 @@ public com.google.storage.v2.Object moveObject(
* ## API Overview and Naming Syntax
* The Cloud Storage gRPC API allows applications to read and write data through
* the abstractions of buckets and objects. For a description of these
- * abstractions please see https://cloud.google.com/storage/docs.
+ * abstractions please see [Cloud Storage
+ * documentation](https://cloud.google.com/storage/docs).
* Resources are named as follows:
* - Projects are referred to as they are defined by the Resource Manager API,
* using strings like `projects/123456` or `projects/my-string-id`.
* - Buckets are named using string names of the form:
- * `projects/{project}/buckets/{bucket}`
- * For globally unique buckets, `_` may be substituted for the project.
+ * `projects/{project}/buckets/{bucket}`.
+ * For globally unique buckets, `_` might be substituted for the project.
* - Objects are uniquely identified by their name along with the name of the
* bucket they belong to, as separate strings in this API. For example:
- * ReadObjectRequest {
+ * ```
+ * ReadObjectRequest {
* bucket: 'projects/_/buckets/my-bucket'
* object: 'my-object'
- * }
- * Note that object names can contain `/` characters, which are treated as
- * any other character (no special directory semantics).
+ * }
+ * ```
+ * Note that object names can contain `/` characters, which are treated as
+ * any other character (no special directory semantics).
*
*/
public static final class StorageBlockingStub
@@ -2768,6 +3100,25 @@ protected StorageBlockingStub build(io.grpc.Channel channel, io.grpc.CallOptions
*
*
* Permanently deletes an empty bucket.
+ * The request fails if there are any live or
+ * noncurrent objects in the bucket, but the request succeeds if the
+ * bucket only contains soft-deleted objects or incomplete uploads, such
+ * as ongoing XML API multipart uploads. Does not permanently delete
+ * soft-deleted objects.
+ * When this API is used to delete a bucket containing an object that has a
+ * soft delete policy
+ * enabled, the object becomes soft deleted, and the
+ * `softDeleteTime` and `hardDeleteTime` properties are set on the
+ * object.
+ * Objects and multipart uploads that were in the bucket at the time of
+ * deletion are also retained for the specified retention duration. When
+ * a soft-deleted bucket reaches the end of its retention duration, it
+ * is permanently deleted. The `hardDeleteTime` of the bucket always
+ * equals
+ * or exceeds the expiration time of the last soft-deleted object in the
+ * bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.delete` IAM permission on the bucket.
*
*/
public com.google.protobuf.Empty deleteBucket(
@@ -2781,6 +3132,13 @@ public com.google.protobuf.Empty deleteBucket(
*
*
* Returns metadata for the specified bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.get`
+ * IAM permission on
+ * the bucket. Additionally, to return specific bucket metadata, the
+ * authenticated user must have the following permissions:
+ * - To return the IAM policies: `storage.buckets.getIamPolicy`
+ * - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
*
*/
public com.google.storage.v2.Bucket getBucket(com.google.storage.v2.GetBucketRequest request) {
@@ -2793,6 +3151,13 @@ public com.google.storage.v2.Bucket getBucket(com.google.storage.v2.GetBucketReq
*
*
* Creates a new bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.create` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated user
+ * must have the following permissions:
+ * - To enable object retention using the `enableObjectRetention` query
+ * parameter: `storage.buckets.enableObjectRetention`
+ * - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
*
*/
public com.google.storage.v2.Bucket createBucket(
@@ -2805,7 +3170,14 @@ public com.google.storage.v2.Bucket createBucket(
*
*
*
- * Retrieves a list of buckets for a given project.
+ * Retrieves a list of buckets for a given project, ordered
+ * lexicographically by name.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.list` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated
+ * user must have the following permissions:
+ * - To list the IAM policies: `storage.buckets.getIamPolicy`
+ * - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
*
*/
public com.google.storage.v2.ListBucketsResponse listBuckets(
@@ -2818,7 +3190,20 @@ public com.google.storage.v2.ListBucketsResponse listBuckets(
*
*
*
- * Locks retention policy on a bucket.
+ * Permanently locks the retention
+ * policy that is
+ * currently applied to the specified bucket.
+ * Caution: Locking a bucket is an
+ * irreversible action. Once you lock a bucket:
+ * - You cannot remove the retention policy from the bucket.
+ * - You cannot decrease the retention period for the policy.
+ * Once locked, you must delete the entire bucket in order to remove the
+ * bucket's retention policy. However, before you can delete the bucket, you
+ * must delete all the objects in the bucket, which is only
+ * possible if all the objects have reached the retention period set by the
+ * retention policy.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.update` IAM permission on the bucket.
*
*/
public com.google.storage.v2.Bucket lockBucketRetentionPolicy(
@@ -2831,11 +3216,15 @@ public com.google.storage.v2.Bucket lockBucketRetentionPolicy(
*
*
*
- * Gets the IAM policy for a specified bucket.
+ * Gets the IAM policy for a specified bucket or managed folder.
* The `resource` field in the request should be
* `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
* for a managed folder.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.getIamPolicy` on the bucket or
+ * `storage.managedFolders.getIamPolicy` IAM permission on the
+ * managed folder.
*
*/
public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyRequest request) {
@@ -2847,7 +3236,7 @@ public com.google.iam.v1.Policy getIamPolicy(com.google.iam.v1.GetIamPolicyReque
*
*
*
- * Updates an IAM policy for the specified bucket.
+ * Updates an IAM policy for the specified bucket or managed folder.
* The `resource` field in the request should be
* `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
@@ -2864,9 +3253,8 @@ public com.google.iam.v1.Policy setIamPolicy(com.google.iam.v1.SetIamPolicyReque
*
*
*
*
* 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,
+ * 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.
@@ -2882,7 +3270,16 @@ public com.google.iam.v1.TestIamPermissionsResponse testIamPermissions(
*
*
*
*/
@@ -3050,16 +3482,14 @@ public com.google.storage.v2.RewriteResponse rewriteObject(
*
*
- * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+ * Updates a bucket. Changes to the bucket are readable immediately after
+ * writing, but configuration changes might take time to propagate. This
+ * method supports `patch` semantics.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.update` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated user
+ * must have the following permissions:
+ * - To set bucket IP filtering rules: `storage.buckets.setIpFilter`
+ * - To update public access prevention policies or access control lists
+ * (ACLs): `storage.buckets.setIamPolicy`
*
*/
public com.google.storage.v2.Bucket updateBucket(
@@ -2896,7 +3293,14 @@ public com.google.storage.v2.Bucket updateBucket(
*
*
* Concatenates a list of existing objects into a new object in the same
- * bucket.
+ * bucket. The existing source objects are unaffected by this operation.
+ * **IAM Permissions**:
+ * Requires the `storage.objects.create` and `storage.objects.get` IAM
+ * permissions to use this method. If the new composite object
+ * overwrites an existing object, the authenticated user must also have
+ * the `storage.objects.delete` permission. If the request body includes
+ * the retention property, the authenticated user must also have the
+ * `storage.objects.setRetention` IAM permission.
*
*/
public com.google.storage.v2.Object composeObject(
@@ -2911,7 +3315,7 @@ public com.google.storage.v2.Object composeObject(
*
* Deletes an object and its metadata. Deletions are permanent if versioning
* is not enabled for the bucket, or if the generation parameter is used, or
- * if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not
+ * if soft delete is not
* enabled for the bucket.
* When this API is used to delete an object from a bucket that has soft
* delete policy enabled, the object becomes soft deleted, and the
@@ -2923,9 +3327,7 @@ public com.google.storage.v2.Object composeObject(
* API to restore soft-deleted objects until the soft delete retention period
* has passed.
* **IAM Permissions**:
- * Requires `storage.objects.delete`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.delete` IAM permission on the bucket.
*
*/
public com.google.protobuf.Empty deleteObject(
@@ -2938,7 +3340,38 @@ public com.google.protobuf.Empty deleteObject(
*
*
*
- * Restores a soft-deleted object.
+ * Restores a
+ * soft-deleted object.
+ * When a soft-deleted object is restored, a new copy of that object is
+ * created in the same bucket and inherits the same metadata as the
+ * soft-deleted object. The inherited metadata is the metadata that existed
+ * when the original object became soft deleted, with the following
+ * exceptions:
+ * - The `createTime` of the new object is set to the time at which the
+ * soft-deleted object was restored.
+ * - The `softDeleteTime` and `hardDeleteTime` values are cleared.
+ * - A new generation is assigned and the metageneration is reset to 1.
+ * - If the soft-deleted object was in a bucket that had Autoclass enabled,
+ * the new object is
+ * restored to Standard storage.
+ * - The restored object inherits the bucket's default object ACL, unless
+ * `copySourceAcl` is `true`.
+ * If a live object using the same name already exists in the bucket and
+ * becomes overwritten, the live object becomes a noncurrent object if Object
+ * Versioning is enabled on the bucket. If Object Versioning is not enabled,
+ * the live object becomes soft deleted.
+ * **IAM Permissions**:
+ * Requires the following IAM permissions to use this method:
+ * - `storage.objects.restore`
+ * - `storage.objects.create`
+ * - `storage.objects.delete` (only required if overwriting an existing
+ * object)
+ * - `storage.objects.getIamPolicy` (only required if `projection` is `full`
+ * and the relevant bucket
+ * has uniform bucket-level access disabled)
+ * - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is
+ * `true` and the relevant
+ * bucket has uniform bucket-level access disabled)
*
*/
public com.google.storage.v2.Object restoreObject(
@@ -2953,8 +3386,8 @@ public com.google.storage.v2.Object restoreObject(
*
* Cancels an in-progress resumable upload.
* Any attempts to write to the resumable upload after cancelling the upload
- * will fail.
- * The behavior for currently in progress write operations is not guaranteed -
+ * fail.
+ * The behavior for any in-progress write operations is not guaranteed;
* they could either complete before the cancellation or fail if the
* cancellation completes first.
*
@@ -2971,9 +3404,8 @@ public com.google.storage.v2.CancelResumableWriteResponse cancelResumableWrite(
*
* Retrieves object metadata.
* **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket. To return object ACLs, the authenticated user must also have
+ * Requires `storage.objects.get` IAM permission on the bucket.
+ * To return object ACLs, the authenticated user must also have
* the `storage.objects.getIamPolicy` permission.
*
*/
@@ -2988,9 +3420,7 @@ public com.google.storage.v2.Object getObject(com.google.storage.v2.GetObjectReq
*
* Retrieves object data.
* **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.get` IAM permission on the bucket.
*
*/
public java.util.Iterator
* Updates an object's metadata.
- * Equivalent to JSON API's storage.objects.patch.
+ * Equivalent to JSON API's `storage.objects.patch` method.
+ * **IAM Permissions**:
+ * Requires `storage.objects.update` IAM permission on the bucket.
*
*/
public com.google.storage.v2.Object updateObject(
@@ -3020,8 +3452,8 @@ public com.google.storage.v2.Object updateObject(
* Retrieves a list of objects matching the criteria.
* **IAM Permissions**:
* The authenticated user requires `storage.objects.list`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions)
- * to use this method. To return object ACLs, the authenticated user must also
+ * IAM permission to use this method. To return object ACLs, the
+ * authenticated user must also
* have the `storage.objects.getIamPolicy` permission.
*
* Starts a resumable write operation. This
- * method is part of the [Resumable
- * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+ * method is part of the Resumable
+ * upload feature.
* This allows you to upload large objects in multiple chunks, which is more
* resilient to network interruptions than a single upload. The validity
* duration of the write operation, and the consequences of it becoming
* invalid, are service-dependent.
* **IAM Permissions**:
- * Requires `storage.objects.create`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.create` IAM permission on the bucket.
*
*/
public com.google.storage.v2.StartResumableWriteResponse startResumableWrite(
@@ -3073,8 +3503,8 @@ public com.google.storage.v2.StartResumableWriteResponse startResumableWrite(
*
*
* Determines the `persisted_size` of an object that is being written. This
- * method is part of the [resumable
- * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+ * method is part of the resumable
+ * upload feature.
* The returned value is the size of the object that has been persisted so
* far. The value can be used as the `write_offset` for the next `Write()`
* call.
@@ -3100,6 +3530,16 @@ public com.google.storage.v2.QueryWriteStatusResponse queryWriteStatus(
*
*
*/
public static final class StorageFutureStub
@@ -3149,6 +3592,25 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
*
*
* Moves the source object to the destination object in the same bucket.
+ * This operation moves a source object to a destination object in the
+ * same bucket by renaming the object. The move itself is an atomic
+ * transaction, ensuring all steps either complete successfully or no
+ * changes are made.
+ * **IAM Permissions**:
+ * Requires the following IAM permissions to use this method:
+ * - `storage.objects.move`
+ * - `storage.objects.create`
+ * - `storage.objects.delete` (only required if overwriting an existing
+ * object)
*
*/
public com.google.storage.v2.Object moveObject(
@@ -3116,21 +3556,24 @@ public com.google.storage.v2.Object moveObject(
* ## API Overview and Naming Syntax
* The Cloud Storage gRPC API allows applications to read and write data through
* the abstractions of buckets and objects. For a description of these
- * abstractions please see https://cloud.google.com/storage/docs.
+ * abstractions please see [Cloud Storage
+ * documentation](https://cloud.google.com/storage/docs).
* Resources are named as follows:
* - Projects are referred to as they are defined by the Resource Manager API,
* using strings like `projects/123456` or `projects/my-string-id`.
* - Buckets are named using string names of the form:
- * `projects/{project}/buckets/{bucket}`
- * For globally unique buckets, `_` may be substituted for the project.
+ * `projects/{project}/buckets/{bucket}`.
+ * For globally unique buckets, `_` might be substituted for the project.
* - Objects are uniquely identified by their name along with the name of the
* bucket they belong to, as separate strings in this API. For example:
- * ReadObjectRequest {
+ * ```
+ * ReadObjectRequest {
* bucket: 'projects/_/buckets/my-bucket'
* object: 'my-object'
- * }
- * Note that object names can contain `/` characters, which are treated as
- * any other character (no special directory semantics).
+ * }
+ * ```
+ * Note that object names can contain `/` characters, which are treated as
+ * any other character (no special directory semantics).
*
* Permanently deletes an empty bucket.
+ * The request fails if there are any live or
+ * noncurrent objects in the bucket, but the request succeeds if the
+ * bucket only contains soft-deleted objects or incomplete uploads, such
+ * as ongoing XML API multipart uploads. Does not permanently delete
+ * soft-deleted objects.
+ * When this API is used to delete a bucket containing an object that has a
+ * soft delete policy
+ * enabled, the object becomes soft deleted, and the
+ * `softDeleteTime` and `hardDeleteTime` properties are set on the
+ * object.
+ * Objects and multipart uploads that were in the bucket at the time of
+ * deletion are also retained for the specified retention duration. When
+ * a soft-deleted bucket reaches the end of its retention duration, it
+ * is permanently deleted. The `hardDeleteTime` of the bucket always
+ * equals
+ * or exceeds the expiration time of the last soft-deleted object in the
+ * bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.delete` IAM permission on the bucket.
*
*/
public com.google.common.util.concurrent.ListenableFuture
* Returns metadata for the specified bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.get`
+ * IAM permission on
+ * the bucket. Additionally, to return specific bucket metadata, the
+ * authenticated user must have the following permissions:
+ * - To return the IAM policies: `storage.buckets.getIamPolicy`
+ * - To return the bucket IP filtering rules: `storage.buckets.getIpFilter`
*
*/
public com.google.common.util.concurrent.ListenableFuture
* Creates a new bucket.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.create` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated user
+ * must have the following permissions:
+ * - To enable object retention using the `enableObjectRetention` query
+ * parameter: `storage.buckets.enableObjectRetention`
+ * - To set the bucket IP filtering rules: `storage.buckets.setIpFilter`
*
*/
public com.google.common.util.concurrent.ListenableFuture
- * Retrieves a list of buckets for a given project.
+ * Retrieves a list of buckets for a given project, ordered
+ * lexicographically by name.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.list` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated
+ * user must have the following permissions:
+ * - To list the IAM policies: `storage.buckets.getIamPolicy`
+ * - To list the bucket IP filtering rules: `storage.buckets.getIpFilter`
*
*/
public com.google.common.util.concurrent.ListenableFuture<
@@ -3201,7 +3684,20 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
*
*
*
- * Locks retention policy on a bucket.
+ * Permanently locks the retention
+ * policy that is
+ * currently applied to the specified bucket.
+ * Caution: Locking a bucket is an
+ * irreversible action. Once you lock a bucket:
+ * - You cannot remove the retention policy from the bucket.
+ * - You cannot decrease the retention period for the policy.
+ * Once locked, you must delete the entire bucket in order to remove the
+ * bucket's retention policy. However, before you can delete the bucket, you
+ * must delete all the objects in the bucket, which is only
+ * possible if all the objects have reached the retention period set by the
+ * retention policy.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.update` IAM permission on the bucket.
*
*/
public com.google.common.util.concurrent.ListenableFuture
- * Gets the IAM policy for a specified bucket.
+ * Gets the IAM policy for a specified bucket or managed folder.
* The `resource` field in the request should be
* `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
* for a managed folder.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.getIamPolicy` on the bucket or
+ * `storage.managedFolders.getIamPolicy` IAM permission on the
+ * managed folder.
*
*/
public com.google.common.util.concurrent.ListenableFuture
- * Updates an IAM policy for the specified bucket.
+ * Updates an IAM policy for the specified bucket or managed folder.
* The `resource` field in the request should be
* `projects/_/buckets/{bucket}` for a bucket, or
* `projects/_/buckets/{bucket}/managedFolders/{managedFolder}`
@@ -3249,9 +3749,8 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
*
*
*
*
* 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,
+ * 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.
@@ -3268,7 +3767,16 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
*
*
*
*/
@@ -3422,16 +3967,14 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
*
*
- * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.
+ * Updates a bucket. Changes to the bucket are readable immediately after
+ * writing, but configuration changes might take time to propagate. This
+ * method supports `patch` semantics.
+ * **IAM Permissions**:
+ * Requires `storage.buckets.update` IAM permission on the bucket.
+ * Additionally, to enable specific bucket features, the authenticated user
+ * must have the following permissions:
+ * - To set bucket IP filtering rules: `storage.buckets.setIpFilter`
+ * - To update public access prevention policies or access control lists
+ * (ACLs): `storage.buckets.setIamPolicy`
*
*/
public com.google.common.util.concurrent.ListenableFuture
* Concatenates a list of existing objects into a new object in the same
- * bucket.
+ * bucket. The existing source objects are unaffected by this operation.
+ * **IAM Permissions**:
+ * Requires the `storage.objects.create` and `storage.objects.get` IAM
+ * permissions to use this method. If the new composite object
+ * overwrites an existing object, the authenticated user must also have
+ * the `storage.objects.delete` permission. If the request body includes
+ * the retention property, the authenticated user must also have the
+ * `storage.objects.setRetention` IAM permission.
*
*/
public com.google.common.util.concurrent.ListenableFuture
* Deletes an object and its metadata. Deletions are permanent if versioning
* is not enabled for the bucket, or if the generation parameter is used, or
- * if [soft delete](https://cloud.google.com/storage/docs/soft-delete) is not
+ * if soft delete is not
* enabled for the bucket.
* When this API is used to delete an object from a bucket that has soft
* delete policy enabled, the object becomes soft deleted, and the
@@ -3309,9 +3824,7 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
* API to restore soft-deleted objects until the soft delete retention period
* has passed.
* **IAM Permissions**:
- * Requires `storage.objects.delete`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.delete` IAM permission on the bucket.
*
*/
public com.google.common.util.concurrent.ListenableFuture
- * Restores a soft-deleted object.
+ * Restores a
+ * soft-deleted object.
+ * When a soft-deleted object is restored, a new copy of that object is
+ * created in the same bucket and inherits the same metadata as the
+ * soft-deleted object. The inherited metadata is the metadata that existed
+ * when the original object became soft deleted, with the following
+ * exceptions:
+ * - The `createTime` of the new object is set to the time at which the
+ * soft-deleted object was restored.
+ * - The `softDeleteTime` and `hardDeleteTime` values are cleared.
+ * - A new generation is assigned and the metageneration is reset to 1.
+ * - If the soft-deleted object was in a bucket that had Autoclass enabled,
+ * the new object is
+ * restored to Standard storage.
+ * - The restored object inherits the bucket's default object ACL, unless
+ * `copySourceAcl` is `true`.
+ * If a live object using the same name already exists in the bucket and
+ * becomes overwritten, the live object becomes a noncurrent object if Object
+ * Versioning is enabled on the bucket. If Object Versioning is not enabled,
+ * the live object becomes soft deleted.
+ * **IAM Permissions**:
+ * Requires the following IAM permissions to use this method:
+ * - `storage.objects.restore`
+ * - `storage.objects.create`
+ * - `storage.objects.delete` (only required if overwriting an existing
+ * object)
+ * - `storage.objects.getIamPolicy` (only required if `projection` is `full`
+ * and the relevant bucket
+ * has uniform bucket-level access disabled)
+ * - `storage.objects.setIamPolicy` (only required if `copySourceAcl` is
+ * `true` and the relevant
+ * bucket has uniform bucket-level access disabled)
*
*/
public com.google.common.util.concurrent.ListenableFuture
* Cancels an in-progress resumable upload.
* Any attempts to write to the resumable upload after cancelling the upload
- * will fail.
- * The behavior for currently in progress write operations is not guaranteed -
+ * fail.
+ * The behavior for any in-progress write operations is not guaranteed;
* they could either complete before the cancellation or fail if the
* cancellation completes first.
*
@@ -3358,9 +3902,8 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
*
* Retrieves object metadata.
* **IAM Permissions**:
- * Requires `storage.objects.get`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket. To return object ACLs, the authenticated user must also have
+ * Requires `storage.objects.get` IAM permission on the bucket.
+ * To return object ACLs, the authenticated user must also have
* the `storage.objects.getIamPolicy` permission.
*
*/
@@ -3375,7 +3918,9 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
*
*
* Updates an object's metadata.
- * Equivalent to JSON API's storage.objects.patch.
+ * Equivalent to JSON API's `storage.objects.patch` method.
+ * **IAM Permissions**:
+ * Requires `storage.objects.update` IAM permission on the bucket.
*
*/
public com.google.common.util.concurrent.ListenableFuture
* Starts a resumable write operation. This
- * method is part of the [Resumable
- * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+ * method is part of the Resumable
+ * upload feature.
* This allows you to upload large objects in multiple chunks, which is more
* resilient to network interruptions than a single upload. The validity
* duration of the write operation, and the consequences of it becoming
* invalid, are service-dependent.
* **IAM Permissions**:
- * Requires `storage.objects.create`
- * [IAM permission](https://cloud.google.com/iam/docs/overview#permissions) on
- * the bucket.
+ * Requires `storage.objects.create` IAM permission on the bucket.
*
*/
public com.google.common.util.concurrent.ListenableFuture<
@@ -3446,8 +3989,8 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
*
*
* Determines the `persisted_size` of an object that is being written. This
- * method is part of the [resumable
- * upload](https://cloud.google.com/storage/docs/resumable-uploads) feature.
+ * method is part of the resumable
+ * upload feature.
* The returned value is the size of the object that has been persisted so
* far. The value can be used as the `write_offset` for the next `Write()`
* call.
@@ -3474,6 +4017,16 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
*
*
*
*
* Moves the source object to the destination object in the same bucket.
+ * This operation moves a source object to a destination object in the
+ * same bucket by renaming the object. The move itself is an atomic
+ * transaction, ensuring all steps either complete successfully or no
+ * changes are made.
+ * **IAM Permissions**:
+ * Requires the following IAM permissions to use this method:
+ * - `storage.objects.move`
+ * - `storage.objects.create`
+ * - `storage.objects.delete` (only required if overwriting an existing
+ * object)
*
*/
public com.google.common.util.concurrent.ListenableFuture
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
@@ -309,7 +309,7 @@ public boolean hasRoutingToken() {
*
*
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
@@ -334,7 +334,7 @@ public java.lang.String getRoutingToken() {
*
*
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
@@ -1407,7 +1407,7 @@ public Builder clearIfMetagenerationNotMatch() {
*
*
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
@@ -1423,7 +1423,7 @@ public boolean hasRoutingToken() {
*
*
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
@@ -1447,7 +1447,7 @@ public java.lang.String getRoutingToken() {
*
*
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
@@ -1471,7 +1471,7 @@ public com.google.protobuf.ByteString getRoutingTokenBytes() {
*
*
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
@@ -1494,7 +1494,7 @@ public Builder setRoutingToken(java.lang.String value) {
*
*
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
@@ -1513,7 +1513,7 @@ public Builder clearRoutingToken() {
*
*
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpecOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpecOrBuilder.java
index 1f3642ae3d..489924de7e 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpecOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/AppendObjectSpecOrBuilder.java
@@ -166,7 +166,7 @@ public interface AppendObjectSpecOrBuilder
*
*
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
@@ -180,7 +180,7 @@ public interface AppendObjectSpecOrBuilder
*
*
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
@@ -194,7 +194,7 @@ public interface AppendObjectSpecOrBuilder
*
*
* An optional routing token that influences request routing for the stream.
- * Must be provided if a BidiWriteObjectRedirectedError is returned.
+ * Must be provided if a `BidiWriteObjectRedirectedError` is returned.
*
*
* optional string routing_token = 6;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadHandle.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadHandle.java
index 3bf53ad542..90c60b537d 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadHandle.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadHandle.java
@@ -23,8 +23,8 @@
*
*
*
- * BidiReadHandle contains a handle from a previous BiDiReadObject
- * invocation. The client can use this instead of BidiReadObjectSpec as an
+ * `BidiReadHandle` contains a handle from a previous `BiDiReadObject`
+ * invocation. The client can use this instead of `BidiReadObjectSpec` as an
* optimized way of opening subsequent bidirectional streams to the same object.
*
*
@@ -247,8 +247,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * BidiReadHandle contains a handle from a previous BiDiReadObject
- * invocation. The client can use this instead of BidiReadObjectSpec as an
+ * `BidiReadHandle` contains a handle from a previous `BiDiReadObject`
+ * invocation. The client can use this instead of `BidiReadObjectSpec` as an
* optimized way of opening subsequent bidirectional streams to the same object.
*
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedError.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedError.java
index 97f2b0ca51..423c663e52 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedError.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedError.java
@@ -23,7 +23,7 @@
*
*
*
- * Error proto containing details for a redirected read. This error may be
+ * Error proto containing details for a redirected read. This error might be
* attached as details for an ABORTED response to BidiReadObject.
*
*
@@ -73,8 +73,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -90,8 +90,8 @@ public boolean hasReadHandle() {
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -109,8 +109,8 @@ public com.google.storage.v2.BidiReadHandle getReadHandle() {
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -380,7 +380,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * Error proto containing details for a redirected read. This error may be
+ * Error proto containing details for a redirected read. This error might be
* attached as details for an ABORTED response to BidiReadObject.
*
*
@@ -601,8 +601,8 @@ public Builder mergeFrom(
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -617,8 +617,8 @@ public boolean hasReadHandle() {
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -639,8 +639,8 @@ public com.google.storage.v2.BidiReadHandle getReadHandle() {
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -663,8 +663,8 @@ public Builder setReadHandle(com.google.storage.v2.BidiReadHandle value) {
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -684,8 +684,8 @@ public Builder setReadHandle(com.google.storage.v2.BidiReadHandle.Builder builde
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -713,8 +713,8 @@ public Builder mergeReadHandle(com.google.storage.v2.BidiReadHandle value) {
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -734,8 +734,8 @@ public Builder clearReadHandle() {
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -750,8 +750,8 @@ public com.google.storage.v2.BidiReadHandle.Builder getReadHandleBuilder() {
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -770,8 +770,8 @@ public com.google.storage.v2.BidiReadHandleOrBuilder getReadHandleOrBuilder() {
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedErrorOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedErrorOrBuilder.java
index fe5c964b95..473c6030a4 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedErrorOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRedirectedErrorOrBuilder.java
@@ -28,8 +28,8 @@ public interface BidiReadObjectRedirectedErrorOrBuilder
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -42,8 +42,8 @@ public interface BidiReadObjectRedirectedErrorOrBuilder
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
@@ -56,8 +56,8 @@ public interface BidiReadObjectRedirectedErrorOrBuilder
*
*
*
- * The read handle for the redirected read. If set, the client may use this in
- * the BidiReadObjectSpec when retrying the read stream.
+ * The read handle for the redirected read. If set, the client might use this
+ * in the BidiReadObjectSpec when retrying the read stream.
*
*
* .google.storage.v2.BidiReadHandle read_handle = 1;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequest.java
index faf2cf9966..12da44f004 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequest.java
@@ -23,7 +23,8 @@
*
*
*
- * Request message for BidiReadObject.
+ * Request message for
+ * [BidiReadObject][google.storage.v2.Storage.BidiReadObject].
*
*
* Protobuf type {@code google.storage.v2.BidiReadObjectRequest}
@@ -73,8 +74,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -93,8 +94,8 @@ public boolean hasReadObjectSpec() {
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -115,8 +116,8 @@ public com.google.storage.v2.BidiReadObjectSpec getReadObjectSpec() {
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -141,10 +142,10 @@ public com.google.storage.v2.BidiReadObjectSpecOrBuilder getReadObjectSpecOrBuil
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -162,10 +163,10 @@ public java.util.List
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -184,10 +185,10 @@ public java.util.List
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -205,10 +206,10 @@ public int getReadRangesCount() {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -226,10 +227,10 @@ public com.google.storage.v2.ReadRange getReadRanges(int index) {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -421,7 +422,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * Request message for BidiReadObject.
+ * Request message for
+ * [BidiReadObject][google.storage.v2.Storage.BidiReadObject].
*
*
* Protobuf type {@code google.storage.v2.BidiReadObjectRequest}
@@ -686,8 +688,8 @@ public Builder mergeFrom(
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -705,8 +707,8 @@ public boolean hasReadObjectSpec() {
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -730,8 +732,8 @@ public com.google.storage.v2.BidiReadObjectSpec getReadObjectSpec() {
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -757,8 +759,8 @@ public Builder setReadObjectSpec(com.google.storage.v2.BidiReadObjectSpec value)
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -782,8 +784,8 @@ public Builder setReadObjectSpec(
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -814,8 +816,8 @@ public Builder mergeReadObjectSpec(com.google.storage.v2.BidiReadObjectSpec valu
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -838,8 +840,8 @@ public Builder clearReadObjectSpec() {
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -857,8 +859,8 @@ public com.google.storage.v2.BidiReadObjectSpec.Builder getReadObjectSpecBuilder
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -880,8 +882,8 @@ public com.google.storage.v2.BidiReadObjectSpecOrBuilder getReadObjectSpecOrBuil
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -927,10 +929,10 @@ private void ensureReadRangesIsMutable() {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -951,10 +953,10 @@ public java.util.List
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -975,10 +977,10 @@ public int getReadRangesCount() {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -999,10 +1001,10 @@ public com.google.storage.v2.ReadRange getReadRanges(int index) {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1029,10 +1031,10 @@ public Builder setReadRanges(int index, com.google.storage.v2.ReadRange value) {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1057,10 +1059,10 @@ public Builder setReadRanges(
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1087,10 +1089,10 @@ public Builder addReadRanges(com.google.storage.v2.ReadRange value) {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1117,10 +1119,10 @@ public Builder addReadRanges(int index, com.google.storage.v2.ReadRange value) {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1144,10 +1146,10 @@ public Builder addReadRanges(com.google.storage.v2.ReadRange.Builder builderForV
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1172,10 +1174,10 @@ public Builder addReadRanges(
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1200,10 +1202,10 @@ public Builder addAllReadRanges(
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1227,10 +1229,10 @@ public Builder clearReadRanges() {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1254,10 +1256,10 @@ public Builder removeReadRanges(int index) {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1274,10 +1276,10 @@ public com.google.storage.v2.ReadRange.Builder getReadRangesBuilder(int index) {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1298,10 +1300,10 @@ public com.google.storage.v2.ReadRangeOrBuilder getReadRangesOrBuilder(int index
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1323,10 +1325,10 @@ public com.google.storage.v2.ReadRangeOrBuilder getReadRangesOrBuilder(int index
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1344,10 +1346,10 @@ public com.google.storage.v2.ReadRange.Builder addReadRangesBuilder() {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -1365,10 +1367,10 @@ public com.google.storage.v2.ReadRange.Builder addReadRangesBuilder(int index) {
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequestOrBuilder.java
index a2153c64ae..511010dff7 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectRequestOrBuilder.java
@@ -29,8 +29,8 @@ public interface BidiReadObjectRequestOrBuilder
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -46,8 +46,8 @@ public interface BidiReadObjectRequestOrBuilder
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -63,8 +63,8 @@ public interface BidiReadObjectRequestOrBuilder
*
*
* Optional. The first message of each stream should set this field. If this
- * is not the first message, an error will be returned. Describes the object
- * to read.
+ * is not the first message, an error is returned. Describes the object to
+ * read.
*
*
*
@@ -79,10 +79,10 @@ public interface BidiReadObjectRequestOrBuilder
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -97,10 +97,10 @@ public interface BidiReadObjectRequestOrBuilder
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -115,10 +115,10 @@ public interface BidiReadObjectRequestOrBuilder
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -133,10 +133,10 @@ public interface BidiReadObjectRequestOrBuilder
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
@@ -151,10 +151,10 @@ public interface BidiReadObjectRequestOrBuilder
*
* Optional. Provides a list of 0 or more (up to 100) ranges to read. If a
* single range is large enough to require multiple responses, they are
- * guaranteed to be delivered in increasing offset order. There are no
- * ordering guarantees across ranges. When no ranges are provided, the
- * response message will not include ObjectRangeData. For full object
- * downloads, the offset and size can be set to 0.
+ * delivered in increasing offset order. There are no ordering guarantees
+ * across ranges. When no ranges are provided, the response message
+ * doesn't include `ObjectRangeData`. For full object downloads, the
+ * offset and size can be set to `0`.
*
*
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponse.java
index e73610a3d8..95c96e91f3 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponse.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponse.java
@@ -23,7 +23,8 @@
*
*
*
- * Response message for BidiReadObject.
+ * Response message for
+ * [BidiReadObject][google.storage.v2.Storage.BidiReadObject].
*
*
* Protobuf type {@code google.storage.v2.BidiReadObjectResponse}
@@ -74,13 +75,13 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -94,13 +95,13 @@ public java.util.List
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -115,13 +116,13 @@ public java.util.List
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -135,13 +136,13 @@ public int getObjectDataRangesCount() {
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -155,13 +156,13 @@ public com.google.storage.v2.ObjectRangeData getObjectDataRanges(int index) {
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -233,7 +234,7 @@ public com.google.storage.v2.ObjectOrBuilder getMetadataOrBuilder() {
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -251,7 +252,7 @@ public boolean hasReadHandle() {
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -271,7 +272,7 @@ public com.google.storage.v2.BidiReadHandle getReadHandle() {
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -479,7 +480,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * Response message for BidiReadObject.
+ * Response message for
+ * [BidiReadObject][google.storage.v2.Storage.BidiReadObject].
*
*
* Protobuf type {@code google.storage.v2.BidiReadObjectResponse}
@@ -772,13 +774,13 @@ private void ensureObjectDataRangesIsMutable() {
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -795,13 +797,13 @@ public java.util.List
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -818,13 +820,13 @@ public int getObjectDataRangesCount() {
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -841,13 +843,13 @@ public com.google.storage.v2.ObjectRangeData getObjectDataRanges(int index) {
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -870,13 +872,13 @@ public Builder setObjectDataRanges(int index, com.google.storage.v2.ObjectRangeD
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -897,13 +899,13 @@ public Builder setObjectDataRanges(
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -926,13 +928,13 @@ public Builder addObjectDataRanges(com.google.storage.v2.ObjectRangeData value)
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -955,13 +957,13 @@ public Builder addObjectDataRanges(int index, com.google.storage.v2.ObjectRangeD
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -982,13 +984,13 @@ public Builder addObjectDataRanges(
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1009,13 +1011,13 @@ public Builder addObjectDataRanges(
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1036,13 +1038,13 @@ public Builder addAllObjectDataRanges(
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1062,13 +1064,13 @@ public Builder clearObjectDataRanges() {
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1088,13 +1090,13 @@ public Builder removeObjectDataRanges(int index) {
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1107,13 +1109,13 @@ public com.google.storage.v2.ObjectRangeData.Builder getObjectDataRangesBuilder(
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1130,13 +1132,13 @@ public com.google.storage.v2.ObjectRangeDataOrBuilder getObjectDataRangesOrBuild
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1154,13 +1156,13 @@ public com.google.storage.v2.ObjectRangeDataOrBuilder getObjectDataRangesOrBuild
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1174,13 +1176,13 @@ public com.google.storage.v2.ObjectRangeData.Builder addObjectDataRangesBuilder(
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1194,13 +1196,13 @@ public com.google.storage.v2.ObjectRangeData.Builder addObjectDataRangesBuilder(
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -1449,7 +1451,7 @@ public com.google.storage.v2.ObjectOrBuilder getMetadataOrBuilder() {
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -1466,7 +1468,7 @@ public boolean hasReadHandle() {
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -1489,7 +1491,7 @@ public com.google.storage.v2.BidiReadHandle getReadHandle() {
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -1514,7 +1516,7 @@ public Builder setReadHandle(com.google.storage.v2.BidiReadHandle value) {
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -1536,7 +1538,7 @@ public Builder setReadHandle(com.google.storage.v2.BidiReadHandle.Builder builde
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -1566,7 +1568,7 @@ public Builder mergeReadHandle(com.google.storage.v2.BidiReadHandle value) {
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -1588,7 +1590,7 @@ public Builder clearReadHandle() {
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -1605,7 +1607,7 @@ public com.google.storage.v2.BidiReadHandle.Builder getReadHandleBuilder() {
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -1626,7 +1628,7 @@ public com.google.storage.v2.BidiReadHandleOrBuilder getReadHandleOrBuilder() {
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponseOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponseOrBuilder.java
index 351816bbe9..baa53920bf 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponseOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectResponseOrBuilder.java
@@ -28,13 +28,13 @@ public interface BidiReadObjectResponseOrBuilder
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -45,13 +45,13 @@ public interface BidiReadObjectResponseOrBuilder
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -62,13 +62,13 @@ public interface BidiReadObjectResponseOrBuilder
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -79,13 +79,13 @@ public interface BidiReadObjectResponseOrBuilder
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -97,13 +97,13 @@ public interface BidiReadObjectResponseOrBuilder
*
*
*
- * A portion of the object's data. The service **may** leave data
- * empty for any given ReadResponse. This enables the service to inform the
+ * A portion of the object's data. The service might leave data
+ * empty for any given `ReadResponse`. This enables the service to inform the
* client that the request is still live while it is running an operation to
* generate more data.
- * The service **may** pipeline multiple responses belonging to different read
- * requests. Each ObjectRangeData entry will have a read_id
- * set to the same value as the corresponding source read request.
+ * The service might pipeline multiple responses belonging to different read
+ * requests. Each `ObjectRangeData` entry has a `read_id` that is set
+ * to the same value as the corresponding source read request.
*
*
* repeated .google.storage.v2.ObjectRangeData object_data_ranges = 6;
@@ -157,7 +157,7 @@ public interface BidiReadObjectResponseOrBuilder
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -172,7 +172,7 @@ public interface BidiReadObjectResponseOrBuilder
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
@@ -187,7 +187,7 @@ public interface BidiReadObjectResponseOrBuilder
*
*
*
- * This field will be periodically refreshed, however it may not be set in
+ * This field is periodically refreshed, however it might not be set in
* every response. It allows the client to more efficiently open subsequent
* bidirectional streams to the same object.
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpec.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpec.java
index 9b4e87d911..63ba0c2c82 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpec.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpec.java
@@ -422,19 +422,18 @@ public com.google.storage.v2.CommonObjectRequestParams getCommonObjectRequestPar
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
*
* @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
- * google/storage/v2/storage.proto;l=1027
+ * google/storage/v2/storage.proto;l=1187
* @return Whether the readMask field is set.
*/
@java.lang.Override
@@ -448,19 +447,18 @@ public boolean hasReadMask() {
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
*
* @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
- * google/storage/v2/storage.proto;l=1027
+ * google/storage/v2/storage.proto;l=1187
* @return The readMask.
*/
@java.lang.Override
@@ -474,13 +472,12 @@ public com.google.protobuf.FieldMask getReadMask() {
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2113,19 +2110,18 @@ public Builder clearCommonObjectRequestParams() {
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
*
* @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
- * google/storage/v2/storage.proto;l=1027
+ * google/storage/v2/storage.proto;l=1187
* @return Whether the readMask field is set.
*/
@java.lang.Deprecated
@@ -2138,19 +2134,18 @@ public boolean hasReadMask() {
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
*
* @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
- * google/storage/v2/storage.proto;l=1027
+ * google/storage/v2/storage.proto;l=1187
* @return The readMask.
*/
@java.lang.Deprecated
@@ -2167,13 +2162,12 @@ public com.google.protobuf.FieldMask getReadMask() {
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2198,13 +2192,12 @@ public Builder setReadMask(com.google.protobuf.FieldMask value) {
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2226,13 +2219,12 @@ public Builder setReadMask(com.google.protobuf.FieldMask.Builder builderForValue
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2262,13 +2254,12 @@ public Builder mergeReadMask(com.google.protobuf.FieldMask value) {
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2290,13 +2281,12 @@ public Builder clearReadMask() {
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2313,13 +2303,12 @@ public com.google.protobuf.FieldMask.Builder getReadMaskBuilder() {
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
@@ -2338,13 +2327,12 @@ public com.google.protobuf.FieldMaskOrBuilder getReadMaskOrBuilder() {
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpecOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpecOrBuilder.java
index 6859b67d6d..56673655f0 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpecOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiReadObjectSpecOrBuilder.java
@@ -263,19 +263,18 @@ public interface BidiReadObjectSpecOrBuilder
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
*
* @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
- * google/storage/v2/storage.proto;l=1027
+ * google/storage/v2/storage.proto;l=1187
* @return Whether the readMask field is set.
*/
@java.lang.Deprecated
@@ -286,19 +285,18 @@ public interface BidiReadObjectSpecOrBuilder
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
*
* @deprecated google.storage.v2.BidiReadObjectSpec.read_mask is deprecated. See
- * google/storage/v2/storage.proto;l=1027
+ * google/storage/v2/storage.proto;l=1187
* @return The readMask.
*/
@java.lang.Deprecated
@@ -309,13 +307,12 @@ public interface BidiReadObjectSpecOrBuilder
*
*
* Mask specifying which fields to read.
- * The checksummed_data field and its children will always be present.
- * If no mask is specified, will default to all fields except metadata.owner
- * and metadata.acl.
- * * may be used to mean "all fields".
+ * The `checksummed_data` field and its children are always present.
+ * If no mask is specified, it defaults to all fields except `metadata.
+ * owner` and `metadata.acl`.
+ * `*` might be used to mean "all fields".
* As per https://google.aip.dev/161, this field is deprecated.
- * As an alternative, grpc metadata can be used:
- * https://cloud.google.com/apis/docs/system-parameters#definitions
+ * As an alternative, `grpc metadata` can be used:
*
*
* optional .google.protobuf.FieldMask read_mask = 12 [deprecated = true];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteHandle.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteHandle.java
index 65e5149c73..e86ed2a824 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteHandle.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteHandle.java
@@ -23,9 +23,9 @@
*
*
*
- * BidiWriteHandle contains a handle from a previous BidiWriteObject
- * invocation. The client can use this as an optimized way of opening subsequent
- * bidirectional streams to the same object.
+ * `BidiWriteHandle` contains a handle from a previous `BidiWriteObject`
+ * invocation. The client can use this instead of `BidiReadObjectSpec` as an
+ * optimized way of opening subsequent bidirectional streams to the same object.
*
*
* Protobuf type {@code google.storage.v2.BidiWriteHandle}
@@ -247,9 +247,9 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * BidiWriteHandle contains a handle from a previous BidiWriteObject
- * invocation. The client can use this as an optimized way of opening subsequent
- * bidirectional streams to the same object.
+ * `BidiWriteHandle` contains a handle from a previous `BidiWriteObject`
+ * invocation. The client can use this instead of `BidiReadObjectSpec` as an
+ * optimized way of opening subsequent bidirectional streams to the same object.
*
*
* Protobuf type {@code google.storage.v2.BidiWriteHandle}
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedError.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedError.java
index d785d0a379..9932c5982f 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedError.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedError.java
@@ -23,7 +23,7 @@
*
*
*
- * Error proto containing details for a redirected write. This error may be
+ * Error proto containing details for a redirected write. This error might be
* attached as details for an ABORTED response to BidiWriteObject.
*
*
@@ -151,7 +151,7 @@ public com.google.protobuf.ByteString getRoutingTokenBytes() {
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -169,7 +169,7 @@ public boolean hasWriteHandle() {
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -189,7 +189,7 @@ public com.google.storage.v2.BidiWriteHandle getWriteHandle() {
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -208,9 +208,9 @@ public com.google.storage.v2.BidiWriteHandleOrBuilder getWriteHandleOrBuilder()
*
*
*
- * The generation of the object that triggered the redirect. This will be set
- * iff write_handle is set. If set, the client must use this in an
- * AppendObjectSpec first_message when retrying the write stream.
+ * The generation of the object that triggered the redirect. This is set
+ * iff `write_handle` is set. If set, the client must use this in an
+ * `AppendObjectSpec` first_message when retrying the write stream.
*
*
* optional int64 generation = 3;
@@ -226,9 +226,9 @@ public boolean hasGeneration() {
*
*
*
- * The generation of the object that triggered the redirect. This will be set
- * iff write_handle is set. If set, the client must use this in an
- * AppendObjectSpec first_message when retrying the write stream.
+ * The generation of the object that triggered the redirect. This is set
+ * iff `write_handle` is set. If set, the client must use this in an
+ * `AppendObjectSpec` first_message when retrying the write stream.
*
*
* optional int64 generation = 3;
@@ -437,7 +437,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * Error proto containing details for a redirected write. This error may be
+ * Error proto containing details for a redirected write. This error might be
* attached as details for an ABORTED response to BidiWriteObject.
*
*
@@ -813,7 +813,7 @@ public Builder setRoutingTokenBytes(com.google.protobuf.ByteString value) {
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -830,7 +830,7 @@ public boolean hasWriteHandle() {
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -853,7 +853,7 @@ public com.google.storage.v2.BidiWriteHandle getWriteHandle() {
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -878,7 +878,7 @@ public Builder setWriteHandle(com.google.storage.v2.BidiWriteHandle value) {
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -900,7 +900,7 @@ public Builder setWriteHandle(com.google.storage.v2.BidiWriteHandle.Builder buil
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -930,7 +930,7 @@ public Builder mergeWriteHandle(com.google.storage.v2.BidiWriteHandle value) {
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -952,7 +952,7 @@ public Builder clearWriteHandle() {
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -969,7 +969,7 @@ public com.google.storage.v2.BidiWriteHandle.Builder getWriteHandleBuilder() {
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -990,7 +990,7 @@ public com.google.storage.v2.BidiWriteHandleOrBuilder getWriteHandleOrBuilder()
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -1018,9 +1018,9 @@ public com.google.storage.v2.BidiWriteHandleOrBuilder getWriteHandleOrBuilder()
*
*
*
- * The generation of the object that triggered the redirect. This will be set
- * iff write_handle is set. If set, the client must use this in an
- * AppendObjectSpec first_message when retrying the write stream.
+ * The generation of the object that triggered the redirect. This is set
+ * iff `write_handle` is set. If set, the client must use this in an
+ * `AppendObjectSpec` first_message when retrying the write stream.
*
*
* optional int64 generation = 3;
@@ -1036,9 +1036,9 @@ public boolean hasGeneration() {
*
*
*
- * The generation of the object that triggered the redirect. This will be set
- * iff write_handle is set. If set, the client must use this in an
- * AppendObjectSpec first_message when retrying the write stream.
+ * The generation of the object that triggered the redirect. This is set
+ * iff `write_handle` is set. If set, the client must use this in an
+ * `AppendObjectSpec` first_message when retrying the write stream.
*
*
* optional int64 generation = 3;
@@ -1054,9 +1054,9 @@ public long getGeneration() {
*
*
*
- * The generation of the object that triggered the redirect. This will be set
- * iff write_handle is set. If set, the client must use this in an
- * AppendObjectSpec first_message when retrying the write stream.
+ * The generation of the object that triggered the redirect. This is set
+ * iff `write_handle` is set. If set, the client must use this in an
+ * `AppendObjectSpec` first_message when retrying the write stream.
*
*
* optional int64 generation = 3;
@@ -1076,9 +1076,9 @@ public Builder setGeneration(long value) {
*
*
*
- * The generation of the object that triggered the redirect. This will be set
- * iff write_handle is set. If set, the client must use this in an
- * AppendObjectSpec first_message when retrying the write stream.
+ * The generation of the object that triggered the redirect. This is set
+ * iff `write_handle` is set. If set, the client must use this in an
+ * `AppendObjectSpec` first_message when retrying the write stream.
*
*
* optional int64 generation = 3;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedErrorOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedErrorOrBuilder.java
index 82f32c15df..beaef65e1e 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedErrorOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRedirectedErrorOrBuilder.java
@@ -75,7 +75,7 @@ public interface BidiWriteObjectRedirectedErrorOrBuilder
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -90,7 +90,7 @@ public interface BidiWriteObjectRedirectedErrorOrBuilder
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -105,7 +105,7 @@ public interface BidiWriteObjectRedirectedErrorOrBuilder
*
* Opaque value describing a previous write. If set, the client must use this
* in an AppendObjectSpec first_message when retrying the write stream. If not
- * set, clients may retry the original request.
+ * set, clients might retry the original request.
*
*
* optional .google.storage.v2.BidiWriteHandle write_handle = 2;
@@ -116,9 +116,9 @@ public interface BidiWriteObjectRedirectedErrorOrBuilder
*
*
*
- * The generation of the object that triggered the redirect. This will be set
- * iff write_handle is set. If set, the client must use this in an
- * AppendObjectSpec first_message when retrying the write stream.
+ * The generation of the object that triggered the redirect. This is set
+ * iff `write_handle` is set. If set, the client must use this in an
+ * `AppendObjectSpec` first_message when retrying the write stream.
*
*
* optional int64 generation = 3;
@@ -131,9 +131,9 @@ public interface BidiWriteObjectRedirectedErrorOrBuilder
*
*
*
- * The generation of the object that triggered the redirect. This will be set
- * iff write_handle is set. If set, the client must use this in an
- * AppendObjectSpec first_message when retrying the write stream.
+ * The generation of the object that triggered the redirect. This is set
+ * iff `write_handle` is set. If set, the client must use this in an
+ * `AppendObjectSpec` first_message when retrying the write stream.
*
*
* optional int64 generation = 3;
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequest.java
index 87a4ad4257..18c12adff4 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequest.java
@@ -23,7 +23,8 @@
*
*
*
- * Request message for BidiWriteObject.
+ * Request message for
+ * [BidiWriteObject][google.storage.v2.Storage.BidiWriteObject].
*
*
* Protobuf type {@code google.storage.v2.BidiWriteObjectRequest}
@@ -361,15 +362,15 @@ public com.google.storage.v2.AppendObjectSpecOrBuilder getAppendObjectSpecOrBuil
* should be written.
*
* In the first `WriteObjectRequest` of a `WriteObject()` action, it
- * indicates the initial offset for the `Write()` call. The value **must** be
+ * indicates the initial offset for the `Write()` call. The value must be
* equal to the `persisted_size` that a call to `QueryWriteStatus()` would
* return (0 if this is the first write to the object).
*
- * On subsequent calls, this value **must** be no larger than the sum of the
+ * On subsequent calls, this value must be no larger than the sum of the
* first `write_offset` and the sizes of all `data` chunks sent previously on
* this stream.
*
- * An invalid value will cause an error.
+ * An invalid value causes an error.
* int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -388,7 +389,7 @@ public long getWriteOffset() {
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -405,7 +406,7 @@ public boolean hasChecksummedData() {
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -425,7 +426,7 @@ public com.google.storage.v2.ChecksummedData getChecksummedData() {
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -446,9 +447,9 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -467,9 +468,9 @@ public boolean hasObjectChecksums() {
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -490,9 +491,9 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() {
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -513,14 +514,14 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde
*
*
*
- * Optional. For each BidiWriteObjectRequest where state_lookup is `true` or
- * the client closes the stream, the service will send a
- * BidiWriteObjectResponse containing the current persisted size. The
+ * Optional. For each `BidiWriteObjectRequest` where `state_lookup` is `true`
+ * or the client closes the stream, the service sends a
+ * `BidiWriteObjectResponse` containing the current persisted size. The
* persisted size sent in responses covers all the bytes the server has
* persisted thus far and can be used to decide what data is safe for the
* client to drop. Note that the object's current size reported by the
- * BidiWriteObjectResponse may lag behind the number of bytes written by the
- * client. This field is ignored if `finish_write` is set to true.
+ * `BidiWriteObjectResponse` might lag behind the number of bytes written by
+ * the client. This field is ignored if `finish_write` is set to true.
*
*
* bool state_lookup = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -541,7 +542,7 @@ public boolean getStateLookup() {
*
* Optional. Persists data written on the stream, up to and including the
* current message, to permanent storage. This option should be used sparingly
- * as it may reduce performance. Ongoing writes will periodically be persisted
+ * as it might reduce performance. Ongoing writes are periodically persisted
* on the server even when `flush` is not set. This field is ignored if
* `finish_write` is set to true since there's no need to checkpoint or flush
* if this message completes the write.
@@ -565,8 +566,8 @@ public boolean getFlush() {
*
*
*
* Optional. If `true`, this indicates that the write is complete. Sending any
* `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
- * will cause an error.
- * For a non-resumable write (where the upload_id was not set in the first
+ * causes an error.
+ * For a non-resumable write (where the `upload_id` was not set in the first
* message), it is an error not to set this field in the final message of the
* stream.
*
@@ -941,7 +942,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * Request message for BidiWriteObject.
+ * Request message for
+ * [BidiWriteObject][google.storage.v2.Storage.BidiWriteObject].
*
*
* Protobuf type {@code google.storage.v2.BidiWriteObjectRequest}
@@ -1927,15 +1929,15 @@ public com.google.storage.v2.AppendObjectSpecOrBuilder getAppendObjectSpecOrBuil
* should be written.
*
* In the first `WriteObjectRequest` of a `WriteObject()` action, it
- * indicates the initial offset for the `Write()` call. The value **must** be
+ * indicates the initial offset for the `Write()` call. The value must be
* equal to the `persisted_size` that a call to `QueryWriteStatus()` would
* return (0 if this is the first write to the object).
*
- * On subsequent calls, this value **must** be no larger than the sum of the
+ * On subsequent calls, this value must be no larger than the sum of the
* first `write_offset` and the sizes of all `data` chunks sent previously on
* this stream.
*
- * An invalid value will cause an error.
+ * An invalid value causes an error.
* int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1955,15 +1957,15 @@ public long getWriteOffset() {
* should be written.
*
* In the first `WriteObjectRequest` of a `WriteObject()` action, it
- * indicates the initial offset for the `Write()` call. The value **must** be
+ * indicates the initial offset for the `Write()` call. The value must be
* equal to the `persisted_size` that a call to `QueryWriteStatus()` would
* return (0 if this is the first write to the object).
*
- * On subsequent calls, this value **must** be no larger than the sum of the
+ * On subsequent calls, this value must be no larger than the sum of the
* first `write_offset` and the sizes of all `data` chunks sent previously on
* this stream.
*
- * An invalid value will cause an error.
+ * An invalid value causes an error.
* int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -1987,15 +1989,15 @@ public Builder setWriteOffset(long value) {
* should be written.
*
* In the first `WriteObjectRequest` of a `WriteObject()` action, it
- * indicates the initial offset for the `Write()` call. The value **must** be
+ * indicates the initial offset for the `Write()` call. The value must be
* equal to the `persisted_size` that a call to `QueryWriteStatus()` would
* return (0 if this is the first write to the object).
*
- * On subsequent calls, this value **must** be no larger than the sum of the
+ * On subsequent calls, this value must be no larger than the sum of the
* first `write_offset` and the sizes of all `data` chunks sent previously on
* this stream.
*
- * An invalid value will cause an error.
+ * An invalid value causes an error.
* int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -2020,7 +2022,7 @@ public Builder clearWriteOffset() {
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -2037,7 +2039,7 @@ public boolean hasChecksummedData() {
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -2064,7 +2066,7 @@ public com.google.storage.v2.ChecksummedData getChecksummedData() {
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -2088,7 +2090,7 @@ public Builder setChecksummedData(com.google.storage.v2.ChecksummedData value) {
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -2110,7 +2112,7 @@ public Builder setChecksummedData(
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -2143,7 +2145,7 @@ public Builder mergeChecksummedData(com.google.storage.v2.ChecksummedData value)
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -2170,7 +2172,7 @@ public Builder clearChecksummedData() {
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -2184,7 +2186,7 @@ public com.google.storage.v2.ChecksummedData.Builder getChecksummedDataBuilder()
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -2206,7 +2208,7 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -2245,9 +2247,9 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -2265,9 +2267,9 @@ public boolean hasObjectChecksums() {
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -2291,9 +2293,9 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() {
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -2319,9 +2321,9 @@ public Builder setObjectChecksums(com.google.storage.v2.ObjectChecksums value) {
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -2345,9 +2347,9 @@ public Builder setObjectChecksums(
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -2378,9 +2380,9 @@ public Builder mergeObjectChecksums(com.google.storage.v2.ObjectChecksums value)
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -2403,9 +2405,9 @@ public Builder clearObjectChecksums() {
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -2423,9 +2425,9 @@ public com.google.storage.v2.ObjectChecksums.Builder getObjectChecksumsBuilder()
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -2447,9 +2449,9 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -2479,14 +2481,14 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde
*
*
*
- * Optional. For each BidiWriteObjectRequest where state_lookup is `true` or
- * the client closes the stream, the service will send a
- * BidiWriteObjectResponse containing the current persisted size. The
+ * Optional. For each `BidiWriteObjectRequest` where `state_lookup` is `true`
+ * or the client closes the stream, the service sends a
+ * `BidiWriteObjectResponse` containing the current persisted size. The
* persisted size sent in responses covers all the bytes the server has
* persisted thus far and can be used to decide what data is safe for the
* client to drop. Note that the object's current size reported by the
- * BidiWriteObjectResponse may lag behind the number of bytes written by the
- * client. This field is ignored if `finish_write` is set to true.
+ * `BidiWriteObjectResponse` might lag behind the number of bytes written by
+ * the client. This field is ignored if `finish_write` is set to true.
*
*
* bool state_lookup = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -2502,14 +2504,14 @@ public boolean getStateLookup() {
*
*
*
- * Optional. For each BidiWriteObjectRequest where state_lookup is `true` or
- * the client closes the stream, the service will send a
- * BidiWriteObjectResponse containing the current persisted size. The
+ * Optional. For each `BidiWriteObjectRequest` where `state_lookup` is `true`
+ * or the client closes the stream, the service sends a
+ * `BidiWriteObjectResponse` containing the current persisted size. The
* persisted size sent in responses covers all the bytes the server has
* persisted thus far and can be used to decide what data is safe for the
* client to drop. Note that the object's current size reported by the
- * BidiWriteObjectResponse may lag behind the number of bytes written by the
- * client. This field is ignored if `finish_write` is set to true.
+ * `BidiWriteObjectResponse` might lag behind the number of bytes written by
+ * the client. This field is ignored if `finish_write` is set to true.
*
*
* bool state_lookup = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -2529,14 +2531,14 @@ public Builder setStateLookup(boolean value) {
*
*
*
- * Optional. For each BidiWriteObjectRequest where state_lookup is `true` or
- * the client closes the stream, the service will send a
- * BidiWriteObjectResponse containing the current persisted size. The
+ * Optional. For each `BidiWriteObjectRequest` where `state_lookup` is `true`
+ * or the client closes the stream, the service sends a
+ * `BidiWriteObjectResponse` containing the current persisted size. The
* persisted size sent in responses covers all the bytes the server has
* persisted thus far and can be used to decide what data is safe for the
* client to drop. Note that the object's current size reported by the
- * BidiWriteObjectResponse may lag behind the number of bytes written by the
- * client. This field is ignored if `finish_write` is set to true.
+ * `BidiWriteObjectResponse` might lag behind the number of bytes written by
+ * the client. This field is ignored if `finish_write` is set to true.
*
*
* bool state_lookup = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -2558,7 +2560,7 @@ public Builder clearStateLookup() {
*
* Optional. Persists data written on the stream, up to and including the
* current message, to permanent storage. This option should be used sparingly
- * as it may reduce performance. Ongoing writes will periodically be persisted
+ * as it might reduce performance. Ongoing writes are periodically persisted
* on the server even when `flush` is not set. This field is ignored if
* `finish_write` is set to true since there's no need to checkpoint or flush
* if this message completes the write.
@@ -2579,7 +2581,7 @@ public boolean getFlush() {
*
*
*
* Optional. Persists data written on the stream, up to and including the
* current message, to permanent storage. This option should be used sparingly
- * as it may reduce performance. Ongoing writes will periodically be persisted
+ * as it might reduce performance. Ongoing writes are periodically persisted
* on the server even when `flush` is not set. This field is ignored if
* `finish_write` is set to true since there's no need to checkpoint or flush
* if this message completes the write.
@@ -2604,7 +2606,7 @@ public Builder setFlush(boolean value) {
*
*
*
* Optional. Persists data written on the stream, up to and including the
* current message, to permanent storage. This option should be used sparingly
- * as it may reduce performance. Ongoing writes will periodically be persisted
+ * as it might reduce performance. Ongoing writes are periodically persisted
* on the server even when `flush` is not set. This field is ignored if
* `finish_write` is set to true since there's no need to checkpoint or flush
* if this message completes the write.
@@ -2629,8 +2631,8 @@ public Builder clearFlush() {
*
*
*
* Optional. If `true`, this indicates that the write is complete. Sending any
* `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
- * will cause an error.
- * For a non-resumable write (where the upload_id was not set in the first
+ * causes an error.
+ * For a non-resumable write (where the `upload_id` was not set in the first
* message), it is an error not to set this field in the final message of the
* stream.
*
@@ -2650,8 +2652,8 @@ public boolean getFinishWrite() {
*
* Optional. If `true`, this indicates that the write is complete. Sending any
* `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
- * will cause an error.
- * For a non-resumable write (where the upload_id was not set in the first
+ * causes an error.
+ * For a non-resumable write (where the `upload_id` was not set in the first
* message), it is an error not to set this field in the final message of the
* stream.
*
@@ -2675,8 +2677,8 @@ public Builder setFinishWrite(boolean value) {
*
* Optional. If `true`, this indicates that the write is complete. Sending any
* `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
- * will cause an error.
- * For a non-resumable write (where the upload_id was not set in the first
+ * causes an error.
+ * For a non-resumable write (where the `upload_id` was not set in the first
* message), it is an error not to set this field in the final message of the
* stream.
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequestOrBuilder.java
index adb098818e..4224583eb9 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectRequestOrBuilder.java
@@ -151,15 +151,15 @@ public interface BidiWriteObjectRequestOrBuilder
* should be written.
*
* In the first `WriteObjectRequest` of a `WriteObject()` action, it
- * indicates the initial offset for the `Write()` call. The value **must** be
+ * indicates the initial offset for the `Write()` call. The value must be
* equal to the `persisted_size` that a call to `QueryWriteStatus()` would
* return (0 if this is the first write to the object).
*
- * On subsequent calls, this value **must** be no larger than the sum of the
+ * On subsequent calls, this value must be no larger than the sum of the
* first `write_offset` and the sizes of all `data` chunks sent previously on
* this stream.
*
- * An invalid value will cause an error.
+ * An invalid value causes an error.
* int64 write_offset = 3 [(.google.api.field_behavior) = REQUIRED];
@@ -173,7 +173,7 @@ public interface BidiWriteObjectRequestOrBuilder
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -187,7 +187,7 @@ public interface BidiWriteObjectRequestOrBuilder
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -201,7 +201,7 @@ public interface BidiWriteObjectRequestOrBuilder
*
*
* The data to insert. If a crc32c checksum is provided that doesn't match
- * the checksum computed by the service, the request will fail.
+ * the checksum computed by the service, the request fails.
*
*
* .google.storage.v2.ChecksummedData checksummed_data = 4;
@@ -213,9 +213,9 @@ public interface BidiWriteObjectRequestOrBuilder
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -231,9 +231,9 @@ public interface BidiWriteObjectRequestOrBuilder
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -249,9 +249,9 @@ public interface BidiWriteObjectRequestOrBuilder
*
*
* Optional. Checksums for the complete object. If the checksums computed by
- * the service don't match the specified checksums the call will fail. May
- * only be provided in the first request or the last request (with
- * finish_write set).
+ * the service don't match the specified checksums the call fails. Might only
+ * be provided in the first request or the last request (with finish_write
+ * set).
*
*
*
@@ -264,14 +264,14 @@ public interface BidiWriteObjectRequestOrBuilder
*
*
*
- * Optional. For each BidiWriteObjectRequest where state_lookup is `true` or
- * the client closes the stream, the service will send a
- * BidiWriteObjectResponse containing the current persisted size. The
+ * Optional. For each `BidiWriteObjectRequest` where `state_lookup` is `true`
+ * or the client closes the stream, the service sends a
+ * `BidiWriteObjectResponse` containing the current persisted size. The
* persisted size sent in responses covers all the bytes the server has
* persisted thus far and can be used to decide what data is safe for the
* client to drop. Note that the object's current size reported by the
- * BidiWriteObjectResponse may lag behind the number of bytes written by the
- * client. This field is ignored if `finish_write` is set to true.
+ * `BidiWriteObjectResponse` might lag behind the number of bytes written by
+ * the client. This field is ignored if `finish_write` is set to true.
*
*
* bool state_lookup = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -286,7 +286,7 @@ public interface BidiWriteObjectRequestOrBuilder
*
* Optional. Persists data written on the stream, up to and including the
* current message, to permanent storage. This option should be used sparingly
- * as it may reduce performance. Ongoing writes will periodically be persisted
+ * as it might reduce performance. Ongoing writes are periodically persisted
* on the server even when `flush` is not set. This field is ignored if
* `finish_write` is set to true since there's no need to checkpoint or flush
* if this message completes the write.
@@ -304,8 +304,8 @@ public interface BidiWriteObjectRequestOrBuilder
*
*
*
* Optional. If `true`, this indicates that the write is complete. Sending any
* `WriteObjectRequest`s subsequent to one in which `finish_write` is `true`
- * will cause an error.
- * For a non-resumable write (where the upload_id was not set in the first
+ * causes an error.
+ * For a non-resumable write (where the `upload_id` was not set in the first
* message), it is an error not to set this field in the final message of the
* stream.
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponse.java
index e1f30195fe..20f5aac8e4 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponse.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponse.java
@@ -216,7 +216,7 @@ public com.google.storage.v2.ObjectOrBuilder getResourceOrBuilder() {
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -234,7 +234,7 @@ public boolean hasWriteHandle() {
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -254,7 +254,7 @@ public com.google.storage.v2.BidiWriteHandle getWriteHandle() {
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -1036,7 +1036,7 @@ public com.google.storage.v2.ObjectOrBuilder getResourceOrBuilder() {
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -1053,7 +1053,7 @@ public boolean hasWriteHandle() {
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -1076,7 +1076,7 @@ public com.google.storage.v2.BidiWriteHandle getWriteHandle() {
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -1101,7 +1101,7 @@ public Builder setWriteHandle(com.google.storage.v2.BidiWriteHandle value) {
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -1123,7 +1123,7 @@ public Builder setWriteHandle(com.google.storage.v2.BidiWriteHandle.Builder buil
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -1153,7 +1153,7 @@ public Builder mergeWriteHandle(com.google.storage.v2.BidiWriteHandle value) {
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -1175,7 +1175,7 @@ public Builder clearWriteHandle() {
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -1192,7 +1192,7 @@ public com.google.storage.v2.BidiWriteHandle.Builder getWriteHandleBuilder() {
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -1213,7 +1213,7 @@ public com.google.storage.v2.BidiWriteHandleOrBuilder getWriteHandleOrBuilder()
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponseOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponseOrBuilder.java
index 34457ee6ad..8976401bad 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponseOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BidiWriteObjectResponseOrBuilder.java
@@ -96,7 +96,7 @@ public interface BidiWriteObjectResponseOrBuilder
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -111,7 +111,7 @@ public interface BidiWriteObjectResponseOrBuilder
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
@@ -126,7 +126,7 @@ public interface BidiWriteObjectResponseOrBuilder
*
*
*
- * An optional write handle that will periodically be present in response
+ * An optional write handle that is returned periodically in response
* messages. Clients should save it for later use in establishing a new stream
* if a connection is interrupted.
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Bucket.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Bucket.java
index 617f2d1754..207c401c04 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Bucket.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/Bucket.java
@@ -637,9 +637,10 @@ public interface CorsOrBuilder
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -652,9 +653,10 @@ public interface CorsOrBuilder
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -667,9 +669,10 @@ public interface CorsOrBuilder
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -683,9 +686,10 @@ public interface CorsOrBuilder
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -701,7 +705,7 @@ public interface CorsOrBuilder
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -717,7 +721,7 @@ public interface CorsOrBuilder
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -733,7 +737,7 @@ public interface CorsOrBuilder
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -750,7 +754,7 @@ public interface CorsOrBuilder
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -765,9 +769,9 @@ public interface CorsOrBuilder
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -780,9 +784,9 @@ public interface CorsOrBuilder
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -795,9 +799,9 @@ public interface CorsOrBuilder
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -811,9 +815,9 @@ public interface CorsOrBuilder
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -827,9 +831,9 @@ public interface CorsOrBuilder
*
*
*
- * Optional. The value, in seconds, to return in the
- * [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
- * header] used in preflight responses.
+ * Optional. The value, in seconds, to return in the [Access-Control-Max-Age
+ * header](https://www.w3.org/TR/cors/#access-control-max-age-response-header)
+ * used in preflight responses.
*
*
* int32 max_age_seconds = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -899,9 +903,10 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -916,9 +921,10 @@ public com.google.protobuf.ProtocolStringList getOriginList() {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -933,9 +939,10 @@ public int getOriginCount() {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -951,9 +958,10 @@ public java.lang.String getOrigin(int index) {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -977,7 +985,7 @@ public com.google.protobuf.ByteString getOriginBytes(int index) {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -995,7 +1003,7 @@ public com.google.protobuf.ProtocolStringList getMethodList() {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -1013,7 +1021,7 @@ public int getMethodCount() {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -1032,7 +1040,7 @@ public java.lang.String getMethod(int index) {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -1055,9 +1063,9 @@ public com.google.protobuf.ByteString getMethodBytes(int index) {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1072,9 +1080,9 @@ public com.google.protobuf.ProtocolStringList getResponseHeaderList() {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1089,9 +1097,9 @@ public int getResponseHeaderCount() {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1107,9 +1115,9 @@ public java.lang.String getResponseHeader(int index) {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -1128,9 +1136,9 @@ public com.google.protobuf.ByteString getResponseHeaderBytes(int index) {
*
*
*
- * Optional. The value, in seconds, to return in the
- * [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
- * header] used in preflight responses.
+ * Optional. The value, in seconds, to return in the [Access-Control-Max-Age
+ * header](https://www.w3.org/TR/cors/#access-control-max-age-response-header)
+ * used in preflight responses.
*
*
* int32 max_age_seconds = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -1614,9 +1622,10 @@ private void ensureOriginIsMutable() {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1632,9 +1641,10 @@ public com.google.protobuf.ProtocolStringList getOriginList() {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1649,9 +1659,10 @@ public int getOriginCount() {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1667,9 +1678,10 @@ public java.lang.String getOrigin(int index) {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1685,9 +1697,10 @@ public com.google.protobuf.ByteString getOriginBytes(int index) {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1711,9 +1724,10 @@ public Builder setOrigin(int index, java.lang.String value) {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1736,9 +1750,10 @@ public Builder addOrigin(java.lang.String value) {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1758,9 +1773,10 @@ public Builder addAllOrigin(java.lang.Iterable
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1779,9 +1795,10 @@ public Builder clearOrigin() {
*
*
*
- * Optional. The list of Origins eligible to receive CORS response headers.
- * See [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
- * Note: "*" is permitted in the list of origins, and means "any Origin".
+ * Optional. The list of origins eligible to receive CORS response headers.
+ * For more information about origins, see [RFC
+ * 6454](https://tools.ietf.org/html/rfc6454). Note: `*` is permitted in the
+ * list of origins, and means `any origin`.
*
*
* repeated string origin = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -1817,7 +1834,7 @@ private void ensureMethodIsMutable() {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -1836,7 +1853,7 @@ public com.google.protobuf.ProtocolStringList getMethodList() {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -1854,7 +1871,7 @@ public int getMethodCount() {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -1873,7 +1890,7 @@ public java.lang.String getMethod(int index) {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -1892,7 +1909,7 @@ public com.google.protobuf.ByteString getMethodBytes(int index) {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -1919,7 +1936,7 @@ public Builder setMethod(int index, java.lang.String value) {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -1945,7 +1962,7 @@ public Builder addMethod(java.lang.String value) {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -1968,7 +1985,7 @@ public Builder addAllMethod(java.lang.Iterable
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -1990,7 +2007,7 @@ public Builder clearMethod() {
*
* Optional. The list of HTTP methods on which to include CORS response
* headers,
- * (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+ * (`GET`, `OPTIONS`, `POST`, etc) Note: `*` is permitted in the list of
* methods, and means "any method".
*
*
@@ -2025,9 +2042,9 @@ private void ensureResponseHeaderIsMutable() {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2043,9 +2060,9 @@ public com.google.protobuf.ProtocolStringList getResponseHeaderList() {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2060,9 +2077,9 @@ public int getResponseHeaderCount() {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2078,9 +2095,9 @@ public java.lang.String getResponseHeader(int index) {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2096,9 +2113,9 @@ public com.google.protobuf.ByteString getResponseHeaderBytes(int index) {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2122,9 +2139,9 @@ public Builder setResponseHeader(int index, java.lang.String value) {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2147,9 +2164,9 @@ public Builder addResponseHeader(java.lang.String value) {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2169,9 +2186,9 @@ public Builder addAllResponseHeader(java.lang.Iterable
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2190,9 +2207,9 @@ public Builder clearResponseHeader() {
*
*
*
- * Optional. The list of HTTP headers other than the
- * [https://www.w3.org/TR/cors/#simple-response-header][simple response
- * headers] to give permission for the user-agent to share across domains.
+ * Optional. The list of HTTP headers other than the [simple response
+ * headers](https://www.w3.org/TR/cors/#simple-response-headers) to give
+ * permission for the user-agent to share across domains.
*
*
* repeated string response_header = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -2218,9 +2235,9 @@ public Builder addResponseHeaderBytes(com.google.protobuf.ByteString value) {
*
*
*
- * Optional. The value, in seconds, to return in the
- * [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
- * header] used in preflight responses.
+ * Optional. The value, in seconds, to return in the [Access-Control-Max-Age
+ * header](https://www.w3.org/TR/cors/#access-control-max-age-response-header)
+ * used in preflight responses.
*
*
* int32 max_age_seconds = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -2236,9 +2253,9 @@ public int getMaxAgeSeconds() {
*
*
*
- * Optional. The value, in seconds, to return in the
- * [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
- * header] used in preflight responses.
+ * Optional. The value, in seconds, to return in the [Access-Control-Max-Age
+ * header](https://www.w3.org/TR/cors/#access-control-max-age-response-header)
+ * used in preflight responses.
*
*
* int32 max_age_seconds = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -2258,9 +2275,9 @@ public Builder setMaxAgeSeconds(int value) {
*
*
*
- * Optional. The value, in seconds, to return in the
- * [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
- * header] used in preflight responses.
+ * Optional. The value, in seconds, to return in the [Access-Control-Max-Age
+ * header](https://www.w3.org/TR/cors/#access-control-max-age-response-header)
+ * used in preflight responses.
*
*
* int32 max_age_seconds = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -2347,8 +2364,8 @@ public interface EncryptionOrBuilder
*
*
*
- * Optional. The name of the Cloud KMS key that will be used to encrypt
- * objects inserted into this bucket, if no encryption method is specified.
+ * Optional. The name of the Cloud KMS key that is used to encrypt objects
+ * inserted into this bucket, if no encryption method is specified.
*
*
*
@@ -2363,8 +2380,8 @@ public interface EncryptionOrBuilder
*
*
*
- * Optional. The name of the Cloud KMS key that will be used to encrypt
- * objects inserted into this bucket, if no encryption method is specified.
+ * Optional. The name of the Cloud KMS key that is used to encrypt objects
+ * inserted into this bucket, if no encryption method is specified.
*
*
*
@@ -2593,7 +2610,7 @@ public interface GoogleManagedEncryptionEnforcementConfigOrBuilder
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -2611,7 +2628,7 @@ public interface GoogleManagedEncryptionEnforcementConfigOrBuilder
*
*
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -2629,7 +2646,7 @@ public interface GoogleManagedEncryptionEnforcementConfigOrBuilder
*
*
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -2741,7 +2758,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -2762,7 +2779,7 @@ public boolean hasRestrictionMode() {
*
*
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -2791,7 +2808,7 @@ public java.lang.String getRestrictionMode() {
*
*
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -3305,7 +3322,7 @@ public Builder mergeFrom(
*
*
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -3325,7 +3342,7 @@ public boolean hasRestrictionMode() {
*
*
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -3353,7 +3370,7 @@ public java.lang.String getRestrictionMode() {
*
*
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -3381,7 +3398,7 @@ public com.google.protobuf.ByteString getRestrictionModeBytes() {
*
*
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -3408,7 +3425,7 @@ public Builder setRestrictionMode(java.lang.String value) {
*
*
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -3431,7 +3448,7 @@ public Builder clearRestrictionMode() {
*
*
*
*
* Restriction mode for google-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* google-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using google-managed
@@ -3729,7 +3746,7 @@ public interface CustomerManagedEncryptionEnforcementConfigOrBuilder
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -3747,7 +3764,7 @@ public interface CustomerManagedEncryptionEnforcementConfigOrBuilder
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -3765,7 +3782,7 @@ public interface CustomerManagedEncryptionEnforcementConfigOrBuilder
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -3877,7 +3894,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -3898,7 +3915,7 @@ public boolean hasRestrictionMode() {
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -3927,7 +3944,7 @@ public java.lang.String getRestrictionMode() {
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -4455,7 +4472,7 @@ public Builder mergeFrom(
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -4475,7 +4492,7 @@ public boolean hasRestrictionMode() {
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -4503,7 +4520,7 @@ public java.lang.String getRestrictionMode() {
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -4531,7 +4548,7 @@ public com.google.protobuf.ByteString getRestrictionModeBytes() {
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -4558,7 +4575,7 @@ public Builder setRestrictionMode(java.lang.String value) {
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -4581,7 +4598,7 @@ public Builder clearRestrictionMode() {
*
*
*
*
* Restriction mode for customer-managed encryption for new objects within
- * the bucket. Valid values are: "NotRestricted", "FullyRestricted".
+ * the bucket. Valid values are: `NotRestricted` and `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-managed encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -4882,8 +4899,8 @@ public interface CustomerSuppliedEncryptionEnforcementConfigOrBuilder
*
*
*
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -4901,8 +4918,8 @@ public interface CustomerSuppliedEncryptionEnforcementConfigOrBuilder
*
*
*
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -4920,8 +4937,8 @@ public interface CustomerSuppliedEncryptionEnforcementConfigOrBuilder
*
*
*
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -5033,8 +5050,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -5055,8 +5072,8 @@ public boolean hasRestrictionMode() {
*
*
*
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -5085,8 +5102,8 @@ public java.lang.String getRestrictionMode() {
*
*
*
@@ -14626,7 +14644,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.ActionOrBuilder getActionOrBu
*
*
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -5615,8 +5632,8 @@ public Builder mergeFrom(
*
*
*
@@ -13852,7 +13870,7 @@ public Builder setDaysSinceNoncurrentTime(int value) {
* This condition is relevant only for versioned objects. An object
* version satisfies this condition only if these many days have been
* passed since it became noncurrent. The value of the field must be a
- * nonnegative integer. If it's zero, the object version will become
+ * nonnegative integer. If it's zero, the object version becomes
* eligible for Lifecycle action as soon as it becomes noncurrent.
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -5636,8 +5653,8 @@ public boolean hasRestrictionMode() {
*
*
*
@@ -13828,7 +13846,7 @@ public int getDaysSinceNoncurrentTime() {
* This condition is relevant only for versioned objects. An object
* version satisfies this condition only if these many days have been
* passed since it became noncurrent. The value of the field must be a
- * nonnegative integer. If it's zero, the object version will become
+ * nonnegative integer. If it's zero, the object version becomes
* eligible for Lifecycle action as soon as it becomes noncurrent.
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -5665,8 +5682,8 @@ public java.lang.String getRestrictionMode() {
*
*
*
@@ -13808,7 +13826,7 @@ public boolean hasDaysSinceNoncurrentTime() {
* This condition is relevant only for versioned objects. An object
* version satisfies this condition only if these many days have been
* passed since it became noncurrent. The value of the field must be a
- * nonnegative integer. If it's zero, the object version will become
+ * nonnegative integer. If it's zero, the object version becomes
* eligible for Lifecycle action as soon as it becomes noncurrent.
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -5694,8 +5711,8 @@ public com.google.protobuf.ByteString getRestrictionModeBytes() {
*
*
*
@@ -13269,8 +13287,8 @@ private void ensureMatchesStorageClassIsMutable() {
*
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -5722,8 +5739,8 @@ public Builder setRestrictionMode(java.lang.String value) {
*
*
*
@@ -11864,7 +11882,7 @@ public boolean hasDaysSinceNoncurrentTime() {
* This condition is relevant only for versioned objects. An object
* version satisfies this condition only if these many days have been
* passed since it became noncurrent. The value of the field must be a
- * nonnegative integer. If it's zero, the object version will become
+ * nonnegative integer. If it's zero, the object version becomes
* eligible for Lifecycle action as soon as it becomes noncurrent.
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -5746,8 +5763,8 @@ public Builder clearRestrictionMode() {
*
*
*
@@ -11659,8 +11677,8 @@ public int getNumNewerVersions() {
*
*
* Restriction mode for customer-supplied encryption for new objects
- * within the bucket. Valid values are: "NotRestricted",
- * "FullyRestricted".
+ * within the bucket. Valid values are: `NotRestricted` and
+ * `FullyRestricted`.
* If `NotRestricted` or unset, creation of new objects with
* customer-supplied encryption is allowed.
* If `FullyRestricted`, new objects can't be created using
@@ -6049,8 +6066,8 @@ public CustomerSuppliedEncryptionEnforcementConfig parsePartialFrom(
*
*
*
*
@@ -11238,7 +11256,7 @@ public interface ConditionOrBuilder
* This condition is relevant only for versioned objects. An object
* version satisfies this condition only if these many days have been
* passed since it became noncurrent. The value of the field must be a
- * nonnegative integer. If it's zero, the object version will become
+ * nonnegative integer. If it's zero, the object version becomes
* eligible for Lifecycle action as soon as it becomes noncurrent.
*
- * Optional. The name of the Cloud KMS key that will be used to encrypt
- * objects inserted into this bucket, if no encryption method is specified.
+ * Optional. The name of the Cloud KMS key that is used to encrypt objects
+ * inserted into this bucket, if no encryption method is specified.
*
*
*
@@ -6076,8 +6093,8 @@ public java.lang.String getDefaultKmsKey() {
*
*
*
- * Optional. The name of the Cloud KMS key that will be used to encrypt
- * objects inserted into this bucket, if no encryption method is specified.
+ * Optional. The name of the Cloud KMS key that is used to encrypt objects
+ * inserted into this bucket, if no encryption method is specified.
*
*
*
@@ -6810,8 +6827,8 @@ public Builder mergeFrom(
*
*
*
- * Optional. The name of the Cloud KMS key that will be used to encrypt
- * objects inserted into this bucket, if no encryption method is specified.
+ * Optional. The name of the Cloud KMS key that is used to encrypt objects
+ * inserted into this bucket, if no encryption method is specified.
*
*
*
@@ -6836,8 +6853,8 @@ public java.lang.String getDefaultKmsKey() {
*
*
*
- * Optional. The name of the Cloud KMS key that will be used to encrypt
- * objects inserted into this bucket, if no encryption method is specified.
+ * Optional. The name of the Cloud KMS key that is used to encrypt objects
+ * inserted into this bucket, if no encryption method is specified.
*
*
*
@@ -6862,8 +6879,8 @@ public com.google.protobuf.ByteString getDefaultKmsKeyBytes() {
*
*
*
- * Optional. The name of the Cloud KMS key that will be used to encrypt
- * objects inserted into this bucket, if no encryption method is specified.
+ * Optional. The name of the Cloud KMS key that is used to encrypt objects
+ * inserted into this bucket, if no encryption method is specified.
*
*
*
@@ -6887,8 +6904,8 @@ public Builder setDefaultKmsKey(java.lang.String value) {
*
*
*
- * Optional. The name of the Cloud KMS key that will be used to encrypt
- * objects inserted into this bucket, if no encryption method is specified.
+ * Optional. The name of the Cloud KMS key that is used to encrypt objects
+ * inserted into this bucket, if no encryption method is specified.
*
*
*
@@ -6908,8 +6925,8 @@ public Builder clearDefaultKmsKey() {
*
*
*
- * Optional. The name of the Cloud KMS key that will be used to encrypt
- * objects inserted into this bucket, if no encryption method is specified.
+ * Optional. The name of the Cloud KMS key that is used to encrypt objects
+ * inserted into this bucket, if no encryption method is specified.
*
*
*
@@ -7835,8 +7852,8 @@ public interface IamConfigOrBuilder
*
*
*
- * Optional. Whether IAM will enforce public access prevention. Valid values
- * are "enforced" or "inherited".
+ * Optional. Whether IAM enforces public access prevention. Valid values are
+ * `enforced` or `inherited`.
*
*
* string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -7849,8 +7866,8 @@ public interface IamConfigOrBuilder
*
*
*
- * Optional. Whether IAM will enforce public access prevention. Valid values
- * are "enforced" or "inherited".
+ * Optional. Whether IAM enforces public access prevention. Valid values are
+ * `enforced` or `inherited`.
*
*
* string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -8928,8 +8945,8 @@ public boolean hasUniformBucketLevelAccess() {
*
*
*
- * Optional. Whether IAM will enforce public access prevention. Valid values
- * are "enforced" or "inherited".
+ * Optional. Whether IAM enforces public access prevention. Valid values are
+ * `enforced` or `inherited`.
*
*
* string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -8953,8 +8970,8 @@ public java.lang.String getPublicAccessPrevention() {
*
*
*
- * Optional. Whether IAM will enforce public access prevention. Valid values
- * are "enforced" or "inherited".
+ * Optional. Whether IAM enforces public access prevention. Valid values are
+ * `enforced` or `inherited`.
*
*
* string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9597,8 +9614,8 @@ public Builder clearUniformBucketLevelAccess() {
*
*
*
- * Optional. Whether IAM will enforce public access prevention. Valid values
- * are "enforced" or "inherited".
+ * Optional. Whether IAM enforces public access prevention. Valid values are
+ * `enforced` or `inherited`.
*
*
* string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9621,8 +9638,8 @@ public java.lang.String getPublicAccessPrevention() {
*
*
*
- * Optional. Whether IAM will enforce public access prevention. Valid values
- * are "enforced" or "inherited".
+ * Optional. Whether IAM enforces public access prevention. Valid values are
+ * `enforced` or `inherited`.
*
*
* string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9645,8 +9662,8 @@ public com.google.protobuf.ByteString getPublicAccessPreventionBytes() {
*
*
*
- * Optional. Whether IAM will enforce public access prevention. Valid values
- * are "enforced" or "inherited".
+ * Optional. Whether IAM enforces public access prevention. Valid values are
+ * `enforced` or `inherited`.
*
*
* string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9668,8 +9685,8 @@ public Builder setPublicAccessPrevention(java.lang.String value) {
*
*
*
- * Optional. Whether IAM will enforce public access prevention. Valid values
- * are "enforced" or "inherited".
+ * Optional. Whether IAM enforces public access prevention. Valid values are
+ * `enforced` or `inherited`.
*
*
* string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9687,8 +9704,8 @@ public Builder clearPublicAccessPrevention() {
*
*
*
- * Optional. Whether IAM will enforce public access prevention. Valid values
- * are "enforced" or "inherited".
+ * Optional. Whether IAM enforces public access prevention. Valid values are
+ * `enforced` or `inherited`.
*
*
* string public_access_prevention = 3 [(.google.api.field_behavior) = OPTIONAL];
@@ -9781,7 +9798,7 @@ public interface LifecycleOrBuilder
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -9795,7 +9812,7 @@ public interface LifecycleOrBuilder
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -9809,7 +9826,7 @@ public interface LifecycleOrBuilder
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -9823,7 +9840,7 @@ public interface LifecycleOrBuilder
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -9838,7 +9855,7 @@ public interface LifecycleOrBuilder
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -9853,7 +9870,8 @@ public interface LifecycleOrBuilder
*
*
* Lifecycle properties of a bucket.
- * For more information, see https://cloud.google.com/storage/docs/lifecycle.
+ * For more information, see [Object Lifecycle
+ * Management](https://cloud.google.com/storage/docs/lifecycle).
*
*
* Protobuf type {@code google.storage.v2.Bucket.Lifecycle}
@@ -9946,7 +9964,7 @@ public interface RuleOrBuilder
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -9961,7 +9979,7 @@ public interface RuleOrBuilder
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -9976,7 +9994,7 @@ public interface RuleOrBuilder
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -9991,7 +10009,7 @@ public interface RuleOrBuilder
*
*
* A lifecycle Rule, combining an action to take on an object and a
- * condition which will trigger that action.
+ * condition which triggers that action.
*
*
* Protobuf type {@code google.storage.v2.Bucket.Lifecycle.Rule}
@@ -11072,8 +11090,8 @@ public interface ConditionOrBuilder
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -11090,8 +11108,8 @@ public interface ConditionOrBuilder
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -11108,8 +11126,8 @@ public interface ConditionOrBuilder
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -11127,8 +11145,8 @@ public interface ConditionOrBuilder
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -11221,7 +11239,7 @@ public interface ConditionOrBuilder
* This condition is relevant only for versioned objects. An object
* version satisfies this condition only if these many days have been
* passed since it became noncurrent. The value of the field must be a
- * nonnegative integer. If it's zero, the object version will become
+ * nonnegative integer. If it's zero, the object version becomes
* eligible for Lifecycle action as soon as it becomes noncurrent.
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -11679,8 +11697,8 @@ public com.google.protobuf.ProtocolStringList getMatchesStorageClassList() {
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -11699,8 +11717,8 @@ public int getMatchesStorageClassCount() {
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -11720,8 +11738,8 @@ public java.lang.String getMatchesStorageClass(int index) {
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -11844,7 +11862,7 @@ public com.google.type.DateOrBuilder getCustomTimeBeforeOrBuilder() {
* This condition is relevant only for versioned objects. An object
* version satisfies this condition only if these many days have been
* passed since it became noncurrent. The value of the field must be a
- * nonnegative integer. If it's zero, the object version will become
+ * nonnegative integer. If it's zero, the object version becomes
* eligible for Lifecycle action as soon as it becomes noncurrent.
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -13290,8 +13308,8 @@ public com.google.protobuf.ProtocolStringList getMatchesStorageClassList() {
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -13310,8 +13328,8 @@ public int getMatchesStorageClassCount() {
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -13331,8 +13349,8 @@ public java.lang.String getMatchesStorageClass(int index) {
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -13352,8 +13370,8 @@ public com.google.protobuf.ByteString getMatchesStorageClassBytes(int index) {
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -13381,8 +13399,8 @@ public Builder setMatchesStorageClass(int index, java.lang.String value) {
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -13409,8 +13427,8 @@ public Builder addMatchesStorageClass(java.lang.String value) {
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -13434,8 +13452,8 @@ public Builder addAllMatchesStorageClass(java.lang.Iterable
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -13458,8 +13476,8 @@ public Builder clearMatchesStorageClass() {
*
*
* Optional. Objects having any of the storage classes specified by this
- * condition will be matched. Values include `MULTI_REGIONAL`,
- * `REGIONAL`, `NEARLINE`, `COLDLINE`, `STANDARD`, and
+ * condition are matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+ * `NEARLINE`, `COLDLINE`, `STANDARD`, and
* `DURABLE_REDUCED_AVAILABILITY`.
*
*
@@ -13788,7 +13806,7 @@ public com.google.type.DateOrBuilder getCustomTimeBeforeOrBuilder() {
* This condition is relevant only for versioned objects. An object
* version satisfies this condition only if these many days have been
* passed since it became noncurrent. The value of the field must be a
- * nonnegative integer. If it's zero, the object version will become
+ * nonnegative integer. If it's zero, the object version becomes
* eligible for Lifecycle action as soon as it becomes noncurrent.
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -14644,7 +14662,7 @@ public boolean hasCondition() {
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -14664,7 +14682,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Condition getCondition() {
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -14864,7 +14882,7 @@ protected Builder newBuilderForType(
*
*
* A lifecycle Rule, combining an action to take on an object and a
- * condition which will trigger that action.
+ * condition which triggers that action.
*
*
* Protobuf type {@code google.storage.v2.Bucket.Lifecycle.Rule}
@@ -15304,7 +15322,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.ActionOrBuilder getActionOrBu
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -15321,7 +15339,7 @@ public boolean hasCondition() {
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -15344,7 +15362,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Condition getCondition() {
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -15369,7 +15387,7 @@ public Builder setCondition(com.google.storage.v2.Bucket.Lifecycle.Rule.Conditio
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -15392,7 +15410,7 @@ public Builder setCondition(
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -15423,7 +15441,7 @@ public Builder mergeCondition(com.google.storage.v2.Bucket.Lifecycle.Rule.Condit
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -15445,7 +15463,7 @@ public Builder clearCondition() {
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -15462,7 +15480,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Condition.Builder getConditio
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -15484,7 +15502,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Condition.Builder getConditio
*
*
*
- * Optional. The condition(s) under which the action will be taken.
+ * Optional. The condition under which the action is taken.
*
*
*
@@ -15582,7 +15600,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule getDefaultInstanceForType() {
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -15599,7 +15617,7 @@ public java.util.List
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -15617,7 +15635,7 @@ public java.util.List
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -15634,7 +15652,7 @@ public int getRuleCount() {
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -15651,7 +15669,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule getRule(int index) {
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -15830,7 +15848,8 @@ protected Builder newBuilderForType(
*
*
* Lifecycle properties of a bucket.
- * For more information, see https://cloud.google.com/storage/docs/lifecycle.
+ * For more information, see [Object Lifecycle
+ * Management](https://cloud.google.com/storage/docs/lifecycle).
*
*
* Protobuf type {@code google.storage.v2.Bucket.Lifecycle}
@@ -16077,7 +16096,7 @@ private void ensureRuleIsMutable() {
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16097,7 +16116,7 @@ public java.util.List
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16117,7 +16136,7 @@ public int getRuleCount() {
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16137,7 +16156,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule getRule(int index) {
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16163,7 +16182,7 @@ public Builder setRule(int index, com.google.storage.v2.Bucket.Lifecycle.Rule va
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16187,7 +16206,7 @@ public Builder setRule(
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16213,7 +16232,7 @@ public Builder addRule(com.google.storage.v2.Bucket.Lifecycle.Rule value) {
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16239,7 +16258,7 @@ public Builder addRule(int index, com.google.storage.v2.Bucket.Lifecycle.Rule va
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16262,7 +16281,7 @@ public Builder addRule(com.google.storage.v2.Bucket.Lifecycle.Rule.Builder build
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16286,7 +16305,7 @@ public Builder addRule(
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16310,7 +16329,7 @@ public Builder addAllRule(
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16333,7 +16352,7 @@ public Builder clearRule() {
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16356,7 +16375,7 @@ public Builder removeRule(int index) {
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16372,7 +16391,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Builder getRuleBuilder(int in
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16392,7 +16411,7 @@ public com.google.storage.v2.Bucket.Lifecycle.RuleOrBuilder getRuleOrBuilder(int
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16413,7 +16432,7 @@ public com.google.storage.v2.Bucket.Lifecycle.RuleOrBuilder getRuleOrBuilder(int
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16430,7 +16449,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Builder addRuleBuilder() {
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -16447,7 +16466,7 @@ public com.google.storage.v2.Bucket.Lifecycle.Rule.Builder addRuleBuilder(int in
*
*
* Optional. A lifecycle management rule, which is made of an action to take
- * and the condition(s) under which the action will be taken.
+ * and the condition under which the action is taken.
*
*
*
@@ -18046,7 +18065,7 @@ public interface RetentionPolicyOrBuilder
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -18065,7 +18084,7 @@ public interface RetentionPolicyOrBuilder
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -18084,7 +18103,7 @@ public interface RetentionPolicyOrBuilder
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -18230,7 +18249,7 @@ public boolean getIsLocked() {
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -18252,7 +18271,7 @@ public boolean hasRetentionDuration() {
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -18276,7 +18295,7 @@ public com.google.protobuf.Duration getRetentionDuration() {
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -19007,7 +19026,7 @@ public Builder clearIsLocked() {
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -19028,7 +19047,7 @@ public boolean hasRetentionDuration() {
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -19055,7 +19074,7 @@ public com.google.protobuf.Duration getRetentionDuration() {
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -19084,7 +19103,7 @@ public Builder setRetentionDuration(com.google.protobuf.Duration value) {
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -19110,7 +19129,7 @@ public Builder setRetentionDuration(com.google.protobuf.Duration.Builder builder
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -19144,7 +19163,7 @@ public Builder mergeRetentionDuration(com.google.protobuf.Duration value) {
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -19170,7 +19189,7 @@ public Builder clearRetentionDuration() {
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -19191,7 +19210,7 @@ public com.google.protobuf.Duration.Builder getRetentionDurationBuilder() {
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -19216,7 +19235,7 @@ public com.google.protobuf.DurationOrBuilder getRetentionDurationOrBuilder() {
* duration must be greater than zero and less than 100 years. Note that
* enforcement of retention periods less than a day is not guaranteed. Such
* periods should only be used for testing purposes. Any `nanos` value
- * specified will be rounded down to the nearest second.
+ * specified is rounded down to the nearest second.
*
@@ -20444,8 +20463,8 @@ public interface VersioningOrBuilder
*
*
* Properties of a bucket related to versioning.
- * For more on Cloud Storage versioning, see
- * https://cloud.google.com/storage/docs/object-versioning.
+ * For more information about Cloud Storage versioning, see [Object
+ * versioning](https://cloud.google.com/storage/docs/object-versioning).
*
*
* Protobuf type {@code google.storage.v2.Bucket.Versioning}
@@ -20668,8 +20687,8 @@ protected Builder newBuilderForType(
*
*
* Properties of a bucket related to versioning.
- * For more on Cloud Storage versioning, see
- * https://cloud.google.com/storage/docs/object-versioning.
+ * For more information about Cloud Storage versioning, see [Object
+ * versioning](https://cloud.google.com/storage/docs/object-versioning).
*
*
* Protobuf type {@code google.storage.v2.Bucket.Versioning}
@@ -20977,10 +20996,10 @@ public interface WebsiteOrBuilder
*
*
*
- * Optional. If the requested object path is missing, the service will
- * ensure the path has a trailing '/', append this suffix, and attempt to
- * retrieve the resulting object. This allows the creation of `index.html`
- * objects to represent directory pages.
+ * Optional. If the requested object path is missing, the service ensures
+ * the path has a trailing '/', append this suffix, and attempt to retrieve
+ * the resulting object. This allows the creation of `index.html` objects to
+ * represent directory pages.
*
*
* string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -20993,10 +21012,10 @@ public interface WebsiteOrBuilder
*
*
*
- * Optional. If the requested object path is missing, the service will
- * ensure the path has a trailing '/', append this suffix, and attempt to
- * retrieve the resulting object. This allows the creation of `index.html`
- * objects to represent directory pages.
+ * Optional. If the requested object path is missing, the service ensures
+ * the path has a trailing '/', append this suffix, and attempt to retrieve
+ * the resulting object. This allows the creation of `index.html` objects to
+ * represent directory pages.
*
*
* string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21011,8 +21030,8 @@ public interface WebsiteOrBuilder
*
* Optional. If the requested object path is missing, and any
* `mainPageSuffix` object is missing, if applicable, the service
- * will return the named object from this bucket as the content for a
- * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+ * returns the named object from this bucket as the content for a
+ * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
* result.
*
*
@@ -21028,8 +21047,8 @@ public interface WebsiteOrBuilder
*
* Optional. If the requested object path is missing, and any
* `mainPageSuffix` object is missing, if applicable, the service
- * will return the named object from this bucket as the content for a
- * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+ * returns the named object from this bucket as the content for a
+ * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
* result.
*
*
@@ -21045,8 +21064,8 @@ public interface WebsiteOrBuilder
*
*
* Properties of a bucket related to accessing the contents as a static
- * website. For more on hosting a static website via Cloud Storage, see
- * https://cloud.google.com/storage/docs/hosting-static-website.
+ * website. For details, see [hosting a static website using Cloud
+ * Storage](https://cloud.google.com/storage/docs/hosting-static-website).
*
*
* Protobuf type {@code google.storage.v2.Bucket.Website}
@@ -21097,10 +21116,10 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
- * Optional. If the requested object path is missing, the service will
- * ensure the path has a trailing '/', append this suffix, and attempt to
- * retrieve the resulting object. This allows the creation of `index.html`
- * objects to represent directory pages.
+ * Optional. If the requested object path is missing, the service ensures
+ * the path has a trailing '/', append this suffix, and attempt to retrieve
+ * the resulting object. This allows the creation of `index.html` objects to
+ * represent directory pages.
*
*
* string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21124,10 +21143,10 @@ public java.lang.String getMainPageSuffix() {
*
*
*
- * Optional. If the requested object path is missing, the service will
- * ensure the path has a trailing '/', append this suffix, and attempt to
- * retrieve the resulting object. This allows the creation of `index.html`
- * objects to represent directory pages.
+ * Optional. If the requested object path is missing, the service ensures
+ * the path has a trailing '/', append this suffix, and attempt to retrieve
+ * the resulting object. This allows the creation of `index.html` objects to
+ * represent directory pages.
*
*
* string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21158,8 +21177,8 @@ public com.google.protobuf.ByteString getMainPageSuffixBytes() {
*
* Optional. If the requested object path is missing, and any
* `mainPageSuffix` object is missing, if applicable, the service
- * will return the named object from this bucket as the content for a
- * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+ * returns the named object from this bucket as the content for a
+ * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
* result.
*
*
@@ -21186,8 +21205,8 @@ public java.lang.String getNotFoundPage() {
*
* Optional. If the requested object path is missing, and any
* `mainPageSuffix` object is missing, if applicable, the service
- * will return the named object from this bucket as the content for a
- * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+ * returns the named object from this bucket as the content for a
+ * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
* result.
*
*
@@ -21382,8 +21401,8 @@ protected Builder newBuilderForType(
*
*
* Properties of a bucket related to accessing the contents as a static
- * website. For more on hosting a static website via Cloud Storage, see
- * https://cloud.google.com/storage/docs/hosting-static-website.
+ * website. For details, see [hosting a static website using Cloud
+ * Storage](https://cloud.google.com/storage/docs/hosting-static-website).
*
*
* Protobuf type {@code google.storage.v2.Bucket.Website}
@@ -21585,10 +21604,10 @@ public Builder mergeFrom(
*
*
*
- * Optional. If the requested object path is missing, the service will
- * ensure the path has a trailing '/', append this suffix, and attempt to
- * retrieve the resulting object. This allows the creation of `index.html`
- * objects to represent directory pages.
+ * Optional. If the requested object path is missing, the service ensures
+ * the path has a trailing '/', append this suffix, and attempt to retrieve
+ * the resulting object. This allows the creation of `index.html` objects to
+ * represent directory pages.
*
*
* string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21611,10 +21630,10 @@ public java.lang.String getMainPageSuffix() {
*
*
*
- * Optional. If the requested object path is missing, the service will
- * ensure the path has a trailing '/', append this suffix, and attempt to
- * retrieve the resulting object. This allows the creation of `index.html`
- * objects to represent directory pages.
+ * Optional. If the requested object path is missing, the service ensures
+ * the path has a trailing '/', append this suffix, and attempt to retrieve
+ * the resulting object. This allows the creation of `index.html` objects to
+ * represent directory pages.
*
*
* string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21637,10 +21656,10 @@ public com.google.protobuf.ByteString getMainPageSuffixBytes() {
*
*
*
- * Optional. If the requested object path is missing, the service will
- * ensure the path has a trailing '/', append this suffix, and attempt to
- * retrieve the resulting object. This allows the creation of `index.html`
- * objects to represent directory pages.
+ * Optional. If the requested object path is missing, the service ensures
+ * the path has a trailing '/', append this suffix, and attempt to retrieve
+ * the resulting object. This allows the creation of `index.html` objects to
+ * represent directory pages.
*
*
* string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21662,10 +21681,10 @@ public Builder setMainPageSuffix(java.lang.String value) {
*
*
*
- * Optional. If the requested object path is missing, the service will
- * ensure the path has a trailing '/', append this suffix, and attempt to
- * retrieve the resulting object. This allows the creation of `index.html`
- * objects to represent directory pages.
+ * Optional. If the requested object path is missing, the service ensures
+ * the path has a trailing '/', append this suffix, and attempt to retrieve
+ * the resulting object. This allows the creation of `index.html` objects to
+ * represent directory pages.
*
*
* string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21683,10 +21702,10 @@ public Builder clearMainPageSuffix() {
*
*
*
- * Optional. If the requested object path is missing, the service will
- * ensure the path has a trailing '/', append this suffix, and attempt to
- * retrieve the resulting object. This allows the creation of `index.html`
- * objects to represent directory pages.
+ * Optional. If the requested object path is missing, the service ensures
+ * the path has a trailing '/', append this suffix, and attempt to retrieve
+ * the resulting object. This allows the creation of `index.html` objects to
+ * represent directory pages.
*
*
* string main_page_suffix = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -21713,8 +21732,8 @@ public Builder setMainPageSuffixBytes(com.google.protobuf.ByteString value) {
*
* Optional. If the requested object path is missing, and any
* `mainPageSuffix` object is missing, if applicable, the service
- * will return the named object from this bucket as the content for a
- * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+ * returns the named object from this bucket as the content for a
+ * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
* result.
*
*
@@ -21740,8 +21759,8 @@ public java.lang.String getNotFoundPage() {
*
* Optional. If the requested object path is missing, and any
* `mainPageSuffix` object is missing, if applicable, the service
- * will return the named object from this bucket as the content for a
- * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+ * returns the named object from this bucket as the content for a
+ * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
* result.
*
*
@@ -21767,8 +21786,8 @@ public com.google.protobuf.ByteString getNotFoundPageBytes() {
*
* Optional. If the requested object path is missing, and any
* `mainPageSuffix` object is missing, if applicable, the service
- * will return the named object from this bucket as the content for a
- * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+ * returns the named object from this bucket as the content for a
+ * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
* result.
*
*
@@ -21793,8 +21812,8 @@ public Builder setNotFoundPage(java.lang.String value) {
*
* Optional. If the requested object path is missing, and any
* `mainPageSuffix` object is missing, if applicable, the service
- * will return the named object from this bucket as the content for a
- * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+ * returns the named object from this bucket as the content for a
+ * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
* result.
*
*
@@ -21815,8 +21834,8 @@ public Builder clearNotFoundPage() {
*
* Optional. If the requested object path is missing, and any
* `mainPageSuffix` object is missing, if applicable, the service
- * will return the named object from this bucket as the content for a
- * [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+ * returns the named object from this bucket as the content for a
+ * [404 Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)
* result.
*
*
@@ -21964,9 +21983,11 @@ public interface CustomPlacementConfigOrBuilder
*
*
*
- * Configuration for Custom Dual Regions. It should specify precisely two
- * eligible regions within the same Multiregion. More information on regions
- * may be found [here](https://cloud.google.com/storage/docs/locations).
+ * Configuration for [configurable dual-
+ * regions](https://cloud.google.com/storage/docs/locations#configurable). It
+ * should specify precisely two eligible regions within the same multi-region.
+ * For details, see
+ * [locations](https://cloud.google.com/storage/docs/locations).
*
*
* Protobuf type {@code google.storage.v2.Bucket.CustomPlacementConfig}
@@ -22247,9 +22268,11 @@ protected Builder newBuilderForType(
*
*
*
- * Configuration for Custom Dual Regions. It should specify precisely two
- * eligible regions within the same Multiregion. More information on regions
- * may be found [here](https://cloud.google.com/storage/docs/locations).
+ * Configuration for [configurable dual-
+ * regions](https://cloud.google.com/storage/docs/locations#configurable). It
+ * should specify precisely two eligible regions within the same multi-region.
+ * For details, see
+ * [locations](https://cloud.google.com/storage/docs/locations).
*
*
* Protobuf type {@code google.storage.v2.Bucket.CustomPlacementConfig}
@@ -22709,8 +22732,8 @@ public interface AutoclassOrBuilder
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -22727,8 +22750,8 @@ public interface AutoclassOrBuilder
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -22745,8 +22768,8 @@ public interface AutoclassOrBuilder
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -22759,7 +22782,7 @@ public interface AutoclassOrBuilder
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -22774,7 +22797,7 @@ public interface AutoclassOrBuilder
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -22789,7 +22812,7 @@ public interface AutoclassOrBuilder
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -22921,8 +22944,8 @@ public boolean getEnabled() {
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -22942,8 +22965,8 @@ public boolean hasToggleTime() {
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -22963,8 +22986,8 @@ public com.google.protobuf.Timestamp getToggleTime() {
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -22985,7 +23008,7 @@ public com.google.protobuf.TimestampOrBuilder getToggleTimeOrBuilder() {
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -23003,7 +23026,7 @@ public boolean hasTerminalStorageClass() {
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -23029,7 +23052,7 @@ public java.lang.String getTerminalStorageClass() {
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -23641,8 +23664,8 @@ public Builder clearEnabled() {
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -23661,8 +23684,8 @@ public boolean hasToggleTime() {
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -23687,8 +23710,8 @@ public com.google.protobuf.Timestamp getToggleTime() {
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -23715,8 +23738,8 @@ public Builder setToggleTime(com.google.protobuf.Timestamp value) {
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -23740,8 +23763,8 @@ public Builder setToggleTime(com.google.protobuf.Timestamp.Builder builderForVal
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -23773,8 +23796,8 @@ public Builder mergeToggleTime(com.google.protobuf.Timestamp value) {
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -23798,8 +23821,8 @@ public Builder clearToggleTime() {
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -23818,8 +23841,8 @@ public com.google.protobuf.Timestamp.Builder getToggleTimeBuilder() {
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -23842,8 +23865,8 @@ public com.google.protobuf.TimestampOrBuilder getToggleTimeOrBuilder() {
*
* Output only. Latest instant at which the `enabled` field was set to true
* after being disabled/unconfigured or set to false after being enabled. If
- * Autoclass is enabled when the bucket is created, the toggle_time is set
- * to the bucket creation time.
+ * Autoclass is enabled when the bucket is created, the value of the
+ * `toggle_time` field is set to the bucket `create_time`.
*
*
*
@@ -23873,7 +23896,7 @@ public com.google.protobuf.TimestampOrBuilder getToggleTimeOrBuilder() {
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -23890,7 +23913,7 @@ public boolean hasTerminalStorageClass() {
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -23915,7 +23938,7 @@ public java.lang.String getTerminalStorageClass() {
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -23940,7 +23963,7 @@ public com.google.protobuf.ByteString getTerminalStorageClassBytes() {
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -23964,7 +23987,7 @@ public Builder setTerminalStorageClass(java.lang.String value) {
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -23984,7 +24007,7 @@ public Builder clearTerminalStorageClass() {
*
*
*
- * An object in an Autoclass bucket will eventually cool down to the
+ * An object in an Autoclass bucket eventually cools down to the
* terminal storage class if there is no access to the object.
* The only valid values are NEARLINE and ARCHIVE.
*
@@ -24305,7 +24328,7 @@ public interface IpFilterOrBuilder
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -24322,7 +24345,7 @@ public interface IpFilterOrBuilder
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -24339,7 +24362,7 @@ public interface IpFilterOrBuilder
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -24472,8 +24495,8 @@ com.google.storage.v2.Bucket.IpFilter.VpcNetworkSourceOrBuilder getVpcNetworkSou
* Optional. Whether or not to allow VPCs from orgs different than the
* bucket's parent org to access the bucket. When set to true, validations
* on the existence of the VPCs won't be performed. If set to false, each
- * VPC network source will be checked to belong to the same org as the
- * bucket as well as validated for existence.
+ * VPC network source is checked to belong to the same org as the bucket as
+ * well as validated for existence.
* bool allow_cross_org_vpcs = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -24487,7 +24510,7 @@ com.google.storage.v2.Bucket.IpFilter.VpcNetworkSourceOrBuilder getVpcNetworkSou
*
*
* Whether or not to allow all P4SA access to the bucket. When set to true,
- * IP filter config validation will not apply.
+ * IP filter config validation doesn't apply.
*
*
* optional bool allow_all_service_agent_access = 5;
@@ -24501,7 +24524,7 @@ com.google.storage.v2.Bucket.IpFilter.VpcNetworkSourceOrBuilder getVpcNetworkSou
*
*
* Whether or not to allow all P4SA access to the bucket. When set to true,
- * IP filter config validation will not apply.
+ * IP filter config validation doesn't apply.
*
*
* optional bool allow_all_service_agent_access = 5;
@@ -26594,7 +26617,7 @@ public com.google.storage.v2.Bucket.IpFilter.VpcNetworkSource getDefaultInstance
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -26614,7 +26637,7 @@ public boolean hasMode() {
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -26642,7 +26665,7 @@ public java.lang.String getMode() {
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -26826,8 +26849,8 @@ public com.google.storage.v2.Bucket.IpFilter.VpcNetworkSource getVpcNetworkSourc
* Optional. Whether or not to allow VPCs from orgs different than the
* bucket's parent org to access the bucket. When set to true, validations
* on the existence of the VPCs won't be performed. If set to false, each
- * VPC network source will be checked to belong to the same org as the
- * bucket as well as validated for existence.
+ * VPC network source is checked to belong to the same org as the bucket as
+ * well as validated for existence.
* bool allow_cross_org_vpcs = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -26847,7 +26870,7 @@ public boolean getAllowCrossOrgVpcs() {
*
*
* Whether or not to allow all P4SA access to the bucket. When set to true,
- * IP filter config validation will not apply.
+ * IP filter config validation doesn't apply.
*
*
* optional bool allow_all_service_agent_access = 5;
@@ -26864,7 +26887,7 @@ public boolean hasAllowAllServiceAgentAccess() {
*
*
* Whether or not to allow all P4SA access to the bucket. When set to true,
- * IP filter config validation will not apply.
+ * IP filter config validation doesn't apply.
*
*
* optional bool allow_all_service_agent_access = 5;
@@ -27414,7 +27437,7 @@ public Builder mergeFrom(
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -27433,7 +27456,7 @@ public boolean hasMode() {
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -27460,7 +27483,7 @@ public java.lang.String getMode() {
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -27487,7 +27510,7 @@ public com.google.protobuf.ByteString getModeBytes() {
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -27513,7 +27536,7 @@ public Builder setMode(java.lang.String value) {
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -27535,7 +27558,7 @@ public Builder clearMode() {
* `Disabled`. When set to `Enabled`, IP filtering rules are applied to a
* bucket and all incoming requests to the bucket are evaluated against
* these rules. When set to `Disabled`, IP filtering rules are not applied
- * to a bucket.".
+ * to a bucket.
* optional string mode = 1;
@@ -28223,8 +28246,8 @@ public Builder removeVpcNetworkSources(int index) {
* Optional. Whether or not to allow VPCs from orgs different than the
* bucket's parent org to access the bucket. When set to true, validations
* on the existence of the VPCs won't be performed. If set to false, each
- * VPC network source will be checked to belong to the same org as the
- * bucket as well as validated for existence.
+ * VPC network source is checked to belong to the same org as the bucket as
+ * well as validated for existence.
* bool allow_cross_org_vpcs = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -28243,8 +28266,8 @@ public boolean getAllowCrossOrgVpcs() {
* Optional. Whether or not to allow VPCs from orgs different than the
* bucket's parent org to access the bucket. When set to true, validations
* on the existence of the VPCs won't be performed. If set to false, each
- * VPC network source will be checked to belong to the same org as the
- * bucket as well as validated for existence.
+ * VPC network source is checked to belong to the same org as the bucket as
+ * well as validated for existence.
* bool allow_cross_org_vpcs = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -28267,8 +28290,8 @@ public Builder setAllowCrossOrgVpcs(boolean value) {
* Optional. Whether or not to allow VPCs from orgs different than the
* bucket's parent org to access the bucket. When set to true, validations
* on the existence of the VPCs won't be performed. If set to false, each
- * VPC network source will be checked to belong to the same org as the
- * bucket as well as validated for existence.
+ * VPC network source is checked to belong to the same org as the bucket as
+ * well as validated for existence.
*
*
* bool allow_cross_org_vpcs = 4 [(.google.api.field_behavior) = OPTIONAL];
@@ -28289,7 +28312,7 @@ public Builder clearAllowCrossOrgVpcs() {
*
*
* Whether or not to allow all P4SA access to the bucket. When set to true,
- * IP filter config validation will not apply.
+ * IP filter config validation doesn't apply.
*
*
* optional bool allow_all_service_agent_access = 5;
@@ -28306,7 +28329,7 @@ public boolean hasAllowAllServiceAgentAccess() {
*
*
* Whether or not to allow all P4SA access to the bucket. When set to true,
- * IP filter config validation will not apply.
+ * IP filter config validation doesn't apply.
*
*
* optional bool allow_all_service_agent_access = 5;
@@ -28323,7 +28346,7 @@ public boolean getAllowAllServiceAgentAccess() {
*
*
* Whether or not to allow all P4SA access to the bucket. When set to true,
- * IP filter config validation will not apply.
+ * IP filter config validation doesn't apply.
*
*
* optional bool allow_all_service_agent_access = 5;
@@ -28344,7 +28367,7 @@ public Builder setAllowAllServiceAgentAccess(boolean value) {
*
*
* Whether or not to allow all P4SA access to the bucket. When set to true,
- * IP filter config validation will not apply.
+ * IP filter config validation doesn't apply.
*
*
* optional bool allow_all_service_agent_access = 5;
@@ -29035,7 +29058,7 @@ public com.google.protobuf.ByteString getNameBytes() {
*
* Output only. The user-chosen part of the bucket name. The `{bucket}`
* portion of the `name` field. For globally unique buckets, this is equal to
- * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+ * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
*
*
* string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -29061,7 +29084,7 @@ public java.lang.String getBucketId() {
*
* Output only. The user-chosen part of the bucket name. The `{bucket}`
* portion of the `name` field. For globally unique buckets, this is equal to
- * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+ * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
*
*
* string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -29091,8 +29114,8 @@ public com.google.protobuf.ByteString getBucketIdBytes() {
*
*
* The etag of the bucket.
- * If included in the metadata of an UpdateBucketRequest, the operation will
- * only be performed if the etag matches that of the bucket.
+ * If included in the metadata of an `UpdateBucketRequest`, the operation is
+ * only performed if the `etag` matches that of the bucket.
*
*
* string etag = 29;
@@ -29117,8 +29140,8 @@ public java.lang.String getEtag() {
*
*
* The etag of the bucket.
- * If included in the metadata of an UpdateBucketRequest, the operation will
- * only be performed if the etag matches that of the bucket.
+ * If included in the metadata of an `UpdateBucketRequest`, the operation is
+ * only performed if the `etag` matches that of the bucket.
*
*
* string etag = 29;
@@ -29148,9 +29171,9 @@ public com.google.protobuf.ByteString getEtagBytes() {
*
*
* Immutable. The project which owns this bucket, in the format of
- * "projects/{projectIdentifier}".
- * {projectIdentifier} can be the project ID or project number.
- * Output values will always be in project number format.
+ * `projects/{projectIdentifier}`.
+ * `{projectIdentifier}` can be the project ID or project number.
+ * Output values are always in the project number format.
*
*
*
@@ -29177,9 +29200,9 @@ public java.lang.String getProject() {
*
*
* Immutable. The project which owns this bucket, in the format of
- * "projects/{projectIdentifier}".
- * {projectIdentifier} can be the project ID or project number.
- * Output values will always be in project number format.
+ * `projects/{projectIdentifier}`.
+ * `{projectIdentifier}` can be the project ID or project number.
+ * Output values are always in the project number format.
*
*
*
@@ -29231,10 +29254,8 @@ public long getMetageneration() {
*
* Immutable. The location of the bucket. Object data for objects in the
* bucket resides in physical storage within this region. Defaults to `US`.
- * See the
- * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
- * guide] for the authoritative list. Attempting to update this field after
- * the bucket is created will result in an error.
+ * Attempting to update this field after the bucket is created results in an
+ * error.
*
*
* string location = 5 [(.google.api.field_behavior) = IMMUTABLE];
@@ -29260,10 +29281,8 @@ public java.lang.String getLocation() {
*
* Immutable. The location of the bucket. Object data for objects in the
* bucket resides in physical storage within this region. Defaults to `US`.
- * See the
- * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
- * guide] for the authoritative list. Attempting to update this field after
- * the bucket is created will result in an error.
+ * Attempting to update this field after the bucket is created results in an
+ * error.
*
*
* string location = 5 [(.google.api.field_behavior) = IMMUTABLE];
@@ -29350,9 +29369,9 @@ public com.google.protobuf.ByteString getLocationTypeBytes() {
* Optional. The bucket's default storage class, used whenever no storageClass
* is specified for a newly-created object. This defines how objects in the
* bucket are stored and determines the SLA and the cost of storage.
- * If this value is not specified when the bucket is created, it will default
- * to `STANDARD`. For more information, see
- * https://developers.google.com/storage/docs/storage-classes.
+ * If this value is not specified when the bucket is created, it defaults
+ * to `STANDARD`. For more information, see [Storage
+ * classes](https://developers.google.com/storage/docs/storage-classes).
*
*
* string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -29379,9 +29398,9 @@ public java.lang.String getStorageClass() {
* Optional. The bucket's default storage class, used whenever no storageClass
* is specified for a newly-created object. This defines how objects in the
* bucket are stored and determines the SLA and the cost of storage.
- * If this value is not specified when the bucket is created, it will default
- * to `STANDARD`. For more information, see
- * https://developers.google.com/storage/docs/storage-classes.
+ * If this value is not specified when the bucket is created, it defaults
+ * to `STANDARD`. For more information, see [Storage
+ * classes](https://developers.google.com/storage/docs/storage-classes).
*
*
* string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -29411,11 +29430,11 @@ public com.google.protobuf.ByteString getStorageClassBytes() {
*
*
* Optional. The recovery point objective for cross-region replication of the
- * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
- * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+ * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+ * default replication. `ASYNC_TURBO` enables turbo replication, valid for
* dual-region buckets only. If rpo is not specified when the bucket is
- * created, it defaults to "DEFAULT". For more information, see
- * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+ * created, it defaults to `DEFAULT`. For more information, see [Turbo
+ * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
*
*
* string rpo = 27 [(.google.api.field_behavior) = OPTIONAL];
@@ -29440,11 +29459,11 @@ public java.lang.String getRpo() {
*
*
* Optional. The recovery point objective for cross-region replication of the
- * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
- * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+ * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+ * default replication. `ASYNC_TURBO` enables turbo replication, valid for
* dual-region buckets only. If rpo is not specified when the bucket is
- * created, it defaults to "DEFAULT". For more information, see
- * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+ * created, it defaults to `DEFAULT`. For more information, see [Turbo
+ * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
*
*
* string rpo = 27 [(.google.api.field_behavior) = OPTIONAL];
@@ -29474,7 +29493,7 @@ public com.google.protobuf.ByteString getRpoBytes() {
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -29492,7 +29511,7 @@ public java.util.List
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -29511,7 +29530,7 @@ public java.util.List
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -29529,7 +29548,7 @@ public int getAclCount() {
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -29547,7 +29566,7 @@ public com.google.storage.v2.BucketAccessControl getAcl(int index) {
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -29570,7 +29589,7 @@ public com.google.storage.v2.BucketAccessControlOrBuilder getAclOrBuilder(int in
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -29588,7 +29607,7 @@ public java.util.List
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -29607,7 +29626,7 @@ public java.util.List
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -29625,7 +29644,7 @@ public int getDefaultObjectAclCount() {
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -29643,7 +29662,7 @@ public com.google.storage.v2.ObjectAccessControl getDefaultObjectAcl(int index)
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -29664,9 +29683,9 @@ public com.google.storage.v2.ObjectAccessControlOrBuilder getDefaultObjectAclOrB
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -29684,9 +29703,9 @@ public boolean hasLifecycle() {
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -29706,9 +29725,9 @@ public com.google.storage.v2.Bucket.Lifecycle getLifecycle() {
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -29783,8 +29802,8 @@ public com.google.protobuf.TimestampOrBuilder getCreateTimeOrBuilder() {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -29800,8 +29819,8 @@ public java.util.List
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -29818,8 +29837,8 @@ public java.util.List
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -29835,8 +29854,8 @@ public int getCorsCount() {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -29852,8 +29871,8 @@ public com.google.storage.v2.Bucket.Cors getCors(int index) {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -29927,11 +29946,11 @@ public com.google.protobuf.TimestampOrBuilder getUpdateTimeOrBuilder() {
* Optional. The default value for event-based hold on newly created objects
* in this bucket. Event-based hold is a way to retain objects indefinitely
* until an event occurs, signified by the hold's release. After being
- * released, such objects will be subject to bucket-level retention (if any).
- * One sample use case of this flag is for banks to hold loan documents for at
+ * released, such objects are subject to bucket-level retention (if any). One
+ * sample use case of this flag is for banks to hold loan documents for at
* least 3 years after loan is paid in full. Here, bucket-level retention is 3
* years and the event is loan being paid in full. In this example, these
- * objects will be held intact for any number of years until the event has
+ * objects are held intact for any number of years until the event has
* occurred (event-based hold on the object is released) and then 3 more years
* after that. That means retention duration of the objects begins from the
* moment event-based hold transitioned from true to false. Objects under
@@ -30063,9 +30082,9 @@ public java.lang.String getLabelsOrThrow(java.lang.String key) {
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
* .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL];
@@ -30083,9 +30102,9 @@ public boolean hasWebsite() {
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
* .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL];
@@ -30103,9 +30122,9 @@ public com.google.storage.v2.Bucket.Website getWebsite() {
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
* .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL];
@@ -30123,7 +30142,7 @@ public com.google.storage.v2.Bucket.WebsiteOrBuilder getWebsiteOrBuilder() {
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -30141,7 +30160,7 @@ public boolean hasVersioning() {
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -30161,7 +30180,7 @@ public com.google.storage.v2.Bucket.Versioning getVersioning() {
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -30348,7 +30367,7 @@ public com.google.storage.v2.Bucket.EncryptionOrBuilder getEncryptionOrBuilder()
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
* .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL];
@@ -30365,7 +30384,7 @@ public boolean hasBilling() {
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
* .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL];
@@ -30382,7 +30401,7 @@ public com.google.storage.v2.Bucket.Billing getBilling() {
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
* .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL];
@@ -30403,12 +30422,12 @@ public com.google.storage.v2.Bucket.BillingOrBuilder getBillingOrBuilder() {
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -30429,12 +30448,12 @@ public boolean hasRetentionPolicy() {
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -30457,12 +30476,12 @@ public com.google.storage.v2.Bucket.RetentionPolicy getRetentionPolicy() {
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -30483,7 +30502,7 @@ public com.google.storage.v2.Bucket.RetentionPolicyOrBuilder getRetentionPolicyO
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -30501,7 +30520,7 @@ public boolean hasIamConfig() {
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -30521,7 +30540,7 @@ public com.google.storage.v2.Bucket.IamConfig getIamConfig() {
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -30562,9 +30581,8 @@ public boolean getSatisfiesPzs() {
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -30583,9 +30601,8 @@ public boolean hasCustomPlacementConfig() {
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -30606,9 +30623,8 @@ public com.google.storage.v2.Bucket.CustomPlacementConfig getCustomPlacementConf
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -30631,8 +30647,8 @@ public com.google.storage.v2.Bucket.CustomPlacementConfig getCustomPlacementConf
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -30651,8 +30667,8 @@ public boolean hasAutoclass() {
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -30673,8 +30689,8 @@ public com.google.storage.v2.Bucket.Autoclass getAutoclass() {
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -30696,7 +30712,7 @@ public com.google.storage.v2.Bucket.AutoclassOrBuilder getAutoclassOrBuilder() {
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -30716,7 +30732,7 @@ public boolean hasHierarchicalNamespace() {
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -30738,7 +30754,7 @@ public com.google.storage.v2.Bucket.HierarchicalNamespace getHierarchicalNamespa
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -30824,7 +30840,7 @@ public com.google.storage.v2.Bucket.SoftDeletePolicyOrBuilder getSoftDeletePolic
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -30843,7 +30859,7 @@ public boolean hasObjectRetention() {
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -30864,7 +30880,7 @@ public com.google.storage.v2.Bucket.ObjectRetention getObjectRetention() {
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -32482,7 +32498,7 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
*
* Output only. The user-chosen part of the bucket name. The `{bucket}`
* portion of the `name` field. For globally unique buckets, this is equal to
- * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+ * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
*
*
* string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -32507,7 +32523,7 @@ public java.lang.String getBucketId() {
*
* Output only. The user-chosen part of the bucket name. The `{bucket}`
* portion of the `name` field. For globally unique buckets, this is equal to
- * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+ * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
*
*
* string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -32532,7 +32548,7 @@ public com.google.protobuf.ByteString getBucketIdBytes() {
*
* Output only. The user-chosen part of the bucket name. The `{bucket}`
* portion of the `name` field. For globally unique buckets, this is equal to
- * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+ * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
*
*
* string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -32556,7 +32572,7 @@ public Builder setBucketId(java.lang.String value) {
*
* Output only. The user-chosen part of the bucket name. The `{bucket}`
* portion of the `name` field. For globally unique buckets, this is equal to
- * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+ * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
*
*
* string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -32576,7 +32592,7 @@ public Builder clearBucketId() {
*
* Output only. The user-chosen part of the bucket name. The `{bucket}`
* portion of the `name` field. For globally unique buckets, this is equal to
- * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+ * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
*
*
* string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -32602,8 +32618,8 @@ public Builder setBucketIdBytes(com.google.protobuf.ByteString value) {
*
*
* The etag of the bucket.
- * If included in the metadata of an UpdateBucketRequest, the operation will
- * only be performed if the etag matches that of the bucket.
+ * If included in the metadata of an `UpdateBucketRequest`, the operation is
+ * only performed if the `etag` matches that of the bucket.
*
*
* string etag = 29;
@@ -32627,8 +32643,8 @@ public java.lang.String getEtag() {
*
*
* The etag of the bucket.
- * If included in the metadata of an UpdateBucketRequest, the operation will
- * only be performed if the etag matches that of the bucket.
+ * If included in the metadata of an `UpdateBucketRequest`, the operation is
+ * only performed if the `etag` matches that of the bucket.
*
*
* string etag = 29;
@@ -32652,8 +32668,8 @@ public com.google.protobuf.ByteString getEtagBytes() {
*
*
* The etag of the bucket.
- * If included in the metadata of an UpdateBucketRequest, the operation will
- * only be performed if the etag matches that of the bucket.
+ * If included in the metadata of an `UpdateBucketRequest`, the operation is
+ * only performed if the `etag` matches that of the bucket.
*
*
* string etag = 29;
@@ -32676,8 +32692,8 @@ public Builder setEtag(java.lang.String value) {
*
*
* The etag of the bucket.
- * If included in the metadata of an UpdateBucketRequest, the operation will
- * only be performed if the etag matches that of the bucket.
+ * If included in the metadata of an `UpdateBucketRequest`, the operation is
+ * only performed if the `etag` matches that of the bucket.
*
*
* string etag = 29;
@@ -32696,8 +32712,8 @@ public Builder clearEtag() {
*
*
* The etag of the bucket.
- * If included in the metadata of an UpdateBucketRequest, the operation will
- * only be performed if the etag matches that of the bucket.
+ * If included in the metadata of an `UpdateBucketRequest`, the operation is
+ * only performed if the `etag` matches that of the bucket.
*
*
* string etag = 29;
@@ -32723,9 +32739,9 @@ public Builder setEtagBytes(com.google.protobuf.ByteString value) {
*
*
* Immutable. The project which owns this bucket, in the format of
- * "projects/{projectIdentifier}".
- * {projectIdentifier} can be the project ID or project number.
- * Output values will always be in project number format.
+ * `projects/{projectIdentifier}`.
+ * `{projectIdentifier}` can be the project ID or project number.
+ * Output values are always in the project number format.
*
*
*
@@ -32751,9 +32767,9 @@ public java.lang.String getProject() {
*
*
* Immutable. The project which owns this bucket, in the format of
- * "projects/{projectIdentifier}".
- * {projectIdentifier} can be the project ID or project number.
- * Output values will always be in project number format.
+ * `projects/{projectIdentifier}`.
+ * `{projectIdentifier}` can be the project ID or project number.
+ * Output values are always in the project number format.
*
*
*
@@ -32779,9 +32795,9 @@ public com.google.protobuf.ByteString getProjectBytes() {
*
*
* Immutable. The project which owns this bucket, in the format of
- * "projects/{projectIdentifier}".
- * {projectIdentifier} can be the project ID or project number.
- * Output values will always be in project number format.
+ * `projects/{projectIdentifier}`.
+ * `{projectIdentifier}` can be the project ID or project number.
+ * Output values are always in the project number format.
*
*
*
@@ -32806,9 +32822,9 @@ public Builder setProject(java.lang.String value) {
*
*
* Immutable. The project which owns this bucket, in the format of
- * "projects/{projectIdentifier}".
- * {projectIdentifier} can be the project ID or project number.
- * Output values will always be in project number format.
+ * `projects/{projectIdentifier}`.
+ * `{projectIdentifier}` can be the project ID or project number.
+ * Output values are always in the project number format.
*
*
*
@@ -32829,9 +32845,9 @@ public Builder clearProject() {
*
*
* Immutable. The project which owns this bucket, in the format of
- * "projects/{projectIdentifier}".
- * {projectIdentifier} can be the project ID or project number.
- * Output values will always be in project number format.
+ * `projects/{projectIdentifier}`.
+ * `{projectIdentifier}` can be the project ID or project number.
+ * Output values are always in the project number format.
*
*
*
@@ -32916,10 +32932,8 @@ public Builder clearMetageneration() {
*
* Immutable. The location of the bucket. Object data for objects in the
* bucket resides in physical storage within this region. Defaults to `US`.
- * See the
- * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
- * guide] for the authoritative list. Attempting to update this field after
- * the bucket is created will result in an error.
+ * Attempting to update this field after the bucket is created results in an
+ * error.
*
*
* string location = 5 [(.google.api.field_behavior) = IMMUTABLE];
@@ -32944,10 +32958,8 @@ public java.lang.String getLocation() {
*
* Immutable. The location of the bucket. Object data for objects in the
* bucket resides in physical storage within this region. Defaults to `US`.
- * See the
- * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
- * guide] for the authoritative list. Attempting to update this field after
- * the bucket is created will result in an error.
+ * Attempting to update this field after the bucket is created results in an
+ * error.
*
*
* string location = 5 [(.google.api.field_behavior) = IMMUTABLE];
@@ -32972,10 +32984,8 @@ public com.google.protobuf.ByteString getLocationBytes() {
*
* Immutable. The location of the bucket. Object data for objects in the
* bucket resides in physical storage within this region. Defaults to `US`.
- * See the
- * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
- * guide] for the authoritative list. Attempting to update this field after
- * the bucket is created will result in an error.
+ * Attempting to update this field after the bucket is created results in an
+ * error.
*
*
* string location = 5 [(.google.api.field_behavior) = IMMUTABLE];
@@ -32999,10 +33009,8 @@ public Builder setLocation(java.lang.String value) {
*
* Immutable. The location of the bucket. Object data for objects in the
* bucket resides in physical storage within this region. Defaults to `US`.
- * See the
- * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
- * guide] for the authoritative list. Attempting to update this field after
- * the bucket is created will result in an error.
+ * Attempting to update this field after the bucket is created results in an
+ * error.
*
*
* string location = 5 [(.google.api.field_behavior) = IMMUTABLE];
@@ -33022,10 +33030,8 @@ public Builder clearLocation() {
*
* Immutable. The location of the bucket. Object data for objects in the
* bucket resides in physical storage within this region. Defaults to `US`.
- * See the
- * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
- * guide] for the authoritative list. Attempting to update this field after
- * the bucket is created will result in an error.
+ * Attempting to update this field after the bucket is created results in an
+ * error.
*
*
* string location = 5 [(.google.api.field_behavior) = IMMUTABLE];
@@ -33169,9 +33175,9 @@ public Builder setLocationTypeBytes(com.google.protobuf.ByteString value) {
* Optional. The bucket's default storage class, used whenever no storageClass
* is specified for a newly-created object. This defines how objects in the
* bucket are stored and determines the SLA and the cost of storage.
- * If this value is not specified when the bucket is created, it will default
- * to `STANDARD`. For more information, see
- * https://developers.google.com/storage/docs/storage-classes.
+ * If this value is not specified when the bucket is created, it defaults
+ * to `STANDARD`. For more information, see [Storage
+ * classes](https://developers.google.com/storage/docs/storage-classes).
*
*
* string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -33197,9 +33203,9 @@ public java.lang.String getStorageClass() {
* Optional. The bucket's default storage class, used whenever no storageClass
* is specified for a newly-created object. This defines how objects in the
* bucket are stored and determines the SLA and the cost of storage.
- * If this value is not specified when the bucket is created, it will default
- * to `STANDARD`. For more information, see
- * https://developers.google.com/storage/docs/storage-classes.
+ * If this value is not specified when the bucket is created, it defaults
+ * to `STANDARD`. For more information, see [Storage
+ * classes](https://developers.google.com/storage/docs/storage-classes).
*
*
* string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -33225,9 +33231,9 @@ public com.google.protobuf.ByteString getStorageClassBytes() {
* Optional. The bucket's default storage class, used whenever no storageClass
* is specified for a newly-created object. This defines how objects in the
* bucket are stored and determines the SLA and the cost of storage.
- * If this value is not specified when the bucket is created, it will default
- * to `STANDARD`. For more information, see
- * https://developers.google.com/storage/docs/storage-classes.
+ * If this value is not specified when the bucket is created, it defaults
+ * to `STANDARD`. For more information, see [Storage
+ * classes](https://developers.google.com/storage/docs/storage-classes).
*
*
* string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -33252,9 +33258,9 @@ public Builder setStorageClass(java.lang.String value) {
* Optional. The bucket's default storage class, used whenever no storageClass
* is specified for a newly-created object. This defines how objects in the
* bucket are stored and determines the SLA and the cost of storage.
- * If this value is not specified when the bucket is created, it will default
- * to `STANDARD`. For more information, see
- * https://developers.google.com/storage/docs/storage-classes.
+ * If this value is not specified when the bucket is created, it defaults
+ * to `STANDARD`. For more information, see [Storage
+ * classes](https://developers.google.com/storage/docs/storage-classes).
*
*
* string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -33275,9 +33281,9 @@ public Builder clearStorageClass() {
* Optional. The bucket's default storage class, used whenever no storageClass
* is specified for a newly-created object. This defines how objects in the
* bucket are stored and determines the SLA and the cost of storage.
- * If this value is not specified when the bucket is created, it will default
- * to `STANDARD`. For more information, see
- * https://developers.google.com/storage/docs/storage-classes.
+ * If this value is not specified when the bucket is created, it defaults
+ * to `STANDARD`. For more information, see [Storage
+ * classes](https://developers.google.com/storage/docs/storage-classes).
*
*
* string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -33303,11 +33309,11 @@ public Builder setStorageClassBytes(com.google.protobuf.ByteString value) {
*
*
* Optional. The recovery point objective for cross-region replication of the
- * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
- * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+ * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+ * default replication. `ASYNC_TURBO` enables turbo replication, valid for
* dual-region buckets only. If rpo is not specified when the bucket is
- * created, it defaults to "DEFAULT". For more information, see
- * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+ * created, it defaults to `DEFAULT`. For more information, see [Turbo
+ * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
*
*
* string rpo = 27 [(.google.api.field_behavior) = OPTIONAL];
@@ -33331,11 +33337,11 @@ public java.lang.String getRpo() {
*
*
* Optional. The recovery point objective for cross-region replication of the
- * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
- * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+ * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+ * default replication. `ASYNC_TURBO` enables turbo replication, valid for
* dual-region buckets only. If rpo is not specified when the bucket is
- * created, it defaults to "DEFAULT". For more information, see
- * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+ * created, it defaults to `DEFAULT`. For more information, see [Turbo
+ * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
*
*
* string rpo = 27 [(.google.api.field_behavior) = OPTIONAL];
@@ -33359,11 +33365,11 @@ public com.google.protobuf.ByteString getRpoBytes() {
*
*
* Optional. The recovery point objective for cross-region replication of the
- * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
- * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+ * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+ * default replication. `ASYNC_TURBO` enables turbo replication, valid for
* dual-region buckets only. If rpo is not specified when the bucket is
- * created, it defaults to "DEFAULT". For more information, see
- * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+ * created, it defaults to `DEFAULT`. For more information, see [Turbo
+ * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
*
*
* string rpo = 27 [(.google.api.field_behavior) = OPTIONAL];
@@ -33386,11 +33392,11 @@ public Builder setRpo(java.lang.String value) {
*
*
* Optional. The recovery point objective for cross-region replication of the
- * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
- * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+ * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+ * default replication. `ASYNC_TURBO` enables turbo replication, valid for
* dual-region buckets only. If rpo is not specified when the bucket is
- * created, it defaults to "DEFAULT". For more information, see
- * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+ * created, it defaults to `DEFAULT`. For more information, see [Turbo
+ * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
*
*
* string rpo = 27 [(.google.api.field_behavior) = OPTIONAL];
@@ -33409,11 +33415,11 @@ public Builder clearRpo() {
*
*
* Optional. The recovery point objective for cross-region replication of the
- * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
- * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+ * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+ * default replication. `ASYNC_TURBO` enables turbo replication, valid for
* dual-region buckets only. If rpo is not specified when the bucket is
- * created, it defaults to "DEFAULT". For more information, see
- * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+ * created, it defaults to `DEFAULT`. For more information, see [Turbo
+ * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
*
*
* string rpo = 27 [(.google.api.field_behavior) = OPTIONAL];
@@ -33453,7 +33459,7 @@ private void ensureAclIsMutable() {
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33474,7 +33480,7 @@ public java.util.List
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33495,7 +33501,7 @@ public int getAclCount() {
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33516,7 +33522,7 @@ public com.google.storage.v2.BucketAccessControl getAcl(int index) {
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33543,7 +33549,7 @@ public Builder setAcl(int index, com.google.storage.v2.BucketAccessControl value
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33568,7 +33574,7 @@ public Builder setAcl(
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33595,7 +33601,7 @@ public Builder addAcl(com.google.storage.v2.BucketAccessControl value) {
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33622,7 +33628,7 @@ public Builder addAcl(int index, com.google.storage.v2.BucketAccessControl value
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33646,7 +33652,7 @@ public Builder addAcl(com.google.storage.v2.BucketAccessControl.Builder builderF
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33671,7 +33677,7 @@ public Builder addAcl(
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33696,7 +33702,7 @@ public Builder addAllAcl(
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33720,7 +33726,7 @@ public Builder clearAcl() {
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33744,7 +33750,7 @@ public Builder removeAcl(int index) {
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33761,7 +33767,7 @@ public com.google.storage.v2.BucketAccessControl.Builder getAclBuilder(int index
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33782,7 +33788,7 @@ public com.google.storage.v2.BucketAccessControlOrBuilder getAclOrBuilder(int in
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33804,7 +33810,7 @@ public com.google.storage.v2.BucketAccessControlOrBuilder getAclOrBuilder(int in
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33822,7 +33828,7 @@ public com.google.storage.v2.BucketAccessControl.Builder addAclBuilder() {
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33840,7 +33846,7 @@ public com.google.storage.v2.BucketAccessControl.Builder addAclBuilder(int index
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -33891,7 +33897,7 @@ private void ensureDefaultObjectAclIsMutable() {
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -33912,7 +33918,7 @@ public java.util.List
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -33933,7 +33939,7 @@ public int getDefaultObjectAclCount() {
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -33954,7 +33960,7 @@ public com.google.storage.v2.ObjectAccessControl getDefaultObjectAcl(int index)
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -33981,7 +33987,7 @@ public Builder setDefaultObjectAcl(int index, com.google.storage.v2.ObjectAccess
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34006,7 +34012,7 @@ public Builder setDefaultObjectAcl(
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34033,7 +34039,7 @@ public Builder addDefaultObjectAcl(com.google.storage.v2.ObjectAccessControl val
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34060,7 +34066,7 @@ public Builder addDefaultObjectAcl(int index, com.google.storage.v2.ObjectAccess
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34085,7 +34091,7 @@ public Builder addDefaultObjectAcl(
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34110,7 +34116,7 @@ public Builder addDefaultObjectAcl(
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34135,7 +34141,7 @@ public Builder addAllDefaultObjectAcl(
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34159,7 +34165,7 @@ public Builder clearDefaultObjectAcl() {
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34183,7 +34189,7 @@ public Builder removeDefaultObjectAcl(int index) {
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34200,7 +34206,7 @@ public com.google.storage.v2.ObjectAccessControl.Builder getDefaultObjectAclBuil
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34222,7 +34228,7 @@ public com.google.storage.v2.ObjectAccessControlOrBuilder getDefaultObjectAclOrB
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34244,7 +34250,7 @@ public com.google.storage.v2.ObjectAccessControlOrBuilder getDefaultObjectAclOrB
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34262,7 +34268,7 @@ public com.google.storage.v2.ObjectAccessControl.Builder addDefaultObjectAclBuil
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34280,7 +34286,7 @@ public com.google.storage.v2.ObjectAccessControl.Builder addDefaultObjectAclBuil
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -34324,9 +34330,9 @@ public com.google.storage.v2.ObjectAccessControl.Builder addDefaultObjectAclBuil
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -34343,9 +34349,9 @@ public boolean hasLifecycle() {
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -34368,9 +34374,9 @@ public com.google.storage.v2.Bucket.Lifecycle getLifecycle() {
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -34395,9 +34401,9 @@ public Builder setLifecycle(com.google.storage.v2.Bucket.Lifecycle value) {
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -34419,9 +34425,9 @@ public Builder setLifecycle(com.google.storage.v2.Bucket.Lifecycle.Builder build
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -34451,9 +34457,9 @@ public Builder mergeLifecycle(com.google.storage.v2.Bucket.Lifecycle value) {
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -34475,9 +34481,9 @@ public Builder clearLifecycle() {
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -34494,9 +34500,9 @@ public com.google.storage.v2.Bucket.Lifecycle.Builder getLifecycleBuilder() {
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -34517,9 +34523,9 @@ public com.google.storage.v2.Bucket.LifecycleOrBuilder getLifecycleOrBuilder() {
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -34775,8 +34781,8 @@ private void ensureCorsIsMutable() {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -34795,8 +34801,8 @@ public java.util.List
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -34815,8 +34821,8 @@ public int getCorsCount() {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -34835,8 +34841,8 @@ public com.google.storage.v2.Bucket.Cors getCors(int index) {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -34861,8 +34867,8 @@ public Builder setCors(int index, com.google.storage.v2.Bucket.Cors value) {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -34884,8 +34890,8 @@ public Builder setCors(int index, com.google.storage.v2.Bucket.Cors.Builder buil
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -34910,8 +34916,8 @@ public Builder addCors(com.google.storage.v2.Bucket.Cors value) {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -34936,8 +34942,8 @@ public Builder addCors(int index, com.google.storage.v2.Bucket.Cors value) {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -34959,8 +34965,8 @@ public Builder addCors(com.google.storage.v2.Bucket.Cors.Builder builderForValue
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -34982,8 +34988,8 @@ public Builder addCors(int index, com.google.storage.v2.Bucket.Cors.Builder buil
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -35006,8 +35012,8 @@ public Builder addAllCors(
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -35029,8 +35035,8 @@ public Builder clearCors() {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -35052,8 +35058,8 @@ public Builder removeCors(int index) {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -35068,8 +35074,8 @@ public com.google.storage.v2.Bucket.Cors.Builder getCorsBuilder(int index) {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -35088,8 +35094,8 @@ public com.google.storage.v2.Bucket.CorsOrBuilder getCorsOrBuilder(int index) {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -35109,8 +35115,8 @@ public com.google.storage.v2.Bucket.CorsOrBuilder getCorsOrBuilder(int index) {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -35126,8 +35132,8 @@ public com.google.storage.v2.Bucket.Cors.Builder addCorsBuilder() {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -35143,8 +35149,8 @@ public com.google.storage.v2.Bucket.Cors.Builder addCorsBuilder(int index) {
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -35393,11 +35399,11 @@ public com.google.protobuf.TimestampOrBuilder getUpdateTimeOrBuilder() {
* Optional. The default value for event-based hold on newly created objects
* in this bucket. Event-based hold is a way to retain objects indefinitely
* until an event occurs, signified by the hold's release. After being
- * released, such objects will be subject to bucket-level retention (if any).
- * One sample use case of this flag is for banks to hold loan documents for at
+ * released, such objects are subject to bucket-level retention (if any). One
+ * sample use case of this flag is for banks to hold loan documents for at
* least 3 years after loan is paid in full. Here, bucket-level retention is 3
* years and the event is loan being paid in full. In this example, these
- * objects will be held intact for any number of years until the event has
+ * objects are held intact for any number of years until the event has
* occurred (event-based hold on the object is released) and then 3 more years
* after that. That means retention duration of the objects begins from the
* moment event-based hold transitioned from true to false. Objects under
@@ -35421,11 +35427,11 @@ public boolean getDefaultEventBasedHold() {
* Optional. The default value for event-based hold on newly created objects
* in this bucket. Event-based hold is a way to retain objects indefinitely
* until an event occurs, signified by the hold's release. After being
- * released, such objects will be subject to bucket-level retention (if any).
- * One sample use case of this flag is for banks to hold loan documents for at
+ * released, such objects are subject to bucket-level retention (if any). One
+ * sample use case of this flag is for banks to hold loan documents for at
* least 3 years after loan is paid in full. Here, bucket-level retention is 3
* years and the event is loan being paid in full. In this example, these
- * objects will be held intact for any number of years until the event has
+ * objects are held intact for any number of years until the event has
* occurred (event-based hold on the object is released) and then 3 more years
* after that. That means retention duration of the objects begins from the
* moment event-based hold transitioned from true to false. Objects under
@@ -35453,11 +35459,11 @@ public Builder setDefaultEventBasedHold(boolean value) {
* Optional. The default value for event-based hold on newly created objects
* in this bucket. Event-based hold is a way to retain objects indefinitely
* until an event occurs, signified by the hold's release. After being
- * released, such objects will be subject to bucket-level retention (if any).
- * One sample use case of this flag is for banks to hold loan documents for at
+ * released, such objects are subject to bucket-level retention (if any). One
+ * sample use case of this flag is for banks to hold loan documents for at
* least 3 years after loan is paid in full. Here, bucket-level retention is 3
* years and the event is loan being paid in full. In this example, these
- * objects will be held intact for any number of years until the event has
+ * objects are held intact for any number of years until the event has
* occurred (event-based hold on the object is released) and then 3 more years
* after that. That means retention duration of the objects begins from the
* moment event-based hold transitioned from true to false. Objects under
@@ -35660,9 +35666,9 @@ public Builder putAllLabels(java.util.Map
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
*
@@ -35680,9 +35686,9 @@ public boolean hasWebsite() {
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
*
@@ -35706,9 +35712,9 @@ public com.google.storage.v2.Bucket.Website getWebsite() {
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
*
@@ -35734,9 +35740,9 @@ public Builder setWebsite(com.google.storage.v2.Bucket.Website value) {
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
*
@@ -35759,9 +35765,9 @@ public Builder setWebsite(com.google.storage.v2.Bucket.Website.Builder builderFo
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
*
@@ -35792,9 +35798,9 @@ public Builder mergeWebsite(com.google.storage.v2.Bucket.Website value) {
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
*
@@ -35817,9 +35823,9 @@ public Builder clearWebsite() {
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
*
@@ -35837,9 +35843,9 @@ public com.google.storage.v2.Bucket.Website.Builder getWebsiteBuilder() {
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
*
@@ -35861,9 +35867,9 @@ public com.google.storage.v2.Bucket.WebsiteOrBuilder getWebsiteOrBuilder() {
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
*
@@ -35898,7 +35904,7 @@ public com.google.storage.v2.Bucket.WebsiteOrBuilder getWebsiteOrBuilder() {
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -35915,7 +35921,7 @@ public boolean hasVersioning() {
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -35938,7 +35944,7 @@ public com.google.storage.v2.Bucket.Versioning getVersioning() {
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -35963,7 +35969,7 @@ public Builder setVersioning(com.google.storage.v2.Bucket.Versioning value) {
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -35985,7 +35991,7 @@ public Builder setVersioning(com.google.storage.v2.Bucket.Versioning.Builder bui
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -36015,7 +36021,7 @@ public Builder mergeVersioning(com.google.storage.v2.Bucket.Versioning value) {
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -36037,7 +36043,7 @@ public Builder clearVersioning() {
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -36054,7 +36060,7 @@ public com.google.storage.v2.Bucket.Versioning.Builder getVersioningBuilder() {
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -36075,7 +36081,7 @@ public com.google.storage.v2.Bucket.VersioningOrBuilder getVersioningOrBuilder()
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -36751,7 +36757,7 @@ public com.google.storage.v2.Bucket.EncryptionOrBuilder getEncryptionOrBuilder()
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
*
@@ -36768,7 +36774,7 @@ public boolean hasBilling() {
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
*
@@ -36791,7 +36797,7 @@ public com.google.storage.v2.Bucket.Billing getBilling() {
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
*
@@ -36816,7 +36822,7 @@ public Builder setBilling(com.google.storage.v2.Bucket.Billing value) {
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
*
@@ -36838,7 +36844,7 @@ public Builder setBilling(com.google.storage.v2.Bucket.Billing.Builder builderFo
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
*
@@ -36868,7 +36874,7 @@ public Builder mergeBilling(com.google.storage.v2.Bucket.Billing value) {
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
*
@@ -36890,7 +36896,7 @@ public Builder clearBilling() {
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
*
@@ -36907,7 +36913,7 @@ public com.google.storage.v2.Bucket.Billing.Builder getBillingBuilder() {
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
*
@@ -36928,7 +36934,7 @@ public com.google.storage.v2.Bucket.BillingOrBuilder getBillingOrBuilder() {
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
*
@@ -36966,12 +36972,12 @@ public com.google.storage.v2.Bucket.BillingOrBuilder getBillingOrBuilder() {
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -36991,12 +36997,12 @@ public boolean hasRetentionPolicy() {
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -37022,12 +37028,12 @@ public com.google.storage.v2.Bucket.RetentionPolicy getRetentionPolicy() {
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -37055,12 +37061,12 @@ public Builder setRetentionPolicy(com.google.storage.v2.Bucket.RetentionPolicy v
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -37086,12 +37092,12 @@ public Builder setRetentionPolicy(
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -37125,12 +37131,12 @@ public Builder mergeRetentionPolicy(com.google.storage.v2.Bucket.RetentionPolicy
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -37155,12 +37161,12 @@ public Builder clearRetentionPolicy() {
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -37180,12 +37186,12 @@ public com.google.storage.v2.Bucket.RetentionPolicy.Builder getRetentionPolicyBu
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -37209,12 +37215,12 @@ public com.google.storage.v2.Bucket.RetentionPolicyOrBuilder getRetentionPolicyO
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -37249,7 +37255,7 @@ public com.google.storage.v2.Bucket.RetentionPolicyOrBuilder getRetentionPolicyO
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -37266,7 +37272,7 @@ public boolean hasIamConfig() {
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -37289,7 +37295,7 @@ public com.google.storage.v2.Bucket.IamConfig getIamConfig() {
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -37314,7 +37320,7 @@ public Builder setIamConfig(com.google.storage.v2.Bucket.IamConfig value) {
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -37336,7 +37342,7 @@ public Builder setIamConfig(com.google.storage.v2.Bucket.IamConfig.Builder build
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -37366,7 +37372,7 @@ public Builder mergeIamConfig(com.google.storage.v2.Bucket.IamConfig value) {
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -37388,7 +37394,7 @@ public Builder clearIamConfig() {
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -37405,7 +37411,7 @@ public com.google.storage.v2.Bucket.IamConfig.Builder getIamConfigBuilder() {
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -37426,7 +37432,7 @@ public com.google.storage.v2.Bucket.IamConfigOrBuilder getIamConfigOrBuilder() {
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -37518,9 +37524,8 @@ public Builder clearSatisfiesPzs() {
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -37538,9 +37543,8 @@ public boolean hasCustomPlacementConfig() {
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -37564,9 +37568,8 @@ public com.google.storage.v2.Bucket.CustomPlacementConfig getCustomPlacementConf
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -37593,9 +37596,8 @@ public Builder setCustomPlacementConfig(
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -37619,9 +37621,8 @@ public Builder setCustomPlacementConfig(
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -37654,9 +37655,8 @@ public Builder mergeCustomPlacementConfig(
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -37679,9 +37679,8 @@ public Builder clearCustomPlacementConfig() {
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -37700,9 +37699,8 @@ public Builder clearCustomPlacementConfig() {
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -37725,9 +37723,8 @@ public Builder clearCustomPlacementConfig() {
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -37763,8 +37760,8 @@ public Builder clearCustomPlacementConfig() {
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -37782,8 +37779,8 @@ public boolean hasAutoclass() {
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -37807,8 +37804,8 @@ public com.google.storage.v2.Bucket.Autoclass getAutoclass() {
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -37834,8 +37831,8 @@ public Builder setAutoclass(com.google.storage.v2.Bucket.Autoclass value) {
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -37858,8 +37855,8 @@ public Builder setAutoclass(com.google.storage.v2.Bucket.Autoclass.Builder build
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -37890,8 +37887,8 @@ public Builder mergeAutoclass(com.google.storage.v2.Bucket.Autoclass value) {
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -37914,8 +37911,8 @@ public Builder clearAutoclass() {
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -37933,8 +37930,8 @@ public com.google.storage.v2.Bucket.Autoclass.Builder getAutoclassBuilder() {
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -37956,8 +37953,8 @@ public com.google.storage.v2.Bucket.AutoclassOrBuilder getAutoclassOrBuilder() {
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -37993,7 +37990,7 @@ public com.google.storage.v2.Bucket.AutoclassOrBuilder getAutoclassOrBuilder() {
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -38012,7 +38009,7 @@ public boolean hasHierarchicalNamespace() {
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -38037,7 +38034,7 @@ public com.google.storage.v2.Bucket.HierarchicalNamespace getHierarchicalNamespa
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -38065,7 +38062,7 @@ public Builder setHierarchicalNamespace(
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -38090,7 +38087,7 @@ public Builder setHierarchicalNamespace(
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -38124,7 +38121,7 @@ public Builder mergeHierarchicalNamespace(
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -38148,7 +38145,7 @@ public Builder clearHierarchicalNamespace() {
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -38168,7 +38165,7 @@ public Builder clearHierarchicalNamespace() {
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -38192,7 +38189,7 @@ public Builder clearHierarchicalNamespace() {
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -38452,7 +38449,7 @@ public com.google.storage.v2.Bucket.SoftDeletePolicyOrBuilder getSoftDeletePolic
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -38470,7 +38467,7 @@ public boolean hasObjectRetention() {
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -38494,7 +38491,7 @@ public com.google.storage.v2.Bucket.ObjectRetention getObjectRetention() {
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -38520,7 +38517,7 @@ public Builder setObjectRetention(com.google.storage.v2.Bucket.ObjectRetention v
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -38544,7 +38541,7 @@ public Builder setObjectRetention(
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -38576,7 +38573,7 @@ public Builder mergeObjectRetention(com.google.storage.v2.Bucket.ObjectRetention
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -38599,7 +38596,7 @@ public Builder clearObjectRetention() {
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -38617,7 +38614,7 @@ public com.google.storage.v2.Bucket.ObjectRetention.Builder getObjectRetentionBu
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -38639,7 +38636,7 @@ public com.google.storage.v2.Bucket.ObjectRetentionOrBuilder getObjectRetentionO
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControl.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControl.java
index ad4d5e0414..78ba0b195e 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControl.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControl.java
@@ -203,7 +203,7 @@ public com.google.protobuf.ByteString getIdBytes() {
* `group-example@googlegroups.com`
* * All members of the Google Apps for Business domain `example.com` would be
* `domain-example.com`
- * For project entities, `project-{team}-{projectnumber}` format will be
+ * For project entities, `project-{team}-{projectnumber}` format is
* returned on response.
*
*
@@ -244,7 +244,7 @@ public java.lang.String getEntity() {
* `group-example@googlegroups.com`
* * All members of the Google Apps for Business domain `example.com` would be
* `domain-example.com`
- * For project entities, `project-{team}-{projectnumber}` format will be
+ * For project entities, `project-{team}-{projectnumber}` format is
* returned on response.
*
*
@@ -275,7 +275,7 @@ public com.google.protobuf.ByteString getEntityBytes() {
*
*
* Output only. The alternative entity format, if exists. For project
- * entities, `project-{team}-{projectid}` format will be returned on response.
+ * entities, `project-{team}-{projectid}` format is returned in the response.
*
*
* string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -300,7 +300,7 @@ public java.lang.String getEntityAlt() {
*
*
* Output only. The alternative entity format, if exists. For project
- * entities, `project-{team}-{projectid}` format will be returned on response.
+ * entities, `project-{team}-{projectid}` format is returned in the response.
*
*
* string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -382,10 +382,10 @@ public com.google.protobuf.ByteString getEntityIdBytes() {
*
*
*
- * Optional. The etag of the BucketAccessControl.
+ * Optional. The `etag` of the `BucketAccessControl`.
* If included in the metadata of an update or delete request message, the
- * operation operation will only be performed if the etag matches that of the
- * bucket's BucketAccessControl.
+ * operation operation is only performed if the etag matches that of the
+ * bucket's `BucketAccessControl`.
*
*
* string etag = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -409,10 +409,10 @@ public java.lang.String getEtag() {
*
*
*
- * Optional. The etag of the BucketAccessControl.
+ * Optional. The `etag` of the `BucketAccessControl`.
* If included in the metadata of an update or delete request message, the
- * operation operation will only be performed if the etag matches that of the
- * bucket's BucketAccessControl.
+ * operation operation is only performed if the etag matches that of the
+ * bucket's `BucketAccessControl`.
*
*
* string etag = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1395,7 +1395,7 @@ public Builder setIdBytes(com.google.protobuf.ByteString value) {
* `group-example@googlegroups.com`
* * All members of the Google Apps for Business domain `example.com` would be
* `domain-example.com`
- * For project entities, `project-{team}-{projectnumber}` format will be
+ * For project entities, `project-{team}-{projectnumber}` format is
* returned on response.
*
*
@@ -1435,7 +1435,7 @@ public java.lang.String getEntity() {
* `group-example@googlegroups.com`
* * All members of the Google Apps for Business domain `example.com` would be
* `domain-example.com`
- * For project entities, `project-{team}-{projectnumber}` format will be
+ * For project entities, `project-{team}-{projectnumber}` format is
* returned on response.
*
*
@@ -1475,7 +1475,7 @@ public com.google.protobuf.ByteString getEntityBytes() {
* `group-example@googlegroups.com`
* * All members of the Google Apps for Business domain `example.com` would be
* `domain-example.com`
- * For project entities, `project-{team}-{projectnumber}` format will be
+ * For project entities, `project-{team}-{projectnumber}` format is
* returned on response.
*
*
@@ -1514,7 +1514,7 @@ public Builder setEntity(java.lang.String value) {
* `group-example@googlegroups.com`
* * All members of the Google Apps for Business domain `example.com` would be
* `domain-example.com`
- * For project entities, `project-{team}-{projectnumber}` format will be
+ * For project entities, `project-{team}-{projectnumber}` format is
* returned on response.
*
*
@@ -1549,7 +1549,7 @@ public Builder clearEntity() {
* `group-example@googlegroups.com`
* * All members of the Google Apps for Business domain `example.com` would be
* `domain-example.com`
- * For project entities, `project-{team}-{projectnumber}` format will be
+ * For project entities, `project-{team}-{projectnumber}` format is
* returned on response.
*
*
@@ -1576,7 +1576,7 @@ public Builder setEntityBytes(com.google.protobuf.ByteString value) {
*
*
* Output only. The alternative entity format, if exists. For project
- * entities, `project-{team}-{projectid}` format will be returned on response.
+ * entities, `project-{team}-{projectid}` format is returned in the response.
*
*
* string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1600,7 +1600,7 @@ public java.lang.String getEntityAlt() {
*
*
* Output only. The alternative entity format, if exists. For project
- * entities, `project-{team}-{projectid}` format will be returned on response.
+ * entities, `project-{team}-{projectid}` format is returned in the response.
*
*
* string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1624,7 +1624,7 @@ public com.google.protobuf.ByteString getEntityAltBytes() {
*
*
* Output only. The alternative entity format, if exists. For project
- * entities, `project-{team}-{projectid}` format will be returned on response.
+ * entities, `project-{team}-{projectid}` format is returned in the response.
*
*
* string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1647,7 +1647,7 @@ public Builder setEntityAlt(java.lang.String value) {
*
*
* Output only. The alternative entity format, if exists. For project
- * entities, `project-{team}-{projectid}` format will be returned on response.
+ * entities, `project-{team}-{projectid}` format is returned in the response.
*
*
* string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1666,7 +1666,7 @@ public Builder clearEntityAlt() {
*
*
* Output only. The alternative entity format, if exists. For project
- * entities, `project-{team}-{projectid}` format will be returned on response.
+ * entities, `project-{team}-{projectid}` format is returned in the response.
*
*
* string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -1802,10 +1802,10 @@ public Builder setEntityIdBytes(com.google.protobuf.ByteString value) {
*
*
*
- * Optional. The etag of the BucketAccessControl.
+ * Optional. The `etag` of the `BucketAccessControl`.
* If included in the metadata of an update or delete request message, the
- * operation operation will only be performed if the etag matches that of the
- * bucket's BucketAccessControl.
+ * operation operation is only performed if the etag matches that of the
+ * bucket's `BucketAccessControl`.
*
*
* string etag = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1828,10 +1828,10 @@ public java.lang.String getEtag() {
*
*
*
- * Optional. The etag of the BucketAccessControl.
+ * Optional. The `etag` of the `BucketAccessControl`.
* If included in the metadata of an update or delete request message, the
- * operation operation will only be performed if the etag matches that of the
- * bucket's BucketAccessControl.
+ * operation operation is only performed if the etag matches that of the
+ * bucket's `BucketAccessControl`.
*
*
* string etag = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1854,10 +1854,10 @@ public com.google.protobuf.ByteString getEtagBytes() {
*
*
*
- * Optional. The etag of the BucketAccessControl.
+ * Optional. The `etag` of the `BucketAccessControl`.
* If included in the metadata of an update or delete request message, the
- * operation operation will only be performed if the etag matches that of the
- * bucket's BucketAccessControl.
+ * operation operation is only performed if the etag matches that of the
+ * bucket's `BucketAccessControl`.
*
*
* string etag = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1879,10 +1879,10 @@ public Builder setEtag(java.lang.String value) {
*
*
*
- * Optional. The etag of the BucketAccessControl.
+ * Optional. The `etag` of the `BucketAccessControl`.
* If included in the metadata of an update or delete request message, the
- * operation operation will only be performed if the etag matches that of the
- * bucket's BucketAccessControl.
+ * operation operation is only performed if the etag matches that of the
+ * bucket's `BucketAccessControl`.
*
*
* string etag = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -1900,10 +1900,10 @@ public Builder clearEtag() {
*
*
*
- * Optional. The etag of the BucketAccessControl.
+ * Optional. The `etag` of the `BucketAccessControl`.
* If included in the metadata of an update or delete request message, the
- * operation operation will only be performed if the etag matches that of the
- * bucket's BucketAccessControl.
+ * operation operation is only performed if the etag matches that of the
+ * bucket's `BucketAccessControl`.
*
*
* string etag = 8 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControlOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControlOrBuilder.java
index 85135aacec..43c897e583 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControlOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketAccessControlOrBuilder.java
@@ -96,7 +96,7 @@ public interface BucketAccessControlOrBuilder
* `group-example@googlegroups.com`
* * All members of the Google Apps for Business domain `example.com` would be
* `domain-example.com`
- * For project entities, `project-{team}-{projectnumber}` format will be
+ * For project entities, `project-{team}-{projectnumber}` format is
* returned on response.
*
*
@@ -126,7 +126,7 @@ public interface BucketAccessControlOrBuilder
* `group-example@googlegroups.com`
* * All members of the Google Apps for Business domain `example.com` would be
* `domain-example.com`
- * For project entities, `project-{team}-{projectnumber}` format will be
+ * For project entities, `project-{team}-{projectnumber}` format is
* returned on response.
*
*
@@ -141,7 +141,7 @@ public interface BucketAccessControlOrBuilder
*
*
* Output only. The alternative entity format, if exists. For project
- * entities, `project-{team}-{projectid}` format will be returned on response.
+ * entities, `project-{team}-{projectid}` format is returned in the response.
*
*
* string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -155,7 +155,7 @@ public interface BucketAccessControlOrBuilder
*
*
* Output only. The alternative entity format, if exists. For project
- * entities, `project-{team}-{projectid}` format will be returned on response.
+ * entities, `project-{team}-{projectid}` format is returned in the response.
*
*
* string entity_alt = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -194,10 +194,10 @@ public interface BucketAccessControlOrBuilder
*
*
*
- * Optional. The etag of the BucketAccessControl.
+ * Optional. The `etag` of the `BucketAccessControl`.
* If included in the metadata of an update or delete request message, the
- * operation operation will only be performed if the etag matches that of the
- * bucket's BucketAccessControl.
+ * operation operation is only performed if the etag matches that of the
+ * bucket's `BucketAccessControl`.
*
*
* string etag = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -210,10 +210,10 @@ public interface BucketAccessControlOrBuilder
*
*
*
- * Optional. The etag of the BucketAccessControl.
+ * Optional. The `etag` of the `BucketAccessControl`.
* If included in the metadata of an update or delete request message, the
- * operation operation will only be performed if the etag matches that of the
- * bucket's BucketAccessControl.
+ * operation operation is only performed if the etag matches that of the
+ * bucket's `BucketAccessControl`.
*
*
* string etag = 8 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketOrBuilder.java
index 9f5b931207..a3b2d5d013 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/BucketOrBuilder.java
@@ -58,7 +58,7 @@ public interface BucketOrBuilder
*
* Output only. The user-chosen part of the bucket name. The `{bucket}`
* portion of the `name` field. For globally unique buckets, this is equal to
- * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+ * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
*
*
* string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -73,7 +73,7 @@ public interface BucketOrBuilder
*
* Output only. The user-chosen part of the bucket name. The `{bucket}`
* portion of the `name` field. For globally unique buckets, this is equal to
- * the "bucket name" of other Cloud Storage APIs. Example: "pub".
+ * the `bucket name` of other Cloud Storage APIs. Example: `pub`.
*
*
* string bucket_id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
@@ -87,8 +87,8 @@ public interface BucketOrBuilder
*
*
* The etag of the bucket.
- * If included in the metadata of an UpdateBucketRequest, the operation will
- * only be performed if the etag matches that of the bucket.
+ * If included in the metadata of an `UpdateBucketRequest`, the operation is
+ * only performed if the `etag` matches that of the bucket.
*
*
* string etag = 29;
@@ -102,8 +102,8 @@ public interface BucketOrBuilder
*
*
* The etag of the bucket.
- * If included in the metadata of an UpdateBucketRequest, the operation will
- * only be performed if the etag matches that of the bucket.
+ * If included in the metadata of an `UpdateBucketRequest`, the operation is
+ * only performed if the `etag` matches that of the bucket.
*
*
* string etag = 29;
@@ -117,9 +117,9 @@ public interface BucketOrBuilder
*
*
* Immutable. The project which owns this bucket, in the format of
- * "projects/{projectIdentifier}".
- * {projectIdentifier} can be the project ID or project number.
- * Output values will always be in project number format.
+ * `projects/{projectIdentifier}`.
+ * `{projectIdentifier}` can be the project ID or project number.
+ * Output values are always in the project number format.
*
*
*
@@ -135,9 +135,9 @@ public interface BucketOrBuilder
*
*
* Immutable. The project which owns this bucket, in the format of
- * "projects/{projectIdentifier}".
- * {projectIdentifier} can be the project ID or project number.
- * Output values will always be in project number format.
+ * `projects/{projectIdentifier}`.
+ * `{projectIdentifier}` can be the project ID or project number.
+ * Output values are always in the project number format.
*
*
*
@@ -167,10 +167,8 @@ public interface BucketOrBuilder
*
* Immutable. The location of the bucket. Object data for objects in the
* bucket resides in physical storage within this region. Defaults to `US`.
- * See the
- * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
- * guide] for the authoritative list. Attempting to update this field after
- * the bucket is created will result in an error.
+ * Attempting to update this field after the bucket is created results in an
+ * error.
*
*
* string location = 5 [(.google.api.field_behavior) = IMMUTABLE];
@@ -185,10 +183,8 @@ public interface BucketOrBuilder
*
* Immutable. The location of the bucket. Object data for objects in the
* bucket resides in physical storage within this region. Defaults to `US`.
- * See the
- * [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
- * guide] for the authoritative list. Attempting to update this field after
- * the bucket is created will result in an error.
+ * Attempting to update this field after the bucket is created results in an
+ * error.
*
*
* string location = 5 [(.google.api.field_behavior) = IMMUTABLE];
@@ -232,9 +228,9 @@ public interface BucketOrBuilder
* Optional. The bucket's default storage class, used whenever no storageClass
* is specified for a newly-created object. This defines how objects in the
* bucket are stored and determines the SLA and the cost of storage.
- * If this value is not specified when the bucket is created, it will default
- * to `STANDARD`. For more information, see
- * https://developers.google.com/storage/docs/storage-classes.
+ * If this value is not specified when the bucket is created, it defaults
+ * to `STANDARD`. For more information, see [Storage
+ * classes](https://developers.google.com/storage/docs/storage-classes).
*
*
* string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -250,9 +246,9 @@ public interface BucketOrBuilder
* Optional. The bucket's default storage class, used whenever no storageClass
* is specified for a newly-created object. This defines how objects in the
* bucket are stored and determines the SLA and the cost of storage.
- * If this value is not specified when the bucket is created, it will default
- * to `STANDARD`. For more information, see
- * https://developers.google.com/storage/docs/storage-classes.
+ * If this value is not specified when the bucket is created, it defaults
+ * to `STANDARD`. For more information, see [Storage
+ * classes](https://developers.google.com/storage/docs/storage-classes).
*
*
* string storage_class = 7 [(.google.api.field_behavior) = OPTIONAL];
@@ -266,11 +262,11 @@ public interface BucketOrBuilder
*
*
* Optional. The recovery point objective for cross-region replication of the
- * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
- * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+ * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+ * default replication. `ASYNC_TURBO` enables turbo replication, valid for
* dual-region buckets only. If rpo is not specified when the bucket is
- * created, it defaults to "DEFAULT". For more information, see
- * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+ * created, it defaults to `DEFAULT`. For more information, see [Turbo
+ * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
*
*
* string rpo = 27 [(.google.api.field_behavior) = OPTIONAL];
@@ -284,11 +280,11 @@ public interface BucketOrBuilder
*
*
* Optional. The recovery point objective for cross-region replication of the
- * bucket. Applicable only for dual- and multi-region buckets. "DEFAULT" uses
- * default replication. "ASYNC_TURBO" enables turbo replication, valid for
+ * bucket. Applicable only for dual- and multi-region buckets. `DEFAULT` uses
+ * default replication. `ASYNC_TURBO` enables turbo replication, valid for
* dual-region buckets only. If rpo is not specified when the bucket is
- * created, it defaults to "DEFAULT". For more information, see
- * https://cloud.google.com/storage/docs/availability-durability#turbo-replication.
+ * created, it defaults to `DEFAULT`. For more information, see [Turbo
+ * replication](https://cloud.google.com/storage/docs/availability-durability#turbo-replication).
*
*
* string rpo = 27 [(.google.api.field_behavior) = OPTIONAL];
@@ -302,7 +298,7 @@ public interface BucketOrBuilder
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -317,7 +313,7 @@ public interface BucketOrBuilder
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -332,7 +328,7 @@ public interface BucketOrBuilder
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -347,7 +343,7 @@ public interface BucketOrBuilder
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -363,7 +359,7 @@ public interface BucketOrBuilder
*
*
* Optional. Access controls on the bucket.
- * If iam_config.uniform_bucket_level_access is enabled on this bucket,
+ * If `iam_config.uniform_bucket_level_access` is enabled on this bucket,
* requests to set, read, or modify acl is an error.
*
*
@@ -378,7 +374,7 @@ public interface BucketOrBuilder
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -393,7 +389,7 @@ public interface BucketOrBuilder
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -408,7 +404,7 @@ public interface BucketOrBuilder
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -423,7 +419,7 @@ public interface BucketOrBuilder
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -439,7 +435,7 @@ public interface BucketOrBuilder
*
*
* Optional. Default access controls to apply to new objects when no ACL is
- * provided. If iam_config.uniform_bucket_level_access is enabled on this
+ * provided. If `iam_config.uniform_bucket_level_access` is enabled on this
* bucket, requests to set, read, or modify acl is an error.
*
*
@@ -453,9 +449,9 @@ public interface BucketOrBuilder
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -470,9 +466,9 @@ public interface BucketOrBuilder
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -487,9 +483,9 @@ public interface BucketOrBuilder
*
*
*
- * Optional. The bucket's lifecycle config. See
- * [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
- * for more information.
+ * Optional. The bucket's lifecycle configuration. See [Lifecycle
+ * Management](https://developers.google.com/storage/docs/lifecycle) for more
+ * information.
*
*
*
@@ -542,8 +538,8 @@ public interface BucketOrBuilder
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -556,8 +552,8 @@ public interface BucketOrBuilder
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -570,8 +566,8 @@ public interface BucketOrBuilder
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -584,8 +580,8 @@ public interface BucketOrBuilder
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -598,8 +594,8 @@ public interface BucketOrBuilder
*
*
*
- * Optional. The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource
- * Sharing] (CORS) config.
+ * Optional. The bucket's [CORS](https://www.w3.org/TR/cors/)
+ * configuration.
*
*
*
@@ -655,11 +651,11 @@ public interface BucketOrBuilder
* Optional. The default value for event-based hold on newly created objects
* in this bucket. Event-based hold is a way to retain objects indefinitely
* until an event occurs, signified by the hold's release. After being
- * released, such objects will be subject to bucket-level retention (if any).
- * One sample use case of this flag is for banks to hold loan documents for at
+ * released, such objects are subject to bucket-level retention (if any). One
+ * sample use case of this flag is for banks to hold loan documents for at
* least 3 years after loan is paid in full. Here, bucket-level retention is 3
* years and the event is loan being paid in full. In this example, these
- * objects will be held intact for any number of years until the event has
+ * objects are held intact for any number of years until the event has
* occurred (event-based hold on the object is released) and then 3 more years
* after that. That means retention duration of the objects begins from the
* moment event-based hold transitioned from true to false. Objects under
@@ -741,9 +737,9 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
* .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL];
@@ -758,9 +754,9 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
* .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL];
@@ -775,9 +771,9 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's website config, controlling how the service behaves
- * when accessing bucket contents as a web site. See the
- * [https://cloud.google.com/storage/docs/static-website][Static Website
- * Examples] for more information.
+ * when accessing bucket contents as a web site. See the [Static website
+ * examples](https://cloud.google.com/storage/docs/static-website) for more
+ * information.
*
*
* .google.storage.v2.Bucket.Website website = 16 [(.google.api.field_behavior) = OPTIONAL];
@@ -789,7 +785,7 @@ java.lang.String getLabelsOrDefault(
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -804,7 +800,7 @@ java.lang.String getLabelsOrDefault(
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -819,7 +815,7 @@ java.lang.String getLabelsOrDefault(
*
*
*
- * Optional. The bucket's versioning config.
+ * Optional. The bucket's versioning configuration.
*
*
*
@@ -958,7 +954,7 @@ java.lang.String getLabelsOrDefault(
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
* .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL];
@@ -972,7 +968,7 @@ java.lang.String getLabelsOrDefault(
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
* .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL];
@@ -986,7 +982,7 @@ java.lang.String getLabelsOrDefault(
*
*
*
- * Optional. The bucket's billing config.
+ * Optional. The bucket's billing configuration.
*
*
* .google.storage.v2.Bucket.Billing billing = 21 [(.google.api.field_behavior) = OPTIONAL];
@@ -1001,12 +997,12 @@ java.lang.String getLabelsOrDefault(
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -1024,12 +1020,12 @@ java.lang.String getLabelsOrDefault(
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -1047,12 +1043,12 @@ java.lang.String getLabelsOrDefault(
* Optional. The bucket's retention policy. The retention policy enforces a
* minimum retention time for all objects contained in the bucket, based on
* their creation time. Any attempt to overwrite or delete objects younger
- * than the retention period will result in a PERMISSION_DENIED error. An
+ * than the retention period results in a `PERMISSION_DENIED` error. An
* unlocked retention policy can be modified or removed from the bucket via a
* storage.buckets.update operation. A locked retention policy cannot be
* removed or shortened in duration for the lifetime of the bucket.
- * Attempting to remove or decrease period of a locked retention policy will
- * result in a PERMISSION_DENIED error.
+ * Attempting to remove or decrease period of a locked retention policy
+ * results in a `PERMISSION_DENIED` error.
*
*
*
@@ -1065,7 +1061,7 @@ java.lang.String getLabelsOrDefault(
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -1080,7 +1076,7 @@ java.lang.String getLabelsOrDefault(
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -1095,7 +1091,7 @@ java.lang.String getLabelsOrDefault(
*
*
*
- * Optional. The bucket's IAM config.
+ * Optional. The bucket's IAM configuration.
*
*
*
@@ -1122,9 +1118,8 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -1140,9 +1135,8 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -1158,9 +1152,8 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. Configuration that, if present, specifies the data placement for
- * a
- * [https://cloud.google.com/storage/docs/locations#location-dr][configurable
- * dual-region].
+ * a [configurable
+ * dual-region](https://cloud.google.com/storage/docs/locations#location-dr).
*
*
*
@@ -1174,8 +1167,8 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -1191,8 +1184,8 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -1208,8 +1201,8 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's Autoclass configuration. If there is no
- * configuration, the Autoclass feature will be disabled and have no effect on
- * the bucket.
+ * configuration, the Autoclass feature is disabled and has no effect on the
+ * bucket.
*
*
*
@@ -1223,7 +1216,7 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -1240,7 +1233,7 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -1257,7 +1250,7 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's hierarchical namespace configuration. If there is no
- * configuration, the hierarchical namespace feature will be disabled and have
+ * configuration, the hierarchical namespace feature is disabled and has
* no effect on the bucket.
*
*
@@ -1318,7 +1311,7 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -1334,7 +1327,7 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
@@ -1350,7 +1343,7 @@ java.lang.String getLabelsOrDefault(
*
*
* Optional. The bucket's object retention configuration. Must be enabled
- * before objects in the bucket may have retention configured.
+ * before objects in the bucket might have retention configured.
*
*
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteRequest.java
index f04c659c3d..87068a617c 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteRequest.java
@@ -23,8 +23,8 @@
*
*
*
- * Message for canceling an in-progress resumable upload.
- * `upload_id` **must** be set.
+ * Request message for
+ * [CancelResumableWrite][google.storage.v2.Storage.CancelResumableWrite].
*
*
* Protobuf type {@code google.storage.v2.CancelResumableWriteRequest}
@@ -284,8 +284,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * Message for canceling an in-progress resumable upload.
- * `upload_id` **must** be set.
+ * Request message for
+ * [CancelResumableWrite][google.storage.v2.Storage.CancelResumableWrite].
*
*
* Protobuf type {@code google.storage.v2.CancelResumableWriteRequest}
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteResponse.java
index 152703df5f..46fcde480b 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteResponse.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CancelResumableWriteResponse.java
@@ -23,7 +23,7 @@
*
*
*
- * Empty response message for canceling an in-progress resumable upload, will be
+ * Empty response message for canceling an in-progress resumable upload, is
* extended as needed.
*
*
@@ -218,7 +218,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * Empty response message for canceling an in-progress resumable upload, will be
+ * Empty response message for canceling an in-progress resumable upload, is
* extended as needed.
*
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParams.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParams.java
index 80c644af5b..b48bb51c98 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParams.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParams.java
@@ -149,8 +149,8 @@ public com.google.protobuf.ByteString getEncryptionKeyBytes() {
*
*
*
- * Optional. SHA256 hash of encryption key used with the Customer-Supplied
- * Encryption Keys feature.
+ * Optional. SHA256 hash of encryption key used with the Customer-supplied
+ * encryption keys feature.
*
*
* bytes encryption_key_sha256_bytes = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -734,8 +734,8 @@ public Builder clearEncryptionKeyBytes() {
*
*
*
- * Optional. SHA256 hash of encryption key used with the Customer-Supplied
- * Encryption Keys feature.
+ * Optional. SHA256 hash of encryption key used with the Customer-supplied
+ * encryption keys feature.
*
*
* bytes encryption_key_sha256_bytes = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -751,8 +751,8 @@ public com.google.protobuf.ByteString getEncryptionKeySha256Bytes() {
*
*
*
- * Optional. SHA256 hash of encryption key used with the Customer-Supplied
- * Encryption Keys feature.
+ * Optional. SHA256 hash of encryption key used with the Customer-supplied
+ * encryption keys feature.
*
*
* bytes encryption_key_sha256_bytes = 5 [(.google.api.field_behavior) = OPTIONAL];
@@ -774,8 +774,8 @@ public Builder setEncryptionKeySha256Bytes(com.google.protobuf.ByteString value)
*
*
*
- * Optional. SHA256 hash of encryption key used with the Customer-Supplied
- * Encryption Keys feature.
+ * Optional. SHA256 hash of encryption key used with the Customer-supplied
+ * encryption keys feature.
*
*
* bytes encryption_key_sha256_bytes = 5 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParamsOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParamsOrBuilder.java
index f329aea4fc..4119c7784e 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParamsOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CommonObjectRequestParamsOrBuilder.java
@@ -70,8 +70,8 @@ public interface CommonObjectRequestParamsOrBuilder
*
*
*
- * Optional. SHA256 hash of encryption key used with the Customer-Supplied
- * Encryption Keys feature.
+ * Optional. SHA256 hash of encryption key used with the Customer-supplied
+ * encryption keys feature.
*
*
* bytes encryption_key_sha256_bytes = 5 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequest.java
index f242141cdc..0994d8309c 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequest.java
@@ -23,7 +23,7 @@
*
*
*
- * Request message for ComposeObject.
+ * Request message for [ComposeObject][google.storage.v2.Storage.ComposeObject].
*
*
* Protobuf type {@code google.storage.v2.ComposeObjectRequest}
@@ -214,7 +214,7 @@ public interface ObjectPreconditionsOrBuilder
*
* Only perform the composition if the generation of the source object
* that would be used matches this value. If this value and a generation
- * are both specified, they must be the same value or the call will fail.
+ * are both specified, they must be the same value or the call fails.
*
*
* optional int64 if_generation_match = 1;
@@ -229,7 +229,7 @@ public interface ObjectPreconditionsOrBuilder
*
* Only perform the composition if the generation of the source object
* that would be used matches this value. If this value and a generation
- * are both specified, they must be the same value or the call will fail.
+ * are both specified, they must be the same value or the call fails.
*
*
* optional int64 if_generation_match = 1;
@@ -293,7 +293,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
* Only perform the composition if the generation of the source object
* that would be used matches this value. If this value and a generation
- * are both specified, they must be the same value or the call will fail.
+ * are both specified, they must be the same value or the call fails.
*
*
* optional int64 if_generation_match = 1;
@@ -311,7 +311,7 @@ public boolean hasIfGenerationMatch() {
*
* Only perform the composition if the generation of the source object
* that would be used matches this value. If this value and a generation
- * are both specified, they must be the same value or the call will fail.
+ * are both specified, they must be the same value or the call fails.
*
*
* optional int64 if_generation_match = 1;
@@ -709,7 +709,7 @@ public Builder mergeFrom(
*
* Only perform the composition if the generation of the source object
* that would be used matches this value. If this value and a generation
- * are both specified, they must be the same value or the call will fail.
+ * are both specified, they must be the same value or the call fails.
*
*
* optional int64 if_generation_match = 1;
@@ -727,7 +727,7 @@ public boolean hasIfGenerationMatch() {
*
* Only perform the composition if the generation of the source object
* that would be used matches this value. If this value and a generation
- * are both specified, they must be the same value or the call will fail.
+ * are both specified, they must be the same value or the call fails.
*
*
* optional int64 if_generation_match = 1;
@@ -745,7 +745,7 @@ public long getIfGenerationMatch() {
*
* Only perform the composition if the generation of the source object
* that would be used matches this value. If this value and a generation
- * are both specified, they must be the same value or the call will fail.
+ * are both specified, they must be the same value or the call fails.
*
*
* optional int64 if_generation_match = 1;
@@ -767,7 +767,7 @@ public Builder setIfGenerationMatch(long value) {
*
* Only perform the composition if the generation of the source object
* that would be used matches this value. If this value and a generation
- * are both specified, they must be the same value or the call will fail.
+ * are both specified, they must be the same value or the call fails.
*
*
* optional int64 if_generation_match = 1;
@@ -1931,8 +1931,8 @@ public com.google.storage.v2.ObjectOrBuilder getDestinationOrBuilder() {
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -1949,8 +1949,8 @@ public com.google.storage.v2.ObjectOrBuilder getDestinationOrBuilder() {
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -1967,8 +1967,8 @@ public com.google.storage.v2.ObjectOrBuilder getDestinationOrBuilder() {
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -1984,8 +1984,8 @@ public int getSourceObjectsCount() {
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -2001,8 +2001,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject getSourceObjects(
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -2025,8 +2025,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourc
*
*
* Optional. Apply a predefined set of access controls to the destination
- * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
- * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+ * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+ * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
*
*
* string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -2051,8 +2051,8 @@ public java.lang.String getDestinationPredefinedAcl() {
*
*
* Optional. Apply a predefined set of access controls to the destination
- * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
- * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+ * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+ * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
*
*
* string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -2159,7 +2159,7 @@ public long getIfMetagenerationMatch() {
*
* Optional. Resource name of the Cloud KMS key, of the form
* `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
- * that will be used to encrypt the object. Overrides the object
+ * that is used to encrypt the object. Overrides the object
* metadata's `kms_key_name` value, if any.
*
*
@@ -2188,7 +2188,7 @@ public java.lang.String getKmsKey() {
*
* Optional. Resource name of the Cloud KMS key, of the form
* `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
- * that will be used to encrypt the object. Overrides the object
+ * that is used to encrypt the object. Overrides the object
* metadata's `kms_key_name` value, if any.
*
*
@@ -2281,8 +2281,8 @@ public com.google.storage.v2.CommonObjectRequestParams getCommonObjectRequestPar
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -2300,8 +2300,8 @@ public boolean hasObjectChecksums() {
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -2321,8 +2321,8 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() {
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -2594,7 +2594,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * Request message for ComposeObject.
+ * Request message for [ComposeObject][google.storage.v2.Storage.ComposeObject].
*
*
* Protobuf type {@code google.storage.v2.ComposeObjectRequest}
@@ -3175,8 +3175,8 @@ private void ensureSourceObjectsIsMutable() {
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3196,8 +3196,8 @@ private void ensureSourceObjectsIsMutable() {
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3216,8 +3216,8 @@ public int getSourceObjectsCount() {
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3236,8 +3236,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject getSourceObjects(
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3263,8 +3263,8 @@ public Builder setSourceObjects(
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3288,8 +3288,8 @@ public Builder setSourceObjects(
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3314,8 +3314,8 @@ public Builder addSourceObjects(com.google.storage.v2.ComposeObjectRequest.Sourc
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3341,8 +3341,8 @@ public Builder addSourceObjects(
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3365,8 +3365,8 @@ public Builder addSourceObjects(
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3390,8 +3390,8 @@ public Builder addSourceObjects(
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3415,8 +3415,8 @@ public Builder addAllSourceObjects(
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3438,8 +3438,8 @@ public Builder clearSourceObjects() {
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3461,8 +3461,8 @@ public Builder removeSourceObjects(int index) {
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3478,8 +3478,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder getSource
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3499,8 +3499,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder getSource
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3521,8 +3521,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder getSource
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3539,8 +3539,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder getSource
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3558,8 +3558,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder addSource
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -3598,8 +3598,8 @@ public com.google.storage.v2.ComposeObjectRequest.SourceObject.Builder addSource
*
*
* Optional. Apply a predefined set of access controls to the destination
- * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
- * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+ * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+ * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
*
*
* string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -3623,8 +3623,8 @@ public java.lang.String getDestinationPredefinedAcl() {
*
*
* Optional. Apply a predefined set of access controls to the destination
- * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
- * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+ * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+ * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
*
*
* string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -3648,8 +3648,8 @@ public com.google.protobuf.ByteString getDestinationPredefinedAclBytes() {
*
*
* Optional. Apply a predefined set of access controls to the destination
- * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
- * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+ * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+ * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
*
*
* string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -3672,8 +3672,8 @@ public Builder setDestinationPredefinedAcl(java.lang.String value) {
*
*
* Optional. Apply a predefined set of access controls to the destination
- * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
- * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+ * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+ * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
*
*
* string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -3692,8 +3692,8 @@ public Builder clearDestinationPredefinedAcl() {
*
*
* Optional. Apply a predefined set of access controls to the destination
- * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
- * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+ * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+ * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
*
*
* string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -3876,7 +3876,7 @@ public Builder clearIfMetagenerationMatch() {
*
* Optional. Resource name of the Cloud KMS key, of the form
* `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
- * that will be used to encrypt the object. Overrides the object
+ * that is used to encrypt the object. Overrides the object
* metadata's `kms_key_name` value, if any.
*
*
@@ -3904,7 +3904,7 @@ public java.lang.String getKmsKey() {
*
* Optional. Resource name of the Cloud KMS key, of the form
* `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
- * that will be used to encrypt the object. Overrides the object
+ * that is used to encrypt the object. Overrides the object
* metadata's `kms_key_name` value, if any.
*
*
@@ -3932,7 +3932,7 @@ public com.google.protobuf.ByteString getKmsKeyBytes() {
*
* Optional. Resource name of the Cloud KMS key, of the form
* `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
- * that will be used to encrypt the object. Overrides the object
+ * that is used to encrypt the object. Overrides the object
* metadata's `kms_key_name` value, if any.
*
*
@@ -3959,7 +3959,7 @@ public Builder setKmsKey(java.lang.String value) {
*
* Optional. Resource name of the Cloud KMS key, of the form
* `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
- * that will be used to encrypt the object. Overrides the object
+ * that is used to encrypt the object. Overrides the object
* metadata's `kms_key_name` value, if any.
*
*
@@ -3982,7 +3982,7 @@ public Builder clearKmsKey() {
*
* Optional. Resource name of the Cloud KMS key, of the form
* `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
- * that will be used to encrypt the object. Overrides the object
+ * that is used to encrypt the object. Overrides the object
* metadata's `kms_key_name` value, if any.
*
*
@@ -4242,8 +4242,8 @@ public Builder clearCommonObjectRequestParams() {
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -4260,8 +4260,8 @@ public boolean hasObjectChecksums() {
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -4284,8 +4284,8 @@ public com.google.storage.v2.ObjectChecksums getObjectChecksums() {
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -4310,8 +4310,8 @@ public Builder setObjectChecksums(com.google.storage.v2.ObjectChecksums value) {
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -4334,8 +4334,8 @@ public Builder setObjectChecksums(
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -4365,8 +4365,8 @@ public Builder mergeObjectChecksums(com.google.storage.v2.ObjectChecksums value)
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -4388,8 +4388,8 @@ public Builder clearObjectChecksums() {
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -4406,8 +4406,8 @@ public com.google.storage.v2.ObjectChecksums.Builder getObjectChecksumsBuilder()
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -4428,8 +4428,8 @@ public com.google.storage.v2.ObjectChecksumsOrBuilder getObjectChecksumsOrBuilde
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequestOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequestOrBuilder.java
index 4063d0640b..5eabc026c4 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequestOrBuilder.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ComposeObjectRequestOrBuilder.java
@@ -68,8 +68,8 @@ public interface ComposeObjectRequestOrBuilder
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -82,8 +82,8 @@ public interface ComposeObjectRequestOrBuilder
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -96,8 +96,8 @@ public interface ComposeObjectRequestOrBuilder
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -110,8 +110,8 @@ public interface ComposeObjectRequestOrBuilder
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -125,8 +125,8 @@ public interface ComposeObjectRequestOrBuilder
*
*
*
- * Optional. The list of source objects that will be concatenated into a
- * single object.
+ * Optional. The list of source objects that is concatenated into a single
+ * object.
*
*
*
@@ -141,8 +141,8 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject
*
*
* Optional. Apply a predefined set of access controls to the destination
- * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
- * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+ * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+ * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
*
*
* string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -156,8 +156,8 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject
*
*
* Optional. Apply a predefined set of access controls to the destination
- * object. Valid values are "authenticatedRead", "bucketOwnerFullControl",
- * "bucketOwnerRead", "private", "projectPrivate", or "publicRead".
+ * object. Valid values are `authenticatedRead`, `bucketOwnerFullControl`,
+ * `bucketOwnerRead`, `private`, `projectPrivate`, or `publicRead`.
*
*
* string destination_predefined_acl = 9 [(.google.api.field_behavior) = OPTIONAL];
@@ -230,7 +230,7 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject
*
* Optional. Resource name of the Cloud KMS key, of the form
* `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
- * that will be used to encrypt the object. Overrides the object
+ * that is used to encrypt the object. Overrides the object
* metadata's `kms_key_name` value, if any.
*
*
@@ -248,7 +248,7 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject
*
* Optional. Resource name of the Cloud KMS key, of the form
* `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
- * that will be used to encrypt the object. Overrides the object
+ * that is used to encrypt the object. Overrides the object
* metadata's `kms_key_name` value, if any.
*
*
@@ -310,8 +310,8 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -326,8 +326,8 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
@@ -342,8 +342,8 @@ com.google.storage.v2.ComposeObjectRequest.SourceObjectOrBuilder getSourceObject
*
*
*
- * Optional. The checksums of the complete object. This will be validated
- * against the combined checksums of the component objects.
+ * Optional. The checksums of the complete object. This is validated against
+ * the combined checksums of the component objects.
*
*
*
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequest.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequest.java
index 68ab235b1b..256de39c83 100644
--- a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequest.java
+++ b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/CreateBucketRequest.java
@@ -23,7 +23,7 @@
*
*
*
- * Request message for CreateBucket.
+ * Request message for [CreateBucket][google.storage.v2.Storage.CreateBucket].
*
*
* Protobuf type {@code google.storage.v2.CreateBucketRequest}
@@ -77,9 +77,9 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
- * Required. The project to which this bucket will belong. This field must
- * either be empty or `projects/_`. The project ID that owns this bucket
- * should be specified in the `bucket.project` field.
+ * Required. The project to which this bucket belongs. This field must either
+ * be empty or `projects/_`. The project ID that owns this bucket should be
+ * specified in the `bucket.project` field.
*
*
*
@@ -105,9 +105,9 @@ public java.lang.String getParent() {
*
*
*
- * Required. The project to which this bucket will belong. This field must
- * either be empty or `projects/_`. The project ID that owns this bucket
- * should be specified in the `bucket.project` field.
+ * Required. The project to which this bucket belongs. This field must either
+ * be empty or `projects/_`. The project ID that owns this bucket should be
+ * specified in the `bucket.project` field.
*
*
*
@@ -138,7 +138,7 @@ public com.google.protobuf.ByteString getParentBytes() {
*
* Optional. Properties of the new bucket being inserted.
* The name of the bucket is specified in the `bucket_id` field. Populating
- * `bucket.name` field will result in an error.
+ * `bucket.name` field results in an error.
* The project of the bucket must be specified in the `bucket.project` field.
* This field must be in `projects/{projectIdentifier}` format,
* {projectIdentifier} can be the project ID or project number. The `parent`
@@ -160,7 +160,7 @@ public boolean hasBucket() {
*
* Optional. Properties of the new bucket being inserted.
* The name of the bucket is specified in the `bucket_id` field. Populating
- * `bucket.name` field will result in an error.
+ * `bucket.name` field results in an error.
* The project of the bucket must be specified in the `bucket.project` field.
* This field must be in `projects/{projectIdentifier}` format,
* {projectIdentifier} can be the project ID or project number. The `parent`
@@ -182,7 +182,7 @@ public com.google.storage.v2.Bucket getBucket() {
*
* Optional. Properties of the new bucket being inserted.
* The name of the bucket is specified in the `bucket_id` field. Populating
- * `bucket.name` field will result in an error.
+ * `bucket.name` field results in an error.
* The project of the bucket must be specified in the `bucket.project` field.
* This field must be in `projects/{projectIdentifier}` format,
* {projectIdentifier} can be the project ID or project number. The `parent`
@@ -205,9 +205,9 @@ public com.google.storage.v2.BucketOrBuilder getBucketOrBuilder() {
*
*
*