NAME

OntapClusterAPI - Contains the definitions and description of API Bindings for clustered Data ONTAP


SYNOPSIS

         my $s = NaServer->new($server, 1, 0); # create NaServer (server context)
         $s->set_admin_user('admin', 'password'); # provide username and password
         eval{ 
                 my $output = $s->system_get_version(); # use binding for system-get-version API
                 print "Data ONTAP version: $output->{version}\n"; # extract the required parameter from output
                 print "Clustered: $output->{is-clustered}\n"; 
                 my $tuple = $output->{'version-tuple'}->{'system-version-tuple'}; 
                 print "Generation: $tuple->{generation}  Major: $tuple->{major}  Minor: $tuple->{minor} \n";
                 $output = $s->quota_status_iter('query' => { 'quota-status-attributes' => {'volume' => 'vol0'}} ); # nested parameters as hashes of hashes
                 print "Quota Status: $output->{'attributes-list'}->{'quota-status-attributes'}->{'status'} \n";
         };
         if($@) { # check for any exception
                 my ($error_reason, $error_code) = $@ =~ /(.+)\s\((\d+)\)/;  # parse out error reason and error code
                 print "Error Reason: $error_reason  Code: $error_code\n"
         }


DESCRIPTION

NetApp Manageability SDK 5.2.1 provides support for Perl API bindings for both Data ONTAP APIs and OnCommand Unified Manager APIs. The Perl API bindings libraries contain interfaces to establish a connection with either the Data ONTAP server or the OnCommand Unified Manager server. By using these libraries, you can create Perl applications to access and manage the Data ONTAP server or OnCommand Unified Manager server.

NetApp Manageability SDK 5.2.1 Perl API bindings provide a runtime library NaServer.pm, which is available at <installation_folder>/lib/perl/NetApp. This library file enables you to establish a server connection, send requests and receive responses, and interpret error messages. Each binding can be called as a subroutine of NaServer module which in turn invokes the corresponding Data ONTAP or OnCommand Unified Manager API.


API BINDINGS

active_directory_account_create

[Family: vserver]

Create an Active Directory account for the given Vserver. If a CIFS server already exists for the requested Vserver, then this command will fail. The existing CIFS server should be deleted before retrying again.

Inputs

Outputs

active_directory_account_delete

[Family: vserver]

Delete the Active Directory account. If a CIFS server already exists for the requested Vserver, cifs-server-delete API should be used to delete the machine account.

Inputs

Outputs

active_directory_account_get_iter

[Family: cluster, vserver]

Retrieve the list of active directory accounts

Inputs

Outputs

active_directory_account_modify

[Family: vserver]

Modify the Windows Active Directory domain. If a CIFS server already exists for the requested Vserver, cifs-server-modify API should be used to modify the Windows Active Directory domain.

Inputs

Outputs

active_directory_account_password_change

[Family: vserver]

Generate a new password for the machine account and change it in the Windows Active Directory domain.

Inputs

Outputs

active_directory_account_password_reset

[Family: vserver]

Reset the machine account password in the Windows Active Directory domain. This may be required if the password stored along with the machine account in the Windows Active Directory domain is changed or reset without the Vserver's knowledge. This operation requires the credentials for a user with permission to reset the password in the organizational unit (OU) that the machine account is a member of.

Inputs

Outputs

aggr_add

[Family: cluster]

Add disks to the specified aggregate, whether it is free-standing or embedded in a traditional volume. The disks to add are specified in the same way as for "aggr-create". Disks cannot be added to a mirrored aggregate if one or more of the plexes is offline. By the time the API returns, the disk(s) may not yet be completely added. Use 'aggr-list-info' to query the aggregate status to determine when it has finished growing due to the added disk(s). Same can be done using 'aggr-get-iter' when requested from Admin Vserver LIF. When the upgrade-64bit-mode input is provided to this API, the API produces a set of results in the background. These results are not available as output from aggr-add. Use the 'aggr-list-info' and 'volume-list-info' APIs to query the results of the 64-bit upgrade process on the aggregate and flexible volumes, respectively.

Inputs

Outputs

aggr_check_spare_low

[Family: cluster]

Return true if there is no suitable spare disk available for any filesystem (parity or data) disk.

Inputs

Outputs

aggr_create

[Family: cluster]

Create a new aggregate with the given name. Up to 200 aggregates can be created on each filer (including the aggregates that are "embedded" in traditional volumes, which must be created as a side effect of a traditional volume creation). The aggregate may not yet be operational immediately after the API returns. Use 'aggr-list-info' to query the status of the newly-created aggregate to determine when it is fully operational. Same can be done using 'aggr-get-iter' when requested from Admin Vserver LIF. NOTE: If ECANT_USE_ALL_DISKS is returned, then the requested aggregate was indeed created, just not with all the disks that were specified.

Inputs

Outputs

aggr_destroy

[Family: cluster]

Destroys the specified aggregate or plex. If an aggregate is specified, all plexes in the aggregate are destroyed. If the aggregate is embedded in a traditional volume, then the entire traditional volume is destroyed. If a plex is specified, only that plex is destroyed, leaving an unmirrored aggregate containing the remaining plex. The disks in the destroyed object become spare disks. Only offline aggregates and plexes can be destroyed. Note: Offline aggregates will be destroyed even if they contain one or more flexible volumes, which should not typically be the case. From cluster interface only aggregates are supported and plexes are not supported.

Inputs

Outputs

aggr_get_filer_info

[Family: cluster]

Get information on what possibilities and parameters exist for aggregates on a given filer.

Inputs

Outputs

aggr_get_iter

[Family: cluster]

Iterate over a list of aggrgate objects.

Inputs

Outputs

aggr_mirror

[Family: cluster]

Turns an unmirrored aggregate into a mirrored aggregate by adding a plex to it. The plex is either newly formed from disks chosen from a spare pool or, if the "victim-aggregate" option is specified, taken from another existing unmirrored aggregate. The named aggregate must currently be unmirrored. Disks may be specified explicitly using the "mirror-disks" list option in the same way as with the "aggr-create" and "aggr-add" commands. The number of disks indicated must match the number present in the existing aggregate. If disks are not specified explicitly, then disks are automatically selected to match those in the aggregate's existing plex.

Inputs

Outputs

aggr_modify_raid_type

[Family: cluster]

Modify the RAID type for the given aggregate to the specified "raid-type". This API can also selectively change the RAID type of specific raid groups in the aggregate based on the specified "disk-type". The change remains effective even if the filer is rebooted. This API does not support modifying options of a striped aggregate.

Inputs

Outputs

aggr_offline

[Family: cluster]

Take the specified aggregate or plex offline. The operation takes effect before the API returns. Except in maintenance mode, the current root aggregate may not be taken offline. An aggregate marked to become the root aggregate cannot be taken offline. An aggregate containing one or more flexible volumes cannot be taken offline; its contained volumes must first be destroyed. A number of operations being performed on the given aggregate can prevent this operation from succeeding, either at all or for various lengths of time. If such operations are found, the system waits up to one second for them to finish. If they don't, the command is aborted. A check is also made for files in the aggregate opened by internal ONTAP processes. The command is aborted if any are found.

Inputs

Outputs

aggr_online

[Family: cluster]

Bring the specified aggregate or plex online. This command takes effect immediately. All volumes on the aggregate are brought to whatever state they were in before the aggregate was restricted or taken offline. If there are CIFS shares associated with the any of the aggregate's volumes that were also onlined, they are enabled.

Inputs

Outputs

aggr_options_list_info

[Family: cluster]

Get the options that have been set for the specified aggregate. This API does not support listing options of striped aggregate.

Inputs

Outputs

aggr_relocation

[Family: cluster]

Aggregate Relocation

Inputs

Outputs

aggr_relocation_status

[Family: cluster]

Iterate over the list of aggregate relocation status

Inputs

Outputs

aggr_rename

[Family: cluster]

Rename the specified aggregate.

Inputs

Outputs

aggr_restrict

[Family: cluster]

Restrict the specified aggregate. If the aggregate is embedded in a traditional volume, the entire traditional volume will be restricted. An aggregate with one or more flexible volumes cannot be restricted; all of its contained volumes must first be destroyed.

Inputs

Outputs

aggr_scrub_list_info

[Family: cluster]

Get the status of parity scrubbing on the named aggregate. Status includes percentage complete and the scrub's suspended status (if appropriate). If no name is given, then status is generated for all RAID groups.

Inputs

Outputs

aggr_scrub_resume

[Family: cluster]

Resume parity scrubbing on the named aggregate, plex, or RAID group. If no name is given, then resume parity scrubbing on all RAID groups for which it has been suspended. Use "aggr-scrub-list-info" to check scrubbing status.

Inputs

Outputs

aggr_scrub_start

[Family: cluster]

Start parity scrubbing on the named aggregate, plex, or RAID group. Parity scrubbing compares the data disks to the parity disk in a RAID group, correcting the parity disk's contents as necessary. If no name is given, then parity scrubbing is started on all online aggregates. If an aggregate name is given, scrubbing is started on all RAID groups in the aggregate. If a plex name is given, scrubbing is started on all RAID groups contained in the plex. If a RAID group name is given, scrubbing is started only on that group. Use "aggr-scrub-list-info" to check scrubbing status.

Inputs

Outputs

aggr_scrub_stop

[Family: cluster]

Stop parity scrubbing on the named aggregate, plex, or RAID group. If no name is given, scrubbing will stop on all RAID groups currently being scrubbed. Use "aggr-scrub-list-info" to check scrubbing status.

Inputs

Outputs

aggr_scrub_suspend

[Family: cluster]

Suspend parity scrubbing on the named aggregate, plex, or RAID group. If no name is given, suspend scrubbing on all RAID groups currently being scrubbed. Use "aggr-scrub-list-info" to check scrubbing status.

Inputs

Outputs

aggr_set_option

[Family: cluster]

Set the specified option for the given aggregate to "option-value". The change remains effective even if the filer is rebooted. Some options have values that are numbers, and some have values that are "on" (also expressible as "yes", "true", or "1" ) or "off" (also expressible as "no", "false", or "0"). A mixture of uppercase and lowercase characters may be used when typing an option's value. Note that the "root" option is special in that it doesn't have a corresponding value. This API does not support modifying options of striped aggregate.

Inputs

Outputs

aggr_verify_list_info

[Family: cluster]

Get the status of RAID mirror verification on the named aggregate. Status includes percentage complete and whether it's currently suspended.

Inputs

Outputs

aggr_verify_resume

[Family: cluster]

Resume RAID mirror verification on the named aggregate. If no name is given, then resume mirror verification on all aggregates that have been suspended.

Inputs

Outputs

aggr_verify_start

[Family: cluster]

Start RAID mirror verification on the named aggregate. Verification compares the data in both plexes of a mirrored aggregate. In the default case, any blocks that differ are logged and no changes are made. The fix-plex option is used to fix any mismatches. It specifies which plex to fix. If no name is given, then mirror verification is started on all online aggregates. Use the "aggr-verify-list-info" API to check mirror verification status. If the fix-plex option is used, then a name must be specified.

Inputs

Outputs

aggr_verify_stop

[Family: cluster]

Stop RAID mirror verification on the named aggregate. If no name is given, stop mirror verification on all aggregates currently being verified.

Inputs

Outputs

aggr_verify_suspend

[Family: cluster]

Suspend RAID mirror verification on the named aggregate. If no name is given, suspend mirror verification on all aggregates currently being verified.

Inputs

Outputs

av_get_engine_info

[Family: cluster]

This gets the attributes of the Anti-Virus engine installed.

Inputs

Outputs

av_get_engine_options

[Family: cluster]

Get the attributes of the antivirus.

Inputs

Outputs

av_get_log

[Family: cluster]

Get the attributes of the antivirus.

Inputs

Outputs

av_get_remedy_info

[Family: cluster]

This gets the remedy information of the Anti-Virus engine installed. i.e. what to do when a virus is found.

Inputs

Outputs

av_get_version_info

[Family: cluster]

This gets the version information of the Anti-Virus engine installed.

Inputs

Outputs

av_log_iter

[Family: cluster]

Iterate over a list of antivirus objects.

Inputs

Outputs

av_set_engine_info

[Family: cluster]

This sets the attributes of the Anti-Virus engine installed. If an optional attribute is not specified, the current value is left unchanged.

Inputs

Outputs

av_set_engine_options

[Family: cluster]

Modify the attributes of antivirus object.

Inputs

Outputs

av_set_log

[Family: cluster]

Create a new antivirus.

Inputs

Outputs

av_set_remedy_info

[Family: cluster]

This sets the quarantine information of the Anti-Virus engine installed. If an optional attribute is not specified, the current value is left unchanged.

Inputs

Outputs

av_set_version_info

[Family: cluster]

This sets the version information of the Anti-Virus engine installed. If an optional attribute is not specified, the current value is left unchanged.

Inputs

Outputs

av_start_update

[Family: cluster]

Run an Anti-Virus Update job immediately

Inputs

Outputs

audit_get

[Family: cluster]

Get the cluster administrative audit settings

Inputs

Outputs

audit_modify

[Family: cluster]

Modify the cluster administrative audit settings

Inputs

Outputs

autosupport_budget_get

[Family: cluster]

Get AutoSupport time and size limits for the given node and subsystem.

Inputs

Outputs

autosupport_budget_get_iter

[Family: cluster]

Get AutoSupport time and size limits per subsystem for all nodes.

Inputs

Outputs

autosupport_budget_get_total_records

[Family: cluster]

Return the total number of records.

Inputs

Outputs

autosupport_budget_modify

[Family: cluster]

Modify AutoSupport time and size limits per subsystem.

Inputs

Outputs

autosupport_compliant_get

[Family: cluster]

Get AutoSupport compliance hash mapping

Inputs

Outputs

autosupport_compliant_get_iter

[Family: cluster]

Get AutoSupport compliance hash mapping

Inputs

Outputs

autosupport_compliant_get_total_records

[Family: cluster]

Return the total number of records.

Inputs

Outputs

autosupport_config_get

[Family: cluster]

Get AutoSupport configuration settings for the given node.

Inputs

Outputs

autosupport_config_get_iter

[Family: cluster]

Get AutoSupport configuration settings for all nodes.

Inputs

Outputs

autosupport_config_get_total_records

[Family: cluster]

Return the total number of records.

Inputs

Outputs

autosupport_config_modify

[Family: cluster]

Modify AutoSupport configuration settings for the given node.

Inputs

Outputs

autosupport_destinations_get

[Family: cluster]

Get the list of AutoSupport destinations for the given node.

Inputs

Outputs

autosupport_destinations_get_iter

[Family: cluster]

Get the list of AutoSupport destinations for all nodes.

Inputs

Outputs

autosupport_destinations_get_total_records

[Family: cluster]

Return the total number of records. This sould be equal to the number of nodes in the cluster.

Inputs

Outputs

autosupport_history_get

[Family: cluster]

Get a history record for the given AutoSupport.

Inputs

Outputs

autosupport_history_get_iter

[Family: cluster]

Get the history records for the last 50 AutoSupport messages.

Inputs

Outputs

autosupport_history_get_total_records

[Family: cluster]

Return the total number of records.

Inputs

Outputs

autosupport_history_retransmit

[Family: cluster]

Selectively retransmit a previously collected AutoSupport message.

Inputs

Outputs

autosupport_invoke

[Family: cluster]

Generate a new AutoSupport message

Inputs

Outputs

autosupport_manifest_get_iter

[Family: cluster]

Get a detailed manifest for the contents of an AutoSupport.

Inputs

Outputs

autosupport_manifest_get_total_records

[Family: cluster]

Return the total number of records.

Inputs

Outputs

autosupport_trigger_get

[Family: cluster]

Get the AutoSupport trigger data for the given node and EMS message.

Inputs

Outputs

autosupport_trigger_get_iter

[Family: cluster]

Get a list of the AutoSupport trigger data for all nodes.

Inputs

Outputs

autosupport_trigger_get_total_records

[Family: cluster]

Return the total number of records.

Inputs

Outputs

autosupport_trigger_modify

[Family: cluster]

Modify the AutoSupport trigger data for the given node and EMS message.

Inputs

Outputs

cf_aggregate_giveback_status

[Family: cluster]

Returns giveback status of all the aggregates in the cluster which are taken over or were given back.

Inputs

Outputs

cf_force_takeover

[Family: cluster]

Forces one filer to take over its partner even though the filer detects an error that would otherwise prevent a takeover. For example, normally, if a detached or faulty interconnect cable between the filers causes the filers' NVRAM contents to be unsynchronized, takeover is disabled. However, this will allow the filer to take over its partner despite the unsynchronized NVRAM contents. cf-force-takeover is dangerous and can lead to data corruption; in almost all cases, use cf-takeover instead.

Inputs

Outputs

cf_get_iter

[Family: cluster]

Iterate over a list of cf objects.

Inputs

Outputs

cf_get_partner

[Family: cluster]

Get the host name of the partner. If the name is unknown, It will return partner-unknown.

Inputs

Outputs

cf_giveback

[Family: cluster]

Initiates a giveback of partner resources. Once the giveback is complete, the automatic takeover capability is disabled until the partner is rebooted. A giveback fails if outstanding CIFS sessions, active system dump processes, or other filer operations makes a giveback dangerous or disruptive.

Inputs

Outputs

cf_hwassist_stats

[Family: cluster]

Get useful information about statistics of hardware assisted takeover functionality.

Inputs

Outputs

cf_hwassist_stats_clear

[Family: cluster]

Get useful information about stats of hw_assist functionality.

Inputs

Outputs

cf_hwassist_status

[Family: cluster]

Get useful information about the status of hw_assist functionality.

Inputs

Outputs

cf_hwassist_test

[Family: cluster]

Validates the hardware-assisted takeover configuration. functionality.

Inputs

Outputs

cf_modify_iter

[Family: cluster]

Modify the attributes of cf or a group of cf objects.

Inputs

Outputs

cf_service_disable

[Family: cluster]

Disables the takeover capability of this filer in the cluster.

Inputs

Outputs

cf_service_enable

[Family: cluster]

Enables the takeover capability of this filer in the cluster. This spawns a process to enable the service

Inputs

Outputs

cf_status

[Family: cluster]

Get useful information about the status of the clustering service. If the monitor is not initialized, this returns an error.

Inputs

Outputs

cf_takeover

[Family: cluster]

Initiates a takeover of the storage partner. Takeover is done asynchronously; status may be monitored by calling the cf-status API and examining the state field. If automatic giveback is enabled then control will be returned to storage partner once it boots up.

Inputs

Outputs

cf_takeover_status

[Family: cluster]

Get the takeover status of a node and the takeover status of all its partner aggregates, for all nodes in a cluster.

Inputs

Outputs

cg_commit

[Family: vserver]

Commits the snapshots that were started during the preceeding cg-start call that returned the cg-id key, and unfences the volumes that were fenced. If cg-commit API times out, then it means that either too many volumes were specified to the cg-start api or the timeout value for the cg-start api was very small. In this situation, the caller should try to perform the cg-start operation by specifying lesser volumes or by specifying higher timeout value.

Inputs

Outputs

cg_start

[Family: vserver]

Starts the checkpoint cycle for externally synchronized checkpoints in the filer. This operation fences the specified volumes and returns "success" (if successful). If the API returns "success", the call starts a snapshot create operation in these volumes. If the API returns "success", this operation SHOULD be followed by a call to cg-commit (below).

This API is not supported on Infinite Volume.

Inputs

Outputs

cifs_branchcache_create

[Family: vserver]

Create and setup the BranchCache service.

Inputs

Outputs

cifs_branchcache_flush

[Family: vserver]

Flush (delete) all the BranchCache hashes that have been generated for a Vserver.

Inputs

Outputs

cifs_branchcache_get

[Family: vserver]

Retrieve information about the BranchCache service.

Inputs

Outputs

cifs_branchcache_get_iter

[Family: cluster, vserver]

Retrieve the per-Vserver BranchCache configurations for the cluster.

Inputs

Outputs

cifs_branchcache_hash

[Family: vserver]

Force the generation of BranchCache hashes for a file or path.

Inputs

Outputs

cifs_branchcache_modify

[Family: vserver]

Modify the CIFS BranchCache service settings

Inputs

Outputs

cifs_branchcache_remove

[Family: vserver]

Remove the BranchCache service

Inputs

Outputs

cifs_domain_discovered_servers_get_iter

[Family: cluster, vserver]

Retrieve the list of servers discovered by the cluster.

Inputs

Outputs

cifs_domain_discovered_servers_reset

[Family: vserver]

Command to trigger re-discovery of servers.

Inputs

Outputs

cifs_domain_name_mapping_search_add

[Family: vserver]

Add to the list of trusted domains for name-mapping search

Inputs

Outputs

cifs_domain_name_mapping_search_get_iter

[Family: cluster, vserver]

Retrieve the list of trusted domains for name-mapping search.

Inputs

Outputs

cifs_domain_name_mapping_search_modify

[Family: vserver]

Modify the list of trusted domains for name-mapping search

Inputs

Outputs

cifs_domain_name_mapping_search_remove

[Family: vserver]

Remove from the list of trusted domains for name-mapping search

Inputs

Outputs

cifs_domain_preferred_dc_add

[Family: vserver]

Add to a list of preferred domain controllers

Inputs

Outputs

cifs_domain_preferred_dc_get_iter

[Family: cluster, vserver]

Retrieve the list of preferred domain controllers associated with Active Directory domains.

Inputs

Outputs

cifs_domain_preferred_dc_remove

[Family: vserver]

Remove from a list of preferred domain controllers

Inputs

Outputs

cifs_domain_trusts_get_iter

[Family: cluster, vserver]

Retrieve the list of discovered trusted domains.

Inputs

Outputs

cifs_domain_trusts_rediscover

[Family: vserver]

Command to trigger re-discovery of trusted domains.

Inputs

Outputs

cifs_home_directory_search_path_add

[Family: vserver]

Add a path to the list of paths that will be searched to find a CIFS user's home directory.

Inputs

Outputs

cifs_home_directory_search_path_delete

[Family: vserver]

Remove a home directory search path.

Inputs

Outputs

cifs_home_directory_search_path_get_iter

[Family: cluster, vserver]

Iterate over a list of cifs-home-directory-search-path objects.

Inputs

Outputs

cifs_home_directory_search_path_remove

[Family: vserver]

Remove a home directory search path.

