APIs in Category: system
Cluster-Mode API version 1.15

 
system-api-get-elements
system-api-list
system-api-list-types
system-get-node-info-iter
system-get-ontapi-version
system-get-vendor-info
system-get-version
system-image-fetch-package
system-image-get-iter
system-image-install
system-image-modify
system-image-package-delete
system-image-package-get-iter
system-image-update
system-image-update-progress-get
system-node-get
system-node-get-iter
system-node-reboot
system-node-rename
system-node-shutdown

NetApp Manage ONTAP
 
system-api-get-elements [top]

get elements for specified apis
Input Name Range Type Description
api-list api-list-info[]
list of apis to retrieve
 
Output Name Range Type Description
api-entries system-api-entry-info[]
 Errno  Description
 EAPIERROR

 
system-api-list [top]
get list of apis. This returns the names only - to get the parameter info, use system-api-get-elements
Output Name Range Type Description
apis system-api-info[]
 Errno  Description
 EAPIERROR

 
system-api-list-types [top]
get list and description of typedefs
Output Name Range Type Description
type-entries system-api-type-entry-info[]

 
system-get-node-info-iter [top]
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.
Input Name Range Type Description
desired-attributes system-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
max-records [1..100] integer
optional
The maximum number of records to return in this call. Default: 20
query system-info
optional
A query that specifies which objects to return. A query could be specified on any number of attributes in the system-info object. All system-info objects matching this query up to 'max-records' will be returned.
tag string
optional
Specify the tag from the last call. It is usually not specified for the first call. For subsequent calls, copy values from the 'next-tag' obtained from the previous call.
 
Output Name Range Type Description
attributes-list system-info[]
optional
The list of attributes of system-info objects.
next-tag string
optional
Tag for the next call. Not present when there are no more system-info objects to return.
num-records [0..100] integer
The number of records returned in this call.
 Errno  Description
 EINTERNALERROR

 
system-get-ontapi-version [top]
Obtain the current ONTAPI major and minor versions.
Output Name Range Type Description
major-version integer
Current ONTAPI major version supported by this appliance.
minor-version integer
Current ONTAPI minor version supported by this appliance.
node-ontapi-details node-ontapi-detail-info[]
optional
List of nodes along with the ONTAPI versions supported by each of them.

 
system-get-vendor-info [top]
Obtain the Data ONTAP vendor information.
Output Name Range Type Description
autosupport-email string
Vendor's autosupport e-mail target. Example is: "autosupport@netapp.com".
autosupport-url string
Vendor's autosupport URL target. Example is: "http://support.netapp.com/asupprod/post/1.0/postAsup".
complete-name string
Complete name of vendor. For example, "NetApp".
customer-support-contact string
Vendor's technical support contact information. For example, "Please contact NetApp Global Services.". Could include a global phone number.
customer-support-name string
Name of vendor's customer support organization. For example, "NetApp Global Services".
information-url string
Vendor's information URL. For example, "http://now.netapp.com/autosupport/"
ontap-oid-prefix string
Vendor's starting SNMP OID prefix for Data ONTAP. The suffix that follows is the NetApp MIB, netapp.mib. For example, ".1.3.6.1.4.1.789". To obtain the filer's model name, one would concatenate the OID prefix and ".1.1.5.0" from the NetApp MIB.
product-url string
Vendor's product information URL. For example, "http://now.netapp.com/installedproducts/"
short-name string
Vendor's short name. For example, "NetApp".
 Errno  Description
 EAPIERROR

 
system-get-version [top]
Obtain the Data ONTAP version.
Output Name Range Type Description
build-timestamp integer
optional
Time of build creation, in seconds since January 1, 1970, of the image running on the appliance or of the build whose Data ONTAP version is lowest across the cluster. This field is available in Data ONTAP 8.1 or later.
is-clustered boolean
If true, indicates Data ONTAP Cluster-Mode, else Data ONTAP 7-Mode. This field is available in Data ONTAP 8.1 or later.
node-version-details node-version-detail-info[]
optional
List of node names along with the Data ONTAP version running on each node. This field is returned only if the cluster is currently operating with more than one version of Data ONTAP.
version string
Current Data ONTAP version running on the appliance. If the cluster is currently operating with more than one version of Data ONTAP, then the lowest version of all is returned.
version-tuple system-version-tuple
optional
The Data ONTAP version tuple, lowest across the cluster i.e. the effective cluster version. This field is available in Data ONTAP 8.1 or later.

 
system-image-fetch-package [top]
Fetch a file from a URL. This API will return immediately. The progress can be monitored using the 'system-image-update-progress-get' API.
Input Name Range Type Description
node string
Node
package string
Package URL
rename-package string
optional
Rename the File
replace-package boolean
optional
Replace the Local File
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
system-image-get-iter [top]
Display software image information
Input Name Range Type Description
desired-attributes system-image-attributes
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
max-records [1..100] integer
optional
The maximum number of records to return in this call. Default: 20
query system-image-attributes
optional
A query that specifies which objects to return. A query could be specified on any number of attributes in the system object. All system objects matching this query up to 'max-records' will be returned.
tag string
optional
Specify the tag from the last call. It is usually not specified for the first call. For subsequent calls, copy values from the 'next-tag' obtained from the previous call.
 
