APIs in Category: FcpTarget
API version 5.0

 
FcpTargetListInfoIterEnd
FcpTargetListInfoIterNext
FcpTargetListInfoIterStart
List FCP Target information stored in DFM Server database.

NetApp Manage ONTAP API version 5.0
 
FcpTargetListInfoIterEnd (supported) [top]

Ends iteration of Targets.
Input Name Type
FcpTargetListInfoIterEnd FcpTargetListInfoIterEnd
 
Output Name Type
FcpTargetListInfoIterEndResult FcpTargetListInfoIterEndResult
 Error Name  Description
 EINVALIDTAG

 
FcpTargetListInfoIterNext (supported) [top]
Get next set of Records in the iteration started by call To FcpTargetListInfoIterStart. This zapi will fetch the fcp Target info Records. The input param 'Maximum' specifies the number of Records it will show at a time.
Input Name Type
FcpTargetListInfoIterNext FcpTargetListInfoIterNext
 
Output Name Type
FcpTargetListInfoIterNextResult FcpTargetListInfoIterNextResult
 Error Name  Description
 EINVALIDTAG

 
FcpTargetListInfoIterStart (supported) [top]
Start iteration of Targets.Depending on the input it will return a Tag and the number of Records To be retrieved.
Input Name Type
FcpTargetListInfoIterStart FcpTargetListInfoIterStart
 
Output Name Type
FcpTargetListInfoIterStartResult FcpTargetListInfoIterStartResult
 Error Name  Description
 EACCESSDENIED
 EDATABASEERROR
 EINVALIDINPUTERROR
 EOBJECTAMBIGUOUS
 EOBJECTNOTFOUND

 
Element definition: FcpTargetListInfoIterEnd [top]
Ends iteration of Targets.
Name Type Description
Tag xsd:string
Tag From a previous FcpTargetListInfoIterStart.

 
Element definition: FcpTargetListInfoIterEndResult [top]
[none]

 
Element definition: FcpTargetListInfoIterNext [top]
Get next set of Records in the iteration started by call To FcpTargetListInfoIterStart. This zapi will fetch the fcp Target info Records. The input param 'Maximum' specifies the number of Records it will show at a time.
Name Type Description
Maximum xsd:integer
Maximum Records To retrieve.
Range: [1..2^31-1]
Tag xsd:string
Tag From a previous FcpTargetListInfoIterStart.

 
Element definition: FcpTargetListInfoIterNextResult [top]
Name Type Description
Records xsd:integer
The number of Records actually returned. Value of 0 Records indicates that end of Records.
Range: [1..2^31-1]
Targets ArrayOfTargetInfo
List of Targets.

 
Element definition: FcpTargetListInfoIterStart [top]
Start iteration of Targets.Depending on the input it will return a Tag and the number of Records To be retrieved.
Name Type Description
ObjectNameOrId ObjNameOrId
optional
Name or Id of the following Objects.
  • FCPTarget
  • Storage System
      If Storage System Name or Id is specified only the FCP Targets discovered on the Storage System are returned.
      The Name of the FCP Target should be specified in : format. Ex: storage01:0c_2 If no ObjectNameOrId is present in the input all the fcp Targets will be fetched.

 
Element definition: FcpTargetListInfoIterStartResult [top]
Name Type Description
Records xsd:integer
Number of Records fetched and stored for retrieval using FcpTargetListInfoIterNext.
Range: [1..2^31-1]
Tag xsd:string
Tag To be used for subsequent calls.

 
Element definition: ArrayOfTargetInfo [top]
Name Type Description
TargetInfo TargetInfo[]

 
Element definition: ObjNameOrId [top]
Name or internal ID of a DFM object. This typedef is an alias for the builtin ZAPI Type string. An ObjNameOrId must contain between 1 and 64 characters, and must conform To one of the following formats:
  • It must have the format of an ObjName, or
  • It must be the decimal numeric string form of a positive integer whose Value is in the range [1..2^31 - 1].
  • In case of application resources From the Host Service, this field can contain unique identifier assigned To the object by the Host Service e.g. for a Virtual Machine, it can be a GUID of the VM. One exception is when such unique identifier is a decimal numeric string containing only digits From 0 through 9. In that case, you cannot use such identifier as ObjNameOrId input.
Elements of Type ObjNameOrId are used only as inputs To ZAPIs. The Value must Match either the Name or internal ID of an existing DFM object. The ZAPI must specify the object's DFM object Type (e.g. Dataset, Host, DP Policy, etc.). Some ZAPIs allow the object To be one of several different types.

