APIs in Category: snapshot | Cluster-Mode API version 1.20

snapshot-get-iter snapshot-modify-iter snapshot-policy-add-schedule snapshot-policy-create snapshot-policy-delete snapshot-policy-get snapshot-policy-get-iter snapshot-policy-modify snapshot-policy-modify-schedule snapshot-policy-remove-schedule snapshot-reserve-list-info

NetApp Manage ONTAP

snapshot-get-iter | [top]

> Iterate over a list of snapshot objects.

> Input Name | Range | Type | Description
> desired-attributes |  | snapshot-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..2^32-1] | integer optional | The maximum number of records to return in this call. Default: 20
> query |  | snapshot-info optional | A query that specifies which objects to return. A query could be specified on any number of attributes in the snapshot object. All snapshot 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 |  | snapshot-info[] optional | The list of attributes of snapshot objects.
> next-tag |  | string optional | Tag for the next call. Not present when there are no more snapshot objects to return.
> num-records | [0..2^32-1] | integer | The number of records returned in this call.
> volume-errors |  | volume-error[] optional | Volume Error Info

> Errno | Description
> EINTERNALERROR |  |

snapshot-modify-iter | [top]

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

> Input Name | Range | Type | Description
> attributes |  | snapshot-info | Specify at least one modifiable element. Do not specify any other element.
> continue-on-failure |  | boolean optional | This input element is useful when multiple snapshot objects match a given query. If set to true, the API will continue modifying the next matching snapshot even when modification of a previous snapshot fails. If set to false, the API will return on the first failure. Default: false
> max-failure-count | [1..2^32-1] | integer optional | When allowing failures ('continue-on-failure' is set to true), then this input element may be provided to limit the number of failed modify operations before the server gives up and returns. If set, the API will continue modifying the next matching snapshot even when the modification of a previous matching snapshot fails, and do so until the total number of objects failed to be modified reaches the maximum specified. If set to the maximum or not provided, then there will be no limit on the number of failed modify operations. Only applicable if 'continue-on-failure' is set to true. Default: 2^32-1
> max-records | [1..2^32-1] | integer optional | The maximum number of objects to be modified in this call. Default: 20
> query |  | snapshot-info | If modifying a specific snapshot, this input element must specify all keys. If modifying snapshot objects based on query, this input element must specify a query.
> return-failure-list |  | boolean optional | If set to true, the API will return the list of snapshot objects (just keys) that were not modified due to some error. If set to false, the list of snapshot objects not modified will not be returned. Default: true
> return-success-list |  | boolean optional | If set to true, the API will return the list of snapshot objects (just keys) that were successfully updated. If set to false, the list of snapshot objects modified will not be returned. Default: true
> 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
> failure-list |  | snapshot-modify-iter-info[] optional | Information about snapshot objects that were not modified due to some error. This element will be returned only if input element 'return-failure-list' is true.
> next-tag |  | string optional | Tag for the next call. Not present when there are no more matching snapshot objects to be modified.
> num-failed | [0..2^32-1] | integer optional | Number of snapshot objects that matched the query, but were not modified due to some error.
> num-succeeded | [0..2^32-1] | integer optional | The number of snapshot objects that matched the query and were successfully updated.
> success-list |  | snapshot-modify-iter-info[] optional | The snapshot objects that were successfully updated. This element will be returned only if input element 'return-success-list' is true

> Errno | Description
> EOPNOTSUPPORTED |  |
> EINVALIDINPUTERROR |  |

snapshot-policy-add-schedule | [top]

> 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.

> Input Name | Range | Type | Description
> count | [0..255] | integer | The maximum number of snapshots to be retained for the schedule. The count of all the snapshots for to be retained for this policy cannot be more than 255.
> policy |  | snapshot-policy | A human readable string describing the name of the snapshot scheduling policy.
> prefix |  | string optional | The snapshot name prefix for the schedule. This field should be unique within the policy.
> schedule |  | string | A human readable string describing the name of a new schedule to be added inside the snapshot policy. Maximum length of this field can be 255 characters. The schedule name can be any one of the reserved schedules like 'hourly', 'weekly' or 'daily' or it can be a user created schedule.
> snapmirror-label |  | string optional | The SnapMirror Label for the schedule. This label will be used to define vaulting policies at a vault destination. Maximum length of this field is 31 characters