Output Name Range Type Description
attributes-list system-image-attributes[]
optional
The list of attributes of system objects.
next-tag string
optional
Tag for the next call. Not present when there are no more system objects to return.
num-records [0..100] integer
The number of records returned in this call.
 Errno  Description
 EINTERNALERROR

 
system-image-install [top]
Perform software image fresh install
Input Name Range Type Description
node string
Node
package string
Package URL
rename-package string
optional
Rename the File
replace-package boolean
optional
Replace the Local File
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
system-image-modify [top]
Modify software image configuration
Input Name Range Type Description
image string
Image Name
is-default boolean
optional
Is Default Image
node string
Node
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
system-image-package-delete [top]
Delete a software package
Input Name Range Type Description
node string
Node
package string
Package File Name
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
system-image-package-get-iter [top]
Display software information for all packages
Input Name Range Type Description
desired-attributes system-image-package-attributes
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
max-records [1..100] integer
optional
The maximum number of records to return in this call. Default: 20
query system-image-package-attributes
optional
A query that specifies which objects to return. A query could be specified on any number of attributes in the system object. All system objects matching this query up to 'max-records' will be returned.
tag string
optional
Specify the tag from the last call. It is usually not specified for the first call. For subsequent calls, copy values from the 'next-tag' obtained from the previous call.
 
Output Name Range Type Description
attributes-list system-image-package-attributes[]
optional
The list of attributes of system objects.
next-tag string
optional
Tag for the next call. Not present when there are no more system objects to return.
num-records [0..100] integer
The number of records returned in this call.
 Errno  Description
 EINTERNALERROR

 
system-image-update [top]
Perform software image upgrade/downgrade. This API will return immediately. The progress can be monitored using the 'system-image-update-progress-get' API.
Input Name Range Type Description
ignore-compatibility boolean
optional
Ignore Version Compatibility Checking
node string
Node
package string
Package URL
rename-package string
optional
Rename the File
replace string
optional
Image to Replace
replace-package boolean
optional
Replace the Local File
setdefault boolean
optional
Set Newly Updated Image as Default
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
system-image-update-progress-get [top]
Show progress information for current or previous update
Input Name Range Type Description
node node-name
Node
 
Output Name Range Type Description
exit-message string
Exit Message
exit-status string
Exit Status
last-message string
Internal message
phase string
Phase
run-status string
Run Status
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
system-node-get [top]
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.
Input Name Range Type Description
desired-attributes node-details-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
node string
The node name. This is the name defined during setup. The node name could be a maximum of 253 characters long.
 
Output Name Range Type Description
attributes node-details-info
The attributes of the system-node.
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
system-node-get-iter [top]
Obtain the node information when the node is a part of the cluster in an iteration.
Input Name Range Type Description
desired-attributes node-details-info
optional
Specify the attributes that should be returned. If not present, all attributes for which information is available will be returned. If present, only the desired attributes for which information is available will be returned.
max-records [1..100] integer
optional
The maximum number of records to return in this call. Default: 20
query node-details-info
optional
A query that specifies which objects to return. A query could be specified on any number of attributes in the system-node object. All system-node objects matching this query up to 'max-records' will be returned.
tag string
optional
Specify the tag from the last call. It is usually not specified for the first call. For subsequent calls, copy values from the 'next-tag' obtained from the previous call.
 
Output Name Range Type Description
attributes-list node-details-info[]
optional
The list of attributes of system-node objects.
next-tag string
optional
Tag for the next call. Not present when there are no more system-node objects to return.
num-records [0..100] integer
The number of records returned in this call.
 Errno  Description
 EINTERNALERROR

 
system-node-reboot [top]
Reboot the specified node. Only an admin can reboot the node. If attempted by a user with insufficient privileges EAPIPRIVILEGE is returned.
Input Name Range Type Description
node string
The node name. This is the name defined during setup. The node name could be a maximum of 253 characters long.
 Errno  Description
 EOBJECTNOTFOUND
 EAPIPRIVILEGE
 EINTERNALERROR

 