Inputs

Outputs

cifs_home_directory_search_path_reorder

[Family: vserver]

Change the position of this path in the list of paths that will be searched to find a CIFS user's home directory.

Inputs

Outputs

cifs_local_group_create

[Family: vserver]

Create a single local group

Inputs

Outputs

cifs_local_group_delete

[Family: vserver]

Delete a single local group

Inputs

Outputs

cifs_local_group_get_iter

[Family: cluster, vserver]

Retrieve the list of local groups

Inputs

Outputs

cifs_local_group_members_add_members

[Family: vserver]

Add local users or Active Directory users or groups to a local group

Inputs

Outputs

cifs_local_group_members_get_iter

[Family: cluster, vserver]

Retrieve the list of local group members

Inputs

Outputs

cifs_local_group_members_remove_members

[Family: vserver]

Remove local users or Active Directory users or groups from a local group

Inputs

Outputs

cifs_local_group_modify

[Family: vserver]

Modify a description of a single local group

Inputs

Outputs

cifs_local_group_rename

[Family: vserver]

Rename a local group

Inputs

Outputs

cifs_local_user_create

[Family: vserver]

Configure and create a local user, associated with a Vserver

Inputs

Outputs

cifs_local_user_delete

[Family: vserver]

Delete a single local user

Inputs

Outputs

cifs_local_user_get_iter

[Family: cluster, vserver]

Retrieve the list of local users

Inputs

Outputs

cifs_local_user_membership_get_iter

[Family: cluster, vserver]

Retrieve local users' membership information

Inputs

Outputs

cifs_local_user_modify

[Family: vserver]

Modify a single local user

Inputs

Outputs

cifs_local_user_rename

[Family: vserver]

Rename a local user

Inputs

Outputs

cifs_local_user_set_password

[Family: vserver]

Set password for a local user

Inputs

Outputs

cifs_nbtstat_get_iter

[Family: cluster, vserver]

Retrieve the NetBIOS Name Service statistics for Vservers in cluster.

Inputs

Outputs

cifs_options_get_iter

[Family: cluster, vserver]

Iterate over a list of cifs-options objects.

Inputs

Outputs

cifs_options_modify

[Family: vserver]

Modify the attributes of cifs-options object.

Inputs

Outputs

cifs_password_change

[Family: vserver]

Generate a new password for the CIFS server's machine account and change it in the Windows Active Directory domain.

Inputs

Outputs

cifs_password_reset

[Family: vserver]

Reset the CIFS server's machine account password in the Windows Active Directory domain. This may be required if the password stored along with the machine account in the Windows Active Directory domain is changed or reset without the Vserver's knowledge. This operation requires the credentials for a user with permission to reset the password in the organizational unit (OU) that the machine account is a member of.

Inputs

Outputs

cifs_privilege_add_privilege

[Family: vserver]

Add privileges to a local or Active Directory user or group

Inputs

Outputs

cifs_privilege_get_iter

[Family: cluster, vserver]

Retrieve the list of local groups

Inputs

Outputs

cifs_privilege_remove_privilege

[Family: vserver]

Remove privileges from a local or Active Directory user or group

Inputs

Outputs

cifs_privilege_reset_privilege

[Family: vserver]

Reset privileges for a local or Active Directory user or group

Inputs

Outputs

cifs_security_get_iter

[Family: cluster, vserver]

Iterate over a list of cifs-security objects.

Inputs

Outputs

cifs_security_modify

[Family: vserver]

Modify the attributes of cifs-security object.

Inputs

Outputs

cifs_server_create

[Family: vserver]

Configure and setup CIFS services on a Vserver.

Inputs

Outputs

cifs_server_delete

[Family: vserver]

Delete a CIFS server. If the admin-username and admin-password are not specified, the CIFS server's machine account will not be deleted from the Windows Active Directory domain. The deletion of the CIFS server will also delete the CIFS shares associated with it.

Inputs

Outputs

cifs_server_get_iter

[Family: cluster, vserver]

Retrieve the list of CIFS servers on the cluster and their basic configurations.

Inputs

Outputs

cifs_server_modify

[Family: vserver]

Modify the basic configurations of a CIFS server.

Inputs

Outputs

cifs_server_start

[Family: vserver]

Start a CIFS server on the specified Vserver. The CIFS server must already exist. To create a CIFS server, use cifs-server-create.

Inputs

Outputs

cifs_server_stop

[Family: vserver]

Stop a CIFS server on the specified Vserver. Note that established sessions will be terminated and their open files closed. Workstations with cached data will not be able to save those changes, which could result in data loss.

Inputs

Outputs

cifs_session_file_get_iter

[Family: cluster, vserver]

Retrieve the list of the opened CIFS files.

Inputs

Outputs

cifs_session_get_iter

[Family: cluster, vserver]

Retrieve the list of the established CIFS sessions.

Inputs

Outputs

cifs_share_access_control_create

[Family: vserver]

Add permissions for a user or group for a defined CIFS share.

Inputs

Outputs

cifs_share_access_control_delete

[Family: vserver]

Remove permissions for a user or group on a defined CIFS share.

Inputs

Outputs

cifs_share_access_control_get_iter

[Family: cluster, vserver]

Retrieve the list of permissions on defined CIFS shares.

Inputs

Outputs

cifs_share_access_control_modify

[Family: vserver]

Modify the permissions for a user or group on a defined CIFS share.

Inputs

Outputs

cifs_share_create

[Family: vserver]

Creates a new CIFS share rooted at the specified path.

Inputs

Outputs

cifs_share_delete

[Family: vserver]

Deletes the specified CIFS share.

Inputs

Outputs

cifs_share_get_iter

[Family: cluster, vserver]

Gives information about one or more CIFS shares.

Inputs

Outputs

cifs_share_modify

[Family: vserver]

Modifies settings of a CIFS share, even if the shares are in use.

Inputs

Outputs

cifs_symlink_create

[Family: vserver]

Create a new CIFS symbolic link path mapping from a UNIX symlink to a target CIFS path. This symbolic link path mapping will be effective on symbolic links that have a prefix match with the value of 'unix-path'. e.g.: if the value of 'unix-path' is '/usr/local/' and there exists a symbolic link on the file system at '/home/user/link' which points to '/usr/local/share/dest'. If a CIFS client accesses the symbolic link 'link', this entry of path mapping would have a prefix match '/usr/local/'. The CIFS client would be redirected to the location pointed to by this path mapping's 'cifs-server', 'share-name' and 'cifs-path' fields.

Inputs

Outputs

cifs_symlink_delete

[Family: vserver]

Delete a CIFS symbolic link path mapping.

Inputs

Outputs

cifs_symlink_get_iter

[Family: cluster, vserver]

Retrieve the list of CIFS symbolic link path mappings.

Inputs

Outputs

cifs_symlink_modify

[Family: vserver]

Modify a CIFS symbolic link path mapping parameters.

Inputs

Outputs

clock_get_timezone

[Family: cluster]

Gets current timezone and timezone file version.

Inputs

Outputs

clone_autodelete

[Family: vserver]

Set autodelete on a lun clone.

Inputs

Outputs

clone_create

[Family: vserver]

Create a file/sub file or LUN/sub LUN clone.

Inputs

Outputs

cluster_identity_get

[Family: cluster]

Returns the cluster identity information.

Inputs

Outputs

cluster_identity_modify

[Family: cluster]

Modifies the cluster identity information.

Inputs

Outputs

cluster_node_get

[Family: cluster]

Returns information about a node in a cluster.

Inputs

Outputs

cluster_node_get_iter

[Family: cluster]

Returns information about nodes in a cluster.

Inputs

Outputs

cluster_node_modify

[Family: cluster]

Modifies state of a node in a cluster.

Inputs

Outputs

cluster_peer_create

[Family: cluster]

Create a cluster peer relationship

Inputs

Outputs

cluster_peer_delete

[Family: cluster]

Delete a cluster peer relationship

Inputs

Outputs

cluster_peer_get

[Family: cluster]

Return the specified peer cluster relationship information

Inputs

Outputs

cluster_peer_get_iter

[Family: cluster]

Returns a list of cluster peer relationships

Inputs

Outputs

cluster_peer_health_info_get

[Family: cluster]

Get the health of the specified peer node

Inputs

Outputs

cluster_peer_health_info_get_iter

[Family: cluster]

Get the health of all local and peer nodes sequentially

Inputs

Outputs

cluster_peer_modify

[Family: cluster]

Modifies a cluster peer relationship

Inputs

Outputs

cluster_peer_ping_iter

[Family: cluster]

Ping the specified peer nodes. Ping operations take place between a node in a cluster and a node in a remote cluster. The originating node is the node which initiates the ping operation and the destination cluster and node specify the remote node which is the target of the ping.

Inputs

Outputs

config_backup_copy

[Family: cluster]

Copy a configuration backup. A job will be queued to copy the configuration backup. A job will be spawned to operate on the config-backup and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

config_backup_create

[Family: cluster]

Create a configuration backup. A job will be queued to create the configuration backup in the background. Creation of configuration backup may take several minutes. This ZAPI creates an on demand backup. A job will be spawned to operate on the config-backup and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

config_backup_delete

[Family: cluster]

Delete a configuration backup.

Inputs

Outputs

config_backup_download

[Family: cluster]

Download a configuration backup from a URL.

Inputs

Outputs

config_backup_info_get

[Family: cluster]

Return information about a specified configuration backup.

Inputs

Outputs

config_backup_info_get_iter

[Family: cluster]

Return a list of configuration backups in the cluster.

Inputs

Outputs

config_backup_rename

[Family: cluster]

Rename a configuration backup. Renamed backup stays on the same node.

Inputs

Outputs

config_backup_settings_get

[Family: cluster]

Return information about the configuration backup settings.

Inputs

Outputs

config_backup_settings_modify

[Family: cluster]

Modify the settings for configuration backup operations.

Inputs

Outputs

config_backup_settings_password_set

[Family: cluster]

Modify the password for destination URL.

Inputs

Outputs

config_backup_upload

[Family: cluster]

Upload a configuration backup to a URL.

Inputs

Outputs

dashboard_alarm_get

[Family: cluster]

Get alarm monitoring data for the given node object.

Inputs

Outputs

dashboard_alarm_get_iter

[Family: cluster]

Get alarm monitoring data for all objects in the cluster.

Inputs

Outputs

dashboard_alarm_get_total_records

[Family: cluster]

Return the total number of records.

Inputs

Outputs

dashboard_alarm_threshold_get

[Family: cluster]

Get alarm threshold settings for the given metric group.

Inputs

Outputs

dashboard_alarm_threshold_get_iter

[Family: cluster]

Get alarm threshold settings for all metric groups.

Inputs

Outputs

dashboard_alarm_threshold_get_total_records

[Family: cluster]

Return the total number of records.

Inputs

Outputs

dashboard_alarm_threshold_modify

[Family: cluster]

Modify alarm threshold settings for the given metric group.

Inputs

Outputs

diagnosis_alert_definition_get

[Family: cluster]

Return alert definition

Inputs

Outputs

diagnosis_alert_definition_get_iter

[Family: cluster]

Iterate over a list of Alert Definition objects.

Inputs

Outputs

diagnosis_alert_get

[Family: cluster]

Return a subsystem alert

Inputs

Outputs

diagnosis_alert_get_iter

[Family: cluster]

Iterate over a list of Alert Information objects.

Inputs

Outputs

diagnosis_alert_modify

[Family: cluster]

Acknowledge/suppress an alert

Inputs

Outputs

diagnosis_config_get

[Family: cluster]

Return the system health framework configuration

Inputs

Outputs

diagnosis_config_get_iter

[Family: cluster]

Iterate over a list of Health Monitor Configuration objects.

Inputs

Outputs

diagnosis_delete_alert

[Family: cluster]

Delete subsystem alert

Inputs

Outputs

diagnosis_policy_definition_get

[Family: cluster]

Return policy definition

Inputs

Outputs

diagnosis_policy_definition_get_iter

[Family: cluster]

Iterate over a list of Policy Definition objects.

Inputs

Outputs

diagnosis_policy_modify

[Family: cluster]

Enable/disable policy

Inputs

Outputs

diagnosis_status_get

[Family: cluster]

Return the overall system health

Inputs

Outputs

diagnosis_subscriptions_create

[Family: cluster]

Create a new Subscriptions for Notifications.

Inputs

Outputs

diagnosis_subscriptions_get

[Family: cluster]

Return system health subscription

Inputs

Outputs

diagnosis_subscriptions_get_iter

[Family: cluster]

Iterate over a list of Subscriptions for Notifications objects.

Inputs

Outputs

diagnosis_subscriptions_modify

[Family: cluster]

Modify system health subscription

Inputs

Outputs

diagnosis_subsystem_config_get

[Family: cluster]

Get the attributes of the Health Monitor Subsystem Status.

Inputs

Outputs

diagnosis_subsystem_config_get_iter

[Family: cluster]

Iterate over a list of Health Monitor Subsystem Status objects.

Inputs

Outputs

disk_fail

[Family: cluster]

Fail a file system disk. Removes the specified file system disk from the RAID configuration, spinning the disk down when removal is complete. disk fail is used to remove a file system disk that may be logging excessive errors and requires replacement. Note that if optional input parameter 'is-immediate' is true, the specified disk will be immediately failed out, and the RAID group to which the disk belongs will enter degraded mode (meaning a disk is missing from the RAID group). If a spare disk at least as large as the disk being removed is available, the contents of the disk being removed will be reconstructed onto that spare disk. If 'is-immediate' options is false or not specified, system will prefail the disk and its content will be copied to a replacement disk if a suitable spare disk is available, and afterwards the prefailed disk will be failed out. This process can be observed by polling disk-list-info for this disk and tracking values of elements copy-destination and copy-percent. Same can be done using 'storage-disk-get-iter' when requested from Admin Vserver LIF. The disk being failed is marked as ``broken'', so that if it remains in the disk shelf, it will not be used by the filer as a spare disk. If the disk is moved to another filer, that filer will use it as a spare. This is not a recommended course of action, as the reason that the disk was failed may have been because it needed to be replaced. NOTE: Data ONTAP 7.0 and earlier releases don't indicate failure code properly.

Inputs

Outputs

disk_remove

[Family: cluster]

Remove a spare disk. Removes the specified spare disk from the RAID configuration, spinning the disk down when removal is complete. You can use disk remove to remove a spare disk so that it can be used by another filer (as a replacement for a failed disk or to expand file system space). NOTE: Data ONTAP 7.0 and earlier releases don't indicate failure code properly.

Inputs

Outputs

disk_sanown_assign

[Family: cluster]

Assigns ownership of a disk. The normal usage is when the disk is unowned, or to assign a disk to a pool.

Inputs

Outputs

disk_sanown_filer_list_info

[Family: cluster]

Get sanown filer information.

Inputs

Outputs

disk_sanown_list_info

[Family: cluster]

Get sanown disk information.

Inputs

Outputs

disk_sanown_reassign

[Family: cluster]

Changes ownership on disks already belonging to an owner.

Inputs

Outputs

disk_sanown_remove_ownership

[Family: cluster]

Removes ownership information on a disk. Default usage is to remove ownership information for all disks owned by the local node, in maintenance mode.

Inputs

Outputs

disk_unfail

[Family: cluster]

Unfail a disk in the broken pool, by clearing its FDR (Failed Disk Registry) entry and unfailing it at the Storage Layer, as necessary. If the "make-spare" option is set to B_TRUE, the disk is returned to the spare pool. Otherwise, label assimilation will bring the disk back according to its on-disk labels, with one of four possible outcomes. 1. Disk becomes a spare. This is the common case. The disk becomes a spare upon unfail, because its parent volume is complete and online. 2. Disk is assimilated into former volume. This is a recovery scenario. The disk is brought back into an existing volume, which may result in this volume coming back online. 3. Disk is assimilated into a new partial volume. This may occur in the rare case that the disk's former volume was destroyed or moved. 4. Disk returned to broken pool. This is the case if a fatal error occurs in process of unfailing the disk.

Inputs

Outputs

disk_update_disk_fw

[Family: cluster]

Start disk firmware download process to update firmware on disks. This operation is asynchronous, and therefore returns no errors that might occur during the download process. This operation will only update firmware on disks that do not have the latest firmware revision. The firmware revision on the disk can be monitored via the disk-list-info API.

Inputs

Outputs

disk_zero_spares

[Family: cluster]