> Errno | Description
> EOBJECTNOTFOUND |  |
> EINTERNALERROR |  |
> EINVALIDINPUTERROR |  |
> EOPNOTSUPPORTED |  |

snapshot-policy-create | [top]

> Create a new Snapshot Scheduling Policy

> Input Name | Range | Type | Description
> comment |  | string optional | A human readable description associated with the snapshot policy. The maximum length of this field can be 255 characters.
> count1 | [0..255] | integer | Retention count for the snapshots created by the first schedule. The count of all the snapshots to be retained for this policy cannot be more than 255.
> count2 | [0..255] | integer optional | Retention count for the snapshots created by the second schedule. The count of all the snapshots to be retained for this policy cannot be more than 255.
> count3 | [0..255] | integer optional | Retention count for the snapshots created by the third schedule. The count of all the snapshots to be retained for this policy cannot be more than 255.
> count4 | [0..255] | integer optional | Retention count for the snapshots created by the fourth schedule. The count of all the snapshots to be retained for this policy cannot be more than 255.
> count5 | [0..255] | integer optional | Retention count for the snapshots created by the fifth schedule. The count of all the snapshots to be retained for this policy cannot be more than 255.
> enabled |  | boolean | Status of the snapshot policy indicating whether the policy will be enabled or disabled. If set to true, the policy will be enabled.
> policy |  | string | The name of the snapshot scheduling policy which has to be created. This API creates a snapshot policy and adds the schedules to it. At the most 5 schedules can be added to the snapshot policy. Maximum length of this string can be 256 characters.
> prefix1 |  | string optional | Snapshot name prefix for the first schedule. Prefix name should be unique within the policy.
> prefix2 |  | string optional | Snapshot name prefix for the second schedule. Prefix name should be unique within the policy.
> prefix3 |  | string optional | Snapshot name prefix for the third schedule. Prefix name should be unique within the policy.
> prefix4 |  | string optional | Snapshot name prefix for the fourth schedule. Prefix name should be unique within the policy.
> prefix5 |  | string optional | Snapshot name prefix for the fifth schedule. Prefix name should be unique within the policy.
> schedule1 |  | string | First schedule to be added inside the policy. Atleast one schedule has to be added to create a policy.
> schedule2 |  | string optional | Second schedule to be added inside the policy.
> schedule3 |  | string optional | Third schedule to be added inside the policy.
> schedule4 |  | string optional | Fourth schedule to be added inside the policy.
> schedule5 |  | string optional | Fifth schedule to be added inside the policy.
> snapmirror-label1 |  | string optional | Label for SnapMirror Operations for first schedule. Maximum length of this field is 31 characters.
> snapmirror-label2 |  | string optional | Label for SnapMirror Operations for second schedule. Maximum length of this field is 31 characters.
> snapmirror-label3 |  | string optional | Label for SnapMirror Operations for third schedule. Maximum length of this field is 31 characters.
> snapmirror-label4 |  | string optional | Label for SnapMirror Operations for fourth schedule. Maximum length of this field is 31 characters.
> snapmirror-label5 |  | string optional | Label for SnapMirror Operations for fifth schedule. Maximum length of this field is 31 characters.

> Errno | Description
> EOBJECTNOTFOUND |  |
> EINTERNALERROR |  |
> EINVALIDINPUTERROR |  |
> EOPNOTSUPPORTED |  |

snapshot-policy-delete | [top]

> Delete the specified Snapshot Scheduling Policy

> Input Name | Range | Type | Description
> policy |  | snapshot-policy | A human readable string describing the name of the snapshot scheduling policy.

> Errno | Description
> EOBJECTNOTFOUND |  |
> EINVALIDINPUTERROR |  |
> EINTERNALERROR |  |
> EOPNOTSUPPORTED |  |

snapshot-policy-get | [top]

> Get Information about a single Snapshot Policy