system-node-rename [top]
Rename the specified node to a new name specified by 'new-name'
Input Name Range Type Description
new-name string
New Name
node string
The node name. This is the name defined during setup. The node name could be a maximum of 253 characters long.
 Errno  Description
 EOBJECTNOTFOUND
 EINTERNALERROR

 
system-node-shutdown [top]
Shut down a node. Only an admin can initiate a node shutdown. If attempted by a user with insufficient privileges EAPIPRIVILEGE is returned.
Input Name Range Type Description
node string
The node name. This is the name defined during setup. The node name could be a maximum of 253 characters long.
 Errno  Description
 EOBJECTNOTFOUND
 EAPIPRIVILEGE
 EINTERNALERROR

 
Element definition: api-list-info [top]
name of the API
[none]

 
Element definition: node-details-info [top]
Contains information about a specific node When returned as part of the output, all elements of this typedef are reported, unless limited by a set of desired attributes specified by the caller.

When used as input to specify desired attributes to return, omitting a given element indicates that it shall not be returned in the output. In contrast, by providing an element (even with no value) the caller ensures that a value for that element will be returned, given that the value can be retrieved.

When used as input to specify queries, any element can be omitted in which case the resulting set of objects is not constrained by any specific value of that attribute.

Name Range Type Description
node string
optional
The node name. This is the name defined during setup. The node name could be a maximum of 253 characters long. Attributes: key, non-creatable, non-modifiable
node-asset-tag string
optional
The asset tag of the node. This is defined by the vendor. Currently, a string of numbers. Attributes: non-creatable, modifiable
node-location string
optional
The physical location of the node. For example, Sunnyvale. Attributes: non-creatable, modifiable
node-model string
optional
The model of the node. For example, FAS3070. Attributes: non-creatable, non-modifiable
node-nvram-id integer
optional
Vendor specific NVRAM ID of the node. Attributes: non-creatable, non-modifiable
node-owner string
optional
The owner of the node. Attributes: non-creatable, modifiable
node-serial-number string
optional
The serial number of the node. This is defined by the vendor. Currently, a string of numbers. Attributes: non-creatable, non-modifiable
node-uptime [0..2^32-1] integer
optional
Total time, in seconds, that the node has been up. Attributes: non-creatable, non-modifiable
node-uuid string
optional
The univerally unique identifier for the node. It is a 36-character string composed of 32 hexadecimal characters. For example, '542366ea-a024-11dd-9caa-7302e474c5ae'. Attributes: non-creatable, non-modifiable
node-vendor string
optional
The hardware vendor of the node. Attributes: non-creatable, non-modifiable

 
Element definition: node-name [top]
The node's name
[none]

 
Element definition: node-ontapi-detail-info [top]
The node names along with the ONTAPI version on the respective node.
Name Range Type Description
major-version integer
Current ONTAPI major version supported by this node. Range: [0..2^31-1].
minor-version integer
Current ONTAPI minor version supported by this node. Range: [0..2^31-1].
node-name string
Name of the node.
node-uuid string
UUID, Universal Unique IDentifier, of the node.

 
Element definition: node-version-detail-info [top]
The node names along with the ONTAP version on the respective node.
Name Range Type Description
build-timestamp integer
optional
Time of build creation, in seconds since January 1, 1970, of the image running on the node. This field is available in Data ONTAP 8.1 or later.
node-name string
Name of the node.
node-uuid string
UUID, Universal Unique IDentifier, of the node.
version string
Data ONTAP version running on the node.

 
Element definition: system-api-entry-info [top]
list of api names and their elements
Name Range Type Description
api-elements system-api-element-info[]
list of api elements
name string
api name

 
Element definition: system-api-info [top]
api information
Name Range Type Description
is-streaming boolean
optional
does api stream data?
license string
optional
license needed if any
name string
name of api

 
Element definition: system-api-type-entry-info [top]
list of type names and their elements
Name Range Type Description
name string
type name
type-elements system-api-element-info[]
list of type elements

 
Element definition: system-image-attributes [top]
These attributes describe or modify the configuration of the nodes's boot images. When returned as part of the output, all elements of this typedef are reported, unless limited by a set of desired attributes specified by the caller.

When used as input to specify desired attributes to return, omitting a given element indicates that it shall not be returned in the output. In contrast, by providing an element (even with no value) the caller ensures that a value for that element will be returned, given that the value can be retrieved.

When used as input to specify queries, any element can be omitted in which case the resulting set of objects is not constrained by any specific value of that attribute.

