feat: [netapp] Add ONTAP passthrough APIs

packages/google-cloud-netapp/README.md

@@ -82,6 +82,11 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | delete volume | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-netapp/samples/generated/v1/net_app.delete_volume.js) |
 | encrypt volumes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-netapp/samples/generated/v1/net_app.encrypt_volumes.js) |
 | establish peering | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-netapp/samples/generated/v1/net_app.establish_peering.js) |
+| establish volume peering | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-netapp/samples/generated/v1/net_app.establish_volume_peering.js) |
+| execute ontap delete | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-netapp/samples/generated/v1/net_app.execute_ontap_delete.js) |
+| execute ontap get | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-netapp/samples/generated/v1/net_app.execute_ontap_get.js) |
+| execute ontap patch | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-netapp/samples/generated/v1/net_app.execute_ontap_patch.js) |
+| execute ontap post | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-netapp/samples/generated/v1/net_app.execute_ontap_post.js) |
 | get active directory | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-netapp/samples/generated/v1/net_app.get_active_directory.js) |
 | get backup | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-netapp/samples/generated/v1/net_app.get_backup.js) |
 | get backup policy | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-netapp/samples/generated/v1/net_app.get_backup_policy.js) |

packages/google-cloud-netapp/protos/google/cloud/netapp/v1/backup.proto

