feat: deprecating daos_version field

google-cloud-parallelstore-v1/.owlbot-manifest.json

@@ -42,6 +42,7 @@
     "proto_docs/google/protobuf/empty.rb",
     "proto_docs/google/protobuf/field_mask.rb",
     "proto_docs/google/protobuf/timestamp.rb",
+    "proto_docs/google/rpc/code.rb",
     "proto_docs/google/rpc/status.rb",
     "snippets/Gemfile",
     "snippets/parallelstore/create_instance.rb",

google-cloud-parallelstore-v1/proto_docs/google/cloud/parallelstore/v1/parallelstore.rb

@@ -50,7 +50,9 @@ module V1
         #     Allowed values are between 12000 and 100000, in multiples of 4000; e.g.,
         #     12000, 16000, 20000, ...
         # @!attribute [r] daos_version
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::String]
+        #     Deprecated 'daos_version' field.
         #     Output only. The version of DAOS software running in the instance.
         # @!attribute [r] access_points
         #   @return [::Array<::String>]
@@ -73,7 +75,7 @@ module V1
         #     the value currently used by the service.
         # @!attribute [rw] file_stripe_level
         #   @return [::Google::Cloud::Parallelstore::V1::FileStripeLevel]
-        #     Optional. Stripe level for files. Allowed values are:
+        #     Optional. Immutable. Stripe level for files. Allowed values are:
         #
         #     * `FILE_STRIPE_LEVEL_MIN`: offers the best performance for small size
         #       files.
@@ -82,14 +84,21 @@ module V1
         #     * `FILE_STRIPE_LEVEL_MAX`: higher throughput performance for larger files.
         # @!attribute [rw] directory_stripe_level
         #   @return [::Google::Cloud::Parallelstore::V1::DirectoryStripeLevel]
-        #     Optional. Stripe level for directories. Allowed values are:
+        #     Optional. Immutable. Stripe level for directories. Allowed values are:
         #
         #     * `DIRECTORY_STRIPE_LEVEL_MIN`: recommended when directories contain a
         #       small number of files.
         #     * `DIRECTORY_STRIPE_LEVEL_BALANCED`: balances performance for workloads
         #       involving a mix of small and large directories.
         #     * `DIRECTORY_STRIPE_LEVEL_MAX`: recommended for directories with a large
         #       number of files.
+        # @!attribute [rw] deployment_type
+        #   @return [::Google::Cloud::Parallelstore::V1::DeploymentType]
+        #     Optional. Immutable. The deployment type of the instance. Allowed values
+        #     are:
+        #
+        #     * `SCRATCH`: the instance is a scratch instance.
+        #     * `PERSISTENT`: the instance is a persistent instance.
         class Instance
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -122,6 +131,10 @@ module State
 
             # The instance is being upgraded.
             UPGRADING = 5
+
+            # The instance is being repaired. This should only be used by instances
+            # using the `PERSISTENT` deployment type.
+            REPAIRING = 6
           end
         end
 
@@ -433,6 +446,35 @@ class ImportDataResponse
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # An entry describing an error that has occurred.
+        # @!attribute [rw] uri
+        #   @return [::String]
+        #     A URL that refers to the target (a data source, a data sink,
+        #     or an object) with which the error is associated.
+        # @!attribute [rw] error_details
+        #   @return [::Array<::String>]
+        #     A list of messages that carry the error details.
+        class TransferErrorLogEntry
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A summary of errors by error code, plus a count and sample error log
+        # entries.
+        # @!attribute [rw] error_code
+        #   @return [::Google::Rpc::Code]
+        #     One of the error codes that caused the transfer failure.
+        # @!attribute [rw] error_count
+        #   @return [::Integer]
+        #     Count of this type of error.
+        # @!attribute [rw] error_log_entries
+        #   @return [::Array<::Google::Cloud::Parallelstore::V1::TransferErrorLogEntry>]
+        #     A list of messages that carry the error details.
+        class TransferErrorSummary
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Metadata related to the data import operation.
         # @!attribute [rw] operation_metadata
         #   @return [::Google::Cloud::Parallelstore::V1::TransferOperationMetadata]