> Input Name | Range | Type | Description
> desired-attributes |  | snapshot-policy-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.
> policy |  | snapshot-policy | A human readable string describing the name of the snapshot scheduling policy.
> Output Name | Range | Type | Description
> attributes |  | snapshot-policy-info | The attributes of the snapshot.

> Errno | Description
> EOBJECTNOTFOUND |  |
> EINVALIDINPUTERROR |  |

snapshot-policy-get-iter | [top]

> Get Information about multiple Snapshot Policies

> Input Name | Range | Type | Description
> desired-attributes |  | snapshot-policy-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..2^32-1] | integer optional | The maximum number of records to return in this call. Default: 20
> query |  | snapshot-policy-info optional | A query that specifies which objects to return. A query could be specified on any number of attributes in the snapshot object. All snapshot 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 |  | snapshot-policy-info[] optional | The list of attributes of snapshot objects.
> next-tag |  | string optional | Tag for the next call. Not present when there are no more snapshot objects to return.
> num-records | [0..2^32-1] | integer | The number of records returned in this call.

> Errno | Description
> EOBJECTNOTFOUND |  |
> EINVALIDINPUTERROR |  |

snapshot-policy-modify | [top]

> Enable or Disable the specified Snapshot Scheduling Policy

> Input Name | Range | Type | Description
> enabled |  | boolean | The state of the snapshot policy. If true, the snapshot policy is enabled and scheduled snapshots will be created on the volume associated with this policy.
> policy |  | string | A human readable string describing the name of the snapshot scheduling policy.

> Errno | Description
> EOBJECTNOTFOUND |  |
> EINVALIDNPUTERROR |  |
> EINTERNALERROR |  |
> EOPNOTSUPPORTED |  |

snapshot-policy-modify-schedule | [top]

> Modify a snapshot policy

> Input Name | Range | Type | Description
> new-count | [0..255] | integer optional | The new retention count for the schedule.
> new-snapmirror-label |  | string optional | The new SnapMirror Label for the schedule. This label will be used to define vaulting policies at a vault destination. If an empty label is specified, the existing label will be deleted. The maximum length of this field is 31 characters
> policy |  | snapshot-policy | A human readable string describing the name of the snapshot scheduling policy.
> schedule |  | string | A human readable string describing the name of a schedule whose retention count will be modified. Maximum length of this field can be 255 characters. The schedule name can be any one of the reserved schedules like 'hourly','weekly' or 'daily' or it can be user created schedule.

> Errno | Description
> EOBJECTNOTFOUND |  |
> EINTERNALERROR |  |
> EINVALIDINPUTERROR |  |
> EOPNOTSUPPORTED |  |

snapshot-policy-remove-schedule | [top]

> Remove a snapshot schedule from policy

> Input Name | Range | Type | Description
> policy |  | snapshot-policy | A human readable string describing the name of the snapshot scheduling policy.
> schedule |  | string | A human readable string describing the name of a schedule which will be removed from the snapshot policy. Maximum length of this field can be 255 characters. The schedule name can be any one of the reserved schedules like 'hourly','weekly' or 'daily' or it can be a user created schedule.

> Errno | Description
> EOBJECTNOTFOUND |  |
> EINTERNALERROR |  |
> EINVALIDINPUTERROR |  |

snapshot-reserve-list-info | [top]

> 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. This API is deprecated in Data ONTAP Cluster-Mode 8.2 and later. Use volume-get-iter instead.

> Input Name | Range | Type | Description
> volume |  | string optional | Volume to get percentage of space reserved for snapshots.
> Output Name | Range | Type | Description
> snapshot-reserve-details |  | snapshot-reserve-detail-info[] | List of volumes along with their snapshot space reservation configuration.

> Errno | Description
> EVOLUMEDOESNOTEXIST |  |
> EVSERVERNOTFOUND |  |
> EVOLUMEBUSY |  |
> EOPNOTSUPPORTED |  |
> EINTERNALERROR |  |
> EINVALIDINPUTERROR |  |
> EOBJECTNOTFOUND |  |
> EAGGRRELOCATING |  |

Element definition: snapshot-info | [top]

