google-cloud-netapp-v1 2.7.0 → 2.8.0

data/proto_docs/google/cloud/netapp/v1/host_group.rb

@@ -0,0 +1,193 @@
+# frozen_string_literal: true
+
+# Copyright 2026 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 Cloud
+    module NetApp
+      module V1
+        # ListHostGroupsRequest for listing host groups.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Parent value for ListHostGroupsRequest
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. Requested page size. Server may return fewer items than
+        #     requested. If unspecified, the server will pick an appropriate default.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A token identifying a page of results the server should return.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Filter to apply to the request.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. Hint for how to order the results
+        class ListHostGroupsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # ListHostGroupsResponse is the response to a ListHostGroupsRequest.
+        # @!attribute [rw] host_groups
+        #   @return [::Array<::Google::Cloud::NetApp::V1::HostGroup>]
+        #     The list of host groups.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token identifying a page of results the server should return.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Locations that could not be reached.
+        class ListHostGroupsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # GetHostGroupRequest for getting a host group.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the host group.
+        #     Format:
+        #     `projects/{project_number}/locations/{location_id}/hostGroups/{host_group_id}`.
+        class GetHostGroupRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # CreateHostGroupRequest for creating a host group.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Parent value for CreateHostGroupRequest
+        # @!attribute [rw] host_group
+        #   @return [::Google::Cloud::NetApp::V1::HostGroup]
+        #     Required. Fields of the host group to create.
+        # @!attribute [rw] host_group_id
+        #   @return [::String]
+        #     Required. ID of the host group to create. Must be unique within the parent
+        #     resource. Must contain only letters, numbers, and hyphen, with
+        #     the first character a letter or underscore, the last a letter or underscore
+        #     or a number, and a 63 character maximum.
+        class CreateHostGroupRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # UpdateHostGroupRequest for updating a host group.
+        # @!attribute [rw] host_group
+        #   @return [::Google::Cloud::NetApp::V1::HostGroup]
+        #     Required. The host group to update.
+        #     The host group's `name` field is used to identify the host group.
+        #     Format:
+        #     `projects/{project_number}/locations/{location_id}/hostGroups/{host_group_id}`.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. The list of fields to update.
+        class UpdateHostGroupRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # DeleteHostGroupRequest for deleting a single host group.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the host group.
+        #     Format:
+        #     `projects/{project_number}/locations/{location_id}/hostGroups/{host_group_id}`.
+        class DeleteHostGroupRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Host group is a collection of hosts that can be used for accessing a Block
+        # Volume.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. The resource name of the host group.
+        #     Format:
+        #     `projects/{project_number}/locations/{location_id}/hostGroups/{host_group_id}`.
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::NetApp::V1::HostGroup::Type]
+        #     Required. Type of the host group.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::NetApp::V1::HostGroup::State]
+        #     Output only. State of the host group.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Create time of the host group.
+        # @!attribute [rw] hosts
+        #   @return [::Array<::String>]
+        #     Required. The list of hosts associated with the host group.
+        # @!attribute [rw] os_type
+        #   @return [::Google::Cloud::NetApp::V1::OsType]
+        #     Required. The OS type of the host group. It indicates the type of operating
+        #     system used by all of the hosts in the HostGroup. All hosts in a HostGroup
+        #     must be of the same OS type. This can be set only when creating a
+        #     HostGroup.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. Description of the host group.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Labels of the host group.
+        class HostGroup
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Types of host group.
+          module Type
+            # Unspecified type for host group.
+            TYPE_UNSPECIFIED = 0
+
+            # iSCSI initiator host group.
+            ISCSI_INITIATOR = 1
+          end
+
+          # Host group states.
+          module State
+            # Unspecified state for host group.
+            STATE_UNSPECIFIED = 0
+
+            # Host group is creating.
+            CREATING = 1
+
+            # Host group is ready.
+            READY = 2
+
+            # Host group is updating.
+            UPDATING = 3
+
+            # Host group is deleting.
+            DELETING = 4
+
+            # Host group is disabled.
+            DISABLED = 5
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/netapp/v1/kms.rb