Name Range Type Description
image string
optional
Image Name Attributes: key, non-creatable, non-modifiable
install-time datetime
optional
Install Date Attributes: non-creatable, non-modifiable
is-current boolean
optional
Is Current Image Attributes: non-creatable, non-modifiable
is-default boolean
optional
Is Default Image Attributes: non-creatable, modifiable
kernel-path string
optional
Kernel Image Path Attributes: non-creatable, non-modifiable
node string
optional
Node Attributes: key, non-creatable, non-modifiable
rootfs-path string
optional
Root Filesystem Image Path Attributes: non-creatable, non-modifiable
version string
optional
Software Version Attributes: non-creatable, non-modifiable

 
Element definition: system-image-package-attributes [top]
These attributes provide details about the software packages available on the system. When returned as part of the output, all elements of this typedef are reported, unless limited by a set of desired attributes specified by the caller.

When used as input to specify desired attributes to return, omitting a given element indicates that it shall not be returned in the output. In contrast, by providing an element (even with no value) the caller ensures that a value for that element will be returned, given that the value can be retrieved.

When used as input to specify queries, any element can be omitted in which case the resulting set of objects is not constrained by any specific value of that attribute.

Name Range Type Description
node string
optional
Node Attributes: key, non-creatable, non-modifiable
package string
optional
Package File Name Attributes: key, optional-for-create, non-modifiable

 
Element definition: system-info [top]
Information about the system. Here system refers to a cluster node when running in cluster mode.
Name Range Type Description
backplane-part-number string
optional
Part number of the backplane.
backplane-revision string
optional
Revision of the backplane part number.
backplane-serial-number string
optional
Backplane serial number.
board-speed integer
Speed of the system board in mega Hertz.
board-type string
Type of the system board. This is defined by the vendor
controller-address string
optional
The location of the controller in a multi-controller platform. Defined by the platform layer. Possible values: A,B,C,...
cpu-ciob-revision-id string
optional
Processor's CIOB (Champion I/O Bus) revision ID. Defined by the CPU manufacturer.
cpu-firmware-release string
optional
Firmware release number. Defined by the CPU manufacturer.
cpu-microcode-version string
optional
cpu's microcode version. Defined by the CPU manufacturer.
cpu-part-number string
optional
CPU's part number. Defined by the CPU manufacturer.
cpu-processor-id string
optional
Processor's ID. Defined by the CPU manufacturer.
cpu-processor-type string
optional
Processor's Type. Defined by the CPU manufacturer.
cpu-revision string
optional
CPU's part number revision. Defined by the CPU manufacturer.
cpu-serial-number string
optional
CPU's serial number. Defined by the CPU manufacturer.
memory-size integer
Memory size in megabytes. (1024*1024).
number-of-processors integer
Number of processors in the appliance.
partner-system-id string
optional
Partner's system ID. Displayed in a cluster environment. A string of 10 characters.
partner-system-name string
optional
Partner's system name. Displayed in a cluster environment. Defined in the partner's setup.
partner-system-serial-number string
optional
Partner System serial number. Currently a string of numbers.
prod-type string
optional
Will be set to "V-Series" to indicate a v-series system for NetApp filers.For IBM filers, "gateway" will used.
supports-raid-array boolean
Indicates whether the system supports raid arrays back-end connectivity or not. Possible values: "true" or "false".
system-id string
System ID. This is defined by the vendor. Currently, it is a string of numbers
system-machine-type string
Machine type of the system, like FAS3050
system-model string
Model name of the system, like FAS3050
system-name string
System name. This is the name defined during setup.
system-revision string
optional
System revision. There revision id of the system board. Currently, a character followed by a number, B0.
system-serial-number string
optional
System serial number.Currently a string of numbers.
vendor-id string
Hardware vendor identifier. For example, "NetApp".

 
Element definition: system-version-tuple [top]
Contains the Data ONTAP version tuple corresponding to the lowest version across the cluster.
Name Range Type Description
generation integer
First integer of the Data ONTAP version tuple corresponding the lowest version across the cluster.
major integer
Second integer of the Data ONTAP version tuple corresponding the lowest version across the cluster.
minor integer
Third integer of the Data ONTAP version tuple corresponding the lowest version across the cluster.

 
Element definition: datetime [top]
The number of seconds since January 1, 1970. Range : [0..2^31-1].
[none]

 
Element definition: system-api-element-info [top]
api element description. This can be a simple type or a reference to another typedef (as defined in the 'type' element. Arrays are signified by having '[]' appended to the type name.
Name Range Type Description
encrypted string
optional
encryption type. If missing the parameter isn't encrypted
is-nonempty boolean
optional
must element be non-empty. If false or missing element value may be empty.
is-optional boolean
optional
is element optional. If false or missing element is required.
is-output boolean
optional
is element an output element. If false or missing then is an input element
is-validated boolean
optional
argument will have strong validation done by the server (e.g. integer range). If false or empty, no validation will be done.
name string
name of element
type string
type of variable possible values: "string", "integer", "boolean", type-name