@@ -534,6 +576,10 @@ class ExportDataMetadata
         # @!attribute [r] transfer_type
         #   @return [::Google::Cloud::Parallelstore::V1::TransferType]
         #     Output only. The type of transfer occurring.
+        # @!attribute [r] error_summary
+        #   @return [::Array<::Google::Cloud::Parallelstore::V1::TransferErrorSummary>]
+        #     Output only. List of files that failed to be transferred. This list will
+        #     have a maximum size of 5 elements.
         class TransferOperationMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -564,6 +610,12 @@ class TransferOperationMetadata
         # @!attribute [rw] bytes_copied
         #   @return [::Integer]
         #     Bytes that are copied to the data destination.
+        # @!attribute [rw] objects_failed
+        #   @return [::Integer]
+        #     Objects that failed to write to the data destination.
+        # @!attribute [rw] bytes_failed
+        #   @return [::Integer]
+        #     Number of Bytes that failed to be written to the data destination.
         class TransferCounters
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -610,6 +662,19 @@ module DirectoryStripeLevel
           # Maximum directory striping
           DIRECTORY_STRIPE_LEVEL_MAX = 3
         end
+
+        # Represents the deployment type for the instance.
+        module DeploymentType
+          # Default Deployment Type
+          # It is equivalent to SCRATCH
+          DEPLOYMENT_TYPE_UNSPECIFIED = 0
+
+          # Scratch
+          SCRATCH = 1
+
+          # Persistent
+          PERSISTENT = 2
+        end
       end
     end
   end

