|
APIs in Category: graph |
API version 3.8 |
graph-data-list-info |
These APIs allow the user to get information and data of all the graphs present in DFM. The graph-list-info-iter-* API can be used presentation and graph-data-list-info API is used for retrieving data of the graphs. Some of the key terms are as follows: |
| graph-data-list-info | [top] |
Retrieve data of all the graph lines of a graph.
Input Name Range Type Description end-date integer
optional
The number of seconds in the future that the graph should end. The graph values from the current time till the end-date will be extrapolated and used for trending. Use a negative value if the graph should stop in the past. graph-name string
Name of the graph. Maximum length: 64 characters. graph-period string
optional
The period for which graph data has to be returned. This returns consolidated graph data depending on the graph period. Possible values: Default value is '1d'. The default value of start-date will be the same as the graph period specified. The default values of end-date will be as follows:
- '1d' - graph data for 1 day.
- '1w' - graph data for 1 week.
- '1m' - graph data for 1 month.
- '3m' - graph data for 3 months.
- '1y' - graph data for 1 year.
- 3 hours for graph period '1d'.
- 1 day for graph period '1w'.
- 4 days for graph period '1m'.
- 7 days for graph period '3m'.
- 31 days for graph period '1y'.
primary-object obj-name-or-id
optional
The primary object for which the graph data is returned. If not specified then global group is considered. secondary-object obj-name-or-id
optional
This object is valid only if the primary object is a quota user and should be a volume or a qtree.The primary and secondary object together represent a single quota object. If not specified, - its ignored only if the primary object is not a quota user. - if the primary object is a quota user then the ZAPI will fail with errors. Used in graphs like user-disk-space-used-vs-total, user-disk-space-used-percent. start-date integer
optional
The number of seconds in the past that the graph should start. Output Name Range Type Description graph-line-values graph-line-value-info[]
Data for various lines in a graph.
Errno Description EINTERNALERROR EINVALIDINPUT EACCESSDENIED EDATABASEERROR EOBJECTNOTFOUND EOBJECTAMBIGUOUS
| graph-list-info-iter-end | [top] |
Input Name Range Type Description tag string
An opaque handle used by the DFM station to identify a temporary store.
Errno Description EINVALIDTAG
| graph-list-info-iter-next | [top] |
Returns items from a previous call to graph-list-info-iter-start
Input Name Range Type Description maximum integer
The maximum number of entries to retrieve. Range: [1..(2^31)-1] tag string
An opaque handle used by the DFM station to identify a temporary store. Output Name Range Type Description graphs graph-info[]
A list of graphs. records integer
The number of records actually returned.
Errno Description EINVALIDTAG
| graph-list-info-iter-start | [top] |
Initiates a query for a list of graphs and its metadata like graph lines and sample information.
Input Name Range Type Description graph-name string
optional
Name of the graph. If not specified then all the graphs are returned. Maximum length: 64 characters. Output Name Range Type Description records integer
Number indicating how many items are available for future retrieval with graph-list-info-iter-next. Range: [1..(2^31)-1] tag string
An opaque handle used by the DFM station to identify a temporary store. Used in subsequent calls to graph-list-info-iter-next or graph-list-info-iter-end.
Errno Description EGRAPHNOTFOUND EAPIERROR
| Element definition: graph-info | [top] |
Describes the meta data of a graph.
Name Range Type Description graph-lines graph-line-info[]
Specifies the list of lines in the graph. graph-name string
Specifies the name of the graph. Maximum length: 64 characters. graph-pretty-name string
Specifies the pretty name of the graph. Maximum length: 64 characters.
| Element definition: graph-line-value-info | [top] |
The sample values of a line in a graph.
Name Range Type Description sample-name string
Name of the sample. Maximum length: 64 characters. sample-values string
A comma separated list of timestamp:value pairs. The timestamp value is the time in seconds since 00:00:00 Jan 1, 1970, UTC. The values may have optional decimal extensions, for example 1064439599:127, 1064439600:98.6, 1064439601:12. If the value of the sample is not available for a particular time, then the value returned will be empty e.g. (1188779400:).
| Element definition: obj-name-or-id | [top] |
Name or internal ID of a DFM object. This typedef is an alias for the builtin ZAPI type string. An obj-name-or-id must contain between 1 and 64 characters, and must conform to one of the following formats: Elements of type obj-name-or-id 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.
- It must have the format of an obj-name, or
- It must be the decimal numeric string form of a positive integer whose value is in the range [1..2^31 - 1].
If the format of an obj-name-or-id 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: graph-line-info | [top] |
Describes the meta data of a line in a graph.
Name Range Type Description sample-format string
The format in which the sample value is returned. Possible values: Range of the sample value if integer: [0..(2^63) - 1] Range of the sample value if float: [0..(2^63) - 1]
- 'integer'
- 'float'
sample-name string
Name of the sample. Maximum length: 64 characters. sample-pretty-name string
The name of the sample which can be used for displaying. Maximum length: 64 characters. sample-suffix string
The unit of the sample. If the unit is not known then 'none' is returned. Possible values:
- 'bytes'
- 'percentage'
- 'minutes'
- 'none'