If the format of an ObjNameOrId input element does not conform, or the Value does not Match the Name or ID of an existing object, then generally the ZAPI documents that it fails with Error code EOBJECTNOTFOUND. A ZAPI may return more specific Error codes. In such cases, the ZAPI specification must document its behavior.

If a ZAPI can accept a null Value (e.g. reference To no object at all) for such an element, then the element is declared optional, and the absence of the input element represents a null Value.

[none]

 
Element definition: TargetInfo [top]
Information of about one Target.
Name Type Description
HostId ObjId
Identifier of the Storage System on which the Target is present.
HostName xsd:string
DNS Name of the Storage System on which the Target is present.
TargetId ObjId
Identifier of Target in DFM Server database.
TargetName ObjName
Name of the Target (ex: 0c).
TargetPortName xsd:string
WWPN of the Target.
TargetStatus xsd:string
Operation Status of the Target,Possible Values: "startup","uninitialized","initializing_fw", "link_not_connected","waiting_for_link_up", "online","link_disconnected","resetting", "offline","offlined_by_user_system", "unknown".

 
Element definition: ObjId [top]
Identification number (ID) for a DFM object. This typedef is an alias for the builtin ZAPI Type integer. Object IDs are unsigned integers in the range [1..2^31 - 1]. In some contexts, an object ID is also allowed To be 0, which is interpreted as a null Value, e.g., a reference To no object at all.

The ID for a DFM object is always assigned by the system; the user is never allowed To assign an ID To an object. Therefore, an input element of Type ObjId is always used To refer To an existing object by its ID. The ZAPI must specify the object's DFM object Type (e.g. Dataset, Host, DP Policy, etc.). Some ZAPIs allow the object To be one of several different types.

If the Value of an ObjId input element does not Match the ID of any existing DFM object of the specified Type or types, then typically the ZAPI fails with Error code EOBJECTNOTFOUND. A ZAPI may deviate From this general rule, for example, it may return a more specific Error code. In either case, the ZAPI specification must document its behavior.

[none]

 
Element definition: ObjName [top]
Name of a DFM object. This typedef is an alias for the built in ZAPI Type string. An object Name must conform To the following format:
  • It must contain between 1 and 64 characters.
  • It may start with any character and may contain any combination of characters, except that it may not consist solely of decimal digits ('0' through '9').
  • In some contexts, a Name may be the empty string (""), which is interpreted as a null Value, e.g., a reference To no object at all.
The behavior of a ZAPI when it encounters an Error involving an ObjName input element depends on how the ZAPI uses the input element. Here are the general rules:
  • If the input Name element is used To create a new object with the given Name, or rename an existing object To that Name, and the Name does not conform To the above format, then the ZAPI fails with Error code EINVALIDINPUTERROR. Note that because EINVALIDINPUTERROR is such a common Error code, ZAPI specifications are not required To document cases when they may return it.
  • If the input Name element is used To refer To an existing object with that Name, and there is no object with that Name, then the ZAPI fails with Error code EOBJECTNOTFOUND. Generally the ZAPI specification documents cases when it may return this Error code.
A ZAPI may deviate From these general rules, for example, it may return more specific Error codes. In such cases, the ZAPI specification must document its behavior.

If an input Name element is used To refer To an existing object, then the ZAPI specification must specify which DFM object Type (e.g. data set, Host, DP Policy, etc.) is allowed. Some ZAPIs allow the object To be one of several different types. See the Description of ObjFullName for examples of valid input formats.

Note that there is no requirement that all object names must be unique. However, the names for some specific types of Objects are constrained such that no two Objects of that Type may have the same Name. For example, this constraint applies To Datasets, DP schedules, and DP policies. This means that no two Datasets may have the same Name, but a Dataset may have the same Name as a DP schedule or DP Policy.

In general, object names are compared in a case-insensitive manner. This means that, for example, "MyObject" and "MYOBJECT" are considered To be the same Name for purposes of: creating new Objects, renaming existing Objects, or looking up an object by Name. On the other hand, ZAPIs that return an ObjName generally do not change the capitalization at all. For example, if an object's Name has been set To "MyObject", then list iteration ZAPIs that return the object's Name return it as "MyObject" rather than "MYOBJECT" or "myobject".

ZAPIs that operate on ObjName Values and do not follow these general rules about case sensitivity must document the rules that they do follow.

One important exception To these general rules is that Volumes, Qtrees, OSSV Directories, SRM Paths, Interfaces, FCP Targets and FC switch ports all have case-sensitive names. When looking up Objects of these types by Name, the case must Match the object Name.

[none]