apitest

apitest is a command-line utility to test APIs. This utility is suitable for API users who are at the beginner's level. This utility is available in C, Java, Perl, C#, VB.NET, and PowerShell in Windows. In UNIX-like environments, apitest is available in C, Java, and Perl.

 

How to use the apitest utility:

apitest in C

For Windows, complete the following steps:

  1. Open the command prompt.

  2. Go to the bin\nt\ directory.

  3. To execute, run apitest.

 

For a UNIX-like environment, complete the following steps:

  1. Open the command prompt.

  2. Go to the src\util\apitest\ directory.

  3. Run make to create the executable.

 

apitest in Java

For Windows, complete the following steps:

  1. Open the command prompt.

  2. Go to the src\sample\java\apitest\ directory.

  3. Run MAKE.BAT file to create the class file.

 

For a UNIX-like environment, complete the following steps:

  1. Open the command prompt.

  2. Go to the src\sample\java\apitest\ directory.

  3. Run make to create the class file.

 

apitest in Perl

Complete the following steps:

  1. Open the command prompt.

  2. Go to the src\sample\perl\ directory.

  3. Run the perl apitest.pl command to execute.

 

apitest in C#

Complete the following steps:

  1. Open apitest.sln located at src\sample\CSharp\apitest\ in Visual Studio editor.

  2. From the Build menu, click Build apitest to generate the executable.

 

apitest in VB.NET

Complete the following steps:

  1. Open apitest.sln located at src\sample\VB.NET\apitest\ in Visual Studio editor.

  2. From the Build menu, click Build apitest to generate the executable.

 

apitest in PowerShell

Complete the following steps:

  1. Open the PowerShell command prompt.

  2. Go to the src\sample\PowerShell\ directory.

  3. Run the .\apitest.ps1 command to execute.

 

Command syntax

The command syntax is as follows:

apitest {options} <host> <user> <password> <API> [ <paramname> <arg> ...]

 

Command details

Description

apitest

The command name.

options

An optional parameter.

See the table below for more information.

host

The host name or IP address of the server.

user

The user name.

password

The corresponding password.

API

The name of the API.

paramname

The input element of the API.

arg

The value of the input element.

 

Following are the options of the apitest command:

Options

Description

-i

API specified as XML output, on the command line.

-I

API specified as XML output, on standard input.

-t

Server type.

Following are the possible values:

  • filer

  • dfm

  • agent

-v

The vFiler name, if the API has to be executed in the context of a vFiler unit.

-r

Uses RPC transport.

-s

Uses SSL.

-p

Overrides port to use.

-x

Shows the XML input and output.

-X

Shows the raw XML input and output.

-h

Authenticates hosts using the hosts.equiv file.

-c

Sets the connection timeout.

 

The -v, -r, and -h options are not applicable for DataFabric Manager server.

 

The following are examples of the apitest command:

Sending an API query to a storage system running Data ONTAP

$apitest -x <host> <user> <password> file-read-file length 100 offset 0 path /vol/vol0/etc/temp/1

INPUT:

<file-read-file>

        <length>100</length>

        <offset>0</offset>

        <path>/vol/vol0/etc/temp/1</path>

</file-read-file>

 

OUTPUT:

<results status="passed">

        <length>3</length>

        <data>00abcd</data>

</results>

 

Sending an API query to a DataFabric Manager server

apitest.exe -t dfm sweetpea root tryme dfm-user-priv-get

<results status="passed">

        <privilege>FULL</privilege>

</results>

 

On the Windows platform, the RPC transport layer does not work without the ntapadmin.dll file in the DLL search path of the application. The file ntapadmin.dll is at bin\nt\.