Skip to content

Commit c39ec13

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
authored
docs: Add documentation about quantum write alignment, use of ObjectChecksums, Bucket.name format, and Object.delete_time (#2032)
* feat: Add ctype=CORD for ChecksummedData.content docs: Add documentation about quantum write alignment, use of ObjectChecksums, Bucket.name format, and Object.delete_time PiperOrigin-RevId: 534116186 Source-Link: googleapis/googleapis@117be9d Source-Link: https://github.com/googleapis/googleapis-gen/commit/8b2ea9267295839c03b6b129a8f9d9c48d59861c Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiOGIyZWE5MjY3Mjk1ODM5YzAzYjZiMTI5YThmOWQ5YzQ4ZDU5ODYxYyJ9 chore: upgrading Protobuf to 23.1 and gRPC to 1.55.0 in code generation PiperOrigin-RevId: 534084593 Source-Link: googleapis/googleapis@aa4559a Source-Link: https://github.com/googleapis/googleapis-gen/commit/370325af8236732f5885f5940e0ef481fee83003 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMzcwMzI1YWY4MjM2NzMyZjU4ODVmNTk0MGUwZWY0ODFmZWU4MzAwMyJ9 * docs: clarified the behavior of supplying bucket.name field in CreateBucket to reflect actual implementation PiperOrigin-RevId: 535720951 Source-Link: googleapis/googleapis@e54ab8c Source-Link: https://github.com/googleapis/googleapis-gen/commit/47a36bde3a4594178d93cceb5df2c00e3494be82 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNDdhMzZiZGUzYTQ1OTQxNzhkOTNjY2ViNWRmMmMwMGUzNDk0YmU4MiJ9 * chore: upgrading protobuf to 23.2 for code generation PiperOrigin-RevId: 537035741 Source-Link: googleapis/googleapis@640f743 Source-Link: https://github.com/googleapis/googleapis-gen/commit/5ec02ed2022878f99c94c763060ff6a018896b6e Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNWVjMDJlZDIwMjI4NzhmOTljOTRjNzYzMDYwZmY2YTAxODg5NmI2ZSJ9 * chore: upgrading protobuf to 23.2 for code generation --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent ee1ea32 commit c39ec13

71 files changed

Lines changed: 988 additions & 1193 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageClient.java‎

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -426,10 +426,10 @@ public final UnaryCallable<GetBucketRequest, Bucket> getBucketCallable() {
426426
*
427427
* @param parent Required. The project to which this bucket will belong.
428428
* @param bucket Properties of the new bucket being inserted. The name of the bucket is specified
429-
* in the `bucket_id` field. Populating `bucket.name` field will result in an error. The
430-
* project of the bucket must be specified in the `bucket.project` field. This field must be
431-
* in `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or
432-
* project number. The `parent` field must be either empty or `projects/_`.
429+
* in the `bucket_id` field. Populating `bucket.name` field will be ignored. The project of
430+
* the bucket must be specified in the `bucket.project` field. This field must be in
431+
* `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or project
432+
* number. The `parent` field must be either empty or `projects/_`.
433433
* @param bucketId Required. The ID to use for this bucket, which will become the final component
434434
* of the bucket's resource name. For example, the value `foo` might result in a bucket with
435435
* the name `projects/123456/buckets/foo`.
@@ -467,10 +467,10 @@ public final Bucket createBucket(ProjectName parent, Bucket bucket, String bucke
467467
*
468468
* @param parent Required. The project to which this bucket will belong.
469469
* @param bucket Properties of the new bucket being inserted. The name of the bucket is specified
470-
* in the `bucket_id` field. Populating `bucket.name` field will result in an error. The
471-
* project of the bucket must be specified in the `bucket.project` field. This field must be
472-
* in `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or
473-
* project number. The `parent` field must be either empty or `projects/_`.
470+
* in the `bucket_id` field. Populating `bucket.name` field will be ignored. The project of
471+
* the bucket must be specified in the `bucket.project` field. This field must be in
472+
* `projects/{projectIdentifier}` format, {projectIdentifier} can be the project ID or project
473+
* number. The `parent` field must be either empty or `projects/_`.
474474
* @param bucketId Required. The ID to use for this bucket, which will become the final component
475475
* of the bucket's resource name. For example, the value `foo` might result in a bucket with
476476
* the name `projects/123456/buckets/foo`.
@@ -2674,7 +2674,9 @@ public final UnaryCallable<UpdateObjectRequest, Object> updateObjectCallable() {
26742674
* were already persisted (without checking that it matches the previously written data), and
26752675
* write only the data starting from the persisted offset. Even though the data isn't written, it
26762676
* may still incur a performance cost over resuming at the correct write offset. This behavior can
2677-
* make client-side handling simpler in some cases.
2677+
* make client-side handling simpler in some cases. - Clients must only send data that is a
2678+
* multiple of 256 KiB per message, unless the object is being finished with `finish_write` set to
2679+
* `true`.
26782680
*
26792681
* <p>The service will not view the object as complete until the client has sent a
26802682
* `WriteObjectRequest` with `finish_write` set to `true`. Sending any requests on a stream after

‎grpc-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageGrpc.java‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1713,6 +1713,8 @@ default void updateObject(
17131713
* persisted offset. Even though the data isn't written, it may still
17141714
* incur a performance cost over resuming at the correct write offset.
17151715
* This behavior can make client-side handling simpler in some cases.
1716+
* - Clients must only send data that is a multiple of 256 KiB per message,
1717+
* unless the object is being finished with `finish_write` set to `true`.
17161718
* The service will not view the object as complete until the client has
17171719
* sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any
17181720
* requests on a stream after sending a request with `finish_write` set to
@@ -2320,6 +2322,8 @@ public void updateObject(
23202322
* persisted offset. Even though the data isn't written, it may still
23212323
* incur a performance cost over resuming at the correct write offset.
23222324
* This behavior can make client-side handling simpler in some cases.
2325+
* - Clients must only send data that is a multiple of 256 KiB per message,
2326+
* unless the object is being finished with `finish_write` set to `true`.
23232327
* The service will not view the object as complete until the client has
23242328
* sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any
23252329
* requests on a stream after sending a request with `finish_write` set to

0 commit comments

Comments
 (0)