APIs in Category: vfiler
API version 1.5

 
vfiler-add-ipaddress
vfiler-add-storage
vfiler-allow-protocol
vfiler-create
vfiler-destroy
vfiler-disallow-protocol
vfiler-get-allowed-protocols
vfiler-get-disallowed-protocols
vfiler-get-status
vfiler-list-info
vfiler-migrate
vfiler-remove-ipaddress
vfiler-remove-storage
vfiler-setup
vfiler-start
vfiler-stop

NetApp Manage ONTAP
 
vfiler-add-ipaddress [top]

Add an ipaddress to a vfiler
Input Name Range Type Description
ipaddress string
Ipaddress to be added, in dotted-decimal format (for example, "192.168.11.12").
vfiler string
Name of the vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-add-storage [top]
Add a storage unit to a vfiler
Input Name Range Type Description
storage-path string
Storage-path to be added, in the form "/vol/<volume>/..."
vfiler string
Name of the vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-allow-protocol [top]
Allow a protocol on a specified vfiler
Input Name Range Type Description
protocol string
Name of the protocol to be allowed. Possible values are: nfs, cifs, rsh.
vfiler string
Name of the vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-create [top]
Create a new vfiler. The inputs specify a list of storage units, which are qtree or volume paths.
Input Name Range Type Description
ip-addresses ip-address[]
ipspace string
optional
Name of the ipspace.
storage-units storage-unit[]
vfiler string
Name of the vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED

 
vfiler-destroy [top]
Destroy a vfiler
Input Name Range Type Description
vfiler string
Name of the vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-disallow-protocol [top]
Disallow a protocol on a specified vfiler
Input Name Range Type Description
protocol string
Name of the protocol to be disallowed. Possible values are: nfs, cifs, rsh.
vfiler string
Name of the vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-get-allowed-protocols [top]
Get the protocols allowed for a vfiler
Input Name Range Type Description
vfiler string
Name of the vfiler.
 
Output Name Range Type Description
allowed-protocols protocol-info[]
This contains a list of all allowed protocols for this vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-get-disallowed-protocols [top]
Get the protocols disallowed for a vfiler
Input Name Range Type Description
vfiler string
Name of the vfiler.
 
Output Name Range Type Description
disallowed-protocols protocol-info[]
This contains a list of all disallowed protocols for this vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-get-status [top]
Get the status of a vfiler
Input Name Range Type Description
vfiler string
Name of the vfiler.
 
Output Name Range Type Description
status string
Status of the vfiler. Possible values: running, stopped, inconsistent or defunct.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-list-info [top]
Retrieve information about all vfilers. An optional vfiler parameter lets you retrive information about a single vfiler.
Input Name Range Type Description
vfiler string
optional
Name of the vfiler whose information you want to retrieve. If this parameter is not provided, information about all vfilers will be returned.
 
Output Name Range Type Description
vfilers vfiler-info[]
This contains a list of all the vfilers.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-migrate [top]
Migrate a vfiler on remote filer to this filer. The vfiler facility must be licensed on the remote filer and on the local filer. Other requirements are detailed in the migration-method parameter documentation below.

Migration may fail for a number of reasons. For example, the vfiler facility may not be licensed or the vfiler may not be in a state suitable for migration. In these cases EVFILEROPNOTALLOWED will be returned, along with a descriptive reason string.

Input Name Range Type Description
force boolean
optional
If this value is true, the vfiler should be migrated even under various conditions which would normally prevent a migration are encountered. See na_vfiler(1) for details.
ipaddrs ipaddr-info[]
Contains a list of all the IP address (and associated information) which should be bound to the vfiler at the destination
migration-method string
optional
Name of the vfiler migration method. Possible values: snapmirror, nocopy. Defaults to "snapmirror".

Snapmirror: SnapMirror must be licensed on the local and remote filer.

Nocopy: SnapMover must be licensed on the local and remote filer. If the force parameter is not set to true, the vfiler will not be migrated if data belonging to belonging to the source vfiler is part of a SnapMirror or SnapVault relationship, if the source filer file system version is not the same as the local file system version, if NFS, CIFS, DAFS, or iSCSI are allowed on the source vfiler but not licensed locally, or if clustering is licensed on the source filer but not licensed locally. The "force" parameter overrides these checks. However, even if the "force" parameter is supplied the vfiler will not be migrated if the source filer's file system version is greater than the local filer's file system version.