google-cloud-parallelstore-v1/proto_docs/google/rpc/code.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Rpc
+    # The canonical error codes for gRPC APIs.
+    #
+    #
+    # Sometimes multiple error codes may apply.  Services should return
+    # the most specific error code that applies.  For example, prefer
+    # `OUT_OF_RANGE` over `FAILED_PRECONDITION` if both codes apply.
+    # Similarly prefer `NOT_FOUND` or `ALREADY_EXISTS` over `FAILED_PRECONDITION`.
+    module Code
+      # Not an error; returned on success.
+      #
+      # HTTP Mapping: 200 OK
+      OK = 0
+
+      # The operation was cancelled, typically by the caller.
+      #
+      # HTTP Mapping: 499 Client Closed Request
+      CANCELLED = 1
+
+      # Unknown error.  For example, this error may be returned when
+      # a `Status` value received from another address space belongs to
+      # an error space that is not known in this address space.  Also
+      # errors raised by APIs that do not return enough error information
+      # may be converted to this error.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      UNKNOWN = 2
+
+      # The client specified an invalid argument.  Note that this differs
+      # from `FAILED_PRECONDITION`.  `INVALID_ARGUMENT` indicates arguments
+      # that are problematic regardless of the state of the system
+      # (e.g., a malformed file name).
+      #
+      # HTTP Mapping: 400 Bad Request
+      INVALID_ARGUMENT = 3
+
+      # The deadline expired before the operation could complete. For operations
+      # that change the state of the system, this error may be returned
+      # even if the operation has completed successfully.  For example, a
+      # successful response from a server could have been delayed long
+      # enough for the deadline to expire.
+      #
+      # HTTP Mapping: 504 Gateway Timeout
+      DEADLINE_EXCEEDED = 4
+
+      # Some requested entity (e.g., file or directory) was not found.
+      #
+      # Note to server developers: if a request is denied for an entire class
+      # of users, such as gradual feature rollout or undocumented allowlist,
+      # `NOT_FOUND` may be used. If a request is denied for some users within
+      # a class of users, such as user-based access control, `PERMISSION_DENIED`
+      # must be used.
+      #
+      # HTTP Mapping: 404 Not Found
+      NOT_FOUND = 5
+
+      # The entity that a client attempted to create (e.g., file or directory)
+      # already exists.
+      #
+      # HTTP Mapping: 409 Conflict
+      ALREADY_EXISTS = 6
+
+      # The caller does not have permission to execute the specified
+      # operation. `PERMISSION_DENIED` must not be used for rejections
+      # caused by exhausting some resource (use `RESOURCE_EXHAUSTED`
+      # instead for those errors). `PERMISSION_DENIED` must not be
+      # used if the caller can not be identified (use `UNAUTHENTICATED`
+      # instead for those errors). This error code does not imply the
+      # request is valid or the requested entity exists or satisfies
+      # other pre-conditions.
+      #
+      # HTTP Mapping: 403 Forbidden
+      PERMISSION_DENIED = 7
+
+      # The request does not have valid authentication credentials for the
+      # operation.
+      #
+      # HTTP Mapping: 401 Unauthorized
+      UNAUTHENTICATED = 16
+
+      # Some resource has been exhausted, perhaps a per-user quota, or
+      # perhaps the entire file system is out of space.
+      #
+      # HTTP Mapping: 429 Too Many Requests
+      RESOURCE_EXHAUSTED = 8
+
+      # The operation was rejected because the system is not in a state
+      # required for the operation's execution.  For example, the directory
+      # to be deleted is non-empty, an rmdir operation is applied to
+      # a non-directory, etc.
+      #
+      # Service implementors can use the following guidelines to decide
+      # between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`:
+      #  (a) Use `UNAVAILABLE` if the client can retry just the failing call.
+      #  (b) Use `ABORTED` if the client should retry at a higher level. For
+      #      example, when a client-specified test-and-set fails, indicating the
+      #      client should restart a read-modify-write sequence.
+      #  (c) Use `FAILED_PRECONDITION` if the client should not retry until
+      #      the system state has been explicitly fixed. For example, if an "rmdir"
+      #      fails because the directory is non-empty, `FAILED_PRECONDITION`
+      #      should be returned since the client should not retry unless
+      #      the files are deleted from the directory.
+      #
+      # HTTP Mapping: 400 Bad Request
+      FAILED_PRECONDITION = 9
+
+      # The operation was aborted, typically due to a concurrency issue such as
+      # a sequencer check failure or transaction abort.
+      #
+      # See the guidelines above for deciding between `FAILED_PRECONDITION`,
+      # `ABORTED`, and `UNAVAILABLE`.
+      #
+      # HTTP Mapping: 409 Conflict
+      ABORTED = 10
+
+      # The operation was attempted past the valid range.  E.g., seeking or
+      # reading past end-of-file.
+      #
+      # Unlike `INVALID_ARGUMENT`, this error indicates a problem that may
+      # be fixed if the system state changes. For example, a 32-bit file
+      # system will generate `INVALID_ARGUMENT` if asked to read at an
+      # offset that is not in the range [0,2^32-1], but it will generate
+      # `OUT_OF_RANGE` if asked to read from an offset past the current
+      # file size.
+      #
+      # There is a fair bit of overlap between `FAILED_PRECONDITION` and
+      # `OUT_OF_RANGE`.  We recommend using `OUT_OF_RANGE` (the more specific
+      # error) when it applies so that callers who are iterating through
+      # a space can easily look for an `OUT_OF_RANGE` error to detect when
+      # they are done.
+      #
+      # HTTP Mapping: 400 Bad Request
+      OUT_OF_RANGE = 11
+
+      # The operation is not implemented or is not supported/enabled in this
+      # service.
+      #
+      # HTTP Mapping: 501 Not Implemented
+      UNIMPLEMENTED = 12
+
+      # Internal errors.  This means that some invariants expected by the
+      # underlying system have been broken.  This error code is reserved
+      # for serious errors.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      INTERNAL = 13
+
+      # The service is currently unavailable.  This is most likely a
+      # transient condition, which can be corrected by retrying with
+      # a backoff. Note that it is not always safe to retry
+      # non-idempotent operations.
+      #
+      # See the guidelines above for deciding between `FAILED_PRECONDITION`,
+      # `ABORTED`, and `UNAVAILABLE`.
+      #
+      # HTTP Mapping: 503 Service Unavailable
+      UNAVAILABLE = 14
+
+      # Unrecoverable data loss or corruption.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      DATA_LOSS = 15
+    end
+  end
+end

google-cloud-parallelstore-v1/proto_docs/google/rpc/status.rb

@@ -29,7 +29,7 @@ module Rpc
     # @!attribute [rw] code
     #   @return [::Integer]
     #     The status code, which should be an enum value of
-    #     [google.rpc.Code][google.rpc.Code].
+    #     {::Google::Rpc::Code google.rpc.Code}.
     # @!attribute [rw] message
     #   @return [::String]
     #     A developer-facing error message, which should be in English. Any