docs: Updated ChecksummedData message definition to specify ctype=CORD, and removed incorrect earlier attempt that set that annotation in the ReadObjectResponse message definition (#1959)

gcf-owl-bot[bot] · web-flow · commit 3d97bddc668d · 2023-03-30T10:49:04.000-04:00
* docs: Updated ChecksummedData message definition to specify ctype=CORD, and removed incorrect earlier attempt that set that annotation in the ReadObjectResponse message definition docs: Clarified behavior of resumable upload cancellation PiperOrigin-RevId: 520467605 Source-Link: googleapis/googleapis@ae0254f Source-Link: https://github.com/googleapis/googleapis-gen/commit/9b05c311fb9086850234522ef6b5775490a87807 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiOWIwNWMzMTFmYjkwODY4NTAyMzQ1MjJlZjZiNTc3NTQ5MGE4NzgwNyJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
diff --git a/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageClient.java b/gapic-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageClient.java
@@ -2200,6 +2200,11 @@ public final UnaryCallable<DeleteObjectRequest, Empty> deleteObjectCallable() {
   /**
    * Cancels an in-progress resumable upload.
    *
+   * <p>Any attempts to write to the resumable upload after cancelling the upload will fail.
+   *
+   * <p>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.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -2228,6 +2233,11 @@ public final CancelResumableWriteResponse cancelResumableWrite(String uploadId)
   /**
    * Cancels an in-progress resumable upload.
    *
+   * <p>Any attempts to write to the resumable upload after cancelling the upload will fail.
+   *
+   * <p>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.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -2255,6 +2265,11 @@ public final CancelResumableWriteResponse cancelResumableWrite(
   /**
    * Cancels an in-progress resumable upload.
    *
+   * <p>Any attempts to write to the resumable upload after cancelling the upload will fail.
+   *
+   * <p>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.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
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
@@ -1613,6 +1613,11 @@ default void deleteObject(
      *
      * <pre>
      * 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.
      * </pre>
      */
     default void cancelResumableWrite(
@@ -2209,6 +2214,11 @@ public void deleteObject(
      *
      * <pre>
      * 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.
      * </pre>
      */
     public void cancelResumableWrite(
@@ -2751,6 +2761,11 @@ public com.google.protobuf.Empty deleteObject(
      *
      * <pre>
      * 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.
      * </pre>
      */
     public com.google.storage.v2.CancelResumableWriteResponse cancelResumableWrite(
@@ -3200,6 +3215,11 @@ protected StorageFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * <pre>
      * 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.
      * </pre>
      */
     public com.google.common.util.concurrent.ListenableFuture<
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ChecksummedData.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ChecksummedData.java
@@ -78,7 +78,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * The data.
    * </pre>
    *
-   * <code>bytes content = 1;</code>
+   * <code>bytes content = 1 [ctype = CORD];</code>
    *
    * @return The content.
    */
@@ -496,7 +496,7 @@ public Builder mergeFrom(
      * The data.
      * </pre>
      *
-     * <code>bytes content = 1;</code>
+     * <code>bytes content = 1 [ctype = CORD];</code>
      *
      * @return The content.
      */
@@ -511,7 +511,7 @@ public com.google.protobuf.ByteString getContent() {
      * The data.
      * </pre>
      *
-     * <code>bytes content = 1;</code>
+     * <code>bytes content = 1 [ctype = CORD];</code>
      *
      * @param value The content to set.
      * @return This builder for chaining.
@@ -532,7 +532,7 @@ public Builder setContent(com.google.protobuf.ByteString value) {
      * The data.
      * </pre>
      *
-     * <code>bytes content = 1;</code>
+     * <code>bytes content = 1 [ctype = CORD];</code>
      *
      * @return This builder for chaining.
      */
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ChecksummedDataOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ChecksummedDataOrBuilder.java
@@ -30,7 +30,7 @@ public interface ChecksummedDataOrBuilder
    * The data.
    * </pre>
    *
-   * <code>bytes content = 1;</code>
+   * <code>bytes content = 1 [ctype = CORD];</code>
    *
    * @return The content.
    */
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponse.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponse.java
@@ -77,7 +77,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * generate more data.
    * </pre>
    *
-   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
    *
    * @return Whether the checksummedData field is set.
    */
@@ -95,7 +95,7 @@ public boolean hasChecksummedData() {
    * generate more data.
    * </pre>
    *
-   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
    *
    * @return The checksummedData.
    */
@@ -115,7 +115,7 @@ public com.google.storage.v2.ChecksummedData getChecksummedData() {
    * generate more data.
    * </pre>
    *
-   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
    */
   @java.lang.Override
   public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilder() {
@@ -744,7 +744,7 @@ public Builder mergeFrom(
      * generate more data.
      * </pre>
      *
-     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
      *
      * @return Whether the checksummedData field is set.
      */
@@ -761,7 +761,7 @@ public boolean hasChecksummedData() {
      * generate more data.
      * </pre>
      *
-     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
      *
      * @return The checksummedData.
      */
@@ -784,7 +784,7 @@ public com.google.storage.v2.ChecksummedData getChecksummedData() {
      * generate more data.
      * </pre>
      *
-     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
      */
     public Builder setChecksummedData(com.google.storage.v2.ChecksummedData value) {
       if (checksummedDataBuilder_ == null) {
@@ -809,7 +809,7 @@ public Builder setChecksummedData(com.google.storage.v2.ChecksummedData value) {
      * generate more data.
      * </pre>
      *
-     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
      */
     public Builder setChecksummedData(
         com.google.storage.v2.ChecksummedData.Builder builderForValue) {
@@ -832,7 +832,7 @@ public Builder setChecksummedData(
      * generate more data.
      * </pre>
      *
-     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
      */
     public Builder mergeChecksummedData(com.google.storage.v2.ChecksummedData value) {
       if (checksummedDataBuilder_ == null) {
@@ -860,7 +860,7 @@ public Builder mergeChecksummedData(com.google.storage.v2.ChecksummedData value)
      * generate more data.
      * </pre>
      *
-     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
      */
     public Builder clearChecksummedData() {
       bitField0_ = (bitField0_ & ~0x00000001);
@@ -882,7 +882,7 @@ public Builder clearChecksummedData() {
      * generate more data.
      * </pre>
      *
-     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
      */
     public com.google.storage.v2.ChecksummedData.Builder getChecksummedDataBuilder() {
       bitField0_ |= 0x00000001;
@@ -899,7 +899,7 @@ public com.google.storage.v2.ChecksummedData.Builder getChecksummedDataBuilder()
      * generate more data.
      * </pre>
      *
-     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
      */
     public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilder() {
       if (checksummedDataBuilder_ != null) {
@@ -920,7 +920,7 @@ public com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilde
      * generate more data.
      * </pre>
      *
-     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+     * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.storage.v2.ChecksummedData,
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponseOrBuilder.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/ReadObjectResponseOrBuilder.java
@@ -33,7 +33,7 @@ public interface ReadObjectResponseOrBuilder
    * generate more data.
    * </pre>
    *
-   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
    *
    * @return Whether the checksummedData field is set.
    */
@@ -48,7 +48,7 @@ public interface ReadObjectResponseOrBuilder
    * generate more data.
    * </pre>
    *
-   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
    *
    * @return The checksummedData.
    */
@@ -63,7 +63,7 @@ public interface ReadObjectResponseOrBuilder
    * generate more data.
    * </pre>
    *
-   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1 [ctype = CORD];</code>
+   * <code>.google.storage.v2.ChecksummedData checksummed_data = 1;</code>
    */
   com.google.storage.v2.ChecksummedDataOrBuilder getChecksummedDataOrBuilder();
 
diff --git a/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageProto.java b/proto-google-cloud-storage-v2/src/main/java/com/google/storage/v2/StorageProto.java
diff --git a/proto-google-cloud-storage-v2/src/main/proto/google/storage/v2/storage.proto b/proto-google-cloud-storage-v2/src/main/proto/google/storage/v2/storage.proto
