Find Volume operation


The Find Volume operation finds the list of all the volumes contained inside a Resource Group, Data Set, Storage Set, Host, Aggregate, Volume, Qtree.

The following table describes the elements for this request.


 Adapter request elements for the Find Volume operation

A sample adapter request for this operation is given in the following figure. 

Sample adapter request for the Find Volume operation

<netapp-storage-request>
   <operation-name>find-volume</operation-name>
   <arguments>
     <targets>
       <target>
         <host>server137</host>
         <user-name>username</user-name>
         <password encryption-type = "Base64">cGFzc3dvcmQ=</password>
         <protocol>http</protocol>
         <port>8088</port>
       </target>
     </targets>
     <target />
     <object-name-or-id>test1:/test</object-name-or-id>
     <include-is-available>true</include-is-available>
     <is-dp-ignored>false</is-dp-ignored>
     <is-in-dataset>false</is-in-dataset>
     <volume-type>flexible</volume-type>
     <is-snapmirror-primary-capable>false</is-snapmirror-primary-capable>
     <is-snapmirror-secondary-capable>false</is-snapmirror-secondary-capable>
     <is-snapvault-primary-capable>false</is-snapvault-primary-capable>
     <is-snapvault-secondary-capable>false</is-snapvault-secondary-capable>
   </arguments>
</netapp-storage-request>

A sample adapter response for this operation is given in the following figure. 

Sample adapter response for the Find Volume operation

<netapp-storage-response>
 <metadata>
   <status>success</status>
   <response-count>1</response-count>
 </metadata>
 <responses>
   <response>
     <metadata>
       <target>server137</target>
       <status>success</status>
       <count>1</count>
     </metadata>
     <output>
       <volume-info>
         <volume-id>563</volume-id>
         <volume-name>test1:/test</volume-name>
         <host-id>74</host-id>
         <host-name>test1</host-name>
         <aggregate-id>75</aggregate-id>
         <aggregate-name>test1:aggr0</aggregate-name>
         <volume-type>flexible</volume-type>
         <block-type>32_bit</block-type>
         <volume-state>online</volume-state>
         <volume-status>normal</volume-status>
         <volume-perf-status>unknown</volume-perf-status>
         <is-available>true</is-available>
         <is-dp-ignored>false</is-dp-ignored>
         <is-in-dataset>false</is-in-dataset>
         <datasets />
         <dataset-nodes />
         <is-snapvault-primary-volume>false</is-snapvault-primary-volume>
         <is-snapvault-secondary-volume>false</is-snapvault-secondary-volume>
         <is-snapmirror-primary-volume>false</is-snapmirror-primary-volume>
         <is-snapmirror-secondary-volume>false</is-snapmirror-secondary-volume>
         <is-vsm-secondary-volume>false</is-vsm-secondary-volume>
         <is-readonly-volume>false</is-readonly-volume>
         <is-snapvault-primary-capable>true</is-snapvault-primary-capable>
         <is-snapvault-secondary-capable>true</is-snapvault-secondary-capable>
         <is-snapmirror-primary-capable>true</is-snapmirror-primary-capable>
         <is-snapmirror-secondary-capable>true</is-snapmirror-secondary-capable>
         <volume-nearly-full-threshold />
         <volume-full-threshold />
         <volume-space-status>ok</volume-space-status>
         <space-guarantee>volume</space-guarantee>
         <snapshot-volume-id>564</snapshot-volume-id>
         <snapshot-volume-name>test1:/test.snapshot</snapshot-volume-name>
         <volume-size>
           <snapshot-reserve-total>10485760</snapshot-reserve-total>
           <snapshot-reserve-used>114688</snapshot-reserve-used>
           <snapshot-reserve-avail>10371072</snapshot-reserve-avail>
           <afs-total>41943040</afs-total>
           <afs-used>299008</afs-used>
           <afs-data>299008</afs-data>
           <afs-used-per-day>6144</afs-used-per-day>
           <afs-avail>41644032</afs-avail>
           <total>52428800</total>
           <space-allocated-from-aggr>52690944</space-allocated-from-aggr>
           <overwrite-reserve-total>0</overwrite-reserve-total>
           <overwrite-reserve-used>0</overwrite-reserve-used>
           <overwrite-reserve-avail>0</overwrite-reserve-avail>
           <hole-reserve>0</hole-reserve>
           <is-autosize-enabled>false</is-autosize-enabled>
           <actual-volume-size>52428800</actual-volume-size>
         </volume-size>
         <volume-qtree>
           <total-qtree-count>1</total-qtree-count>
           <protected-qtree-count>0</protected-qtree-count>
           <unprotected-qtree-count>1</unprotected-qtree-count>
           <protected-data-size>0</protected-data-size>
           <unprotected-data-size>0</unprotected-data-size>
         </volume-qtree>
       </volume-info>
     </output>
   </response>
 </responses>
</netapp-storage-response>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*