> One snapshot contained in the specified volume. This type is used by snapshot-get-iter, snapshot-modify-iter and snapshot-list-info ZAPIs. When using this type to modify snapshot information, every field except snapmirror-label is non-modifiable.

> Name | Range | Type | Description
> access-time |  | integer optional | The volume access time when the snapshot was created in seconds since Jan 1, 1970. This value will not change even if the snapshot is accessed.
> busy |  | boolean optional | True if the snapshot is being used by an application.
> contains-lun-clones |  | boolean optional | This snapshots contains lun clones. If true, this snapshot contains lun clones. This is available only if the 'lun-clone-snapshot' option is specified.
> cumulative-percentage-of-total-blocks |  | integer optional | Percentage of blocks owned by this snapshot and all more recent snapshots, relative to the total number of blocks in the volume. Not returned for Infinite Volumes.
> cumulative-percentage-of-used-blocks |  | integer optional | Percentage of blocks owned by this snapshot and all more recent snapshots, relative to the number of blocks currently used in the volume. Not returned for Infinite Volumes.
> cumulative-total |  | integer optional | Cumulative total of 1024 byte blocks of this snapshot and previous snapshots. If the "terse" input is true, this value is omitted.
> dependency |  | string optional | Application(s) dependent on this snapshot. Possible values include "snapmirror", "snapvault", "dump", "vclone", "LUNs", "snaplock". Comma separated if more than one application depends on this snapshot.
> is-7-mode-snapshot |  | boolean optional | True if the snapshot is a 7-mode snapshot.
> name |  | string optional | Name of the snapshot to be listed.
> percentage-of-total-blocks |  | integer optional | Percentage of blocks owned by this snapshot, relative to the total number of blocks in the volume.
> percentage-of-used-blocks |  | integer optional | Percentage of blocks owned by this snapshot, relative to the number of blocks currently used in the volume.
> snapmirror-label |  | string optional | A human readable SnapMirror Label attached with the snapshot. Size of the label can be at most 31 characters. This label will be used by the vaulting system to identify a vaulting scheme.
> snapshot-instance-uuid |  | UUID optional | The 128 bit unique snapshot identifier expressed in the form of UUID. This field uniquely identifies the snapshot's physical data layout.
> snapshot-owners-list |  | snapshot-owner[] optional | The list of owners of a busy snapshot.
> snapshot-version-uuid |  | UUID optional | The 128 bit unique snapshot identifier expressed in the form of UUID. This field uniquely identifies the snapshot's logical data layout.
> state |  | string optional | The state of the snapshot. Possible values: 'valid' ... The snapshot is complete and consistent 'invalid' ... The namespace constituent snapshot is missing 'partial' ... One or more data constituent snapshots are missing Only a snapshot on an Infinite Volume can have a state of partial or invalid. The default value is valid.
> total |  | integer optional | Number of 1024 byte blocks in the snapshot. If the "terse" input is true, this value is omitted.
> volume |  | string optional | Volume name.
> volume-provenance-uuid |  | UUID optional | Provenance UUID of the volume at the time the snapshot was created. Refer to the volume-get-iter API for a description of the volume provenance UUID.
> vserver |  | string optional | Name of the vserver to which this volume belongs. This field is returned only when request is sent to Admin Vserver LIF.

Element definition: snapshot-modify-iter-info | [top]

> Information about the modify operation that was attempted/performed against snapshot object.

> Name | Range | Type | Description
> error-code | [0..2^32-1] | integer optional | Error code, if the modify operation caused an error.
> error-message |  | string optional | Error description, if the modify operation caused an error.
> snapshot-key |  | snapshot-info | The keys for the snapshot object to which the modify operation applies.

Element definition: snapshot-policy | [top]

> Snapshot Policy

> [none]

Element definition: snapshot-policy-info | [top]