Set up all non-zeroed spares owned by the filer to start zeroing. This operation is asynchronous, and therefore returns no errors that might occur when the zeroing operation actually starts, which could be several seconds after this API operation completes. Zeroing progress can be monitored via the disk-list-info API. Same can be done using 'storage-disk-get-iter' when requested from Admin Vserver LIF. The "zeroing-percent" element of disk-detail-info is returned if disk zeroing has started, and "is-zeroed" returns TRUE once the zeroing has completed (or, if zeroing wasn't necessary in the first place).

Inputs

Outputs

ems_autosupport_log

[Family: vserver]

This API is used by SnapDrive to log SnapDrive specific events occurring on a host system to the the appliance and optionally use the appliance to generate an autosupport message. This event information will be encapsulated in an app.log.x EMS event based on error level. If auto-support is true, an autosupport message will be sent from the filer.

Inputs

Outputs

ems_config_get

[Family: cluster]

Return the EMS Configuration.

Inputs

Outputs

ems_config_modify

[Family: cluster]

Modify the EMS Configuration.

Inputs

Outputs

ems_destination_create

[Family: cluster]

Creates an EMS destination.

Inputs

Outputs

ems_destination_destroy

[Family: cluster]

Deletes the specified EMS destination.

Inputs

Outputs

ems_destination_destroy_iter

[Family: cluster]

Deletes several EMS destinations.

Inputs

Outputs

ems_destination_get

[Family: cluster]

Return the specified EMS destination information.

Inputs

Outputs

ems_destination_get_iter

[Family: cluster]

Return information on EMS destinations.

Inputs

Outputs

ems_destination_modify

[Family: cluster]

Modifies the specified EMS destination.

Inputs

Outputs

ems_destination_modify_iter

[Family: cluster]

Modifies several EMS destinations.

Inputs

Outputs

ems_mail_history_destroy

[Family: cluster]

Delete an individual mail history entry.

Inputs

Outputs

ems_mail_history_destroy_iter

[Family: cluster]

Delete mail history entries.

Inputs

Outputs

ems_mail_history_get

[Family: cluster]

Return an individual mail history entry.

Inputs

Outputs

ems_mail_history_get_iter

[Family: cluster]

Return information mail history.

Inputs

Outputs

ems_message_get

[Family: cluster]

Return an EMS message.

Inputs

Outputs

ems_message_get_iter

[Family: cluster]

Return EMS messages.

Inputs

Outputs

ems_routing_add_destination

[Family: cluster]

Add EMS Destinations.

Inputs

Outputs

ems_routing_get

[Family: cluster]

Return the specified EMS route information.

Inputs

Outputs

ems_routing_get_iter

[Family: cluster]

Return information on several EMS routes.

Inputs

Outputs

ems_routing_modify

[Family: cluster]

Modifies the specified EMS route.

Inputs

Outputs

ems_routing_modify_iter

[Family: cluster]

Modifies several EMS route.

Inputs

Outputs

ems_routing_remove_destination

[Family: cluster]

Remote EMS Destinations.

Inputs

Outputs

ems_snmp_history_destroy

[Family: cluster]

Delete an individual SNMP history entry.

Inputs

Outputs

ems_snmp_history_destroy_iter

[Family: cluster]

Delete SNMP history entries.

Inputs

Outputs

ems_snmp_history_get

[Family: cluster]

Return an individual SNMP history entry.

Inputs

Outputs

ems_snmp_history_get_iter

[Family: cluster]

Return information SNMP history.

Inputs

Outputs

ems_status_get

[Family: cluster]

Return information an EMS message.

Inputs

Outputs

ems_status_get_iter

[Family: cluster]

Return information on EMS messages.

Inputs

Outputs

environment_sensors_get_iter

[Family: cluster]

Returns the sensors information from the environmental subsystem.

Inputs

Outputs

export_policy_create

[Family: vserver]

Create an Export policy configuration.

Inputs

Outputs

export_policy_destroy

[Family: vserver]

Delete an Export policy configuration.

Inputs

Outputs

export_policy_get

[Family: vserver]

Get an Export policy configuration.

Inputs

Outputs

export_policy_get_iter

[Family: cluster, vserver]

Get a group of Export policy configurations.

Inputs

Outputs

export_policy_rename

[Family: vserver]

Rename an Export policy

Inputs

Outputs

export_rule_create

[Family: vserver]

Create an Export rule configuration.

Inputs

Outputs

export_rule_destroy

[Family: vserver]

Delete an Export rule configuration.

Inputs

Outputs

export_rule_get

[Family: vserver]

Get an Export rule configuration.

Inputs

Outputs

export_rule_get_create_defaults

[Family: cluster, vserver]

Obtain the default values for Export rule configuration

Inputs

Outputs

export_rule_get_iter

[Family: cluster, vserver]

Get a group of Export rule configurations.

Inputs

Outputs

export_rule_modify

[Family: vserver]

Modify an Export rule configuration.

Inputs

Outputs

export_rule_set_index

[Family: vserver]

Move a rule to the specified index

Inputs

Outputs

fc_config_adapter_disable

[Family: cluster]

Call the corresponding adapter driver disable function to bring the adapter offline. Under some circumstances an adapter can not be put offline. (e.g. when the adapter is being used by the RAID sub-system to provide disks in a volume). In some cases, manual intervention is required. When this happens, an appropriate error messages is returned.

Inputs

Outputs

fc_config_adapter_enable

[Family: cluster]

Call the corresponding adapter driver enable function to bring the adapter online. Under some circumstances an adapter can not be brought online. (e.g. when that adapter is in the UNCONFIGURED state, or when there is no cable attached to the adapter port). When this happens, an appropriate error messages is returned.

Inputs

Outputs

fc_config_list_info

[Family: cluster]

Iterate over a list of fc objects.

Inputs

Outputs

fc_config_set_adapter_fc_type

[Family: cluster]

fc-config-set-adapter-fc-type changes the adapter driver and/or configuration state. Each configurable adapter has an adapter-type and adapter-state. The adapter-type indicates which driver is attached to the adapter, the adapter-state indicates what the configuration state of the adapter is. The fc-type is used to modify both the adapter-type and the adapter-state. After setting the adapter fc-type a filer reboot is sometimes needed to make the change effective. Use fc-config-list-info to determine if a filer reboot is needed.

Inputs

Outputs

fcp_adapter_config_down

[Family: cluster]

Bring a Fibre Channel target adapter offline. The adapter may not be offline immediately after the call returns, it may take up to a few seconds for the adapter to change state. In Data ONTAP 7-Mode, if the FCP service is not running then all adapters are automatically offlined. They cannot be brought online again until FCP service is started. adapter to change state. In Data ONTAP Cluster-Mode, offlining an adapter will operationally disable all FCP logical interfaces (LIFs) hosted by the adapter.

Inputs

Outputs

fcp_adapter_config_up

[Family: cluster]

Bring a Fibre Channel target adapter online. The adapter may not be online immediately after the call returns, it may take up to a few seconds for the adapter to initialize. In Data ONTAP 7-Mode, if the FCP service is not running then all adapters are automatically offlined. They cannot be brought online again until FCP service is started. In Data ONTAP Cluster-Mode, offlining an adapter will operationally disable all FCP logical interfaces (LIFs) hosted by the adapter.

Inputs

Outputs

fcp_adapter_get_iter

[Family: cluster]

Iterate over the list of physical FC adapters.

Inputs

Outputs

fcp_adapter_set_speed

[Family: cluster]

Sets the speed on the Fibre Channel target adapter. It can be configured to run at 1Gb, 2Gb, 4Gb, or to autonegotiate. Note only 4Gb adapters support the 4Gb speed. If the adapter is online it must be brought offline before setting the speed, and then online in order for a new speed to take effect. This may temporarily disrupt fcp service on the target adapter.

Inputs

Outputs

fcp_adapter_stats_get_iter

[Family: cluster]

Iterate over a list of fcp objects.

Inputs

Outputs

fcp_initiator_get_iter

[Family: cluster, vserver]

List all initiators connected to FCP target LIFs.

Inputs

Outputs

fcp_interface_get_iter

[Family: cluster, vserver]

Iterate over a list of FCP Target Logical Interfaces (LIF).

Inputs

Outputs

fcp_node_get_name

[Family: vserver]

Get the current FCP World Wide Node Name (WWNN). This WWNN name is in the form XX:XX:XX:XX:XX:XX:XX:XX where X is a hexadecimal digit. In Data ONTAP 7-Mode, this is the WWNN of the individual storage system. In "single_image" cfmode, the WWNN of the system and its high availability partner will be the same. In Data ONTAP Cluster-Mode, this is the WWNN of the Vserver FCP Service.

Inputs

Outputs

fcp_node_set_name

[Family: vserver]

Set the current FCP World Wide Node Name (WWNN). This WWNN is in the form XX:XX:XX:XX:XX:XX:XX:XX where X is a hexadecimal digit. The supplied WWNN must also match the vendor's registered namespace unless the force argument is also supplied. In Data ONTAP 7-Mode, the registered namespace is "50:0a:80:8X:XX:XX:XX" and all Fibre Channel adapters must be offline. Changes will take place when the adapters are brought online. In Data ONTAP Cluster-Mode, the registered namespace is "2X:XX:00:a0:98:XX:XX:XX" and the FCP service must be offline. Changes will take place when the service is brought online.

Inputs

Outputs

fcp_port_name_get_iter

[Family: cluster, vserver]

Iterate over the list of valid Fibre Channel target port names on a Vserver's FCP LIFs.

Inputs

Outputs

fcp_port_name_set

[Family: vserver]

Set a valid but unused port name on a Fibre Channel target interface.

Inputs

Outputs

fcp_service_create

[Family: vserver]

Create an FCP Service in a Vserver. Each Vserver requires an online FCP Service in order to serve data via the Fibre Channel protocol.

Inputs

Outputs

fcp_service_destroy

[Family: vserver]

Destroy the FCP Service in a Vserver.

Inputs

Outputs

fcp_service_get_iter

[Family: cluster, vserver]

Iterate over the list of FCP Services.

Inputs

Outputs

fcp_service_start

[Family: vserver]

Starts FCP service. When FCP service is started, the adapters are brought online. Service will be avaliable once the call returns with success. The adapters however, may not be available immediately after the call, it may take up to a few seconds for the adapters to initialize.

Inputs

Outputs

fcp_service_status

[Family: vserver]

Get status of the FCP service, whether or not it is running.

Inputs

Outputs

fcp_service_stop

[Family: vserver]

Stops FCP service. When FCP service is stopped, the adapters are brought offline. Service will be unavaliable once the call returns with success.

Inputs

Outputs

fcp_wwpnalias_get_iter

[Family: cluster, vserver]

Iterate over the list of assigned World Wide Port Name (WWPN) aliases.

Inputs

Outputs

fcp_wwpnalias_remove

[Family: vserver]

Remove an alias for a World Wide Port Name of an initiator. Either the alias or the wwpn argument must be provided.

Inputs

Outputs

fcp_wwpnalias_set

[Family: vserver]

Set an alias for a World Wide Port Name of an initiator that might login to the target.

Inputs

Outputs

fcport_get_link_state

[Family: cluster]

Get the link state of a specific adapter on this system.

Inputs

Outputs

feature_status_list_info

[Family: cluster, vserver]

Returns status information for managed features.

Inputs

Outputs

file_assign_qos

[Family: cluster]

Manage the association of QoS policy group to a specified file. QoS Policy groups define measurable Service Level Objectives (SLOs) that apply to the storage object with which the policy group is associated. In Data ONTAP 8.2 hierarchical QoS is not supported i.e. QoS policy groups cannot be assigned to multiple objects in the file's storage hierarchy - such as the parent LUN, volume or Vserver.

Inputs

Outputs

file_create_directory

[Family: vserver]

Create a directory.

Inputs

Outputs

file_delete_directory

[Family: vserver]

Delete a directory.

Inputs

Outputs

file_delete_file

[Family: vserver]

Delete a file.

Inputs

Outputs

file_get_file_info

[Family: vserver]

Obtains the file information or properties.

Inputs

Outputs

file_get_space_reservation_info

[Family: vserver]

Queries the space reservation settings for the named file.

Inputs

Outputs

file_hole_range_query_iter

[Family: vserver]

Return ranges of holes in a file

Inputs

Outputs

file_list_directory_iter

[Family: vserver]

list of files in a given directory.

Inputs

Outputs

file_punch_hole_iter

[Family: vserver]

Punch hole in the file. Hole punching involves reclaiming of blocks in a file by unallocating them and then direct or indirect blocks can be made to point to 0.

Inputs

Outputs

file_read_file

[Family: vserver]

Read data from a named file. API will fail if length exceeds 1 MB. This API should only be used on normal files. The results for other file types such as LUNs is undefined.

Inputs

Outputs

file_rename_file

[Family: vserver]

Rename a file or directory. Note that this API cannot be used to rename to a different volume.

Inputs

Outputs

file_set_space_reservation_info

[Family: vserver]

Sets the space reservation settings for the named file. is-overwrite-enabled and is-fill-enabled both must be the same value.

Inputs

Outputs

file_truncate_file

[Family: vserver]

Truncate a file. Any data past the truncation point will be lost, of course.

Inputs

Outputs

file_usage_get

[Family: vserver]

Reports unique bytes held in a file.

Inputs

Outputs

file_usage_result_get

[Family: vserver]

Used to poll and retrieve results for a previous file-usage-start call. EINPROGRESS indicates that the background job has not finished yet.

Inputs

Outputs

file_usage_start

[Family: vserver]

Starts a background job to compute unique bytes held in a file. The result can be obtained by passing the cookie to file-usage-result-get call.

Inputs

Outputs

file_write_file

[Family: vserver]

Write data into a named file. If the file does not previously exist, it will be created - the owner of the file will be root and it will not be readable or writable by non-root users. API will fail if data exceeds 1 MB. This API should only be used on normal files. The results for other file types such as LUNs is undefined.

Inputs

Outputs

file_directory_security_get

[Family: vserver]

Returns security information of a file/folder

Inputs

Outputs

file_directory_security_ntfs_create

[Family: vserver]

Creates a new NTFS security descriptor

Inputs

Outputs

file_directory_security_ntfs_dacl_add

[Family: vserver]

Add a discretionary access control entry to NTFS security descriptor.

Inputs

Outputs

file_directory_security_ntfs_dacl_get_iter

[Family: cluster, vserver]

Returns information about one or more discretionary access control entries

Inputs

Outputs

file_directory_security_ntfs_dacl_modify

[Family: vserver]

Modify an discretionary access control entry of a file security descriptor

Inputs

Outputs

file_directory_security_ntfs_dacl_remove

[Family: vserver]

Remove a discretionary access control entry from NTFS security descriptor.

Inputs

Outputs

file_directory_security_ntfs_delete

[Family: vserver]

Deletes an NTFS security descriptor information

Inputs

Outputs

file_directory_security_ntfs_get_iter

[Family: cluster, vserver]

Returns information about one or more NTFS security descriptor

Inputs

Outputs

file_directory_security_ntfs_modify

[Family: vserver]

Modifies an NTFS security descriptor

Inputs

Outputs

file_directory_security_ntfs_sacl_add

[Family: vserver]

Add a system/audit access control entry to NTFS security descriptor.

Inputs

Outputs

file_directory_security_ntfs_sacl_get_iter

[Family: cluster, vserver]

Returns information about one or more system/audit access control entries

Inputs

Outputs

file_directory_security_ntfs_sacl_modify

[Family: vserver]

Modify an system/audit access control entry of a file security descriptor

Inputs

Outputs

file_directory_security_ntfs_sacl_remove

[Family: vserver]

Remove an system/audit access control entry from NTFS security descriptor.

Inputs

Outputs

file_directory_security_policy_create

[Family: vserver]

Creates a new file/folder security policy configuration. To preserve the security configuration of a file(or, folder) or set of files(or, folders) security policy has been defined. Policy is a container for tasks and a task associates a file/folder path name and the security descriptor that needs to be set on the file/folder. Every task in a policy is uniquely identified by the file/folder path. Policy can't have duplicate task entries and there is only one task per path.

Inputs

Outputs

file_directory_security_policy_delete

[Family: vserver]

Deletes a file/folder security policy. To preserve the security configuration of a file(or, folder) or set of files(or, folders) security policy has been defined. Policy is a container for tasks and a task associates a file/folder path name and the security descriptor that needs to be set on the file/folder. Every task in a policy is uniquely identified by the file/folder path. Policy can't have duplicate task entries and there is only one task per path.

Inputs

Outputs

file_directory_security_policy_get_iter

[Family: cluster, vserver]

Returns information about one or more security policies. To preserve the security configuration of a file(or, folder) or set of files(or, folders) security policy has been defined. Policy is a container for tasks and a task associates a file/folder path name and the security descriptor that needs to be set on the file/folder. Every task in a policy is uniquely identified by the file/folder path. Policy can't have duplicate task entries and there is only one task per path.

Inputs

Outputs

file_directory_security_policy_task_add

[Family: vserver]

Add a file security policy task. A task maps security descriptor with a file or folder.

Inputs

Outputs

file_directory_security_policy_task_get_iter

[Family: cluster, vserver]

Returns information about one or more policy tasks. Policy is a container for tasks and a task associates a file/folder path name and the security descriptor that needs to be set on the file/folder. Every task in a policy is uniquely identified by the file/folder path. Policy can't have duplicate task entries and there is only one task per path.

Inputs

Outputs

file_directory_security_policy_task_modify

[Family: vserver]

Modify a file security policy task

Inputs

Outputs

file_directory_security_policy_task_remove

[Family: vserver]

Remove a task from the policy of a vserver.

Inputs

Outputs

file_directory_security_set

[Family: vserver]

Apply security descriptors on files and directories defined in a policy to a Vserver

Inputs

Outputs

fileservice_audit_config_create

[Family: vserver]

Create audit configuration for a Vserver

Inputs

Outputs

fileservice_audit_config_get

[Family: vserver]

Show Audit configuration details for a Vserver

Inputs

Outputs

fileservice_audit_config_get_iter

[Family: cluster, vserver]

Show Audit configuration details for all Vservers

Inputs

Outputs

fileservice_audit_config_get_total_records

[Family: cluster]

Return the total number of records

Inputs

Outputs

fileservice_audit_config_modify

[Family: vserver]

Modify audit configuration for a Vserver

Inputs

Outputs

fileservice_audit_disable

[Family: vserver]

Disable Auditing for specified Vserver

Inputs

Outputs

fileservice_audit_enable

[Family: vserver]

Enable Auditing for specified Vserver

Inputs

Outputs

fileservice_audit_remove

[Family: vserver]

Disable Audit Configuration for specified vserver

Inputs

Outputs

fileservice_audit_rotate_log

[Family: vserver]

Rotate audit log for specified vserver

Inputs

Outputs

flash_device_get_iter

[Family: cluster]

Iterate over a list of Flash Cache device info objects.

Inputs

Outputs

flash_device_list_info

[Family: cluster]

This API is used to retrieve information about the flash devices in the controller registered with Flash Management Module (FMM).

Inputs

Outputs

flash_get_thresholds

[Family: cluster]

Get threshold profiles available in Flash Management Module.

Inputs

Outputs

flash_thresholds_get_iter

[Family: cluster]

Iterate over a list of Flash Cache threshold profiles objects.

Inputs

Outputs

flexcache_cache_policy_create

[Family: vserver]

Create a new flexcache-cache-policy.

Inputs

Outputs

flexcache_cache_policy_destroy

[Family: vserver]

Delete an existing flexcache-cache-policy object.

Inputs

Outputs

flexcache_cache_policy_get

[Family: vserver]

Get the attributes of the flexcache-cache-policy.

Inputs

Outputs

flexcache_cache_policy_get_iter

[Family: cluster, vserver]

Iterate over a list of flexcache-cache-policy objects.

Inputs

Outputs

flexcache_cache_policy_modify

[Family: vserver]

Modify the attributes of flexcache-cache-policy object.

Inputs

Outputs

flexcache_create

[Family: cluster, vserver]

Create cluster-wide caching for a given volume.

Inputs

Outputs

flexcache_delete

[Family: cluster, vserver]

Delete cluster-wide caching for a given volume.

Inputs

Outputs

flexcache_get

[Family: vserver]

Get the attributes of the flexcache.

Inputs

Outputs

flexcache_get_iter

[Family: cluster, vserver]

Iterate over a list of flexcache objects.

Inputs

Outputs

flexcache_options_get

[Family: cluster]

Get the cluster-wide attributes of FlexCache.

Inputs

Outputs

flexcache_options_modify

[Family: cluster]

Modify the cluster-wide attributes of FlexCache.

Inputs

Outputs

fpolicy_disable_policy

[Family: vserver]

Disables a specific named policy.

Inputs

Outputs

fpolicy_enable_policy

[Family: vserver]

Enables a specific named policy. The operation will fail if the policy doesn't exist.

Inputs

Outputs

fpolicy_policy_create

[Family: vserver]

Create a policy.

Inputs

Outputs

fpolicy_policy_delete

[Family: vserver]

Delete a policy.

Inputs

Outputs

fpolicy_policy_event_create

[Family: vserver]

Create FPolicy Event.

Inputs

Outputs

fpolicy_policy_event_delete

[Family: vserver]

Delete FPolicy event.

Inputs

Outputs

fpolicy_policy_event_get_iter

[Family: cluster, vserver]

Get a list of rows for FPolicy event options. FPolicy event is consist of protocol, file operations, vo lume operation and filters.

Inputs

Outputs

fpolicy_policy_event_modify

[Family: vserver]

Set FPolicy event options. FPolicy event is consist of protocol, file operation, volume operation and f ilters.

Inputs

Outputs

fpolicy_policy_external_engine_create

[Family: vserver]

Create an external engine.

Inputs

Outputs

fpolicy_policy_external_engine_delete

[Family: vserver]

Delete an external engine.

Inputs

Outputs

fpolicy_policy_external_engine_get_iter

[Family: cluster, vserver]

Returns information on external engines.

Inputs

Outputs

fpolicy_policy_external_engine_modify

[Family: vserver]

Modify an external engine. External engine can be modified only when none of the enabled policies are using it.

Inputs

Outputs

fpolicy_policy_get_iter

[Family: cluster, vserver]

Returns information about policies.

Inputs

Outputs

fpolicy_policy_modify

[Family: vserver]

Modify a policy.

Inputs

Outputs

fpolicy_policy_scope_create

[Family: vserver]

Set FPolicy scope options. FPolicy Scope is consist of share, volume, export policy, volume, file extention.

Inputs

Outputs

fpolicy_policy_scope_delete

[Family: vserver]

Delete a scope.

Inputs

Outputs

fpolicy_policy_scope_get_iter

[Family: cluster, vserver]

Get a list of rows for FPolicy scope options. FPolicy Scope consists of share, volume, export policy, volume, file extention.

Inputs

Outputs

fpolicy_policy_scope_modify

[Family: vserver]

Set FPolicy scope options. FPolicy Scope is consist of share, volume, export policy, volume, file extention.

Inputs

Outputs

fpolicy_policy_status_get_iter

[Family: cluster, vserver]

Returns FPolicy policy status information.

Inputs

Outputs

fpolicy_server_connect

[Family: vserver]

Make a connection to FPolicy server

Inputs

Outputs

fpolicy_server_disconnect

[Family: vserver]

Terminate connection to FPolicy server

Inputs

Outputs

fpolicy_server_status_get_iter

[Family: cluster, vserver]

Returns FPolicy server status information.

Inputs

Outputs

gpo_applied_info_get_iter

[Family: cluster, vserver]

Get the list of entries of the applied GPO rules, organized on a per-Vserver basis.

Inputs

Outputs

gpo_get_iter

[Family: cluster, vserver]

Retrieve the Vserver's group policy configuration.

Inputs

Outputs

gpo_gpresult_info_get_iter

[Family: cluster, vserver]

Get a list of entries of the GPO RSoP(Resultant Set of Policy) data, organized on a per-Vserver basis.

Inputs

Outputs

gpo_modify

[Family: vserver]

Change the Vserver's group policy configuration.

Inputs

Outputs

gpo_update

[Family: vserver]

Download and apply the latest version of the group policy defined in Active Directory.

Inputs

Outputs

group_mapping_create

[Family: vserver]

Create a new group mapping for a Vserver.

Inputs

Outputs

group_mapping_delete

[Family: vserver]

Delete an existing group mapping entry.

Inputs

Outputs

group_mapping_get_iter

[Family: cluster, vserver]

Retrieve the list of group mappings in the cluster.

Inputs

Outputs

group_mapping_insert

[Family: vserver]

Insert a group mapping into the table at a specified position.

Inputs

Outputs

group_mapping_modify

[Family: vserver]

Modify an existing group mapping entry.

Inputs

Outputs

group_mapping_swap

[Family: vserver]

Swap the position of one group mapping with another. The position is the place in the sequence of group mappings in which the mappings are applied.

Inputs

Outputs

igroup_add

[Family: vserver]

Adds initiator to an existing initiator group.

Inputs

Outputs

igroup_bind_portset

[Family: vserver]

Bind an existing igroup to a given portset.

Inputs

Outputs

igroup_create

[Family: vserver]

Creates a new initiator group. In Data ONTAP 7.3 and upto ONTAP 8.0, the ALUA (Asymmetiric Logical Unit Access) attribute will be enabled by default if initiator-group-type is "fcp" and os-type is "aix", "hpux", or "linux. In Data ONTAP 7-mode 8.1 and later, the ALUA attribute is enabled by default for all os-type if initiator-group-type is "fcp". In Data ONTAP Cluster-Mode 8.1 and later, the ALUA attribute is enabled by default on all initiator groups.

Inputs

Outputs

igroup_destroy

[Family: vserver]

Destroys an existing initiator group. By default a group cannot be destroyed if there are existing lun maps defined for that group. This behaviour can be overridden with the use of force option set to "true" which will destroy the initiator group and any associated lun maps.

Inputs

Outputs

igroup_get_iter

[Family: cluster, vserver]

Iterate over a list of igroup objects.

Inputs

Outputs

igroup_lookup_lun

[Family: vserver]

Find the path to the lun mapped at a given lun-id for a given initiator group.

Inputs

Outputs

igroup_remove

[Family: vserver]

Removes node(s) from an initiator group. The operation is prohibited if there are existing lun maps defined for that group. The force option set to "true" can be used to forcibly remove the node regardless of mappings.

Inputs

Outputs

igroup_rename

[Family: vserver]

Rename an existing initiator group. The rename operation is non-disruptive.

Inputs

Outputs

igroup_set_attribute

[Family: vserver]

Sets an attribute for an initiator group.

Inputs

Outputs

igroup_unbind_portset

[Family: vserver]

Unbind an existing igroup from a portset.

Inputs

Outputs

iscsi_auth_generate_chap_password

[Family: vserver]

Generate a 128 bit random password that can be used as a CHAP secret.

Inputs

Outputs

iscsi_connection_get_iter

[Family: cluster, vserver]

Iterate over a list of iSCSI Connection objects.

Inputs

Outputs

iscsi_initiator_add_auth

[Family: vserver]

Add initiator to the authentication list.

Inputs

Outputs

iscsi_initiator_auth_get_iter

[Family: cluster, vserver]

Iterate over a list of iSCSI initiator authentication configuration objects.

Inputs

Outputs

iscsi_initiator_delete_auth

[Family: vserver]

Delete initiator from the authentication list

Inputs

Outputs

iscsi_initiator_get_auth

[Family: vserver]

Get the authentication info for an initiator, if auth type is CHAP, only the user-name is returned, password is not returned for security purposes.

Inputs

Outputs

iscsi_initiator_get_default_auth

[Family: vserver]

Get the default auth info for iscsi. If the auth type is CHAP, only the username is retuned, and not the password, for security purposes.

Inputs

Outputs

iscsi_initiator_get_iter

[Family: cluster, vserver]

Iterate over a list of remote iSCSI initiator objects.

Inputs

Outputs

iscsi_initiator_modify_chap_params

[Family: vserver]

Modify CHAP parameters to an existing per-initiator authentication info whose auth-type equals CHAP.

Inputs

Outputs

iscsi_initiator_set_default_auth

[Family: vserver]

Configure the default authentication method. If an initiator is not configured with a specific authentication method using iscsi-initiator-add-auth the default authentication method will be applied to it.

Inputs

Outputs

iscsi_interface_accesslist_add

[Family: vserver]

Add the iSCSI LIFs to the accesslist of the specified initiator

Inputs

Outputs

iscsi_interface_accesslist_get_iter

[Family: cluster, vserver]

Iterate over a list of iSCSI Interface Accesslist objects.

Inputs

Outputs

iscsi_interface_accesslist_remove

[Family: vserver]

Remove the iSCSI LIFs from the accesslist of the specified initiator

Inputs

Outputs

iscsi_interface_disable

[Family: vserver]

Disables an interface for use by iSCSI

Inputs

Outputs

iscsi_interface_enable

[Family: vserver]

Enables an interface for use by iSCSI

Inputs

Outputs

iscsi_interface_get_iter

[Family: cluster, vserver]

Iterate over a list of iSCSI target interface objects.

Inputs

Outputs

iscsi_isns_config

[Family: vserver]

Configures the iSNS service. In Data ONTAP Cluster-Mode, this this API can only modify the configuration of a Vserver where an iSNS service has already been created. To create an iSNS service in a Vserver where one does not exist, use the iscsi-isns-create API.

Inputs

Outputs

iscsi_isns_create

[Family: vserver]

Create the iSNS Service for a Vserver.

Inputs

Outputs

iscsi_isns_destroy

[Family: vserver]

Destroy the iSNS Service for a Vserver.

Inputs

Outputs

iscsi_isns_get_info

[Family: vserver]

Gets iSNS service configuration.

Inputs

Outputs

iscsi_isns_get_iter

[Family: cluster, vserver]

Gets iSNS service configuration for a Vserver.

Inputs

Outputs

iscsi_isns_start

[Family: vserver]

Start iSNS service. Service will be avaliable once the call returns with success.

Inputs

Outputs

iscsi_isns_stop

[Family: vserver]

Stops iSNS service. Service will not be available once the call returns with success.

Inputs

Outputs

iscsi_isns_update

[Family: vserver]

Forces an update of the iSNS service configuration stored in the external iSNS server.

Inputs

Outputs

iscsi_node_get_name

[Family: vserver]

Return the current iscsi node name.

Inputs

Outputs

iscsi_node_set_name

[Family: vserver]

Set the current iscsi node name.

Inputs

Outputs

iscsi_service_create

[Family: vserver]

Create an iSCSI Service in a Vserver. Each Vserver requires an online iSCSI Service in order to serve data via the iSCSI protocol.

Inputs

Outputs

iscsi_service_destroy

[Family: vserver]

Destroy the iSCSI Service in a Vserver.

Inputs

Outputs

iscsi_service_get_iter

[Family: cluster, vserver]

Iterate over the list of iSCSI Services.

Inputs

Outputs

iscsi_service_start

[Family: vserver]

Start iSCSI service. Service will be avaliable once the call returns with success.

Inputs

Outputs

iscsi_service_status

[Family: vserver]

Get status of the iSCSI service, whether or not it is running.

Inputs

Outputs

iscsi_service_stop

[Family: vserver]

Stops iSCSI service. Service will be not be available once the call returns with success.

Inputs

Outputs

iscsi_session_get_iter

[Family: cluster, vserver]

Iterate over a list of iSCSI session objects.

Inputs

Outputs

iscsi_stats_get_iter

[Family: cluster, vserver]

Iterate over a list of iscsi objects.

Inputs

Outputs

iscsi_target_alias_clear_alias

[Family: vserver]

Clear the current iscsi target alias

Inputs

Outputs

iscsi_target_alias_get_alias

[Family: vserver]

Return the current iscsi target alias

Inputs

Outputs

iscsi_target_alias_set_alias

[Family: vserver]

Set the current iscsi target alias

Inputs

Outputs

iscsi_tpgroup_create

[Family: vserver]

Create a new user defined target portal group.

Inputs

Outputs

iscsi_tpgroup_destroy

[Family: vserver]

Destroy a tpgroup. Only user defined target portal groups may be destroyed.

Inputs

Outputs

iscsi_tpgroup_get_iter

[Family: cluster, vserver]

Iterate over a list of iSCSI Target Portal Group objects.

Inputs

Outputs

iscsi_tpgroup_interface_add

[Family: vserver]

Add an interface to a target portal group. Interfaces may only be added to a user defined target portal group.

Inputs

Outputs

iscsi_tpgroup_interface_delete

[Family: vserver]

Remove an interface from a target portal group. Interfaces may only be removed from a user defined target portal group. Removing an interface will return it to the system defined default group for the interface.

Inputs

Outputs

job_by_node_get

[Family: vserver]

Get a single job entry. This is just a performance optimization for job-get that only searches for the job among the ones currently owned by the given node.

Inputs

Outputs

job_by_node_get_iter

[Family: cluster, vserver]

Get multiple job records organized by node. This is just a performance optimization for job-get-iter that only searches for the job among the ones currently owned by the given node.

Inputs

Outputs

job_completed_get

[Family: vserver]

Get a single completed job entry. This is just a performance optimization for job-get.

Inputs

Outputs

job_completed_get_iter

[Family: cluster, vserver]

Get multiple completed job records. This is just a performance optimization for job-get-iter.

Inputs

Outputs

job_get

[Family: vserver]

Get a single job entry.

Inputs

Outputs

job_get_iter

[Family: cluster, vserver]

Get multiple job records.

Inputs

Outputs

job_history_get

[Family: vserver]

Get a single job history event.

Inputs

Outputs

job_history_get_iter

[Family: cluster, vserver]

Get multiple job history records.

Inputs

Outputs

job_pause

[Family: vserver]

Pause a job. A job must be of a type that has job-type-is-pausible set to true before it may be paused. Once notified of a pause request, a job should stop performing work until it is subsequently resumed.

Inputs

Outputs

job_pause_iter

[Family: cluster, vserver]

Pause a collection of jobs.

Inputs

Outputs

job_private_completed_get

[Family: vserver]

Get a single completed, private job entry. This is just a performance optimization for job-private-get.

Inputs

Outputs

job_private_completed_get_iter

[Family: cluster, vserver]

Get multiple completed, private job records. This is just a performance optimization for job-private-get-iter.

Inputs

Outputs

job_private_get

[Family: vserver]

Get a single private job entry.

Inputs

Outputs

job_private_get_iter

[Family: cluster, vserver]

Get multiple private job records.

Inputs

Outputs

job_private_pause

[Family: vserver]

Pause a private job.

Inputs

Outputs

job_private_pause_iter

[Family: cluster, vserver]

Pause a collection of private jobs.

Inputs

Outputs

job_private_resume

[Family: vserver]

Resume a job.

Inputs

Outputs

job_private_resume_iter

[Family: cluster, vserver]

Resume a collection of jobs.

Inputs

Outputs

job_private_soft_pause

[Family: vserver]

Soft pause a private job.

Inputs

Outputs

job_private_soft_pause_iter

[Family: cluster, vserver]

Soft pause a collection of private jobs.

Inputs

Outputs

job_private_stop

[Family: vserver]

Stop a job.

Inputs

Outputs

job_private_stop_iter

[Family: cluster, vserver]

Stop a collection of jobs.

Inputs

Outputs

job_resume

[Family: vserver]

Resume a job from the paused state.

Inputs

Outputs

job_resume_iter

[Family: cluster, vserver]

Resume a collection of jobs.

Inputs

Outputs

job_schedule_cron_create

[Family: cluster]

Create a new cron job schedule entry.

Inputs

Outputs

job_schedule_cron_destroy

[Family: cluster]

Delete a single cron job schedule entry. The entry must not be in use.

Inputs

Outputs

job_schedule_cron_destroy_iter

[Family: cluster]

Delete multiple cron job schedule entries. The entries must not be in use.

Inputs

Outputs

job_schedule_cron_get

[Family: cluster, vserver]

Get a single cron job schedule entry.

Inputs

Outputs

job_schedule_cron_get_iter

[Family: cluster, vserver]

Get multiple cron job schedule entries.

Inputs

Outputs

job_schedule_cron_modify

[Family: cluster]

Modify an existing cron job schedule entry.

Inputs

Outputs

job_schedule_get

[Family: cluster, vserver]

Get a single job schedule entry.

Inputs

Outputs

job_schedule_get_iter

[Family: cluster, vserver]

Get multiple job schedule entries.

Inputs

Outputs

job_schedule_interval_create

[Family: cluster]

Create a new interval job schedule entry.

Inputs

Outputs

job_schedule_interval_destroy

[Family: cluster]

Delete a single interval job schedule entry. The entry must not be in use.

Inputs

Outputs

job_schedule_interval_destroy_iter

[Family: cluster]

Delete multiple interval job schedule entries. The entries must not be in use.

Inputs

Outputs

job_schedule_interval_get

[Family: cluster, vserver]

Get a single interval job schedule entry.

Inputs

Outputs

job_schedule_interval_get_iter

[Family: cluster, vserver]

Get multiple interval job schedule entries.

Inputs

Outputs

job_schedule_interval_modify

[Family: cluster]

Modify an existing interval job schedule entry.

Inputs

Outputs

job_soft_pause

[Family: vserver]

Soft pause a job. Indicates to the job that a soft pause has been initiated. It is up to the job to do what it needs to do for a soft pause. As a result of this command the job may request to be moved into the runnnable queue to perform further processing of the soft pause.

Inputs

Outputs

job_soft_pause_iter

[Family: cluster, vserver]

Soft pause a collection of jobs.

Inputs

Outputs

job_stop

[Family: vserver]

Stop a job. A job must be of a type that has job-type-is-quittable set to true before it may be stopped. job-stop attempts to stop a job that's currently running. If the job allows itself to stop it completes its current run. If the job has a recurring schedule it will transition to the Queued state; otherwise it will transition into either the Success or Failure state.

Inputs

Outputs

job_stop_iter

[Family: cluster, vserver]

Stop a collection of jobs.

Inputs

Outputs

kerberos_config_get

[Family: vserver]

Get Kerberos configuration information for a LIF.

Inputs

Outputs

kerberos_config_get_iter

[Family: cluster, vserver]

Get Kerberos configuration information for a group of LIFs.

Inputs

Outputs

kerberos_config_modify

[Family: vserver]

Modify Kerberos configuration informaiton for a LIF

Inputs

Outputs

kerberos_realm_create

[Family: cluster]

Create a new Kerberos realm configuration.

Inputs

Outputs

kerberos_realm_delete

[Family: cluster]

Delete the Kerberos realm configuration.

Inputs

Outputs

kerberos_realm_get_iter

[Family: cluster]

Retrieve the list of Kerberos realm configurations.

Inputs

Outputs

kerberos_realm_modify

[Family: cluster]

Modify the Kerberos realm configuration.

Inputs

Outputs

ldap_client_create

[Family: cluster]

Create a new Lightweight Directory Access Protocol (LDAP) client configuration for the cluster.

Inputs

Outputs

ldap_client_delete

[Family: cluster]

Delete an existing Lightweight Directory Access Protocol (LDAP) client configuration from the cluster.

Inputs

Outputs

ldap_client_get_iter

[Family: cluster, vserver]

Retrieve the list of Lightweight Directory Access Protocol (LDAP) client configurations for the cluster.

Inputs

Outputs

ldap_client_modify

[Family: cluster]

Modify an existing Lightweight Directory Access Protocol (LDAP) client configuration.

Inputs

Outputs

ldap_client_schema_copy

[Family: cluster]

Copy an existing LDAP schema. If the LDAP server that the storage system needs to query does not support any of the default read-only schemas, this API can be used to create an editable copy of an existing read-only schema. After copying the schema, the copy can be modified using the ldap-client-schema-modify API.

Inputs

Outputs

ldap_client_schema_delete

[Family: cluster]

Delete an existing Lightweight Directory Access Protocol (LDAP) schema configuration. Only the schemas that are defined using the ldap-client-schema-copy API can be deleted using this API.

Inputs

Outputs

ldap_client_schema_get_iter

[Family: cluster, vserver]

Retrieve the list of Lightweight Directory Access Protocol (LDAP) client schema configurations that are defined for the cluster.

Inputs

Outputs

ldap_client_schema_modify

[Family: cluster]

Modify an existing Lightweight Directory Access Protocol (LDAP) schema configuration. If the LDAP server that the storage system needs to query does not support any of the default read-only schemas, the ldap-client-schema-copy API can be used to create a editable copy of an existing read-only schema. After copying the schema, the copy can be modified using this API to support the target schema.

Inputs

Outputs

ldap_config_create

[Family: vserver]

Create a new association between a Lightweight Directory Access Protocol (LDAP) client configuration and a Vserver. A Vserver can have only one client configuration associated with it.

Inputs

Outputs

ldap_config_delete

[Family: vserver]

Delete a Vserver's association with a Lightweight Directory Access Protocol (LDAP) configuration.

Inputs

Outputs

ldap_config_get_iter

[Family: cluster, vserver]

Retrieve the list of Lightweight Directory Access Protocol (LDAP) configurations in the cluster.

Inputs

Outputs

ldap_config_modify

[Family: vserver]

Modify the Lightweight Directory Access Protocol (LDAP) configuration for a Vserver.

Inputs

Outputs

license_v2_add

[Family: cluster]

Add license for a Data ONTAP service.

Inputs

Outputs

license_v2_cleanup_list_info

[Family: cluster]

Returns licenses that can be cleaned up. A license can be cleaned up if it's a demo license and its expiration time has passed (expired), or if it is a license for a controller that is no longer part of a cluster (unused). One can use the cleanup apis to remove these licenses together, or alternatively, they can use the standard license-remove api to remove them one at a time.

Inputs

Outputs

license_v2_delete

[Family: cluster]

Removes license for a Data ONTAP service.

Inputs

Outputs

license_v2_delete_expired

[Family: cluster]

Remove licenses that have expired in the cluster.

Inputs

Outputs

license_v2_delete_unused

[Family: cluster]

Remove licenses that have no controller affiliation in the cluster.

Inputs

Outputs

license_v2_list_info

[Family: cluster]

Returns infomation for DATA ONTAP licenses.

Inputs

Outputs

license_v2_status_list_info

[Family: cluster]

Returns license status information for cluster mode packages.

Inputs

Outputs

lun_alignment_get_iter

[Family: cluster, vserver]

Iterate over a list of lun objects.

Inputs

Outputs

lun_clear_persistent_reservation_info

[Family: vserver]

Clear the SCSI-2 reservation or SCSI-3 persistent reservation information for a given LUN. Note: In Data ONTAP Cluster-Mode, the LUN must either be offline or not mapped to clear the persistent reservation information.

Inputs

Outputs

lun_create_by_size

[Family: vserver]

Create a new lun of given size, with initially zero contents. The lun is created at the path given. No file should already exist at the given path. The directory specified in the path must be a qtree root directory. The size of the created lun could be larger than the size specified, in order to get an integral number of cylinders while reporting the geometry using SAN protocols.

Inputs

Outputs

lun_create_from_file

[Family: vserver]

Create a lun from an existing file. A new lun is created, at the given lun path (which must be at a qtree root). A hard link is created to the existing file. The file contents are not copied or changed. The file can be resized to a larger size, rounding up to a cylinder boundary.

Inputs

Outputs

lun_destroy

[Family: vserver]

Destroy the specified LUN. This operation will fail if the LUN is currently mapped and is online. The force option can be used to destroy it regardless of being online or mapped.

Inputs

Outputs

lun_get_attribute

[Family: vserver]

Get a named attribute for a given LUN.

Inputs

Outputs

lun_get_attributes

[Family: vserver]

Get named attributes for a given LUN.

Inputs

Outputs

lun_get_comment

[Family: vserver]

Get the optional descriptive comment for a LUN.

Inputs

Outputs

lun_get_geometry

[Family: vserver]

Get SCSI disk geometry for a given LUN.

Inputs

Outputs

lun_get_inquiry_info

[Family: vserver]

Get the SCSI INQUIRY response data for vendor id (vid), product id (pid), and firmware revision (rev) based on the igroup that the lun in question is mapped to.

Inputs

Outputs

lun_get_iter

[Family: cluster, vserver]

Iterate over a list of lun objects.

Inputs

Outputs

lun_get_maxsize

[Family: vserver]

Returns the maximum possible size in bytes of a lun on a given volume or qtree. The user can pass the path to a volume or qtree in which the lun is to be created. This returns the maximum size for different types of luns and the possible maximum size with or without snapshot reserves.

Inputs

Outputs

lun_get_minsize

[Family: vserver]

Returns the minimum possible size in bytes. This returns the minimum size for different types of luns (based on the specified OS type). Space reservation does not affect the minimum lun size, thus only a single minimum size is returned.

Inputs

Outputs

lun_get_occupied_size

[Family: vserver]

Get the size occupied by the LUN in the active FS.

Inputs

Outputs

lun_get_persistent_reservation_info

[Family: vserver]

Get the persistent reservation information for a given LUN.

Inputs

Outputs

lun_get_select_attribute

[Family: vserver]

Get the select attribute for the specified LUN.

Inputs

Outputs

lun_get_serial_number

[Family: vserver]

Get the serial number for the specified LUN. Prior to Data ONTAP 8.1 release, the serial number is a 12-character string formed of upper and lower-case letters, numbers, and slash (/) and hyphen (-) characters. Starting Data ONTAP 8.1 release, the serial number is a 12-character string formed of upper and lower-case letters, numbers, and the characters /-#$%&*+<=>?[!]^~@ .

Inputs

Outputs

lun_get_space_reservation_info

[Family: vserver]

Queries the space reservation settings for the named LUN.

Inputs

Outputs

lun_get_vdisk_attributes

[Family: cluster, vserver]

Lookup a LUN path and storage system by serial number.

Inputs

Outputs

lun_has_scsi_reservations

[Family: vserver]

Queries for all types of scsi reservations covering both iSCSI and FCP.

Inputs

Outputs

lun_initiator_list_map_info

[Family: cluster, vserver]

List all the luns mapped to an initiator

Inputs

Outputs

lun_initiator_logged_in

[Family: vserver]

Determine if an initiator is logged in via FCP or iSCSI.

Inputs

Outputs

lun_map

[Family: vserver]

Maps the LUN to all the initiators in the specified initiator group.

Inputs

Outputs

lun_map_get_iter

[Family: cluster, vserver]

Iterate over a list of LUN map detail objects.

Inputs

Outputs

lun_map_list_info

[Family: vserver]

Returns a list of initiator groups and their members (the initiators) mapped to the given LUN.

Inputs

Outputs

lun_move

[Family: vserver]

Move (rename) a LUN.

Inputs

Outputs

lun_offline

[Family: vserver]

Disables block-protocol accesses to the LUN. Mappings, if any, configured for the lun are not altered. Note that unless explicitly offlined, a lun is online.

Inputs

Outputs

lun_online

[Family: vserver]

Re-enables block-protocol accesses to the lun.

Inputs

Outputs

lun_port_has_scsi_reservations

[Family: vserver]

Queries for all types of scsi reservations covering both iSCSI and FCP for a given initiator name. Initiator name can be FCP portname in case of FCP or ISCSI nodename for ISCSI.

Inputs

Outputs

lun_resize

[Family: vserver]

Changes the size of the lun. Note that client-side operations may be needed to ensure that client software recognizes the changed size.

Inputs

Outputs

lun_set_attribute

[Family: vserver]

Set a named attribute for a given LUN. Attributes are arbitrary key/value pairs for application-defined use.

Inputs

Outputs

lun_set_comment

[Family: vserver]

Set the optional descriptive comment for a LUN.

Inputs

Outputs

lun_set_device_id

[Family: vserver]

Set a SCSI peripheral device identifying information value on a LUN. In Data ONTAP 7-Mode, the value set will be returned in response to the vendor unique SCSI command GET DEV ID. In Data ONTAP Cluster-Mode, the value set will be returned in response to the SCSI command REPORT IDENTIFYING INFORMATION for the appropriate INFORMATION TYPE: Either or both peripheral device identifying information values may be set or cleared independently.

Inputs

Outputs

lun_set_qos_policy_group

[Family: vserver]

null

Inputs

Outputs

lun_set_select_attribute

[Family: vserver]

Set the select attribute for the specified LUN. The select attribute is used by mult-pathing software to discriminate between luns when mirrored or cloned copies of a vdisk are mapped to the same host.

Inputs

Outputs

lun_set_serial_number

[Family: vserver]

Set the serial number for the specified LUN. The lun must first be made offline before changing the serial number. Prior to Data ONTAP 8.1 release, the serial number is a 12-character string formed of upper and lower-case letters, numbers, and slash (/) and hyphen (-) characters. Starting Data ONTAP 8.1 release, the serial number is a 12-character string formed of upper and lower-case letters, numbers, and the characters /-#$%&*+<=>?[!]^~@ .

Inputs

Outputs

lun_set_space_alloc

[Family: vserver]

Modify the attributes of lun object.

Inputs

Outputs

lun_set_space_reservation_info

[Family: vserver]

Sets the space reservation settings for the named LUN.

Inputs

Outputs

lun_stats_get_iter

[Family: cluster, vserver]

Iterate over a list of lun objects.

Inputs

Outputs

lun_unmap

[Family: vserver]

Reverses the effect of lun-map on the specified LUN for the specified group.

Inputs

Outputs

lun_unset_attribute

[Family: vserver]

Clear a named attribute for a given LUN.

Inputs

Outputs

lun_unset_device_id

[Family: vserver]

Remove a SCSI peripheral device identifying information value from a LUN.

Inputs

Outputs

name_mapping_create

[Family: vserver]

Create a new name mapping for a Vserver.

Inputs

Outputs

name_mapping_delete

[Family: vserver]

Delete an existing name mapping entry.

Inputs

Outputs

name_mapping_get_iter

[Family: cluster, vserver]

Retrieve the list of name mappings in the cluster.

Inputs

Outputs

name_mapping_insert

[Family: vserver]

Insert a name mapping into the table at a specified position.

Inputs

Outputs

name_mapping_modify

[Family: vserver]

Modify an existing name mapping entry.

Inputs

Outputs

name_mapping_swap

[Family: vserver]

Swap the position of one name mapping with another. The position is the place in the sequence of name mappings in which the mappings are applied.

Inputs

Outputs

name_mapping_unix_group_add_user

[Family: vserver]

Add a user to a UNIX group

Inputs

Outputs

name_mapping_unix_group_create

[Family: vserver]

Create a new UNIX group.

Inputs

Outputs

name_mapping_unix_group_delete_user

[Family: vserver]

Delete a user from a UNIX group

Inputs

Outputs

name_mapping_unix_group_destroy

[Family: vserver]

Destroy an existing UNIX group.

Inputs

Outputs

name_mapping_unix_group_get

[Family: vserver]

Get the attributes of a UNIX group.

Inputs

Outputs

name_mapping_unix_group_get_iter

[Family: cluster, vserver]

Iterate over a list of UNIX groups.

Inputs

Outputs

name_mapping_unix_group_modify

[Family: vserver]

Modify the attributes of a UNIX group.

Inputs

Outputs

name_mapping_unix_user_create

[Family: vserver]

Create a new UNIX user.

Inputs

Outputs

name_mapping_unix_user_destroy

[Family: vserver]

Destroy an existing UNIX user.

Inputs

Outputs

name_mapping_unix_user_get

[Family: vserver]

Get the attributes of a UNIX user.

Inputs

Outputs

name_mapping_unix_user_get_iter

[Family: cluster, vserver]

Iterate over a list of UNIX users.

Inputs

Outputs

name_mapping_unix_user_modify

[Family: vserver]

Modify the attributes of a UNIX user.

Inputs

Outputs

ndmp_password_generate

[Family: vserver]

Generate NDMP password for the given user in a specific Vserver context. The generated NDMP password is based on the actual login password for the user; hence it should be regenerated whenever the actual user password is changed.

Inputs

Outputs

net_cluster_ping

[Family: cluster]

Ping an IP address to verify whether the interface is alive

Inputs

Outputs

net_connections_receive_window_size_get

[Family: cluster]

Get the receive buffer size of a service

Inputs

Outputs

net_connections_receive_window_size_get_iter

[Family: cluster]

Iterate over connections returning receive window size

Inputs

Outputs

net_connections_receive_window_size_modify

[Family: cluster]

Modify a receive buffer size

Inputs

Outputs

net_device_discovery_get_iter

[Family: cluster]

Iterate over a list of network device discovery objects found by a discovery protocol such as CDP or LLDP.

Inputs

Outputs

net_dns_create

[Family: vserver]

Creates DNS configuration for a Vserver

Inputs

Outputs

net_dns_get

[Family: vserver]

Get the DNS configuration of the Vserver

Inputs

Outputs

net_dns_get_iter

[Family: cluster, vserver]

Iterate through DNS configurations of the cluster

Inputs

Outputs

net_dns_modify

[Family: vserver]

Modify the DNS configuration of the specified Vserver. Omitted (optional) fields will not be changed.

Inputs

Outputs

net_failover_group_get

[Family: cluster]

Get the attributes of a failover group.

Inputs

Outputs

net_failover_group_get_iter

[Family: cluster]

Iterate over a list of failover group objects.

Inputs

Outputs

net_hosts_create

[Family: vserver]

Create a new IP to host names mapping

Inputs

Outputs

net_hosts_destroy

[Family: vserver]

Delete an existing hosts object.

Inputs

Outputs

net_hosts_get

[Family: vserver]

Given an IP address, return the corresponding IP to host names mapping of the running Vserver context

Inputs

Outputs

net_hosts_get_iter

[Family: cluster, vserver]

Iterate all IP to host name mappings (over all Vserver) of the cluster

Inputs

Outputs

net_hosts_modify

[Family: vserver]

Given an IP address, modify the corresponding IP to host name mapping. Omitted (optional) fields will not be changed.

Inputs

Outputs

net_interface_create

[Family: cluster]

Create a new logical interface.

Inputs

Outputs

net_interface_delete

[Family: cluster]

Destroy an existing network interface object.

Inputs

Outputs

net_interface_get

[Family: vserver]

Get the attributes of a network interface.

Inputs

Outputs

net_interface_get_iter

[Family: cluster, vserver]

Iterate over a list of network interface objects.

Inputs

Outputs

net_interface_migrate

[Family: cluster]

Migrate a Logical Interface between nodes and ports

Inputs

Outputs

net_interface_modify

[Family: cluster]

Modify the attributes of network interface object.

Inputs

Outputs

net_interface_modify_iter

[Family: cluster]

Modify the attributes of network interface or a group of network interface objects.

Inputs

Outputs

net_interface_revert

[Family: cluster]

Revert a logical interface back to its home port following a deliberate migration or failover.

Inputs

Outputs

net_options_get

[Family: cluster]

Get the attributes of the net.

Inputs

Outputs

net_options_modify

[Family: cluster]

Modify the attributes of net object.

Inputs

Outputs

net_placement_cache_delete

[Family: cluster]

Delete LIF placement cached information.

Inputs

Outputs

net_placement_cache_get_iter

[Family: cluster]

Iterate over the LIF placement cached information.

Inputs

Outputs

net_placement_discover

[Family: cluster]

Find the ports direcly connected to the IP address

Inputs

Outputs

net_port_get

[Family: cluster]

Get the attributes of a network port.

Inputs

Outputs

net_port_get_iter

[Family: cluster]

Iterate over a list of network port objects.

Inputs

Outputs

net_port_ifgrp_add_port

[Family: cluster]

Add port to a network interface group.

Inputs

Outputs

net_port_ifgrp_create

[Family: cluster]

Create a new network interface group.

Inputs

Outputs

net_port_ifgrp_destroy

[Family: cluster]

Destroy an existing network interface group.

Inputs

Outputs

net_port_ifgrp_get

[Family: cluster]

Get the attributes of a network interface group (ifgrp).

Inputs

Outputs

net_port_ifgrp_remove_port

[Family: cluster]

Remove port from a network interface group.

Inputs

Outputs

net_port_modify

[Family: cluster]

Modify the given attributes of network port and the rest remain unchanged.

Inputs

Outputs

net_port_modify_iter

[Family: cluster]

Modify the attributes of network port or a group of network port objects.

Inputs

Outputs

net_routing_group_route_create

[Family: cluster]

Create a new network routing group route.

Inputs

Outputs

net_routing_group_route_destroy

[Family: cluster]

Destroy an existing network routing group route.

Inputs

Outputs

net_routing_group_route_get

[Family: vserver]

Get the attributes of a network routing group route.

Inputs

Outputs

net_routing_group_route_get_iter

[Family: cluster, vserver]

Iterate over a list of network routing group route.

Inputs

Outputs

net_san_lif_placement_get

[Family: cluster]

Get the attributes of the SAN LIF Placement.

Inputs

Outputs

net_vlan_create

[Family: cluster]

Create a new vlan interface. In Data ONTAP 7-Mode, changes made by this API are not persisted across system reboots. In Data ONTAP Cluster-Mode, changes made by this API are persisted across system reboots.

Inputs

Outputs

net_vlan_delete

[Family: cluster]

Delete a vlan interface. In Data ONTAP 7-Mode, changes made by this API are not persisted across system reboots. In Data ONTAP Cluster-Mode, changes made by this API are persisted across system reboots.

Inputs

Outputs

net_vlan_get

[Family: cluster]

Get the attributes of a VLAN.

Inputs

Outputs

net_vlan_get_iter

[Family: cluster]

Iterate over a list of VLAN objects.

Inputs

Outputs

nfs_disable

[Family: vserver]

In Data ONTAP 7-Mode, this API will disable NFS server access (effectively same as the CLI command "nfs off") In Data ONTAP Cluster-Mode, this will stop the Vserver's NFS service. If the NFS service was not explicitly created, this API does nothing.

Inputs

Outputs

nfs_enable

[Family: vserver]

In Data ONTAP 7-Mode, this API will enable NFS server access (effectively same as the CLI command "nfs on") In Data ONTAP Cluster-Mode, this will start the Vserver's NFS service. If the NFS service was not explicitly created, this API will create one with default options.

Inputs

Outputs

nfs_exportfs_append_rules

[Family: vserver]

Enables pathnames for mounting according to the rules specified. New rules for the pathnames take effect immediately, ignoring previous rules for specified pathnames. In the Data ONTAP 7-Mode, set the persistent option to true to save the rule in the etc/exports file and keep the option persistent upon loading or reboot whereas it must be true in Data ONTAP Cluster-Mode as the export entries are always persistent.

Inputs

Outputs

nfs_exportfs_append_rules_2

[Family: vserver]

Enables pathnames for mounting according to the rules specified. New rules for the pathnames take effect immediately, ignoring previous rules for specified pathnames. In the Data ONTAP 7-Mode, set the persistent option to true to save the rule in the etc/exports file and keep the option persistent upon loading or reboot whereas it must be true in Data ONTAP Cluster-Mode as the export entries are always persistent. The new security-rule-info structure contains finer grained information about security rules than exports-rule-info.

Inputs

Outputs

nfs_exportfs_check_permission

[Family: vserver]

Returns true if the host IP has mount permissions for a specified path.

Inputs

Outputs

nfs_exportfs_delete_rules

[Family: vserver]

Removes the rules for a set of pathnames. This returns an error if any of the pathnames don't have a rule. In the Data ONTAP 7-Mode, set the persistent option to modify the etc/exports file and keep this change persistent upon reboots whereas it must be true in Data ONTAP Cluster-Mode as the export entries are always persistent.

Inputs

Outputs

nfs_exportfs_list_rules

[Family: vserver]

Returns the rules associated with exports. If a pathname is specified, the rules associated with the export matching that pathname, are returned; otherwise, rules for all exports are returned.

Inputs

Outputs

nfs_exportfs_list_rules_2

[Family: vserver]

Returns the rules associated with exports, using the new security info structure. If a pathname is specified, the rules associated with the export matching that pathname, are returned; otherwise, rules for all exports are returned.

Inputs

Outputs

nfs_exportfs_modify_rule

[Family: vserver]

Functionally similar to append with the following caveats. Returns an error if the rule does not exist. Only works for one rule at a time.

Inputs

Outputs

nfs_exportfs_modify_rule_2

[Family: vserver]

Functionally similar to append-2 with the following caveats. Returns an error if the rule does not exist. Only works for one rule at a time.

Inputs

Outputs

nfs_get_supported_sec_flavors

[Family: vserver]

Returns a list of currently supported security flavors. Hosts with permmisions and connecting via the proper security flavor have access to directories on the filer. Default security flavor for all exports is "sys".

Inputs

Outputs

nfs_service_create

[Family: vserver]

Create a new NFS configuration.

Inputs

Outputs

nfs_service_destroy

[Family: vserver]

Delete an NFS configuration.

Inputs

Outputs

nfs_service_get

[Family: vserver]

Get the NFS server configuration.

Inputs

Outputs

nfs_service_get_create_defaults

[Family: cluster, vserver]

Obtain the default values for NFS server configuration.

Inputs

Outputs

nfs_service_get_iter

[Family: cluster, vserver]

Iterate over the list of NFS servers.

Inputs

Outputs

nfs_service_modify

[Family: vserver]

Modify an NFS configuration. If no values are given, the NFS configuration is not modified.

Inputs

Outputs

nfs_status

[Family: vserver]

Returns the status of the NFS server.

Inputs

Outputs

nis_create

[Family: vserver]

Create an NIS domain configuration. Multiple NIS domains can be configured on a single Vserver, but only one NIS domain can be active at any given time.

Inputs

Outputs

nis_destroy

[Family: vserver]

Destroy an existing NIS configuration.

Inputs

Outputs

nis_get

[Family: vserver]

Get NIS domain configuration.

Inputs

Outputs

nis_get_iter

[Family: cluster, vserver]

Iterate over a list of NIS configurations.

Inputs

Outputs

nis_modify

[Family: vserver]

Modify the attributes of NIS configuration.

Inputs

Outputs

options_get

[Family: vserver]

Get the value of a single option.

Inputs

Outputs

options_get_iter

[Family: cluster, vserver]

Iterate over a list of options objects.

Inputs

Outputs

options_list_info

[Family: vserver]

Get a list of all options

Inputs

Outputs

options_modify_iter

[Family: cluster, vserver]

Modify the attributes of options or a group of options objects.

Inputs

Outputs

options_set

[Family: vserver]

Set the value of a single option. For complete list of names and values of options, please refer to options man pages.

Inputs

Outputs

perf_archive_config_get

[Family: cluster]

Display the current Performance Archive configuration

Inputs

Outputs

perf_archive_config_modify

[Family: cluster]

Modify the current Performance Archive configuration

Inputs

Outputs

perf_archive_create

[Family: cluster]

Save a new Performance Archive

Inputs

Outputs

perf_archive_destroy

[Family: cluster]

Destroy a Performance Archive

Inputs

Outputs

perf_archive_get_iter

[Family: cluster]

Iteratively get information about Performance Archives

Inputs

Outputs

perf_archive_modify

[Family: cluster]

Modify properties of a Performance Archive

Inputs

Outputs

perf_object_counter_list_info

[Family: cluster]

Get information about the counters of an object. This information is static and independent of any particular instance of the object. It includes counter names and descriptions, as well as properties which are necessary to to interpret counter values.

Inputs

Outputs

perf_object_get_instances

[Family: cluster]

Get a list of current counter values of instances of an object. This will return the values of all specified counters and instances of the specified object with one call. If the object is expected to have a large number of instances and/or counters, the iterator version of this API should be used.

Inputs

Outputs

perf_object_instance_list_info_iter

[Family: cluster]

Iterate over a list of perf objects.

Inputs

Outputs

perf_object_list_info

[Family: cluster]

Get list of performance objects in the system.

Inputs

Outputs

perf_preset_create

[Family: cluster]

Create a single Performance Preset configuration and all of its details

Inputs

Outputs

perf_preset_delete

[Family: cluster]

Delete a Performance Preset and all of its Preset Details

Inputs

Outputs

perf_preset_detail_get

[Family: cluster]

Get detailed information about a single Performance Preset configuration

Inputs

Outputs

perf_preset_get_iter

[Family: cluster]

Iteratively get information about Performance Presets

Inputs

Outputs

perf_preset_modify

[Family: cluster]

Modify a Performance Preset

Inputs

Outputs

portset_add

[Family: vserver]

Add a port to an existing port set

Inputs

Outputs

portset_create

[Family: vserver]

Create a port set

Inputs

Outputs

portset_destroy

[Family: vserver]

Destroys an existing port set. By default a set cannot be destroyed if there are existing igroup associated with that portset.

Inputs

Outputs

portset_get_iter

[Family: cluster, vserver]

Iterate over a list of portset objects.

Inputs

Outputs

portset_remove

[Family: vserver]

Removes a port from a port set.

Inputs

Outputs

qos_policy_create

[Family: cluster]

Create a new policy. A unique name must be provided for the new policy, and a uuid will be returned. The policy will not affect any work until it is assigned to a workload. Therefore a workload referencing the policy should usually be created along with the policy.

Inputs

Outputs

qos_policy_destroy

[Family: cluster]

Delete single policy. The policy may not be attached to any workloads. Only user defined policies may be deleted.

Inputs

Outputs

qos_policy_destroy_iter

[Family: cluster]

Delete multiple policies. The policies may not be attached to any workloads. Only user defined policies may be deleted.

Inputs

Outputs

qos_policy_get

[Family: cluster]

Get the attributes of a policy.

Inputs

Outputs

qos_policy_get_iter

[Family: cluster]

Iterate over list of policies.

Inputs

Outputs

qos_policy_group_create

[Family: cluster]

Create a policy group. A unique name must be provided for the new policy group. A QoS Policy group defines measurable Service Level Objectives (SLOs) that apply to the storage object with which the policy group is associated.

Inputs

Outputs

qos_policy_group_delete

[Family: cluster]

Delete single policy group. The default policy group may not be deleted. The policy group may not be attached to any workloads. Only user defined policy groups may be deleted.

Inputs

Outputs

qos_policy_group_delete_iter

[Family: cluster]

Delete multiple policy groups.

Inputs

Outputs

qos_policy_group_get

[Family: cluster]

Get the attributes of a policy group.

Inputs

Outputs

qos_policy_group_get_iter

[Family: cluster]

Iterate over list of policy groups.

Inputs

Outputs

qos_policy_group_modify

[Family: cluster]

Modify an existing policy group.

Inputs

Outputs

qos_policy_group_modify_iter

[Family: cluster]

Modify multiple policy groups

Inputs

Outputs

qos_policy_group_rename

[Family: cluster]

Rename a QoS Policy Group

Inputs

Outputs

qos_policy_modify

[Family: cluster]

Modify an existing policy.

Inputs

Outputs

qos_policy_modify_iter

[Family: cluster]

Modify multiple policies

Inputs

Outputs

qos_policy_read_ahead_create

[Family: cluster]

Create a new read-ahead policy. A unique name must be provided for the new read-ahead policy. If the 'default' field is set to true, these become the default read-ahead settings for policies that don't otherwise name read-ahead settings. Unless creating a new default, creating read-ahead policies should usually be assigned to an existing QoS policy.

Inputs

Outputs

qos_policy_read_ahead_destroy

[Family: cluster]

Delete single read-ahead policy. The default policy may not be deleted. The policy may not be attached to any workloads. Only user defined policies may be deleted.

Inputs

Outputs

qos_policy_read_ahead_destroy_iter

[Family: cluster]

Delete multiple read-ahead policies.

Inputs

Outputs

qos_policy_read_ahead_get

[Family: cluster]

Get the attributes of a read-ahead policy.

Inputs

Outputs

qos_policy_read_ahead_get_iter

[Family: cluster]

Iterate over list of read-ahead policies.

Inputs

Outputs

qos_policy_read_ahead_modify

[Family: cluster]

Modify an existing read-ahead policy.

Inputs

Outputs

qos_policy_read_ahead_modify_iter

[Family: cluster]

Modify multiple read-ahead policies

Inputs

Outputs

qos_settings_archived_workload_get

[Family: cluster]

Get the cluster-wide QoS workload archival settings.

Inputs

Outputs

qos_settings_archived_workload_modify

[Family: cluster]

Modify the cluster-wide QoS workload archival settings.

Inputs

Outputs

qos_settings_control_get

[Family: cluster]

Get the cluster-wide QoS control settings.

Inputs

Outputs

qos_settings_control_modify

[Family: cluster]

Modify the existing cluster-wide QoS control settings.

Inputs

Outputs

qos_settings_read_ahead_create

[Family: cluster]

Create a new read-ahead setting. A unique name must be provided for the new read-ahead setting. If the 'default' field is set to true, these become the default read-ahead settings for settings that don't otherwise name read-ahead settings. Unless creating a new default, creating read-ahead settings should usually be assigned to an existing QoS setting.

Inputs

Outputs

qos_settings_read_ahead_destroy

[Family: cluster]

Destroy single read-ahead setting. The default setting may not be destroyed. The setting may not be attached to any workloads. Only user defined settings may be destroyed.

Inputs

Outputs

qos_settings_read_ahead_destroy_iter

[Family: cluster]

Destroy multiple read-ahead settings.

Inputs

Outputs

qos_settings_read_ahead_get

[Family: cluster]

Get the attributes of a read-ahead setting.

Inputs

Outputs

qos_settings_read_ahead_get_iter

[Family: cluster]

Iterate over list of read-ahead settings.

Inputs

Outputs

qos_settings_read_ahead_modify

[Family: cluster]

Modify an existing read-ahead setting.

Inputs

Outputs

qos_settings_read_ahead_modify_iter

[Family: cluster]

Modify multiple read-ahead settings

Inputs

Outputs

qos_stream_create

[Family: cluster]

Create a new stream. A workload uuid and stream properties must be provided, and a new stream-id is returned.

Inputs

Outputs

qos_stream_destroy

[Family: cluster]

Delete single stream.

Inputs

Outputs

qos_stream_destroy_iter

[Family: cluster]

Delete multiple streams.

Inputs

Outputs

qos_stream_get

[Family: cluster]

Get the attributes of a stream.

Inputs

Outputs

qos_stream_get_iter

[Family: cluster]

Iterate over list of streams.

Inputs

Outputs

qos_test_smf_zapi_error

[Family: cluster]

Returns SMF error with ZAPI error codes

Inputs

Outputs

qos_workload_create

[Family: cluster]

Create a new workload. A unique name must be provided for the new workload, and a uuid is returned. Subsequent management operations should index workloads by uuid as the name may be modified. No work will be classified to a workload unless the workload has at least one stream. Therefore at least one stream should usually be created along with a workload. If the performance of the workload is to be controlled by QoS, a policy must also be defined and attached to the workload.

Inputs

Outputs

qos_workload_delete

[Family: cluster]

Delete a single workload. Only user defined workloads may be deleted.

Inputs

Outputs

qos_workload_delete_iter

[Family: cluster]

Delete multiple workloads. Only user defined workloads may be deleted.

Inputs

Outputs

qos_workload_destroy

[Family: cluster]

Delete single workload. This also deletes any streams attached to the workload. Only user defined workloads may be deleted.

Inputs

Outputs

qos_workload_destroy_iter

[Family: cluster]

Delete multiple workloads. This also deletes any streams attached to the workloads. Only user defined workloads may be deleted.

Inputs

Outputs

qos_workload_get

[Family: cluster]

Get the attributes of a workload.

Inputs

Outputs

qos_workload_get_iter

[Family: cluster]

Iterate over list of workloads.

Inputs

Outputs

qos_workload_modify

[Family: cluster]

Modify an existing workload. This may be used to rename the workload, modify the workload's ID, its class, or its category.

Inputs

Outputs

qos_workload_modify_iter

[Family: cluster]

Modify multiple workloads

Inputs

Outputs

qtree_create

[Family: vserver]

Create a new qtree.

Inputs

Outputs

qtree_delete

[Family: vserver]

Delete the specified qtree.

For unclustered volumes, use the quota management APIs to delete the quota rules that reference this qtree in the /etc/quotas file.

For clustered volumes, all the quota rules that reference this qtree will be automatically deleted.

Inputs

Outputs

qtree_delete_async

[Family: vserver]

Delete the specified qtree by spawning a background job. The jobid will be returned. The progress of the job can be tracked using the job APIs. All the quota rules that reference this qtree will be automatically deleted.

Inputs

Outputs

qtree_list_iter

[Family: cluster, vserver]

Iterate over the list of qtrees in the cluster.

Inputs

Outputs

qtree_modify

[Family: vserver]

Modify the attributes of a qtree. If values are not provided for any of the fields, then that field will not be modified.

Inputs

Outputs

qtree_rename

[Family: vserver]

Renames the specified qtree to a new name specified by "new-qtree-name".

For unclustered volumes, if the qtree is referenced in the file /etc/exportfs, use NFS API nfs-exportfs-append-rules to modify the file so that the affected file system can be exported by the filer immediately. The "qtree-rename" command does not automatically update the /etc/exports file. Also, if the qtree is referenced in the file /etc/quotas, use the quota management APIs to delete and re-create the quota rule with the new qtree name.

For clustered volumes, the qtree name in the quota rules will be automatically updated with the new qtree name.

Inputs

Outputs

quota_add_entry

[Family: vserver]

Adds a quota entry. If the type, target, volume, and tree do not exist, a new entry is created. If the type, target, volume, and tree exist, then an error is returned.

Inputs

Outputs

quota_delete_entry

[Family: vserver]

Deletes a quota entry specified by type, target, volume, and tree.

Inputs

Outputs

quota_get_entry

[Family: vserver]

Obtains a quota entry specified by type, target, volume, and tree.

Inputs

Outputs

quota_list_entries_iter

[Family: cluster, vserver]

Iterate over the list of quota rules in the cluster.

Inputs

Outputs

quota_modify_entry

[Family: vserver]

Modifys a quota entry. If the type, target, volume, and tree exist, the entry is modified. If the type, target, volume, and tree do not exist, then an error is returned.

Inputs

Outputs

quota_off

[Family: vserver]

Turns the quota subsystem off for a volume.

For clustered volumes, a jobid will also be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

quota_on

[Family: vserver]

Starts to turn quotas on for a volume. A successful return from this API does not mean that quotas are on, merely that an attempt to start it has been triggered. Use the quota-status API to check the status.

For clustered volumes, a jobid will also be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

quota_report_iter

[Family: cluster, vserver]

Iterate over the quota report in the cluster.

Inputs

Outputs

quota_resize

[Family: vserver]

Starts an ONTAP operation to resize quotas for a volume. A successful return from this API does not mean that the operation has finished, merely that an attempt to start it been triggered. Use the quota-status API to check the status.

For clustered volumes, a jobid will also be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

quota_set_entry

[Family: vserver]

Sets a quota entry. If the type, target, volume, and tree do not exist, a new entry is created. If the type, target, volume, and tree exist, then the entry is modified.

Inputs

Outputs

quota_status

[Family: vserver]

Obtains the status of quotas

Inputs

Outputs

quota_status_iter

[Family: cluster, vserver]

Iterate over quota status for all volumes in the cluster

Inputs

Outputs

security_trace_filter_create

[Family: vserver]

Creates a new Security trace entry.

Inputs

Outputs

security_trace_filter_delete

[Family: vserver]

Deletes the specified Security trace entry.

Inputs

Outputs

security_trace_filter_get_iter

[Family: cluster, vserver]

Gives information about one or more Security trace entries.

Inputs

Outputs

security_trace_filter_modify

[Family: vserver]

Modifies settings of a Security trace entry, even if it is in use.

Inputs

Outputs

security_trace_result_delete

[Family: vserver]

Delete the specified security tracing event record.

Inputs

Outputs

security_trace_result_show

[Family: cluster, vserver]

Retrieve the list of permission tracing results for the cluster.

Inputs

Outputs

security_login_create

[Family: cluster]

Create a new user account associated the specified application and authentication method.

Inputs

Outputs

security_login_delete

[Family: cluster]

Delete an existing user account object.

Inputs

Outputs

security_login_delete_iter

[Family: cluster]

Delete an existing user account or a group of user account objects.

Inputs

Outputs

security_login_get

[Family: cluster]

Get the attributes of a user account.

Inputs

Outputs

security_login_get_iter

[Family: cluster]

Iterate over a list of user account objects.

Inputs

Outputs

security_login_lock

[Family: cluster]

Lock a user account that uses password as the authentication method. Returns an error if the user account does not use password authentication.

Inputs

Outputs

security_login_modify

[Family: cluster]

Modify the attributes of a user account object. Omitted (optional) fields will not be changed.

Inputs

Outputs

security_login_modify_iter

[Family: cluster]

Modify the attributes of a user account or a group of user account objects.

Inputs

Outputs

security_login_modify_password

[Family: vserver]

Changes the password of a specified user.

Inputs

Outputs

security_login_role_config_get

[Family: cluster]

Get the attributes of a role configuration.

Inputs

Outputs

security_login_role_config_get_iter

[Family: cluster]

Iterate over a list of role objects.

Inputs

Outputs

security_login_role_config_modify

[Family: cluster]

Modify the specified attributes of role configuration object. Omitted (optional) fields will not be changed.

Inputs

Outputs

security_login_role_config_modify_iter

[Family: cluster]

Modify the attributes of role configuration or a group of role configuration objects.

Inputs

Outputs

security_login_role_create

[Family: cluster]

Create a new user role.

Inputs

Outputs

security_login_role_delete

[Family: cluster]

Delete an existing user role object.

Inputs

Outputs

security_login_role_delete_iter

[Family: cluster]

Delete an existing user role or a group of user role objects.

Inputs

Outputs

security_login_role_get

[Family: cluster]

Get the attributes of a user role.

Inputs

Outputs

security_login_role_get_iter

[Family: cluster]

Iterate over a list of user role objects.

Inputs

Outputs

security_login_role_modify

[Family: cluster]

Modify the attributes of user role object. Omitted (optional) fields will not be changed.

Inputs

Outputs

security_login_role_modify_iter

[Family: cluster]

Modify the attributes of user role or a group of user role objects.

Inputs

Outputs

security_login_unlock

[Family: cluster]

Unlock a user account that uses password as the authentication method. Returns an error if the user account does not use password authentication.

Inputs

Outputs

security_ssh_add

[Family: cluster, vserver]

Adds the input algorithms and ciphers to the SSH configuration. Existing algorithms and ciphers remain in the configuration. API will succeed if requested algorithm or cipher is not currently enabled in the configuration.

Inputs

Outputs

security_ssh_get_iter

[Family: cluster, vserver]

Display SSH configuration options

Inputs

Outputs

security_ssh_remove

[Family: cluster, vserver]

Removes the input algorithms and ciphers from the SSH configuration. API will succeed if requested algorithm or cipher is already currently enabled in the configuration.

Inputs

Outputs

security_ssh_reset

[Family: vserver]

Enable and replace SSH configuration options to this new setting

Inputs

Outputs

security_certificate_ca_issued_get

[Family: vserver]

Get the attributes of the security-certificate-ca-issued.

Inputs

Outputs

security_certificate_ca_issued_get_iter

[Family: cluster, vserver]

Iterate over a list of security-certificate-ca-issued objects.

Inputs

Outputs

security_certificate_create

[Family: cluster, vserver]

If a certificate is created with the existing Common Name then a new certificate is generated with a different serial number

Inputs

Outputs

security_certificate_delete

[Family: cluster, vserver]

Delete an existing security-certificate object.

Inputs

Outputs

security_certificate_delete_iter

[Family: cluster, vserver]

Delete an existing security-certificate or a group of security-certificate objects.

Inputs

Outputs

security_certificate_file_get_iter

[Family: cluster]

Iterate over a list of security-certificate-file objects.

Inputs

Outputs

security_certificate_generate_csr

[Family: cluster, vserver]

Generate a digital certificate signing request(CSR)

Inputs

Outputs

security_certificate_get

[Family: vserver]

Get the attributes of the security-certificate.

Inputs

Outputs

security_certificate_get_iter

[Family: cluster, vserver]

Iterate over a list of security-certificate objects.

Inputs

Outputs

security_certificate_install

[Family: cluster, vserver]

Install a digital certificate

Inputs

Outputs

security_certificate_revoke

[Family: cluster, vserver]

Revoke a digital certificate

Inputs

Outputs

security_certificate_sign

[Family: cluster, vserver]

Sign a certificate using self-signed root CA

Inputs

Outputs

security_ssl_get

[Family: vserver]

Get the attributes of SSL security

Inputs

Outputs

security_ssl_get_iter

[Family: cluster, vserver]

Get the attributes of SSL security

Inputs

Outputs

security_ssl_modify

[Family: cluster, vserver]

Modify SSL authentication for a Vserver. Only field(s) that are provided will be modified.

Inputs

Outputs

service_processor_get

[Family: cluster]

Get basic information about the device

Inputs

Outputs

service_processor_image_get

[Family: cluster]

Get information about installed firmware images

Inputs

Outputs

service_processor_image_modify

[Family: cluster]

Enable or disable automatic firmware update

Inputs

Outputs

service_processor_image_update

[Family: cluster]

Install new firmware image

Inputs

Outputs

service_processor_image_update_progress_get

[Family: cluster]

Get firmware update progress

Inputs

Outputs

service_processor_network_get

[Family: cluster]

Get the network configuration

Inputs

Outputs

service_processor_network_modify

[Family: cluster]

Modify the network configuration

Inputs

Outputs

service_processor_reboot

[Family: cluster]

Reboot the Service Processor

Inputs

Outputs

storage_shelf_bay_list_info

[Family: cluster]

Returns information about storage shelf bays and ports for a selected number of shelves, or optionally all shelves connected to the storage controller.

Inputs

Outputs

storage_shelf_environment_list_info

[Family: cluster]

Returns the environmental information for a selected number of shelves, or optionally all shelves connected to the storage controller.

Inputs

Outputs

storage_shelf_get_shelf_info

[Family: cluster]

This returns information about an identified shelf. The information is the number of bays present (bay-count), and which shelf bays have drives (bay-list). Shelf bays are numbered from 0 to bay-count minus 1. Shelf bay 0 is always on the right when looking at the front of the shelf. Incidentally, the bay-list may be empty indicating the absence of any drives. However, there are some shelf designs which require a disk drive in bay 0 or 1 for any SES functionality to operate (e.g., DS14 and DS14-Mk2-FC). In these cases, shelves without drives in bay 0 or 1 will not be listed.

Inputs

Outputs

storage_shelf_list_info

[Family: cluster]

This interface returns information about one or more shelves.

Inputs

Outputs

sis_disable

[Family: vserver]

Disable sis on a volume. If the sis operation is active on the volume, it needs to be stopped by "sis-stop" API before disabling.

This API is not supported for Infinite Volumes.

Inputs

Outputs

sis_disable_async

[Family: vserver]

Disable sis on an Infinite Volume. If the sis operation is active on the Infinite Volume, it needs to be stopped by "sis-stop-async" API before disabling.

This API is not supported for Flexible Volumes. This API is not supported on Infinite Volume constituents or Infinite Volumes that are managed by storage services.

Inputs

Outputs

sis_enable

[Family: vserver]

Enable sis on a volume.

On a non-SnapVault secondary volume, the sis operation will be started periodically according to a per-volume schedule. By default, this schedule is sun-sat@0. (Everyday at 0:00 hours) On a SnapVault secondary volume, the sis operation will be kicked off at the end of the SnapVault transfer. This API does not enable compression on the volume. See the "sis-set-config" API for options to enable compression and for modifying the default schedule set on the volume. A sis operation can also be manually started using the sis-start API.

This API is not supported for Infinite Volumes.

Inputs

Outputs

sis_enable_async

[Family: vserver]

Enable sis on an Infinite Volume.

This is similar to 'sis-enable' API except that it operates on an Infinite Volume. Read about 'sis-enable' API for specific details.

This API is not supported for Flexible Volumes. This API is not supported on Infinite Volume constituents or Infinite Volumes that are managed by storage services.

Inputs

Outputs

sis_get

[Family: vserver]

Get status of a sis volume.

Inputs

Outputs

sis_get_iter

[Family: cluster, vserver]

Iterate over a list of sis volumes.

Inputs

Outputs

sis_policy_create

[Family: vserver]

Create a new sis policy.

Inputs

Outputs

sis_policy_delete

[Family: vserver]

Delete a sis policy.

Inputs

Outputs

sis_policy_get

[Family: vserver]

Get attributes of a sis policy.

Inputs

Outputs

sis_policy_get_iter

[Family: cluster, vserver]

Iterate over a list of sis policy objects.

Inputs

Outputs

sis_policy_modify

[Family: vserver]

Modify the attributes of a sis policy.

Inputs

Outputs

sis_set_config

[Family: vserver]

Setup or modify sis policy, schedule or options for a volume.

This API is not supported for Infinite Volumes.

Inputs

Outputs

sis_set_config_async

[Family: vserver]

Setup or modify sis policy, schedule or options for an Infinite Volume.

This API is not supported for Flexible Volumes. This API is not supported on Infinite Volume constituents or Infinite Volumes that are managed by storage services.

Inputs

Outputs

sis_start

[Family: vserver]

Start a sis operation on a volume. The volume must have sis enabled, before starting a sis operation. If the sis operation is already active on the volume, this API will fail.

This API is not supported for Infinite Volumes.

Inputs

Outputs

sis_start_async

[Family: vserver]

Start a sis operation on an Infinite Volume. The Infinite Volume must have sis enabled, before starting a sis operation. If the sis operation is already active on the Infinite Volume, this API will fail.

This API is not supported for Flexible Volumes. This API is not supported on Infinite Volume constituents or Infinite Volumes that are managed by storage services.

Inputs

Outputs

sis_status

[Family: cluster, vserver]

Get Status of a sis volume This API is not optimal for use in Data ONTAP Cluster-Mode systems, and is deprecated. Use sis-get and sis-get-iter APIs for Data ONTAP Cluster Mode systems. This API is still supported for Data ONTAP 7-Mode systems.

Inputs

Outputs

sis_stop

[Family: vserver]

Abort currently active sis operation on the volume. The sis operation will remain paused and the operation can be resumed by "sis-start", SnapVault transfer, or the scheduler.

This API is not supported for Infinite Volumes.

Inputs

Outputs

sis_stop_async

[Family: vserver]

Abort currently active sis operation on the Infinite Volume. The sis operation will remain paused and the operation can be resumed by "sis-start-async" or the scheduler.

This API is not supported for Flexible Volumes. This API is not supported on Infinite Volume constituents or Infinite Volumes that are managed by storage services.

Inputs

Outputs

snapmirror_abort

[Family: cluster]

The snapmirror-abort API stops ongoing transfers for a SnapMirror relationship. The relationship is identified by its destination endpoint. You must specify the destination endpoint when using snapmirror-abort. On Data ONTAP Cluster-Mode, the snapmirror-abort API stops all of the active transfers to each associated volume on the receiving side in a set of load-sharing mirrors. Load-sharing mirrors are either up to date and serving data to clients, or they are lagging and not serving data to clients. If the snapmirror-abort API identifies an up-to-date load-sharing mirror, then SnapMirror transfers to associated up-to-date load-sharing mirrors in the set of load-sharing mirrors are also aborted. If the snapmirror-abort API identifies a lagging load-sharing mirror, then only the SnapMirror transfer associated with the lagging load-sharing mirror is aborted. After the snapmirror-abort API successfully completes its operation, the volume on the receiving side of the transfer might contain a restart checkpoint. The restart checkpoint can be used by a subsequent transfer to restart and continue the aborted SnapMirror transfer. Snapmirror-abort API must be used from the destination filer on Data ONTAP 7-Mode, and from the destination cluster on Data ONTAP Cluster-Mode.

This API is not supported if the destination end point is an Infinite Volume.

Inputs

Outputs

snapmirror_abort_async

[Family: cluster, vserver]

The snapmirror-abort-async API stops ongoing transfer for a SnapMirror relationship on Infinite Volume. The relationship is identified by its destination endpoint. You must specify the destination endpoint when using the snapmirror-abort-async API. After the snapmirror-abort-async API successfully aborted the transfer, the volume on the receiving side of the transfer might contain a restart checkpoint. The restart checkpoint can be used by a subsequent transfer to restart and continue the aborted SnapMirror transfer. Snapmirror-abort-async API must be used from the destination cluster on Data ONTAP Cluster-Mode. This API is not supported if the destination end point is a flexible volume or an Infinite Volume constituent. A job will be spawned to operate on the snapmirror and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_abort_iter

[Family: cluster]

The snapmirror-abort-iter API aborts SnapMirror transfers for one or more SnapMirror relationships. This API is not supported on Infinite Volume constituents.

Inputs

Outputs

snapmirror_break

[Family: cluster]

Breaks a SnapMirror relationship between a source and destination volume of a data protection mirror. When Data ONTAP breaks the relationship, the destination volume is made a read-write volume and can diverge from the source volume, client redirection is turned off on the destination volume, the restart checkpoint is cleared, and the clients can see the latest Snapshot copy. On Data ONTAP 7-Mode, no check to determined whether the operation is legal or successful is done. You need to query the status afterward by using the snapmirror-get-status API. Subsequent manual or scheduled SnapMirror updates to the broken relationship will fail until the SnapMirror relationship is re-established using the snapmirror-resync API. On Data ONTAP Cluster-Mode, this API applies only to data protection mirrors and not to load-sharing mirrors. The snapmirror-break API must be issued on destination filer on Data ONTAP 7-Mode, and on the destination cluster on Data ONTAP Cluster-Mode.

This API is not supported if the destination end point is an Infinite Volume.

Inputs

Outputs

snapmirror_break_async

[Family: cluster, vserver]

The snapmirror-break-async API breaks an Infinite Volume SnapMirror relationship between a source and destination volume of a data protection mirror. When Data ONTAP breaks the relationship, the destination volume is made a read-write volume and can diverge from the source volume, client redirection is turned off on the destination volume, the restart checkpoint is cleared, and the clients can see the latest Snapshot copy. You must specify the destination endpoint when using snapmirror-break-async. Subsequent manual or scheduled SnapMirror updates to the broken relationship will fail until the SnapMirror relationship is reestablished using the snapmirror-resync API. This API applies only to data protection mirrors for Infinite Volume. You must use the snapmirror-break-async API from the destination cluster. This API is not supported on Infinite Volume constituents. This API is not supported if the destination end point is a flexible volume. A job will be spawned to operate on the snapmirror and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_break_iter

[Family: cluster]

The snapmirror-break-iter API breaks one or more SnapMirror relationships.

Inputs

Outputs

snapmirror_check

[Family: cluster]

The snapmirror-check API starts an operation to compare the contents of a snapshot between the source volume and destination volume. You must specify the destination endpoint when using snapmirror-check. A job will be spawned to operate on the snapmirror and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_check_iter

[Family: cluster]

The snapmirror-check-iter API checks one or more SnapMirror relationships. A job will be spawned to operate on the snapmirror and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_create

[Family: cluster]

The snapmirror-create API creates a SnapMirror relationship between a source and destination volume. You can create either a load-sharing relationship or a data protection relationship using this API. You must specify the source endpoint and destination endpoint when using snapmirror-create. Before you can use this command you should have created a source and destination volume using the volume create command. The source volume should be in the online state and a read-write (RW) type. The destination volume should be in the online state and a data protection (DP) type. Note: The source volume might contain data and Snapshot copies prior to creating the Snapmirror relationship. If the destination volume is not empty, it must have a Snapshot copy in common with the source volume, that is, it must have once been a copy of the source volume. You must also take the volume style into consideration when creating SnapMirror relationships. Source and destination volumes might be required to be either both regular volumes or both striped volumes. Striped volumes might have the further restriction of requiring the same striping geometry on both the source and destination volume, and restriping volumes might be disallowed. Load-sharing mirrors have the following restrictions: They only use regular style volumes, no striped volumes. They are confined to a single Vserver; they are not allowed to span Vservers. A set of load-sharing mirrors can have one or more destination volumes. You create separate SnapMirror relationships between the common source volume and each destination volume to create the set of load-sharing mirrors. If the optional schedule is specified, the destination volume is initialized on the first scheduled update. The destination volume can also be initialized using the snapmirror-initialize API and the destination volumes in a set of load-sharing mirrors are initialized using the snapmirror-initialize-ls-set API. The snapmirror-create API must be used from the destination cluster.

Inputs

Outputs

snapmirror_destroy

[Family: cluster]

The snapmirror-destroy API removes only the SnapMirror relationship of a source volume and a destination flexVols, the volumes are not destroyed and Snapshot copies on the volumes are not removed. You must specify the destination endpoint when using snapmirror-destroy. The snapmirror-destroy API fails if a SnapMirror transfer for the SnapMirror relationship is in progress. A set of load-sharing mirrors might contain multiple destination volumes, each destination volume having a separate SnapMirror relationship with the common source volume. When used on one of the SnapMirror relationships from the set of load-sharing mirrors, the snapmirror-destroy API deletes the specified SnapMirror relationship from the set of load-sharing mirrors. The snapmirror-destroy API preserves the read-write or read-only attributes of the volumes of a SnapMirror relationship after the relationship is deleted. Therefore, a read-write volume that was the source of a SnapMirror relationship retains its read-write attributes, and a data protection volume or a load-sharing volume that was a destination of a SnapMirror relationship retains its read-only attributes. Note: When a SnapMirror relationship from a set of load-sharing mirrors is deleted, the destination volume becomes a data protection volume and retains the read-only attributes of a data protection volume. You can use this API from the source or from the destination cluster. When used from the destination cluster, the SnapMirror relationship information on the source and destination clusters is deleted. When used from the source cluster, only the SnapMirror relationship information on the source cluster is deleted. Note: If the relationship does not exist, this API will return success. This API is not supported if the destination end point is a Infinite Volume.

Inputs

Outputs

snapmirror_destroy_async

[Family: cluster, vserver]

The snapmirror-destroy-async API removes only the SnapMirror relationship of a source and a destination Infinite Volume, the volumes are not destroyed and Snapshot copies on the volumes are not removed. You must specify the destination endpoint when using snapmirror-destroy-async. The snapmirror-destroy-async API fails if a SnapMirror transfer for the SnapMirror relationship is in progress. The snapmirror-destroy-async API preserves the read-write or read-only attributes of the volumes of a SnapMirror relationship after the relationship is deleted. Therefore, a read-write volume that was the source of a SnapMirror relationship retains its read-write attributes, and a data protection volume that was a destination of a SnapMirror relationship retains its read-only attributes. The snapmirror-destroy-async API should be used from the destination cluster. When used in this fashion, the destination-side information will be cleaned up. The destination will also attempt to cleanup source-side information. If the source cluster is not available, the destination-side information will still be cleaned up. This API is not supported if the destination end point is a flexible volume or an Infinite Volume constituent. A job will be spawned to operate on the snapmirror and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_destroy_iter

[Family: cluster]

Removes one or a group of SnapMirror relationships. This API is not supported on Infinite Volume constituents.

Inputs

Outputs

snapmirror_get

[Family: cluster]

Get the attributes of a SnapMirror relationship. You must specify the destination endpoint when using snapmirror-get.

Inputs

Outputs

snapmirror_get_destination

[Family: cluster, vserver]

The snapmirror-get-destination API returns information about a SnapMirror relationship whose source endpoint is on the cluster or Vserver it is issued on. The destination endpoint must be specified when using this API. The source endpoint can also be specified.

The cluster or Vserver may have several entries for the specified endpoints, but with different relationship IDs. In this case the API returns information about the first entry. To get information about all the SnapMirror relationships matching the specified endpoints, the snapmirror-get-destination-iter API must be used.

Note that the information for a SnapMirror relationship will not be available on its source Vserver or source cluster until at least one transfer is initiated.

The information returned can be stale. Stale information corresponds to a SnapMirror relationship that has been deleted on its destination cluster or Vserver.

This API is only supported on Data ONTAP 8.2 and above operating in Cluster-Mode.

This API must be issued on the source Vserver or the source cluster of the relationship.

Inputs

Outputs

snapmirror_get_destination_iter

[Family: cluster, vserver]

The snapmirror-get-destination-iter API returns information about, one or more SnapMirror relationships whose source endpoints are in the Vserver or the cluster the API is issued on.

The information returned can be stale. Stale information corresponds to a SnapMirror relationship that has been deleted on its destination cluster or Vserver. Stale information may result to several entries being returned with the same source and destination endpoints, but with different relationship IDs.

Note that the information for a SnapMirror relationship will not be available on its source Vserver or source cluster until at least one transfer is initiated.

This API is only supported on Data ONTAP 8.2 and above operating in Cluster-Mode. It can be issued on a Vserver or a Cluster.

Inputs

Outputs

snapmirror_get_iter

[Family: cluster]

Iterate over a list of SnapMirror relationships.

Inputs

Outputs

snapmirror_get_total_records

[Family: cluster]

Obtain the total number of SnapMirror relationships. This is a point in time estimate and may be different on subsequent calls.

Inputs

Outputs

snapmirror_get_volume_status

[Family: cluster]

Returns SnapMirror status values for a given volume. Including whether: the volume is a source of a SnapMirror relationship; the volume is a destination of a SnapMirror relationship; a transfer is in progress; the relationship is broken off. On Data ONTAP Cluster-Mode, this API is provided for backward compatibility only. It will fail if the volume is the source or destination of a non Data Protection (DP) SnapMirror relationship. On Data ONTAP Cluster-Mode, this API must be issued on the cluster the volume belongs to.

Inputs

Outputs

snapmirror_initialize

[Family: cluster]

Performs the initial update of a SnapMirror relationship. You must specify the destination endpoint when using snapmirror-initialize. This API must be used from the destination filer on Data ONTAP 7-Mode, or from the destination cluster on Data ONTAP Cluster-Mode. On Data ONTAP 7-Mode, If the destination endpoint is a volume, the volume must be in the restricted state. If the destination endpoint is a qtree, the qtree must not already exist. On Data ONTAP Cluster-Mode, this API is usually used after the snapmirror-create API, but it can be used alone, that is, without the snapmirror-create API, to create and initially update a SnapMirror relationship. A job will be spawned to operate on the SnapMirror relationship, and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_initialize_iter

[Family: cluster]

The snapmirror-initialize-iter API initializes the destination volume of one or more SnapMirror relationships. A job will be spawned to operate on the snapmirror and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_initialize_ls_set

[Family: cluster]

The snapmirror-initialize-ls-set API performs the initial manual update of a set of load-sharing mirrors. This API is usually used after the snapmirror-create API is used to create a SnapMirror relationship for each of the destination volumes in the set of load-sharing mirrors. You must specify the source endpoint when using snapmirror-initialize-ls-set. Data and Snapshot copies are transferred from the source volume to all up-to-date destination volumes in the set of load-sharing mirrors. Use the snapmirror-initialize API to add and initialize a new destination volume to an existing set of load-sharing mirrors. A job will be spawned to operate on the snapmirror and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_modify

[Family: cluster]

The snapmirror-modify API allows you to change one or more parameters of a SnapMirror relationship. The key parameter that identifies any SnapMirror relationship is the destination volume. You must specify the destination endpoint when using snapmirror-modify. For load-sharing mirrors, a change to a parameter affects all of the SnapMirror relationships in the set of load-sharing mirrors. Destination volumes in a set of load-sharing mirrors do not have individual parameter settings. Changes made by the snapmirror-modify API do not take effect until the next manual or scheduled update of the SnapMirror relationship. Changes do not affect updates that have started and have not finished yet. The snapmirror-modify API must be used from the destination cluster. This API is not supported on Infinite Volume constituents.

Inputs

Outputs

snapmirror_modify_iter

[Family: cluster]

The snapmirror-modify-iter API allows you to change one or more parameters of one or more SnapMirror relationships. This API is not supported on Infinite Volume constituents.

Inputs

Outputs

snapmirror_promote

[Family: cluster]

The snapmirror-promote API performs a failover to the destination volume of a load-sharing SnapMirror relationship. This API changes the destination volume from a load-sharing volume to a read-write volume and makes the destination volume assume the identity of the source volume. The API then destroys the original source volume. The destination volume must be a load-sharing volume. However, you can still perform 'snapmirror-promote' on a destination load-sharing volume that has been left in read-write state by a previously failed promote operation. You must specify the destination endpoint when using snapmirror-promote. Note: The source volume and destination volume must be on the same Vserver for the promote to work. Client accesses are redirected from the original source volume to the promoted destination volume. The view clients see on the promoted destination volume is the latest transferred Snapshot copy, which might lag behind the view clients had of the original source volume before the promote. The SnapMirror relationship is usually deleted as part of the promotion process. This is not true for a set of load-sharing mirrors that contain more than one destination volume. In this case, the promoted destination volume becomes the new source volume to the set of load-sharing mirrors. It is possible that the original source volume is the source of multiple SnapMirror relationships. For such a configuration, the promoted destination volume becomes the new source volume of the other SnapMirror relationships. The snapmirror-promote API fails if a SnapMirror transfer is in progress for any SnapMirror relationship involving the original source volume.

Inputs

Outputs

snapmirror_promote_iter

[Family: cluster]

The snapmirror-promote-iter API performs failover for one or more SnapMirror relationships.

Inputs

Outputs

snapmirror_quiesce

[Family: cluster]

Disables future transfers to a SnapMirror destination. If there is no transfer in progress, the SnapMirror relationship becomes 'Quiesced'. If there is a transfer in progress, the SnapMirror relationship becomes 'Quiescing' until the transfer completes. If the current transfer aborts, it will be treated like a future transfer and will not restart. When a SnapMirror relationship is quiesced, it remains in that state across reboots and fail-overs. The relationship must exist on the destination and you must specify the destination endpoint when using snapmirror-quiesce. On Data ONTAP Cluster-Mode, if applied to a load-sharing (LS) SnapMirror relationship, all the relationships in the set will be quiesced. This API must be issued on the destination filer on Data ONTAP 7-Mode, and on the destination cluster on Data ONTAP Cluster-Mode.

Inputs

Outputs

snapmirror_quiesce_iter

[Family: cluster, vserver]

Disables future transfers for one or more SnapMirror relationships.

Inputs

Outputs

snapmirror_release

[Family: cluster, vserver]

The snapmirror-release API removes a SnapMirror relationship on the source endpoint. It unlocks and cleanups the snapshots pertaining to the relationship. It does not destroy any volume. You must specify the destination endpoint when using snapmirror-release. Unless relationship-info-only is specified, this operation will fail if it is unable to reach the source volume and clean up snapshots. On Data ONTAP 8.2 or later operating in Cluster-Mode, this API must be executed on the source Vserver or source cluster following the deletion of the relationship on the destination Vserver or destination cluster. It is possible to issue snapmirror-release on the source Vserver without deleting the relationship on the destination Vserver. However, the relationship will continue to exist because the destination is the authority. The relationship will reappear on the source on the next transfer. On Data ONTAP operating in 7-Mode, this API must be issued on the source storage system. On Data ONTAP 8.2 or later operating in Cluster-Mode, this API must be issued on the source Vserver if operating in Vserver context and on the source cluster if operating in a cluster context. This API is not supported on Data ONTAP 8.1 operating in Cluster-Mode, or Data ONTAP 8.2 or later operating in Cluster-Mode if the relationship control plane is 'v1'.

Inputs

Outputs

snapmirror_release_iter

[Family: cluster, vserver]

releases one or a group of SnapMirror relationships.

Inputs

Outputs

snapmirror_restore

[Family: cluster, vserver]

The snapmirror-restore API restores the contents of a selected Snapshot copy from the source volume to the active file system of the destination volume. The destination volume is read write after the data is restored. The snapmirror-restore API creates a temporary SnapMirror relationship of the type RST. For this reason the destination volume cannot be the destination volume of another SnapMirror relationship. The temporary RST relationship is deleted after the operation completes successfully. If the destination volume is an empty data protection volume, the snapmirror-restore API performs a baseline restore. The baseline restore transfers the contents of the selected Snapshot copy from the source volume to the destination volume. If the destination volume is read-write and has at least one Snapshot which also appears on the source volume, an incremental restore is performed. The destination volume is made read only, if is not already read only. When the destination volume is made read only the latest snapshot on destination volume is made the exported snapshot. Note, that any data written to the destination volume since the last snapshot is lost during this operation. To save the contents of the active file system on the destination volume, stop all client access and take a snapshot before starting this operation. During an incremental restore a common Snapshot copy is selected. The snapshot chosen as the common snapshot must be on the source and destination volumes. The contents of the common Snapshot copy on the destination volume are copied to the active file system of the destination volume. Then the contents of the Snapshot copy to be restored are transferred from the source volume to the destination volume. Unless 'source-snapshot' is specified the most recent Snapshot copy on the source volume is restored. This API may be used to restart a failed snapmirror-restore operation. This API may be used to terminate an aborted or failed snapmirror-restore operation by specifying the 'clean-up-failure' parameter set to 'true'. Terminating an aborted or failed snapmirror-restore operation deletes any residual temporary RST relationship and converts the destination volume back to read-write if the destination volume was read-write prior to initial snapmirror-restore operation while removing any data transferred or copied during the snapmirror-restore operation. A job will be spawned to operate on the snapmirror and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_resume

[Family: cluster]

Enables future transfers for a SnapMirror relationship that has been quiesced. If there is a scheduled transfer, it will be triggered on the next schedule. If there is a restart checkpoint, it will be re-used if possible. On Data ONTAP Cluster-Mode, If applied on a load-sharing SnapMirror relationship, transfers will resume for all the relationships of the set. When a quiesced SnapMirror relationship is resumed, it remains in that state across reboots and fail-overs. The relationship must exist on the destination and you must specify the destination end point when using snapmirror-resume. This API must be issued on the destination filer on Data ONTAP 7-Mode, and on the destination cluster on Data ONTAP Cluster-Mode.

Inputs

Outputs

snapmirror_resume_iter

[Family: cluster, vserver]

Enables future transfers for one or more SnapMirror relationships.

Inputs

Outputs

snapmirror_resync

[Family: cluster]

Re-establishes a mirroring relationship between a source volume and a destination volume, typically in the following cases: Attention: The snapmirror-resync API can cause data loss on the destination volume because the API can remove the exported Snapshot copy on the destination volume. The snapmirror-resync API operates by finding the most recent common Snapshot copy between the source and destination volumes, removes Snapshot copies on the destination volume that are newer than the common Snapshot copy, and makes the common Snapshot copy the temporary exported Snapshot copy on the destination volume. The API next takes a Snapshot copy of the source volume to capture the current image and transfers Snapshot copies that are newer than the common Snapshot copy from the source volume to the destination volume. The snapmirror-resync API finally makes the newest Snapshot copy on the destination volume the new exported Snapshot copy. The snapmirror-resync API fails if the destination volume does not have a Snapshot copy in common with the source volume. On Data ONTAP Cluster-Mode a job is spawned to operate on the SnapMirror relationship and the job id is returned. The progress of the job can be tracked using the job APIs. On Data ONTAP 7-Mode, the update is asynchronously handled, and there is no guarantee that it succeeds. This requires that a schedule in /etc/snapmirror.conf is set for the destination. The API must be issued on the destination filer on Data ONTAP 7-Mode, and on the destination cluster on Data ONTAP Cluster-Mode.

Inputs

Outputs

snapmirror_resync_iter

[Family: cluster]

The snapmirror-resync-iter API reestablishes one or more previously broken SnapMirror relationships. This API is not supported on Infinite Volume constituents. A job will be spawned to operate on the snapmirror and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_snapshot_owner_create

[Family: vserver]

Add an owner to preserve a Snapshot copy for a SnapMirror mirror-to-vault cascade configuration.

Inputs

Outputs

snapmirror_snapshot_owner_destroy

[Family: vserver]

Delete an owner used to preserve a Snapshot copy for a SnapMirror mirror-to-vault cascade configuration.

Inputs

Outputs

snapmirror_snapshot_owner_get

[Family: cluster, vserver]

List all owners used to preserve a Snapshot copy for a SnapMirror mirror-to-vault cascade configuration.

Inputs

Outputs

snapmirror_snapshot_owner_get_snapshots

[Family: cluster, vserver]

List all Snapshot copies that are preserved for a SnapMirror mirror-to-vault cascade configuration.

Inputs

Outputs

snapmirror_update

[Family: cluster]

Updates the destination endpoint of the SnapMirror relationship. The update is asynchronously handled, and there is no guarantee that it will succeed. On Data ONTAP 7-Mode the snapmirror-get-status API can be used to check the status of the update. The API must be issued on the destination filer. On Data ONTAP Cluster-Mode a job is spawned to operate on the SnapMirror relationship and the job id is returned. The progress of the job can be tracked using the job APIs. You must specify the destination endpoint when using snapmirror-update. The API makes the destination volume an up-to-date mirror of the source volume. This API must be used from the destination filer on Data ONTAP 7-Mode, or from the destination cluster on Data ONTAP Cluster-Mode. On Data ONTAP 7-Mode, if the destination endpoint is a volume, the volume must be in the restricted state. If the destination endpoint is a qtree, the qtree must not already exist. On Data ONTAP Cluster-Mode if the destination volume is empty, the snapmirror-update API will fail. The snapmirror-initialize API must be called to perform the baseline transfer before the the snapmirror-update can be called. If the destination volume is not empty, the snapmirror-update API performs an incremental transfer. During an incremental transfer, Data ONTAP takes a Snapshot copy on the source volume to capture the current image of the source volume, finds the most recent common Snapshot copy between the source and destination volumes, and incrementally transfers Snapshot copies that are newer than the common Snapshot copy to the destination volume. After the snapmirror-update API successfully completes, the last Snapshot copy transferred is made the new exported Snapshot copy on the destination volume. If the snapmirror-update does not finish successfully, due to a network failure or because a snapmirror-abort API was issued for example, a restart checkpoint might be recorded on the destination volume. If a restart checkpoint is recorded, the next update restarts and continues the transfer from the restart checkpoint. On Data ONTAP Cluster-Mode you can use the snapmirror-update API to update a specific load-sharing mirror that lags behind up-to-date destination volumes in the set of load-sharing mirrors. An update to the lagging load-sharing mirror should bring it up to date with the other up-to-date destination volumes in the set of load-sharing mirrors. Note: You might have to run the snapmirror-update API more than once if the command does not finish before the next scheduled update of the set of load-sharing mirrors. The snapmirror-update API must be used from the destination cluster.

Inputs

Outputs

snapmirror_update_iter

[Family: cluster]

The snapmirror-update-iter API updates the destination volumes of one or more SnapMirror relationships. This API is not supported on Infinite Volume constituents. A job will be spawned to operate on the snapmirror and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_update_ls_set

[Family: cluster]

The snapmirror-update-ls-set API updates destination volumes of the set of load-sharing mirrors. The API makes destination volumes, in the group of load-sharing mirrors, up-to-date mirrors of the source volume. You must specify the source endpoint when using snapmirror-update-ls-set. Separate SnapMirror transfers are performed from the source volume to each of the up-to-date destination volumes in the set of load-sharing mirrors. Load-sharing mirrors that lag behind the up-to-date destination volumes might not be updated by the snapmirror-update-ls-set API. Use the snapmirror-update API to update a lagging load-sharing mirror. A job will be spawned to operate on the snapmirror and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

snapmirror_policy_add_rule

[Family: vserver]

Add a rule to SnapMirror policy

Inputs

Outputs

snapmirror_policy_create

[Family: vserver]

Create the specified SnapMirror Policy

Inputs

Outputs

snapmirror_policy_delete

[Family: vserver]

Delete the specified SnapMirror Policy

Inputs

Outputs

snapmirror_policy_get

[Family: vserver]

Get Information about a single SnapMirror Policy

Inputs

Outputs

snapmirror_policy_get_iter

[Family: cluster, vserver]

Get Information about multiple SnapMirror Policies

Inputs

Outputs

snapmirror_policy_modify

[Family: vserver]

Modify the specified SnapMirror Policy

Inputs

Outputs

snapmirror_policy_modify_rule

[Family: vserver]

Modify a SnapMirror policy rule

Inputs

Outputs

snapmirror_policy_remove_rule

[Family: vserver]

Remove a rule from SnapMirror policy

Inputs

Outputs

snapshot_autodelete_list_info

[Family: vserver]

Returns the current snapshot autodelete settings.

Inputs

Outputs

snapshot_autodelete_set_option

[Family: vserver]

Set the option named 'option-name' to the value specified by 'option-value' in the autodelete settings of the specified volume.

Inputs

Outputs

snapshot_create

[Family: vserver]

Create a new snapshot on a specified volume.

This API is not supported on Infinite Volume.

Inputs

Outputs

snapshot_create_async

[Family: vserver]

Create a new snapshot on a specified Infinite Volume.

This API is not supported on flexible volumes and Infinite Volume constituents.

Inputs

Outputs

snapshot_delete

[Family: vserver]

Delete a snapshot on a specified volume. EBUSY is returned when the snapshot is in use. EROFS is returned when the volume is read-only. EAGAIN is returned when splitting a blockmap or reverting.

This API is not supported on Infinite Volume.

Inputs

Outputs

snapshot_delete_async

[Family: vserver]

Delete a snapshot on a specified Infinite Volume. EBUSY is returned when the snapshot is in use. EROFS is returned when the Infinite Volume is read-only. EAGAIN is returned when splitting a blockmap or reverting.

This API is not supported on flexible volumes and Infinite Volume constituents.

Inputs

Outputs

snapshot_delta_info

[Family: vserver]

Returns the amount of space consumed between two snapshots or a snapshot and active filesystem.

Inputs

Outputs

snapshot_get_iter

[Family: cluster, vserver]

Iterate over a list of snapshot objects.

Inputs

Outputs

snapshot_get_reserve

[Family: vserver]

Obtain the current snapshot reserve on a specified volume. Error Returns: Invalid volume name.

Inputs

Outputs

snapshot_get_schedule

[Family: vserver]

Obtain the current snapshot schedule on a specified volume. Error Returns: Invalid volume name.

Inputs

Outputs

snapshot_list_info

[Family: vserver]

Return snapshot information for a specified volume. A list of snapshots and information about each snapshot is returned. In Data ONTAP Cluster-Mode, 'snapshot-get-iter' API is the preferred way of retrieving snapshot information.

Inputs

Outputs

snapshot_modify_iter

[Family: cluster, vserver]

Modify the attributes of snapshot or a group of snapshot objects.

Inputs

Outputs

snapshot_multicreate

[Family: vserver]

Create a snapshot with the specific name, on each of the specified volumes. It is the caller's responsibility to ensure that the data in the snapshots across all volumes is consistent, by quiescing I/O to these volumes (or the LUNs of interest in these volumes), across the call to this API. The API returns SUCCESS when a snapshot is successfully created on each of the specified volumes. This API bails out and reports FAILURE when an error is found at creating a snapshot on a volume. It does not continue on to create snapshots on the remaining volumes. When the API fails, the returned error code is for the failed volume. For clustered systems, the output 'status' will be set to FALSE in case of failure. In such case the caller should look at the output 'volume-errors' to find out in which volume snapshot creation failed. When an error occurs, it is possible that some snapshots may have been created. If the option cleanup is set to TRUE (default), API will attempt to delete these snapshots (but snapshot deletion may fail). When set to FALSE, it is users' responsibility to delete them. The output array volume-snapcreated-list records for each volume, if a snapshot has been created or not. There are at least two expected use cases for this API. The first one is to call this API with the cleanup option set to TRUE (default). If the call fails, any successfully created snapshots will be deleted before the function returns. This is a simple use case, but has the downside that in case of a failure, the call may take a long time to return due to snapshot cleanup. Another use case would be to call this API in a time critical environment. In such a scenario, it would be good to reduce the impact due to a failure. Hence, it would be better to first call the snapshot-multicreate-validate ZAPI, which would reduce the likelihood of failure of the snapshot-multicreate API. In case a failure does occur, the caller could avoid the cleanup delay by setting the cleanup option to FALSE, and performing snapshot cleanup later, outside the time-critical window.

Inputs

Outputs

snapshot_multicreate_validate

[Family: vserver]

This is a companion API of snapshot-multicreate. It validates the snapshot creation operation on the specified volumes. But it does not actually create any snapshot. This API only does validations on all volumes and report all errors in the output array. This API is intended to be issued before the snapshot-multicreate API to find out all the errors that may be found during the snapshot create. Its main purpose is to enable snapshot-multicreate's caller to reduce the likelihood of snapshot-multicreate's failure, thereby attempting to avoid the cleanup overhead (of deleting any newly created snapshots) during failure processing. However, this validation API does not guarantee that snapshot-multicreate API will actually work. Something could change between the two calls to cause the actual snapshot creations to fail.

Inputs

Outputs

snapshot_multidelete

[Family: vserver]

Delete the snapshot from the given flexible volumes. This API will return failure if the volume could not be found or it is busy. All the volumes should be online when this API is invoked. It will only delete snapshots on Read-Write volumes. Once all the necessary information to delete snapshots is available, this API will start deleting snapshots on the volumes. If any of the snapshot delete failed, the API will remember the failed volume and continue deleting snapshot on the remaining volumes. In case of failure to delete the snapshots from all the given volumes, the API will return a SUCCESS and also return information about the failed snapshot deletes via the 'volume-errors' output. If the API returns SUCCESS, the applications should check if the 'volume-errors' output is returned or not to check for failed snapshot deletions.

This API is not supported on Infinite Volume.

Inputs

Outputs

snapshot_multirename

[Family: vserver]

Rename Snapshot copies with a specific name to a new name across multiple volumes. The API processes all the specified volumes even if rename fails on one or more volumes. The snapshot-multirename-errors field should be inspected for failures even if the API is successful.This API is not supported on Infinite Volume.

Inputs

Outputs

snapshot_partial_restore_file

[Family: vserver]

Restores a particular range of bytes in a file from a specified snapshot.

Partial file restores are used to restore particular pieces of LUNs and NFS or CIFS container files that are used by a host to store multiple sources of data. For example, a host may be storing multiple user databases in the same LUN. A partial file restore can be used to restore one of those databases in the LUN while not touching the other databases that are also stored in the LUN. Compressed files will not be restored, thought compression may be enabled on the volume.

Partial file restores require significant management by the caller. The caller must understand the metadata of the host LUN or container file so that they can know which bytes belong to the object being restored.

Before the restore operation beings, the caller must quiesce the object being restored. It must remain quiesced for the duration of the restore operation. No host I/O should be issued for the object while it is being restored because the snapshot-partial-restore-file commands will be incrementally restoring the LUN or file and the host will therefore see inconsistent content for the object until the restore operation is completed. Host I/O is permitted for the other objects stored in the LUN or container file because the partial file restore will not touch the bytes belonging to those other objects.

During the restore the caller must issue a snapshot-partial-restore-file command for each of the byte ranges that belong to the object being restored, based on the metadata of the LUN or container file. Once each command returns, that byte range is restored and the changes are persistent. If the filer should halt while processing a command, that byte range of the LUN or container file is inconsistent. Some of the bytes at the beginning of the range may have been restored while bytes at the end of the range have not been restored. Once the filer is rebooted the caller should re-issue the command to restore that byte range to complete the restore.

Once the restore is completed, the caller must purge any host operating system or application buffers that may hold data for the LUN or file that is now stale. For NFS or CIFS mounted volumes the easiest way to purge any host buffers is to unmount and remount the volume. Applications holding buffered data may need to be shut down and restarted.

Multiple partial file restore requests may be issued to the same LUN or file simultaneously. There is no requirement that the requests are all restoring from the same snapshot so that multiple restore operations for different objects may be concurrent on the same file. There is no checking to prevent overlapping byte ranges between requests. Preventing this condition is the responsibility of the caller.

Partial file restores are not intended for restoring parts of normal user-level files that are stored in an NFS or CIFS exported volume. Use snapshot-restore-file to restore normal files like these.

The volume where the LUN or container file to restore and where the snapshot to restore from live must be online and must not be a mirror volume.

The partial file restore request may fail if there is not sufficient free space to overwrite all of the blocks in the byte range to be restored.

The partial file restore request is synchronous, meaning that the command will not return until the entire byte range is restored. The snapshot being restored from cannot be deleted while a request is being executed, but it can be deleted between requests. If this happens the next request will notice that the snapshot has been deleted and will return an error.

The maximum number of bytes of data that can be restored in a single request is given by the max-byte-count value returned by the snapshot-partial-restore-file-list-info command. This limit ensures that requests are periodically interruptible and avoids overloading the filer.

If the system halts while a partial file restore request is being executed, the request will not be restarted upon reboot. Some of the bytes at the beginning of the range may have been restored while bytes at the end of the range have not been restored. The caller should reissue the partial file restore request for that byte range to complete the restore.

Inputs

Outputs

snapshot_partial_restore_file_list_info

[Family: vserver]

Returns partial file restore settings of the vserver.

Inputs

Outputs

snapshot_policy_add_schedule

[Family: cluster]

Add a new schedule to the Snapshot Policy. A schedule can be created by using 'job-schedule-cron-create' or 'job-schedule-interval-create' APIs.

Inputs

Outputs

snapshot_policy_create

[Family: cluster]

Create a new Snapshot Scheduling Policy

Inputs

Outputs

snapshot_policy_delete

[Family: cluster]

Delete the specified Snapshot Scheduling Policy

Inputs

Outputs

snapshot_policy_get

[Family: cluster, vserver]

Get Information about a single Snapshot Policy

Inputs

Outputs

snapshot_policy_get_iter

[Family: cluster, vserver]

Get Information about multiple Snapshot Policies

Inputs

Outputs

snapshot_policy_modify

[Family: cluster]

Enable or Disable the specified Snapshot Scheduling Policy

Inputs

Outputs

snapshot_policy_modify_schedule

[Family: cluster]

Modify a snapshot policy

Inputs

Outputs

snapshot_policy_remove_schedule

[Family: cluster]

Remove a snapshot schedule from policy

Inputs

Outputs

snapshot_reclaimable_info

[Family: vserver]

Returns the amount of space that would be freed when a set of snapshots are deleted from a specified volume.

Inputs

Outputs

snapshot_rename

[Family: vserver]

Rename a specified snapshot to a new name on a specified volume. This API is not supported on Infinite Volume constituents.

Inputs

Outputs

snapshot_reserve_list_info

[Family: cluster, vserver]

Gets the percentage of disk space that is reserved for snapshots in the indicated volume. If no volume is specified, this will return the percentage of disk space reserved for snapshots for each of the volumes in the system. Reserve space can be used only by snapshots and not by the active file system.

Inputs

Outputs

snapshot_restore_file

[Family: vserver]

Reverts a single file to a revision from a specified snapshot. The volume used for restoring the file must be online and must not be a mirror. Files other than normal files and LUNs are not restored. This includes directories (and their contents), and files with NT streams. Compressed files will not be restored, though compression may be enabled on the volume.

If there is not enough space in the volume, the single file snap restore will not start. If the file already exists (in the active filesystem), it will be overwritten with the version in the snapshot. It could take up to several minutes for before the API invocation returns. During this time client exclusive oplocks are revoked and hard exclusive locks like the DOS compatibility lock are invalidated. Once the invocation returns, the file restore will proceed in the background.

For normal files while the restore is proceeding, any operation which tries to change the file will be suspended until the restore is done. The restore may take a long time to complete depending on the size of the file being restored. The file is unavailable for use during this time.

For LUNs that are restored over top of their existing LUN, a LUN clone can be created that is backed by the snapshot being restored from and then the clone is split. Snapshots are disabled during restore due to space efficient LUN clone split. In order to disable space efficient split during restore set the optional parameter space-efficient-split-disabled. While the restore is proceeding the LUN is available and I/O (both reads and writes) is permitted. Data that is modified in the LUN while the restore is proceeding will not be overwritten by the restore process. The restore may take a long time to complete depending on the size of the LUN being restored. Use lun-clone-status-list-info to see the progress of the LUN restore.

Other single file snap restores can be executed concurrently. Also it is possible for the single file snap restore to be aborted if we run out of disk space during the operation. When this happens the timestamp of the file being restored will be updated. Thus it will not be the same as the timestamp of the file in the snapshot.

For normal files, an in-progress restore can be aborted by removing the file. For NFS users, the last link to the file must be removed.

For LUNs that are restored over top of their existing LUN, an in-progress restore can be aborted by using lun-clone-stop when in 7-mode. The restored LUN will still be a clone in this case and it will still be partially backed by the snapshot it was restored from.

For all restored files, the snapshot used for the restore cannot be deleted. New snapshots cannot be created while a single-file snaprestore is in progress. Scheduled snapshots on the volume will be suspended for the duration of the restore. Tree, user and group quota limits are not enforced for the owner, group and tree in which the file is being restored. Thus if the user, group or tree quotas are exceeded, /etc/quotas will need to be altered after the single file snap restore operation has completed. Then quota resize will need to be run. When the restore completes, the file's attributes (size, permissions, ownership, etc.) should be identical as those in the snapshot.

If the system is halted or crashes while a single file snap restore is in progress then the operation will be restarted on reboot. A volume cannot have both a volume snaprestore and a single-file snaprestore executing simultaneously. Multiple single-file snaprestores can be in progress simultaneously.

Inputs

Outputs

snapshot_restore_file_info

[Family: vserver]

Get information about snapshot file restores on a given vserver. Returns maximum snapshot file restores limit and snapshot file restores in progress numbers.

Inputs

Outputs

snapshot_restore_volume

[Family: vserver]

Reverts a volume to a specified snapshot. The volume must be online and must not be a mirror. If reverting the root volume, the filer will be rebooted. Non-root volumes do not require a reboot. A volume cannot have both a volume snaprestore and a single-file snaprestore executing simultaneously. Multiple single-file snaprestores can be in progress simultaneously. After the reversion, the volume is in the same state as it was when the snapshot was taken.

This API is not supported on Infinite Volume.

Inputs

Outputs

snapshot_restore_volume_async

[Family: vserver]

Reverts an Infinite Volume to a specified snapshot. The Infinite Volume must be online and unmounted and must not be a mirror. After the reversion, the Infinite Volume is in the same state as it was when the snapshot was taken.

This API is not supported on flexible volumes and Infinite Volume constituents.

Inputs

Outputs

snapshot_set_reserve

[Family: vserver]

Sets the size of the indicated volume's snapshot reserve to the specified percentage. Reserve space can be used only by snapshots and not by the active file system.

Inputs

Outputs

snapshot_volume_info

[Family: vserver]

Returns snapshot related volume information. The information returned is valid at the time the API call reached the filer and maybe outdated soon after.

Inputs

Outputs

snmp_community_add

[Family: cluster]

Adds a community to the list of communities.

Inputs

Outputs

snmp_community_delete

[Family: cluster]

Deletes a community from the list of communities.

Inputs

Outputs

snmp_community_delete_all

[Family: cluster]

Deletes all the communities.

Inputs

Outputs

snmp_disable

[Family: cluster]

Disables snmp protocol.

Inputs

Outputs

snmp_enable

[Family: cluster]

Enables snmp protocol.

Inputs

Outputs

snmp_get

[Family: cluster]

Retrieves the value of a snmp object.

Inputs

Outputs

snmp_get_next

[Family: cluster]

This is used to retrieve the next OID in the mib tree of data. Instead of returning the data you requested, it returns the next OID in the tree and its value. Unlike the snmp-get api, this api does return data for a OID which is too short or is missing the index part of the OID.

Inputs

Outputs

snmp_status

[Family: cluster]

Returns configuration information of the SNMP agent daemon.

Inputs

Outputs

snmp_trap_disable

[Family: cluster]

Disables snmp traps.

Inputs

Outputs

snmp_trap_enable

[Family: cluster]

Enables snmp traps.

Inputs

Outputs

snmp_traphost_add

[Family: cluster]

Adds a host to the list of trap hosts.

Inputs

Outputs

snmp_traphost_delete

[Family: cluster]

Deletes a host from the list of trap hosts.

Inputs

Outputs

storage_adapter_enable_adapter

[Family: cluster]

Enables specified host adapter. I/O traffic can be issued on the adapter.

Inputs

Outputs

storage_adapter_get_adapter_info

[Family: cluster]

Display the information about a specified host adapter. The information is displayed base on the controller interface type. ATA, Paralell SCSI, SAS, FC.

Inputs

Outputs

storage_adapter_get_adapter_list

[Family: cluster]

Get the list of adapters present on this system.

Inputs

Outputs

storage_adapter_modify

[Family: cluster]

Modify the adapter state.

Inputs

Outputs

storage_array_get_config_summary

[Family: cluster]

Generates a high level summary of array LUN pathing (connectivity) information.

Inputs

Outputs

storage_array_list_info

[Family: cluster]

Retrieves a list of all array profiles known to the controller.

Inputs

Outputs

storage_array_modify

[Family: cluster]

Update an array profile with new or changed information.

Inputs

Outputs

storage_array_port_modify

[Family: cluster]

Update an array port with new or changed information.

Inputs

Outputs

storage_array_ports_list_info

[Family: cluster]

generate a list of array ports and their associated arrays

Inputs

Outputs

storage_array_rename

[Family: cluster]

Rename an array profile

Inputs

Outputs

storage_disk_get_iter

[Family: cluster]

Disk enumeration ZAPI. Get disk information about one or more disks, from the Storage Subsystem. Currently only the Data ONTAP Cluster-Mode iterator APIs support filtering of output, to constrain the disks that are included in the return list, and/or what information is returned about each disk. The default is to return all information about all disks in the cluster. That list may be reduced using the 'query' input element. For example, the return list may include only (1) Disks visible to a particular cluster node "nodeA", e.g., "query.disk-paths.disk-name=nodeA:*" (2) A particular disk visible to a particular node, e.g., "query.disk-paths.node=nodeA:6a.01". (3) A disk with a particular unique id, e.g., "query.disk-uid=20000000:87A9652B:00000000:00000000:00000000:00000000:00000000:00000000:00000000:00000000" (4) Disks with a name that matches a certain wildcard pattern, e.g., "query.disk-paths.disk-name=6a*". (5) Disks assigned to a particular node. e.g., "query.disk-ownership-info.home-node-id=1252487" or "query.disk-ownership-info.home-node-name=nodeA". (6) Some subset of disks in the cluster or visible to a particular node in the cluster. If 'desired-attributes' is included, then only those data specified by in 'desired-attributes' are returned for each disk. For the Data ONTAP 7-Mode API, since filtering based upon 'query' and 'desired-attributes' is not yet supported, the behavior is currently to return all available information about all disks visible to the local node. If there is badly formed input or an invalid input value is specified, then EINVALIDINPUTERROR is returned. If there is some internal error which prevents processing of this request, then EINTERNALERROR is returned.

Inputs

Outputs

storage_initiator_balance

[Family: cluster]

Balances primary/secondary array LUN paths across available initiator ports based on I/O load.

Inputs

Outputs

storage_initiator_disk_path_list_info

[Family: cluster]

Returns path information and statistics for a given disk or all disks. We use the word disk to refer to an array lun, real disk, or Solid State Device

Inputs

Outputs

storage_initiator_errors_list_info

[Family: cluster]

Lists all known disk/configuration errors associated with an array or shelves acting like array.

Inputs

Outputs

storage_initiator_get_load

[Family: cluster]

Gets disk I/O rates for a given fibre channel initiator port or for all initiator ports if no port is specified. The term disk refers to an array LUN, actual disk, or solid state device.

Inputs

Outputs

storage_initiator_path_list_info

[Family: cluster]

Returns information and statistics on all known paths to back end storage.

Inputs

Outputs

storage_initiator_path_quiesce

[Family: cluster]

Quiesces an array LUN on a path. A quiesced array LUN will not be sent I/O on the specified path.

Inputs

Outputs

storage_initiator_path_resume

[Family: cluster]

Resumes I/O to array LUN on a path that was previously quiesced. Resuming I/O to a non-quiesced array LUN is a no-op and not an error.

Inputs

Outputs

system_api_get_elements

[Family: cluster, vserver]

get elements for specified apis

Inputs

Outputs

system_api_list

[Family: cluster, vserver]

get list of apis. This returns the names only - to get the parameter info, use system-api-get-elements

Inputs

Outputs

system_api_list_types

[Family: cluster, vserver]

get list and description of typedefs

Inputs

Outputs

system_get_node_info_iter

[Family: cluster]

Obtain appliance information which includes cpu and backplane information. The output contains the head information in a sysconfig -a command. I/O information is not included. System refers to a node in a cluster.

Inputs

Outputs

system_get_ontapi_version

[Family: cluster, vserver]

Obtain the current ONTAPI major and minor versions.

Inputs

Outputs

system_get_vendor_info

[Family: cluster]

Obtain the Data ONTAP vendor information.

Inputs

Outputs

system_get_version

[Family: cluster, vserver]

Obtain the Data ONTAP version.

Inputs

Outputs

system_image_fetch_package

[Family: cluster]

Fetch a file from a URL. This API will return immediately. The progress can be monitored using the 'system-image-update-progress-get' API.

Inputs

Outputs

system_image_get_iter

[Family: cluster]

Display software image information

Inputs

Outputs

system_image_install

[Family: cluster]

Perform software image fresh install

Inputs

Outputs

system_image_modify

[Family: cluster]

Modify software image configuration

Inputs

Outputs

system_image_package_delete

[Family: cluster]

Delete a software package

Inputs

Outputs

system_image_package_get_iter

[Family: cluster]

Display software information for all packages

Inputs

Outputs

system_image_update

[Family: cluster]

Perform software image upgrade/downgrade. This API will return immediately. The progress can be monitored using the 'system-image-update-progress-get' API.

Inputs

Outputs

system_image_update_progress_get

[Family: cluster]

Show progress information for current or previous update

Inputs

Outputs

system_node_get

[Family: cluster]

Obtain the node information when the node is part of a cluster. Information returned includes details like location, serial-number, asset tag, uptime, vendor name etc.

Inputs

Outputs

system_node_get_iter

[Family: cluster]

Obtain the node information when the node is a part of the cluster in an iteration.

Inputs

Outputs

system_node_reboot

[Family: cluster]

Reboot the specified node. Only an admin can reboot the node. If attempted by a user with insufficient privileges EAPIPRIVILEGE is returned.

Inputs

Outputs

system_node_rename

[Family: cluster]

Rename the specified node to a new name specified by 'new-name'

Inputs

Outputs

system_node_shutdown

[Family: cluster]

Shut down a node. Only an admin can initiate a node shutdown. If attempted by a user with insufficient privileges EAPIPRIVILEGE is returned.

Inputs

Outputs

system_user_capability_get_iter

[Family: cluster, vserver]

Returns the objects and their operations which are permitted to user who called this API.

Inputs

Outputs

ucm_adapter_get

[Family: cluster]

Get the attributes of the UC Adapter.

Inputs

Outputs

ucm_adapter_get_iter

[Family: cluster]

Iterate over a list of UC Adapter objects.

Inputs

Outputs

ucm_adapter_modify

[Family: cluster]

Modify configuration of an adapter under the Unified Connect Management (UCM) framework, including the mode and/or the FC-4 type.

Inputs

Outputs

volume_autosize_get

[Family: vserver]

Given the name of a flexible volume, get the autosize settings.

Inputs

Outputs

volume_autosize_set

[Family: vserver]

Given the name of a flexible volume, set the autosize settings.

Inputs

Outputs

volume_clone_create

[Family: vserver]

Create a flexible volume that is a clone of a "backing" or "parent" flexible volume. A clone is a volume that is a writable snapshot of another volume. Initially, the clone and its parent share the same storage; more storage space is consumed only as one volume or the other changes. If a specific snapshot name within the parent volume is provided, it is chosen as the parent snapshot. Otherwise, the filer will create a new, distinctively- named snapshot in the parent volume for that purpose. The parent snapshot is locked in the parent volume, preventing its deletion until the clone is either destroyed or split from the parent using the 'volume-clone-split-start' command (see below). This command fails if the chosen parent volume is currently involved in a split operation. This command also fails if the chosen parent volume is a traditional volume. Cloning is a new capability that applies exclusively to flexible volumes.

Inputs

Outputs

volume_clone_get

[Family: vserver]

Display details of a specific FlexClone volume

Inputs

Outputs

volume_clone_get_iter

[Family: cluster, vserver]

Display a list of FlexClone volumes

Inputs

Outputs

volume_clone_split_estimate

[Family: vserver]

Display an estimate of additional storage required in the underlying aggregate to perform a volume clone split operation. This command fails if applied to a traditional volume. Cloning is a new capability that applies exclusively to flexible volumes.

Inputs

Outputs

volume_clone_split_start

[Family: vserver]

Begin the process by which the given clone is split off from its underlying parent volume and snapshot. New storage is allocated for the clone that is distinct from its parent. This process may take some time and proceeds in the background. Use the 'volume-clone-split-status' command to view the operation's progress. Both clone and parent volumes remain available during the process of splitting them apart. Upon completion, the snapshot on which the clone was based will be unlocked in the parent volume. Any snapshots in the clone are removed at the end of processing. Use the 'volume-clone-split-stop' command to stop this process. This command fails if applied to a traditional volume. Cloning is a new capability that applies exclusively to flexible volumes.

In Data ONTAP Cluster-Mode, a job is created to perform the split operation. The job id of the job is returned in the API response. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

volume_clone_split_status

[Family: vserver]

Display the progress in separating clones from their underlying parent volumes and snapshots. If a clone name is specified, then the split status for that clone is provided. If no clone name is provided, then status is provided for all clones currently being split. This command fails if applied to a traditional volume, and EONTAPI_EVOLNOTFLEX is thrown. Cloning is a capability that applies exclusively to flexible volumes. This command fails if the volume specified is not a clone, and EVOLNOTCLONE is thrown. This command fails if the volume specified is not being split, and EVOLOPNOTUNDERWAY is thrown.

Inputs

Outputs

volume_clone_split_stop

[Family: vserver]

Stop the process of splitting off a clone from its parent volume and snapshot. All of the blocks that were formerly shared between the given clone and its parent volume that have already been split off will remain that way. This command fails if applied to a traditional volume. Cloning is a new capability that applies exclusively to flexible volumes.

Inputs

Outputs

volume_container

[Family: vserver]

Return the name of the containing aggregate for the named flexible volume.

Inputs

Outputs

volume_copy_start

[Family: cluster]

Copy a volume A job will be spawned to operate on the volume and the job id will be returned. The progress of the job can be tracked using the job APIs.

Inputs

Outputs

volume_create

[Family: vserver]

Create a volume.

The maximum number of volumes (traditional or flexible in any combination) on a filer is determined by the amount of main memory. All filers with less than 8GB of memory can support a maximum of 200 volumes, and all others can support a maximum of 500 volumes.

The detailed behavior of this API depends on where it is received:

1. In Data ONTAP Cluster-Mode, create a new flexible volume.

2. In Data ONTAP 7-Mode, create a new flexible, traditional, or sparse volume with the given name and characteristics. Freshly-created traditional volumes may not be operational immediately after the API returns. Use 'volume-list-info' to obtain information about volumes, including the status of the newly-created traditional volume in order to determine when it is fully operational.

This API is not supported for Infinite Volumes.

Inputs