@@ -100,6 +100,7 @@ message Backup {
   Type backup_type = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Volume full name of this backup belongs to.
+  // Either source_volume or ontap_source should be provided.
   // Format:
   // `projects/{projects_id}/locations/{location}/volumes/{volume_id}`
   string source_volume = 6 [

packages/google-cloud-netapp/protos/google/cloud/netapp/v1/cloud_netapp_service.proto

@@ -26,6 +26,7 @@ import "google/cloud/netapp/v1/backup_policy.proto";
 import "google/cloud/netapp/v1/backup_vault.proto";
 import "google/cloud/netapp/v1/host_group.proto";
 import "google/cloud/netapp/v1/kms.proto";
+import "google/cloud/netapp/v1/ontap.proto";
 import "google/cloud/netapp/v1/quota_rule.proto";
 import "google/cloud/netapp/v1/replication.proto";
 import "google/cloud/netapp/v1/snapshot.proto";
@@ -208,6 +209,20 @@ service NetApp {
     };
   }
 
+  // Establish volume peering. This is used to establish cluster and svm
+  // peerings between the GCNV and OnPrem clusters.
+  rpc EstablishVolumePeering(EstablishVolumePeeringRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/volumes/*}:establishPeering"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "Volume"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
   // Returns descriptions of all snapshots for a volume.
   rpc ListSnapshots(ListSnapshotsRequest) returns (ListSnapshotsResponse) {
     option (google.api.http) = {
@@ -832,6 +847,44 @@ service NetApp {
       metadata_type: "OperationMetadata"
     };
   }
+
+  // `ExecuteOntapPost` dispatches the ONTAP `POST` request to the
+  // `StoragePool` cluster.
+  rpc ExecuteOntapPost(ExecuteOntapPostRequest)
+      returns (ExecuteOntapPostResponse) {
+    option (google.api.http) = {
+      post: "/v1/{ontap_path=projects/*/locations/*/storagePools/*/ontap/**}"
+      body: "*"
+    };
+  }
+
+  // `ExecuteOntapGet` dispatches the ONTAP `GET` request to the
+  // `StoragePool` cluster.
+  rpc ExecuteOntapGet(ExecuteOntapGetRequest)
+      returns (ExecuteOntapGetResponse) {
+    option (google.api.http) = {
+      get: "/v1/{ontap_path=projects/*/locations/*/storagePools/*/ontap/**}"
+    };
+  }
+
+  // `ExecuteOntapDelete` dispatches the ONTAP `DELETE` request to the
+  // `StoragePool` cluster.
+  rpc ExecuteOntapDelete(ExecuteOntapDeleteRequest)
+      returns (ExecuteOntapDeleteResponse) {
+    option (google.api.http) = {
+      delete: "/v1/{ontap_path=projects/*/locations/*/storagePools/*/ontap/**}"
+    };
+  }
+
+  // `ExecuteOntapPatch` dispatches the ONTAP `PATCH` request to the
+  // `StoragePool` cluster.
+  rpc ExecuteOntapPatch(ExecuteOntapPatchRequest)
+      returns (ExecuteOntapPatchResponse) {
+    option (google.api.http) = {
+      patch: "/v1/{ontap_path=projects/*/locations/*/storagePools/*/ontap/**}"
+      body: "*"
+    };
+  }
 }
 
 // Represents the metadata of the long-running operation.

packages/google-cloud-netapp/protos/google/cloud/netapp/v1/common.proto

@@ -87,9 +87,6 @@ enum StoragePoolType {
 
   // Storage pool type is unified.
   UNIFIED = 2;
-
-  // Storage pool type is unified large capacity.
-  UNIFIED_LARGE_CAPACITY = 3;
 }
 
 // Schedule for Hybrid Replication.

packages/google-cloud-netapp/protos/google/cloud/netapp/v1/ontap.proto

@@ -0,0 +1,118 @@
+// 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
+//
+//     http://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.
+
+syntax = "proto3";
+
+package google.cloud.netapp.v1;
+
+import "google/api/field_behavior.proto";
+import "google/protobuf/struct.proto";
+
+option csharp_namespace = "Google.Cloud.NetApp.V1";
+option go_package = "cloud.google.com/go/netapp/apiv1/netapppb;netapppb";
+option java_multiple_files = true;
+option java_outer_classname = "OntapProto";
+option java_package = "com.google.cloud.netapp.v1";
+option php_namespace = "Google\\Cloud\\NetApp\\V1";
+option ruby_package = "Google::Cloud::NetApp::V1";
+
+// Request message for `ExecuteOntapPost` API.
+message ExecuteOntapPostRequest {
+  // Required. The raw `JSON` body of the request.
+  // The body should be in the format of the ONTAP resource.
+  // For example:
+  // ```
+  // {
+  //   "body": {
+  //     "field1": "value1",
+  //     "field2": "value2",
+  //   }
+  // }
+  // ```
+  google.protobuf.Struct body = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The resource path of the ONTAP resource.
+  // Format:
+  // `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`.
+  // For example:
+  // `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.
+  string ontap_path = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for `ExecuteOntapPost` API.
+message ExecuteOntapPostResponse {
+  // The raw `JSON` body of the response.
+  google.protobuf.Struct body = 1;
+}
+
+// Request message for `ExecuteOntapGet` API.
+message ExecuteOntapGetRequest {
+  // Required. The resource path of the ONTAP resource.
+  // Format:
+  // `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`.
+  // For example:
+  // `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.
+  string ontap_path = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for `ExecuteOntapGet` API.
+message ExecuteOntapGetResponse {
+  // The raw `JSON` body of the response.
+  google.protobuf.Struct body = 1;
+}
+
+// Request message for `ExecuteOntapDelete` API.
+message ExecuteOntapDeleteRequest {
+  // Required. The resource path of the ONTAP resource.
+  // Format:
+  // `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`.
+  // For example:
+  // `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.
+  string ontap_path = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for `ExecuteOntapDelete` API.
+message ExecuteOntapDeleteResponse {
+  // The raw `JSON` body of the response.
+  google.protobuf.Struct body = 1;
+}
+
+// Request message for `ExecuteOntapPatch` API.
+message ExecuteOntapPatchRequest {
+  // Required. The raw `JSON` body of the request.
+  // The body should be in the format of the ONTAP resource.
+  // For example:
+  // ```
+  // {
+  //   "body": {
+  //     "field1": "value1",
+  //     "field2": "value2",
+  //   }
+  // }
+  // ```
+  google.protobuf.Struct body = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The resource path of the ONTAP resource.
+  // Format:
+  // `projects/{project_number}/locations/{location_id}/storagePools/{storage_pool_id}/ontap/{ontap_resource_path}`.
+  // For example:
+  // `projects/123456789/locations/us-central1/storagePools/my-storage-pool/ontap/api/storage/volumes`.
+  string ontap_path = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for `ExecuteOntapPatch` API.
+message ExecuteOntapPatchResponse {
+  // The raw `JSON` body of the response.
+  google.protobuf.Struct body = 1;
+}

packages/google-cloud-netapp/protos/google/cloud/netapp/v1/storage_pool.proto

@@ -30,6 +30,19 @@ option java_package = "com.google.cloud.netapp.v1";
 option php_namespace = "Google\\Cloud\\NetApp\\V1";
 option ruby_package = "Google::Cloud::NetApp::V1";
 
+// `Mode` of the storage pool or volume. This field is used to control whether
+// the resource is managed by the GCNV APIs or the GCNV ONTAP Mode APIs.
+enum Mode {
+  // The `Mode` is not specified.
+  MODE_UNSPECIFIED = 0;
+
+  // The resource is managed by the GCNV APIs.
+  DEFAULT = 1;
+
+  // The resource is managed by the GCNV ONTAP Mode APIs.
+  ONTAP = 2;
+}
+
 // GetStoragePoolRequest gets a Storage Pool.
 message GetStoragePoolRequest {
   // Required. Name of the storage pool
@@ -302,10 +315,14 @@ message StoragePool {
 
   // 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`.
+  // `BLOCK`) volumes. If not specified during creation, it defaults to `FILE`.
   optional StoragePoolType type = 35 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Mode of the storage pool. This field is used to control whether
+  // the user can perform the ONTAP operations on the storage pool using the
+  // GCNV ONTAP Mode APIs. If not specified during creation, it defaults to
+  // `DEFAULT`.
+  optional Mode mode = 36 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // ValidateDirectoryServiceRequest validates the directory service policy

packages/google-cloud-netapp/protos/google/cloud/netapp/v1/volume.proto

@@ -236,6 +236,31 @@ message Volume {
     singular: "volume"
   };
 
+  // Details about a clone volume.
+  message CloneDetails {
+    // Output only. Specifies the full resource name of the source snapshot from
+    // which this volume was cloned. Format:
+    // projects/{project}/locations/{location}/volumes/{volume}/snapshots/{snapshot}
+    string source_snapshot = 1 [
+      (google.api.field_behavior) = OUTPUT_ONLY,
+      (google.api.resource_reference) = {
+        type: "netapp.googleapis.com/Snapshot"
+      }
+    ];
+
+    // Output only. Full name of the source volume resource.
+    // Format:
+    // projects/{project}/locations/{location}/volumes/{volume}
+    string source_volume = 2 [
+      (google.api.field_behavior) = OUTPUT_ONLY,
+      (google.api.resource_reference) = { type: "netapp.googleapis.com/Volume" }
+    ];
+
+    // Output only. Shared space in GiB. Determined at volume creation time
+    // based on size of source snapshot.
+    int64 shared_space_gib = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
   // The volume states
   enum State {
     // Unspecified Volume State
@@ -438,6 +463,10 @@ message Volume {
   // Currently, only one block device is permitted per Volume.
   repeated BlockDevice block_devices = 45
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. If this volume is a clone, this field contains details about
+  // the clone.
+  CloneDetails clone_details = 47 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Defines the export policy for the volume.
@@ -634,9 +663,13 @@ message RestoreParameters {
     string source_snapshot = 1;
 
     // Full name of the backup resource.
-    // Format:
+    // Format for standard backup:
     // projects/{project}/locations/{location}/backupVaults/{backup_vault_id}/backups/{backup_id}
-    string source_backup = 2;
+    // Format for BackupDR backup:
+    // projects/{project}/locations/{location}/backupVaults/{backup_vault}/dataSources/{data_source}/backups/{backup}
+    string source_backup = 2 [
+      (google.api.resource_reference) = { type: "netapp.googleapis.com/Backup" }
+    ];
   }
 }
 
@@ -960,3 +993,30 @@ message RestoreBackupFilesRequest {
 
 // RestoreBackupFilesResponse is the result of RestoreBackupFilesRequest.
 message RestoreBackupFilesResponse {}
+
+// EstablishVolumePeeringRequest establishes cluster and svm peerings between
+// the source and destination clusters.
+message EstablishVolumePeeringRequest {
+  // Required. The volume resource name, in the format
+  // `projects/{project_id}/locations/{location}/volumes/{volume_id}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "netapp.googleapis.com/Volume" }
+  ];
+
+  // Required. Name of the user's local source cluster to be peered with the
+  // destination cluster.
+  string peer_cluster_name = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the user's local source vserver svm to be peered with the
+  // destination vserver svm.
+  string peer_svm_name = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. List of IPv4 ip addresses to be used for peering.
+  repeated string peer_ip_addresses = 4
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Name of the user's local source volume to be peered with the
+  // destination volume.
+  string peer_volume_name = 5 [(google.api.field_behavior) = REQUIRED];
+}