> A typedef containing information about the Snapshot Scheduling Policies. 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
> comment |  | string optional | A human readable description associated with the snasphot policy. The maximum length of this field can be 255 characters. Attributes: optional-for-create, modifiable
> enabled |  | boolean optional | The state of the snapshot policy. If true, the snapshot policy is enabled and scheduled snapshots will be created on the volume associated with this policy. Attributes: required-for-create, modifiable
> policy |  | snapshot-policy optional | A human readable string describing the name of the snapshot scheduling policy. Attributes: key, required-for-create, non-modifiable
> policy-owner |  | string optional | Owner of the policy Attributes: non-creatable, non-modifiable
> snapshot-policy-schedules |  | snapshot-schedule-info[] optional | Information about individual snapshot schedules
> total-schedules | [0..5] | integer optional | Total Number of Schedules in this Policy Attributes: non-creatable, non-modifiable
> vserver-name |  | vserver-name optional | Vserver Name Attributes: key, non-creatable, non-modifiable

Element definition: snapshot-reserve-detail-info | [top]

> Information about a volume's snapshot space reservation configuration.

> Name | Range | Type | Description
> percentage |  | integer | Percentage of volume reserved for snapshots. Range : [0 - 100].
> size |  | integer | Size in bytes of volume reserved for snapshots. Range : [0 - 2^64-1].
> volume |  | string | Name of volume.
> vserver |  | string optional | Name of the vserver to which this volume belongs. This field is returned only when request is sent to Admin Vserver LIF.

Element definition: volume-error | [top]

> The error code of a given volume.

> Name | Range | Type | Description
> errno |  | integer optional | The error code of the snapshot operation for a given volume. It is returned only when an error is found.
> name |  | volume-name | Name of a volume.
> reason |  | string optional | Description of the error. It is returned only when an error is found.
> vserver |  | string optional | Virtual server containing the volume.

Element definition: UUID | [top]

> The 128-bit universally-unique identifier (UUID). UUIDs are formatted as 36-character strings. These strings are composed of 32 hexadecimal characters broken up into five groupings separated by '-'s.The first grouping has 8 hex characters, the second through fourth groupings have four hex characters each, and the fifth and final grouping has 12 hex characters. Note that a leading '0x' is not used. An example of an actual UUID is: 73a010ec-3d28-11df-84e8-123478563412

> [none]

Element definition: snapshot-info | [top]

> One snapshot contained in the specified volume. This type is used by snapshot-get-iter, snapshot-modify-iter and snapshot-list-info ZAPIs. When using this type to modify snapshot information, every field except snapmirror-label is non-modifiable.

> Name | Range | Type | Description
> access-time |  | integer optional | The volume access time when the snapshot was created in seconds since Jan 1, 1970. This value will not change even if the snapshot is accessed.
> busy |  | boolean optional | True if the snapshot is being used by an application.
> contains-lun-clones |  | boolean optional | This snapshots contains lun clones. If true, this snapshot contains lun clones. This is available only if the 'lun-clone-snapshot' option is specified.
> cumulative-percentage-of-total-blocks |  | integer optional | Percentage of blocks owned by this snapshot and all more recent snapshots, relative to the total number of blocks in the volume. Not returned for Infinite Volumes.
> cumulative-percentage-of-used-blocks |  | integer optional | Percentage of blocks owned by this snapshot and all more recent snapshots, relative to the number of blocks currently used in the volume. Not returned for Infinite Volumes.
> cumulative-total |  | integer optional | Cumulative total of 1024 byte blocks of this snapshot and previous snapshots. If the "terse" input is true, this value is omitted.
> dependency |  | string optional | Application(s) dependent on this snapshot. Possible values include "snapmirror", "snapvault", "dump", "vclone", "LUNs", "snaplock". Comma separated if more than one application depends on this snapshot.
> is-7-mode-snapshot |  | boolean optional | True if the snapshot is a 7-mode snapshot.
> name |  | string optional | Name of the snapshot to be listed.
> percentage-of-total-blocks |  | integer optional | Percentage of blocks owned by this snapshot, relative to the total number of blocks in the volume.
> percentage-of-used-blocks |  | integer optional | Percentage of blocks owned by this snapshot, relative to the number of blocks currently used in the volume.
> snapmirror-label |  | string optional | A human readable SnapMirror Label attached with the snapshot. Size of the label can be at most 31 characters. This label will be used by the vaulting system to identify a vaulting scheme.
> snapshot-instance-uuid |  | UUID optional | The 128 bit unique snapshot identifier expressed in the form of UUID. This field uniquely identifies the snapshot's physical data layout.
> snapshot-owners-list |  | snapshot-owner[] optional | The list of owners of a busy snapshot.
> snapshot-version-uuid |  | UUID optional | The 128 bit unique snapshot identifier expressed in the form of UUID. This field uniquely identifies the snapshot's logical data layout.
> state |  | string optional | The state of the snapshot. Possible values: 'valid' ... The snapshot is complete and consistent 'invalid' ... The namespace constituent snapshot is missing 'partial' ... One or more data constituent snapshots are missing Only a snapshot on an Infinite Volume can have a state of partial or invalid. The default value is valid.
> total |  | integer optional | Number of 1024 byte blocks in the snapshot. If the "terse" input is true, this value is omitted.
> volume |  | string optional | Volume name.
> volume-provenance-uuid |  | UUID optional | Provenance UUID of the volume at the time the snapshot was created. Refer to the volume-get-iter API for a description of the volume provenance UUID.
> vserver |  | string optional | Name of the vserver to which this volume belongs. This field is returned only when request is sent to Admin Vserver LIF.