@@ -146,14 +146,15 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # KmsConfig is the customer managed encryption key(CMEK) configuration.
+        # KmsConfig is the customer-managed encryption key(CMEK) configuration.
         # @!attribute [rw] name
         #   @return [::String]
         #     Identifier. Name of the KmsConfig.
+        #     Format: `projects/{project}/locations/{location}/kmsConfigs/{kms_config}`
         # @!attribute [rw] crypto_key_name
         #   @return [::String]
-        #     Required. Customer managed crypto key resource full name. Format:
-        #     projects/\\{project}/locations/\\{location}/keyRings/\\{key_ring}/cryptoKeys/\\{key}.
+        #     Required. Customer-managed crypto key resource full name. Format:
+        #     `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`
         # @!attribute [r] state
         #   @return [::Google::Cloud::NetApp::V1::KmsConfig::State]
         #     Output only. State of the KmsConfig.

data/proto_docs/google/cloud/netapp/v1/storage_pool.rb

@@ -234,6 +234,13 @@ module Google
         #   @return [::Integer]
         #     Output only. Total hot tier data rounded down to the nearest GiB used by
         #     the storage pool.
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::NetApp::V1::StoragePoolType]
+        #     Optional. Type of the storage pool. This field is used to control whether
+        #     the pool supports `FILE` based volumes only or `UNIFIED` (both `FILE` and
+        #     `BLOCK`) volumes or `UNIFIED_LARGE_CAPACITY` (both `FILE` and `BLOCK`)
+        #     volumes with large capacity. If not specified during creation, it defaults
+        #     to `FILE`.
         class StoragePool
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/netapp/v1/volume.rb

@@ -261,10 +261,17 @@ module Google
         # @!attribute [rw] throughput_mibps
         #   @return [::Float]
         #     Optional. Throughput of the volume (in MiB/s)
+        # @!attribute [rw] cache_parameters
+        #   @return [::Google::Cloud::NetApp::V1::CacheParameters]
+        #     Optional. Cache parameters for the volume.
         # @!attribute [r] hot_tier_size_used_gib
         #   @return [::Integer]
         #     Output only. Total hot tier data rounded down to the nearest GiB used by
         #     the Volume. This field is only used for flex Service Level
+        # @!attribute [rw] block_devices
+        #   @return [::Array<::Google::Cloud::NetApp::V1::BlockDevice>]
+        #     Optional. Block devices for the volume.
+        #     Currently, only one block device is permitted per Volume.
         class Volume
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -380,16 +387,16 @@ module Google
         # @!attribute [rw] anon_uid
         #   @return [::Integer]
         #     Optional. An integer representing the anonymous user ID. Range is 0 to
-        #     4294967295. Required when squash_mode is ROOT_SQUASH or ALL_SQUASH.
+        #     `4294967295`. Required when `squash_mode` is `ROOT_SQUASH` or `ALL_SQUASH`.
         class SimpleExportPolicyRule
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # SquashMode defines how remote user privileges are restricted when accessing
-          # an NFS export. It controls how user identities (like root) are mapped to
-          # anonymous users to limit access and enforce security.
+          # `SquashMode` defines how remote user privileges are restricted when
+          # accessing an NFS export. It controls how user identities (like root) are
+          # mapped to anonymous users to limit access and enforce security.
           module SquashMode
-            # Defaults to NO_ROOT_SQUASH.
+            # Defaults to `NO_ROOT_SQUASH`.
             SQUASH_MODE_UNSPECIFIED = 0
 
             # The root user (UID 0) retains full access. Other users are
@@ -664,6 +671,193 @@ module Google
           end
         end
 