password string
encrypted
Administrative password on remote-filer.
remote-filer string
Name of the filer on which the vfiler resides. This may also take the form of an IP address.
username string
Administrative login name on remote-filer.
vfiler string
Name of the vfiler being migrated. There must not be a vfiler with the same name on the local filer. "vfiler0" is not allowed, as the default vfiler may not be migrated.
 Errno  Description
 EAPIMISSINGARGUMENT
 EVFILEROPNOTALLOWED
 EVFILERNOTFOUND
 License
 vfiler

 
vfiler-remove-ipaddress [top]
Remove an ipaddress from a vfiler
Input Name Range Type Description
ipaddress string
Ipaddress to be removed, in dotted-decimal format (for example, "192.168.11.12").
vfiler string
Name of the vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-remove-storage [top]
Remove a storage unit from a vfiler
Input Name Range Type Description
storage-path string
Storage-path to be removed, in the form "/vol/<volume>/..."
vfiler string
Name of the vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-setup [top]
Setup services for a vfiler that has been already created. At least one of the optional arguments must be specified.
Input Name Range Type Description
adminhost adminhost-info
optional
Information about the administrative host
dnsdomain string
optional
DNS domain name
dnsservers dnsserver-info[]
optional
List of DNS servers
ipbindings ipbinding-info[]
optional
Contains a list of all IP address bindings to apply
nisdomain string
optional
NIS domain name
nisservers nisserver-info[]
optional
List of NIS servers
password string
optional
root password for the vfiler
vfiler string
Name of the vfiler that you want to setup.
 Errno  Description
 EAPIMISSINGARGUMENT
 EVFILEROPNOTALLOWED
 EVFILERNOTFOUND
 License
 vfiler

 
vfiler-start [top]
Start a stopped vfiler. This operation is synchronous.
Input Name Range Type Description
vfiler string
Name of the vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
vfiler-stop [top]
Stop a started vfiler
Input Name Range Type Description
vfiler string
Name of the vfiler.
 Errno  Description
 EVFILERNOTFOUND
 EVFILEROPNOTALLOWED
 License
 vfiler

 
Element definition: adminhost-info [top]
This is information about the administrative host
Name Range Type Description
ipaddress string
IP address of administrative host
name string
name of administrative host, pass an empty string if this is not known

 
Element definition: dnsserver-info [top]
This is information about one DNS server
Name Range Type Description
ipaddress string
DNS server IP address

 
Element definition: ip-address [top]
One ip address, in dotted-decimal format (for example, "192.168.11.12").
[none]

 
Element definition: ipaddr-info [top]
Information about one IP address that should be bound to the vfiler at the destination.
Name Range Type Description
interface string
Name of the network interface.
ip-address string
One ip address, in dotted-decimal format (for example, "192.168.11.12").
netmask string
Netmask, in dotted-decimal format (for example, "255.255.255.0").

 
Element definition: ipbinding-info [top]
This is information about one IP address binding
Name Range Type Description
interface string
Name of interface to bind IP address to.
ipaddress string
IP address to bind binding
netmask string
Netmask of IP address binding

 
Element definition: nisserver-info [top]
This is information about one NIS server
Name Range Type Description
ipaddress string
NIS server IP address, or "*"

 
Element definition: protocol-info [top]
This is information about one protocol
Name Range Type Description
protocol string
Name of a allowed protocol

 
Element definition: storage-unit [top]
one storage unit
[none]

 
Element definition: vfiler-info [top]
Information about one vfiler.
Name Range Type Description
ipspace string
Name of the vfiler's ipspace
name string
Name of the vfiler.
vfnets vfnet-info[]
List of all networking resources of this vfiler.
vfstores vfstore-info[]
List of all storage resources of the vfiler.

 
Element definition: vfnet-info [top]
Information about one networking resource.
Name Range Type Description
interface string
Name of the interface, which should be something that the "ifconfig" command recognizes, like "e0" or a vif name.
ipaddress string
IP address of the networking resource

 
Element definition: vfstore-info [top]
Information about one storage resource.
Name Range Type Description
is-etc boolean
True if this storage unit is the etcpath, false otherwise.
path string
Path of the storage resource
status string
Status of the storage resource. Possible values are: online, offline, inconsistent.