Element definition: snapshot-owner | [top]

> owner of a busy snapshot

> Name | Range | Type | Description
> owner |  | string | Name of the owner of a busy snapshot

Element definition: snapshot-policy | [top]

> Snapshot Policy

> [none]

Element definition: snapshot-schedule-info | [top]

> Information about individual snapshot schedules

> Name | Range | Type | Description
> count | [0..2^32-1] | integer optional | Maximum number of snapshots to retain for the schedule present in the snapshot policy. Attributes: non-creatable, non-modifiable
> prefix |  | string optional | Snapshot name prefix for the schedule present in the snapshot policy. Prefix will be used in the snapshot name instead of the schedule name. If prefix is not provided, schedule name will be used in the snapshot name. For eg, if the prefix name 'hourly-even' is assigned to the schedule name 'hourly' then the snapshot name will look like 'hourly-even.2010-05-10_0205'. If no prefix is associated with the schedule 'hourly' then prefix will be set to 'hourly' as the default value. Attributes: non-creatable, non-modifiable
> schedule |  | string optional | A human readable string describing the name of a schedule present in the snapshot policy. Maximum length of this field can be 255 characters. The schedule name can be any one of the reserved schedules like 'hourly', 'weekly','daily' or it can be a user created schedule. Attributes: non-creatable, non-modifiable
> snapmirror-label |  | string optional | Snapshot SnapMirror Label for the schedule present in the snapshot policy. The value specified will be added as an attribute to the snapshot created by the schedule. The maximum length of this field is 31 characters Attributes: required-for-create, modifiable

Element definition: volume-name | [top]

> The name of the volume. Volume names can contain letters, numbers, and the underscore character (_). The first character must be a letter or an underscore. When creating a Cluster-Mode volume, the user can specify at most 203 characters. If the prefix '/vol/' appears in the volume name, it is striped out and the characters that follow the prefix constitute the actual volume name. Volume names are scoped by their owning Vserver in a cluster, with each Vserver's volume namespace being totally independent. Thus, any Vserver 'S' in a cluster cannot have two volumes with the same name 'V'. However, two different Vservers in the same cluster can each have a volume named 'V'. For example, any given Vserver in a cluster can only have at most one volume named 'vol0'. However, two different Vservers S1 and S2 in the cluster may each have a volume named 'vol0'.

> [none]

Element definition: vserver-name | [top]

> The name of the Vserver.

> [none]

Element definition: UUID | [top]

> The 128-bit universally-unique identifier (UUID). UUIDs are formatted as 36-character strings. These strings are composed of 32 hexadecimal characters broken up into five groupings separated by '-'s.The first grouping has 8 hex characters, the second through fourth groupings have four hex characters each, and the fifth and final grouping has 12 hex characters. Note that a leading '0x' is not used. An example of an actual UUID is: 73a010ec-3d28-11df-84e8-123478563412

> [none]