+        # Cache Parameters for the volume.
+        # @!attribute [rw] peer_volume_name
+        #   @return [::String]
+        #     Required. Name of the origin volume for the cache volume.
+        # @!attribute [rw] peer_cluster_name
+        #   @return [::String]
+        #     Required. Name of the origin volume's ONTAP cluster.
+        # @!attribute [rw] peer_svm_name
+        #   @return [::String]
+        #     Required. Name of the origin volume's SVM.
+        # @!attribute [rw] peer_ip_addresses
+        #   @return [::Array<::String>]
+        #     Required. List of IC LIF addresses of the origin volume's ONTAP cluster.
+        # @!attribute [rw] enable_global_file_lock
+        #   @return [::Boolean]
+        #     Optional. Indicates whether the cache volume has global file lock enabled.
+        # @!attribute [rw] cache_config
+        #   @return [::Google::Cloud::NetApp::V1::CacheConfig]
+        #     Optional. Configuration of the cache volume.
+        # @!attribute [r] cache_state
+        #   @return [::Google::Cloud::NetApp::V1::CacheParameters::CacheState]
+        #     Output only. State of the cache volume indicating the peering status.
+        # @!attribute [r] command
+        #   @return [::String]
+        #     Output only. Copy-paste-able commands to be used on user's ONTAP to accept
+        #     peering requests.
+        # @!attribute [rw] peering_command_expiry_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Optional. Expiration time for the peering command to be executed on user's
+        #     ONTAP.
+        # @!attribute [r] passphrase
+        #   @return [::String]
+        #     Output only. Temporary passphrase generated to accept cluster peering
+        #     command.
+        # @!attribute [r] state_details
+        #   @return [::String]
+        #     Output only. Detailed description of the current cache state.
+        class CacheParameters
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # State of the cache volume indicating the peering status.
+          module CacheState
+            # Default unspecified state.
+            CACHE_STATE_UNSPECIFIED = 0
+
+            # State indicating waiting for cluster peering to be established.
+            PENDING_CLUSTER_PEERING = 1
+
+            # State indicating waiting for SVM peering to be established.
+            PENDING_SVM_PEERING = 2
+
+            # State indicating successful establishment of peering with origin
+            # volumes's ONTAP cluster.
+            PEERED = 3
+
+            # Terminal state wherein peering with origin volume's ONTAP cluster
+            # has failed.
+            ERROR = 4
+          end
+        end
+
+        # Configuration of the cache volume.
+        # @!attribute [rw] cache_pre_populate
+        #   @return [::Google::Cloud::NetApp::V1::CachePrePopulate]
+        #     Optional. Pre-populate cache volume with data from the origin volume.
+        # @!attribute [rw] writeback_enabled
+        #   @return [::Boolean]
+        #     Optional. Flag indicating whether writeback is enabled for the FlexCache
+        #     volume.
+        # @!attribute [rw] cifs_change_notify_enabled
+        #   @return [::Boolean]
+        #     Optional. Flag indicating whether a CIFS change notification is enabled for
+        #     the FlexCache volume.
+        # @!attribute [r] cache_pre_populate_state
+        #   @return [::Google::Cloud::NetApp::V1::CacheConfig::CachePrePopulateState]
+        #     Output only. State of the prepopulation job indicating how the
+        #     prepopulation is progressing.
+        class CacheConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # State of the prepopulation job indicating how the prepopulation is
+          # progressing.
+          module CachePrePopulateState
+            # Default unspecified state.
+            CACHE_PRE_POPULATE_STATE_UNSPECIFIED = 0
+
+            # State representing when the most recent create or update request did not
+            # require a prepopulation job.
+            NOT_NEEDED = 1
+
+            # State representing when the most recent update request requested a
+            # prepopulation job but it has not yet completed.
+            IN_PROGRESS = 2
+
+            # State representing when the most recent update request requested a
+            # prepopulation job and it has completed successfully.
+            COMPLETE = 3
+
+            # State representing when the most recent update request requested a
+            # prepopulation job but the prepopulate job failed.
+            ERROR = 4
+          end
+        end
+
+        # Pre-populate cache volume with data from the origin volume.
+        # @!attribute [rw] path_list
+        #   @return [::Array<::String>]
+        #     Optional. List of directory-paths to be pre-populated for the FlexCache
+        #     volume.
+        # @!attribute [rw] exclude_path_list
+        #   @return [::Array<::String>]
+        #     Optional. List of directory-paths to be excluded for pre-population for the
+        #     FlexCache volume.
+        # @!attribute [rw] recursion
+        #   @return [::Boolean]
+        #     Optional. Flag indicating whether the directories listed with the
+        #     `path_list` need to be recursively pre-populated.
+        class CachePrePopulate
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Block device represents the device(s) which are stored in the block volume.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Optional. User-defined name for the block device, unique within the volume.
+        #     In case no user input is provided, name will be auto-generated in the
+        #     backend. The name must meet the following requirements:
+        #     *   Be between 1 and 255 characters long.
+        #     *   Contain only uppercase or lowercase letters (A-Z, a-z), numbers (0-9),
+        #         and the following special characters: "-", "_", "}", "{", ".".
+        #     *   Spaces are not allowed.
+        # @!attribute [rw] host_groups
+        #   @return [::Array<::String>]
+        #     Optional. A list of host groups that identify hosts that can mount the
+        #     block volume. Format:
+        #     `projects/{project_id}/locations/{location}/hostGroups/{host_group_id}`
+        #     This field can be updated after the block device is created.
+        # @!attribute [r] identifier
+        #   @return [::String]
+        #     Output only. Device identifier of the block volume. This represents
+        #     `lun_serial_number` for iSCSI volumes.
+        # @!attribute [rw] size_gib
+        #   @return [::Integer]
+        #     Optional. The size of the block device in GiB.
+        #     Any value provided for the `size_gib` field during volume creation is
+        #     ignored. The block device's size is system-managed and will be set to match
+        #     the parent Volume's `capacity_gib`.
+        # @!attribute [rw] os_type
+        #   @return [::Google::Cloud::NetApp::V1::OsType]
+        #     Required. Immutable. The OS type of the volume.
+        #     This field can't be changed after the block device is created.
+        class BlockDevice
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # RestoreBackupFilesRequest restores files from a backup to a volume.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The volume resource name, in the format
+        #     `projects/{project_id}/locations/{location}/volumes/{volume_id}`
+        # @!attribute [rw] backup
+        #   @return [::String]
+        #     Required. The backup resource name, in the format
+        #     `projects/{project_id}/locations/{location}/backupVaults/{backup_vault_id}/backups/{backup_id}`
+        # @!attribute [rw] file_list
+        #   @return [::Array<::String>]
+        #     Required. List of files to be restored, specified by their absolute path in
+        #     the source volume.
+        # @!attribute [rw] restore_destination_path
+        #   @return [::String]
+        #     Optional. Absolute directory path in the destination volume. This is
+        #     required if the `file_list` is provided.
+        class RestoreBackupFilesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # RestoreBackupFilesResponse is the result of RestoreBackupFilesRequest.
+        class RestoreBackupFilesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Protocols is an enum of all the supported network protocols for a volume.
         module Protocols
           # Unspecified protocol
@@ -677,6 +871,9 @@ module Google
 
           # SMB protocol
           SMB = 3
+
+          # ISCSI protocol
+          ISCSI = 4
         end
 
         # AccessType is an enum of all the supported access types for a volume.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-netapp-v1
 version: !ruby/object:Gem::Version
-  version: 2.7.0
+  version: 2.8.0
 platform: ruby
 authors:
 - Google LLC
@@ -75,6 +75,7 @@ files:
 - lib/google/cloud/netapp/v1/cloud_netapp_service_pb.rb
 - lib/google/cloud/netapp/v1/cloud_netapp_service_services_pb.rb
 - lib/google/cloud/netapp/v1/common_pb.rb
+- lib/google/cloud/netapp/v1/host_group_pb.rb
 - lib/google/cloud/netapp/v1/kms_pb.rb
 - lib/google/cloud/netapp/v1/netapp.rb
 - lib/google/cloud/netapp/v1/netapp/client.rb
@@ -104,6 +105,7 @@ files:
 - proto_docs/google/cloud/netapp/v1/backup_vault.rb
 - proto_docs/google/cloud/netapp/v1/cloud_netapp_service.rb
 - proto_docs/google/cloud/netapp/v1/common.rb
+- proto_docs/google/cloud/netapp/v1/host_group.rb
 - proto_docs/google/cloud/netapp/v1/kms.rb
 - proto_docs/google/cloud/netapp/v1/quota_rule.rb
 - proto_docs/google/cloud/netapp/v1/replication.rb