Create a volume on an SVM and storage aggregates
POST /storage/volumes
Introduced In: 9.6
Creates a volume on a specified SVM and storage aggregates.
Required properties
-
svm.uuid
orsvm.name
- Existing SVM in which to create the volume. -
name
- Name of the volume. -
aggregates.name
oraggregates.uuid
- Existing aggregates in which to create the volume.
Default property values
-
state
- online -
size
- 20MB -
style
- flexvol -
type
- rw -
encryption.enabled
- false -
snapshot_policy.name
- default -
guarantee.type
- volume -
anti_ransomware.state
- default
Related ONTAP commands
-
volume create
-
volume clone create
Parameters
Name | Type | In | Required | Description |
---|---|---|---|---|
return_timeout |
integer |
query |
False |
The number of seconds to allow the call to execute before returning. When doing a POST, PATCH, or DELETE operation on a single record, the default is 0 seconds. This means that if an asynchronous operation is started, the server immediately returns HTTP code 202 (Accepted) along with a link to the job. If a non-zero value is specified for POST, PATCH, or DELETE operations, ONTAP waits that length of time to see if the job completes so it can return something other than 202.
|
return_records |
boolean |
query |
False |
The default is false. If set to true, the records are returned.
|
Request Body
Name | Type | Description |
---|---|---|
_links |
||
_tags |
array[string] |
Tags are an optional way to track the uses of a resource. Tag values must be formatted as key:value strings. |
access_time_enabled |
boolean |
Indicates whether or not access time updates are enabled on the volume. |
activity_tracking |
||
aggregates |
array[aggregates] |
Aggregate hosting the volume. Required on POST. |
aggressive_readahead_mode |
string |
Specifies the aggressive readahead mode enabled on the volume. When set to "file_prefetch", on a file read, the system aggressively issues readaheads for all of the blocks in the file and retains those blocks in a cache for a finite period of time. This feature is only available on FabricPool volumes on FSx for ONTAP and Cloud Volumes ONTAP.
|
analytics |
||
anti_ransomware |
Anti-ransomware related information of the volume. |
|
anti_ransomware_state |
string |
The Anti-ransomware state of the volume. If no "anti_ransomware_state" property is specified, the volume inherits the value from its parent SVM's "anti_ransomware_default_volume_state" property. If this value is "disabled", Anti-ransomware is disabled on the volume. If this value is "enabled", Anti-ransomware is enabled on the volume and alerts are raised if any suspect is detected for those volumes. If this value is "dry_run", Anti-ransomware is enabled in the dry-run or learning mode on the volume. The "dry_run" state is same as the "enabled" state except that the analytics data is used here for learning. No alerts are raised for any detections or violations. If this value is "paused", Anti-ransomware is paused on the volume. Additionally, three more states are available, which are only valid for GET. If this value is "disable_in_progress", Anti-ransomware monitoring is being disabled and a cleanup operation is in effect. If this value is "enable_paused", Anti-ransomware is paused on the volume from its earlier enabled state. If this value is "dry_run_paused", Anti-ransomware monitoring is paused on the volume from its earlier dry_run state. For POST, the valid Anti-ransomware states are only "disabled", "enabled" and "dry_run", whereas for PATCH, "paused" is also valid along with the three valid states for POST. |
application |
||
asynchronous_directory_delete |
Configuration for asynchronous directory delete from the client. This is only supported on Flexible volumes and FlexGroup volumes. |
|
autosize |
||
clone |
||
cloud_retrieval_policy |
string |
This parameter specifies the cloud retrieval policy for the volume. This policy determines which tiered out blocks to retrieve from the capacity tier to the performance tier. The available cloud retrieval policies are "default" policy retrieves tiered data based on the underlying tiering policy. If the tiering policy is 'auto', tiered data is retrieved only for random client driven data reads. If the tiering policy is 'none' or 'snapshot_only', tiered data is retrieved for random and sequential client driven data reads. If the tiering policy is 'all', tiered data is not retrieved. "on_read" policy retrieves tiered data for all client driven data reads. "never" policy never retrieves tiered data. "promote" policy retrieves all eligible tiered data automatically during the next scheduled scan. It is only supported when the tiering policy is 'none' or 'snapshot_only'. If the tiering policy is 'snapshot_only', the only data brought back is the data in the AFS. Data that is only in a snapshot copy stays in the cloud and if tiering policy is 'none' then all data is retrieved. |
cloud_write_enabled |
boolean |
Indicates whether or not cloud writes are enabled on the volume. NFS writes to this volume are sent to the cloud directly instead of the local performance tier. This feature is only available on volumes in FabricPools on FSx or Cloud Volumes ONTAP.
|
comment |
string |
A comment for the volume. Valid in POST or PATCH. |
consistency_group |
Consistency group the volume is part of. |
|
constituents |
array[constituents] |
FlexGroup Constituents. FlexGroup Constituents can be retrieved more efficiently by specifying "is_constituent=true" or "is_constituent=true&flexgroup.uuid= |
constituents_per_aggregate |
integer |
Specifies the number of times to iterate over the aggregates listed with the "aggregates.name" or "aggregates.uuid" when creating or expanding a FlexGroup volume. If a volume is being created on a single aggregate, the system creates a flexible volume if the "constituents_per_aggregate" field is not specified, or a FlexGroup volume if it is specified. If a volume is being created on multiple aggregates, the system always creates a FlexGroup volume. The root constituent of a FlexGroup volume is always placed on the first aggregate in the list, unless 'optimize_aggregates' is specified as 'true'. |
convert_unicode |
boolean |
Specifies whether directory Unicode format conversion is enabled when directories are accessed by NFS clients. |
create_time |
string |
Creation time of the volume. This field is generated when the volume is created. |
efficiency |
||
encryption |
||
error_state |
||
files |
||
flash_pool |
||
flexcache_endpoint_type |
string |
FlexCache endpoint type. none ‐ The volume is neither a FlexCache nor origin of any FlexCache. cache ‐ The volume is a FlexCache volume. origin ‐ The volume is origin of a FlexCache volume. |
flexgroup |
||
granular_data |
boolean |
State of granular data on the volume. This setting is true by default when creating a new FlexGroup volume, but can be specified as false at the time of creation via a POST request. On FlexVol volumes, the setting is always false, as only FlexGroup volumes and FlexGroup constituents support this feature. Once enabled, this setting can only be disabled by restoring a Snapshot copy. Earlier versions of ONTAP (pre 9.11) are not compatible with this feature. Therefore, reverting to an earlier version of ONTAP is not possible unless this volume is deleted or restored to a Snapshot copy that was taken before the setting was enabled.
|
guarantee |
||
is_object_store |
boolean |
Specifies whether the volume is provisioned for an object store server. |
is_svm_root |
boolean |
Specifies whether the volume is a root volume of the SVM it belongs to. |
language |
string |
Language encoding setting for volume. If no language is specified, the volume inherits its SVM language encoding setting. |
max_dir_size |
integer |
Maximum directory size. This value sets maximum size, in bytes, to which a directory can grow. The default maximum directory size for FlexVol volumes is model-dependent, and optimized for the size of system memory. Before increasing the maximum directory size, involve technical support. |
metric |
Performance numbers, such as IOPS, latency and throughput. |
|
movement |
Volume movement. All attributes are modify, that is, not writable through POST. Set PATCH state to destination_aggregate to initiate a volume move operation. Volume movement on FlexGroup constituents are not supported. |
|
msid |
integer |
The volume's Master Set ID. |
name |
string |
Volume name. The name of volume must start with an alphabetic character (a to z or A to Z) or an underscore (_). The name must be 197 or fewer characters in length for FlexGroups, and 203 or fewer characters in length for all other types of volumes. Volume names must be unique within an SVM. Required on POST. |
nas |
||
optimize_aggregates |
boolean |
Specifies whether to create the constituents of the FlexGroup volume on the aggegates specified in the order they are specified, or whether the system should optimize the ordering of the aggregates. If this value is 'true', the system optimizes the ordering of the aggregates specified. If this value is false, the order of the aggregates is unchanged. The default value is 'false'. |
qos |
QoS information |
|
queue_for_encryption |
boolean |
Specifies whether the volume is queued for encryption. |
quota |
Quotas track the space or file usage of a user, group, or qtree in a FlexVol or a FlexGroup volume. |
|
rebalancing |
Configuration and runtime properties involving non-disruptive volume capacity rebalancing for a FlexGroup volume. |
|
scheduled_snapshot_naming_scheme |
string |
Naming Scheme for automatic Snapshot copies:
|
size |
integer |
Physical size of the volume, in bytes. The minimum size for a FlexVol volume is 20MB and the minimum size for a FlexGroup volume is 200MB per constituent. The recommended size for a FlexGroup volume is a minimum of 100GB per constituent. For all volumes, the default size is equal to the minimum size. |
snaplock |
||
snapmirror |
Specifies attributes for SnapMirror protection. |
|
snapshot_count |
integer |
Number of Snapshot copies in the volume. |
snapshot_directory_access_enabled |
boolean |
This field, if true, enables the visible ".snapshot" directory from the client. The ".snapshot" directory will be available in every directory on the volume. |
snapshot_locking_enabled |
boolean |
Specifies whether or not snapshot copy locking is enabled on the volume. |
snapshot_policy |
This is a reference to the Snapshot copy policy. |
|
space |
||
state |
string |
Volume state. Client access is supported only when volume is online and junctioned. Taking volume to offline or restricted state removes its junction path and blocks client access. When volume is in restricted state some operations like parity reconstruction and iron on commit are allowed. The 'mixed' state applies to FlexGroup volumes only and cannot be specified as a target state. An 'error' state implies that the volume is not in a state to serve data. |
statistics |
These are raw performance numbers, such as IOPS latency and throughput. These numbers are aggregated across all nodes in the cluster and increase with the uptime of the cluster. |
|
status |
array[string] |
Describes the current status of a volume. |
style |
string |
The style of the volume. If "style" is not specified, the volume type is determined based on the specified aggregates or license. Specifying a single aggregate, without "constituents_per_aggregate", creates a flexible volume. Specifying multiple aggregates, or a single aggregate with "constituents_per_aggregate", creates a FlexGroup volume. When the UDO License is installed, and no aggregates are specified, the system automatically provisions a FlexGroup volume on system selected aggregates. Specifying a volume "style" creates a volume of that type. For example, if the style is "flexvol", you must specify a single aggregate. If the style is "flexgroup", the system either uses the specified aggregates or automatically provisions aggregates if there are no specified aggregates. The style "flexgroup_constiutent" is not supported when creating a volume. flexvol ‐ flexible volumes and FlexClone volumes flexgroup ‐ FlexGroup volumes flexgroup_constituent ‐ FlexGroup constituents. |
svm |
SVM containing the volume. Required on POST. |
|
tiering |
||
type |
string |
Type of the volume.
rw ‐ read-write volume.
dp ‐ data-protection volume.
ls ‐ load-sharing |
use_mirrored_aggregates |
boolean |
Specifies whether mirrored aggregates are selected when provisioning a FlexGroup without specifying "aggregates.name" or "aggregates.uuid". Only mirrored aggregates are used if this parameter is set to 'true' and only unmirrored aggregates are used if this parameter is set to 'false'. Aggregate level mirroring for a FlexGroup can be changed by moving all of the constituents to the required aggregates. The default value is 'true' for a MetroCluster configuration and is 'false' for a non-MetroCluster configuration. |
uuid |
string |
Unique identifier for the volume. This corresponds to the instance-uuid that is exposed in the CLI and ONTAPI. It does not change due to a volume move.
|
Example request
{
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"_tags": [
"team:csi",
"environment:test"
],
"activity_tracking": {
"state": "string",
"unsupported_reason": {
"code": "124518405",
"message": "Volume activity tracking cannot be enabled on volumes that contain LUNs."
}
},
"aggregates": [
{
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"name": "aggr1",
"uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
}
],
"aggressive_readahead_mode": "string",
"analytics": {
"initialization": {
"state": "string"
},
"scan_progress": 17,
"state": "string",
"unsupported_reason": {
"code": "111411207",
"message": "File system analytics cannot be enabled on volumes that contain LUNs."
}
},
"anti_ransomware": {
"attack_probability": "string",
"attack_reports": [
{
"_links": {
"suspects": {
"href": "/api/resourcelink"
}
},
"time": "2021-06-01 11:06:41 -0400"
}
],
"dry_run_start_time": "string",
"space": {
"snapshot_count": 0,
"used": 0,
"used_by_logs": 0,
"used_by_snapshots": 0
},
"state": "string",
"suspect_files": [
{
"count": 0,
"entropy": "string",
"format": "string"
}
]
},
"anti_ransomware_state": "string",
"application": {
"name": "string",
"uuid": "1cd8a442-86d1-11e0-ae1d-123478563412"
},
"asynchronous_directory_delete": {
"trash_bin": "string"
},
"autosize": {
"mode": "string"
},
"clone": {
"inherited_physical_used": 0,
"inherited_savings": 0,
"parent_snapshot": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"name": "this_snapshot",
"uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
},
"parent_svm": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"name": "svm1",
"uuid": "02c9e252-41be-11e9-81d5-00a0986138f7"
},
"parent_volume": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"name": "volume1",
"uuid": "028baa66-41bd-11e9-81d5-00a0986138f7"
},
"split_complete_percent": 0,
"split_estimate": 0
},
"cloud_retrieval_policy": "string",
"comment": "string",
"consistency_group": {
"name": "consistency_group_1",
"uuid": "1cd8a442-86d1-11e0-ae1d-123478563412"
},
"constituents": [
{
"aggregates": {
"name": "string",
"uuid": "028baa66-41bd-11e9-81d5-00a0986138f7"
},
"movement": {
"cutover_window": 30,
"destination_aggregate": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"name": "aggr1",
"uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
},
"percent_complete": 0,
"state": "replicating",
"tiering_policy": "string"
},
"name": "string",
"space": {
"available": 0,
"block_storage_inactive_user_data": 0,
"capacity_tier_footprint": 0,
"footprint": 0,
"local_tier_footprint": 0,
"logical_space": {
"available": 0,
"used_by_afs": 0
},
"metadata": 0,
"over_provisioned": 0,
"performance_tier_footprint": 0,
"snapshot": {
"used": 0
},
"total_footprint": 0,
"used": 0
}
}
],
"create_time": "2018-06-04 15:00:00 -0400",
"efficiency": {
"application_io_size": "string",
"auto_state": "string",
"compaction": "string",
"compression": "string",
"compression_type": "string",
"cross_volume_dedupe": "string",
"dedupe": "string",
"idcs_scanner": {
"mode": "string",
"operation_state": "string",
"status": "string",
"threshold_inactive_time": "P14D"
},
"last_op_begin": "string",
"last_op_end": "string",
"last_op_err": "string",
"last_op_size": 0,
"last_op_state": "string",
"op_state": "string",
"policy": {
"name": "string"
},
"progress": "string",
"scanner": {
"state": "string"
},
"schedule": "string",
"space_savings": {
"compression": 0,
"compression_percent": 0,
"dedupe": 0,
"dedupe_percent": 0,
"dedupe_sharing": 0,
"total": 0,
"total_percent": 0
},
"state": "string",
"storage_efficiency_mode": "string",
"type": "string",
"volume_path": "string"
},
"encryption": {
"key_create_time": "2022-01-01 14:00:00 -0500",
"key_id": "string",
"key_manager_attribute": "CRN=v1:bluemix:public:containers-kubernetes:us-south:a/asdfghjkl1234:asdfghjkl1234:worker:kubernetes-asdfghjkl-worker1",
"state": "string",
"status": {
"code": "string",
"message": "string"
},
"type": "string"
},
"files": {
"used": 0
},
"flash_pool": {
"cache_eligibility": "string",
"cache_retention_priority": "string",
"caching_policy": "string"
},
"flexcache_endpoint_type": "string",
"flexgroup": {
"name": "my_flexgroup",
"uuid": "75c9cfb0-3eb4-11eb-9fb4-005056bb088a"
},
"guarantee": {
"type": "string"
},
"language": "string",
"metric": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"cloud": {
"duration": "PT15S",
"iops": {
"read": 200,
"total": 1000,
"write": 100
},
"latency": {
"read": 200,
"total": 1000,
"write": 100
},
"status": "ok",
"timestamp": "2017-01-25 06:20:13 -0500"
},
"duration": "PT15S",
"flexcache": {
"bandwidth_savings": 4096,
"cache_miss_percent": 20,
"duration": "PT1D",
"status": "ok",
"timestamp": "2017-01-25 06:20:13 -0500"
},
"iops": {
"read": 200,
"total": 1000,
"write": 100
},
"latency": {
"read": 200,
"total": 1000,
"write": 100
},
"status": "ok",
"throughput": {
"read": 200,
"total": 1000,
"write": 100
},
"timestamp": "2017-01-25 06:20:13 -0500"
},
"movement": {
"cutover_window": 30,
"destination_aggregate": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"name": "aggr1",
"uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
},
"percent_complete": 0,
"start_time": "2020-12-07 03:45:12 -0500",
"state": "replicating",
"tiering_policy": "string"
},
"name": "vol_cs_dept",
"nas": {
"export_policy": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"id": 100,
"name": "default"
},
"junction_parent": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"name": "vs1_root",
"uuid": "75c9cfb0-3eb4-11eb-9fb4-005056bb088a"
},
"path": "/user/my_volume",
"security_style": "string",
"unix_permissions": 493
},
"qos": {
"policy": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"max_throughput_iops": 10000,
"max_throughput_mbps": 500,
"min_throughput_iops": 2000,
"min_throughput_mbps": 500,
"name": "performance",
"uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
}
},
"quota": {
"state": "string"
},
"rebalancing": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"data_moved": 0,
"engine": {
"movement": {
"file_moves_started": 0,
"last_error": {
"code": 0,
"destination": 0,
"file_id": 0,
"time": "2018-06-04 15:00:00 -0400"
},
"most_recent_start_time": "2018-06-04 15:00:00 -0400"
},
"scanner": {
"blocks_scanned": 0,
"blocks_skipped": {
"efficiency_blocks": 0,
"efficiency_percent": 0,
"fast_truncate": 0,
"footprint_invalid": 0,
"in_snapshot": 0,
"incompatible": 0,
"metadata": 0,
"on_demand_destination": 0,
"other": 0,
"remote_cache": 0,
"too_large": 0,
"too_small": 0,
"write_fenced": 0
},
"files_scanned": 0,
"files_skipped": {
"efficiency_blocks": 0,
"efficiency_percent": 0,
"fast_truncate": 0,
"footprint_invalid": 0,
"in_snapshot": 0,
"incompatible": 0,
"metadata": 0,
"on_demand_destination": 0,
"other": 0,
"remote_cache": 0,
"too_large": 0,
"too_small": 0,
"write_fenced": 0
}
}
},
"imbalance_percent": 0,
"imbalance_size": 0,
"max_constituent_imbalance_percent": 0,
"max_runtime": "string",
"notices": [
{
"arguments": [
{
"code": "string",
"message": "string"
}
],
"code": "4",
"message": "entry doesn't exist",
"target": "uuid"
}
],
"runtime": "string",
"start_time": "string",
"state": "rebalancing",
"stop_time": "string",
"target_used": 0,
"used_for_imbalance": 0
},
"scheduled_snapshot_naming_scheme": "string",
"snaplock": {
"append_mode_enabled": "",
"autocommit_period": "P30M",
"compliance_clock_time": "2018-06-04 15:00:00 -0400",
"expiry_time": "Wed Sep 5 11:02:42 GMT 2018",
"is_audit_log": 1,
"litigation_count": 10,
"privileged_delete": "enabled",
"retention": {
"default": "P30Y",
"maximum": "P30Y",
"minimum": "P30Y"
},
"type": "enterprise",
"unspecified_retention_file_count": 10
},
"snapshot_count": 0,
"snapshot_policy": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"name": "default",
"uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
},
"space": {
"auto_adaptive_compression_footprint_data_reduction": 0,
"available": 0,
"block_storage_inactive_user_data": 0,
"block_storage_inactive_user_data_percent": 0,
"capacity_tier_footprint": 0,
"capacity_tier_footprint_data_reduction": 0,
"cross_volume_dedupe_metafiles_footprint": 0,
"cross_volume_dedupe_metafiles_temporary_footprint": 0,
"dedupe_metafiles_footprint": 0,
"dedupe_metafiles_temporary_footprint": 0,
"delayed_free_footprint": 0,
"effective_total_footprint": 0,
"file_operation_metadata": 0,
"filesystem_size": 0,
"footprint": 0,
"local_tier_footprint": 0,
"logical_space": {
"available": 0,
"used": 0,
"used_by_afs": 0,
"used_by_snapshots": 0,
"used_percent": 0
},
"metadata": 0,
"over_provisioned": 0,
"overwrite_reserve": 0,
"overwrite_reserve_used": 0,
"percent_used": 0,
"performance_tier_footprint": 0,
"size_available_for_snapshots": 0,
"snapmirror_destination_footprint": 0,
"snapshot": {
"autodelete": {
"commitment": "string",
"defer_delete": "string",
"delete_order": "string",
"prefix": "string",
"trigger": "string"
},
"autodelete_trigger": "string",
"reserve_available": 0,
"reserve_size": 0,
"space_used_percent": 0,
"used": 0
},
"snapshot_reserve_unusable": 0,
"snapshot_spill": 0,
"total_footprint": 0,
"used": 0,
"user_data": 0,
"volume_guarantee_footprint": 0
},
"state": "string",
"statistics": {
"cifs_ops_raw": {
"access": {
"count": 1000,
"total_time": 200
},
"audit": {
"count": 1000,
"total_time": 200
},
"create": {
"dir": {
"count": 1000,
"total_time": 200
},
"file": {
"count": 1000,
"total_time": 200
},
"other": {
"count": 1000,
"total_time": 200
},
"symlink": {
"count": 1000,
"total_time": 200
}
},
"getattr": {
"count": 1000,
"total_time": 200
},
"link": {
"count": 1000,
"total_time": 200
},
"lock": {
"count": 1000,
"total_time": 200
},
"lookup": {
"count": 1000,
"total_time": 200
},
"open": {
"count": 1000,
"total_time": 200
},
"read": {
"count": 1000,
"total_time": 200,
"volume_protocol_latency_histogram_counts": [
0,
0,
0,
0,
0,
15,
35,
100,
200,
200,
300,
500,
500,
500,
1000,
1000,
800,
500,
500,
300,
200,
50,
40,
15,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"volume_protocol_latency_histogram_labels": [
"<2us",
"<6us",
"<10us",
"<14us",
"<20us",
"<40us",
"<60us",
"<80us",
"<100us",
"<200us",
"<400us",
"<600us",
"<800us",
"<1ms",
"<2ms",
"<4ms",
"<6ms",
"<8ms",
"<10ms",
"<12ms",
"<14ms",
"<16ms",
"<18ms",
"<20ms",
"<40ms",
"<60ms",
"<80ms",
"<100ms",
"<200ms",
"<400ms",
"<600ms",
"<800ms",
"<1s",
"<2s",
"<4s",
"<6s",
"<8s",
"<10s",
"<20s",
">20s"
],
"volume_protocol_size_histogram_counts": [
2400,
1055,
1100,
700,
500,
300,
200,
100,
100,
50,
50,
75,
25,
0,
0
],
"volume_protocol_size_histogram_labels": [
"< 4KB",
"= 4KB",
"< 8KB",
"= 8KB",
"< 16KB",
"= 16KB",
"< 32KB",
"= 32KB",
"< 64KB",
"= 64KB",
"< 256KB",
"= 256KB",
"< 1024KB",
"= 1024KB",
"> 1024KB"
]
},
"readdir": {
"count": 1000,
"total_time": 200
},
"readlink": {
"count": 1000,
"total_time": 200
},
"rename": {
"count": 1000,
"total_time": 200
},
"setattr": {
"count": 1000,
"total_time": 200
},
"unlink": {
"count": 1000,
"total_time": 200
},
"watch": {
"count": 1000,
"total_time": 200
},
"write": {
"count": 1000,
"total_time": 200,
"volume_protocol_latency_histogram_counts": [
0,
0,
0,
0,
0,
15,
35,
100,
200,
200,
300,
500,
500,
500,
1000,
1000,
800,
500,
500,
300,
200,
50,
40,
15,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"volume_protocol_latency_histogram_labels": [
"<2us",
"<6us",
"<10us",
"<14us",
"<20us",
"<40us",
"<60us",
"<80us",
"<100us",
"<200us",
"<400us",
"<600us",
"<800us",
"<1ms",
"<2ms",
"<4ms",
"<6ms",
"<8ms",
"<10ms",
"<12ms",
"<14ms",
"<16ms",
"<18ms",
"<20ms",
"<40ms",
"<60ms",
"<80ms",
"<100ms",
"<200ms",
"<400ms",
"<600ms",
"<800ms",
"<1s",
"<2s",
"<4s",
"<6s",
"<8s",
"<10s",
"<20s",
">20s"
],
"volume_protocol_size_histogram_counts": [
2400,
1055,
1100,
700,
500,
300,
200,
100,
100,
50,
50,
75,
25,
0,
0
],
"volume_protocol_size_histogram_labels": [
"< 4KB",
"= 4KB",
"< 8KB",
"= 8KB",
"< 16KB",
"= 16KB",
"< 32KB",
"= 32KB",
"< 64KB",
"= 64KB",
"< 256KB",
"= 256KB",
"< 1024KB",
"= 1024KB",
"> 1024KB"
]
}
},
"cloud": {
"iops_raw": {
"read": 200,
"total": 1000,
"write": 100
},
"latency_raw": {
"read": 200,
"total": 1000,
"write": 100
},
"status": "ok",
"timestamp": "2017-01-25 06:20:13 -0500"
},
"flexcache_raw": {
"cache_miss_blocks": 10,
"client_requested_blocks": 500,
"status": "ok",
"timestamp": "2017-01-25 06:20:13 -0500"
},
"iops_raw": {
"read": 200,
"total": 1000,
"write": 100
},
"latency_raw": {
"read": 200,
"total": 1000,
"write": 100
},
"nfs_ops_raw": {
"access": {
"count": 1000,
"total_time": 200
},
"audit": {
"count": 1000,
"total_time": 200
},
"create": {
"dir": {
"count": 1000,
"total_time": 200
},
"file": {
"count": 1000,
"total_time": 200
},
"other": {
"count": 1000,
"total_time": 200
},
"symlink": {
"count": 1000,
"total_time": 200
}
},
"getattr": {
"count": 1000,
"total_time": 200
},
"link": {
"count": 1000,
"total_time": 200
},
"lock": {
"count": 1000,
"total_time": 200
},
"lookup": {
"count": 1000,
"total_time": 200
},
"open": {
"count": 1000,
"total_time": 200
},
"read": {
"count": 1000,
"total_time": 200,
"volume_protocol_latency_histogram_counts": [
0,
0,
0,
0,
0,
15,
35,
100,
200,
200,
300,
500,
500,
500,
1000,
1000,
800,
500,
500,
300,
200,
50,
40,
15,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"volume_protocol_latency_histogram_labels": [
"<2us",
"<6us",
"<10us",
"<14us",
"<20us",
"<40us",
"<60us",
"<80us",
"<100us",
"<200us",
"<400us",
"<600us",
"<800us",
"<1ms",
"<2ms",
"<4ms",
"<6ms",
"<8ms",
"<10ms",
"<12ms",
"<14ms",
"<16ms",
"<18ms",
"<20ms",
"<40ms",
"<60ms",
"<80ms",
"<100ms",
"<200ms",
"<400ms",
"<600ms",
"<800ms",
"<1s",
"<2s",
"<4s",
"<6s",
"<8s",
"<10s",
"<20s",
">20s"
],
"volume_protocol_size_histogram_counts": [
2400,
1055,
1100,
700,
500,
300,
200,
100,
100,
50,
50,
75,
25,
0,
0
],
"volume_protocol_size_histogram_labels": [
"< 4KB",
"= 4KB",
"< 8KB",
"= 8KB",
"< 16KB",
"= 16KB",
"< 32KB",
"= 32KB",
"< 64KB",
"= 64KB",
"< 256KB",
"= 256KB",
"< 1024KB",
"= 1024KB",
"> 1024KB"
]
},
"readdir": {
"count": 1000,
"total_time": 200
},
"readlink": {
"count": 1000,
"total_time": 200
},
"rename": {
"count": 1000,
"total_time": 200
},
"setattr": {
"count": 1000,
"total_time": 200
},
"unlink": {
"count": 1000,
"total_time": 200
},
"watch": {
"count": 1000,
"total_time": 200
},
"write": {
"count": 1000,
"total_time": 200,
"volume_protocol_latency_histogram_counts": [
0,
0,
0,
0,
0,
15,
35,
100,
200,
200,
300,
500,
500,
500,
1000,
1000,
800,
500,
500,
300,
200,
50,
40,
15,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"volume_protocol_latency_histogram_labels": [
"<2us",
"<6us",
"<10us",
"<14us",
"<20us",
"<40us",
"<60us",
"<80us",
"<100us",
"<200us",
"<400us",
"<600us",
"<800us",
"<1ms",
"<2ms",
"<4ms",
"<6ms",
"<8ms",
"<10ms",
"<12ms",
"<14ms",
"<16ms",
"<18ms",
"<20ms",
"<40ms",
"<60ms",
"<80ms",
"<100ms",
"<200ms",
"<400ms",
"<600ms",
"<800ms",
"<1s",
"<2s",
"<4s",
"<6s",
"<8s",
"<10s",
"<20s",
">20s"
],
"volume_protocol_size_histogram_counts": [
2400,
1055,
1100,
700,
500,
300,
200,
100,
100,
50,
50,
75,
25,
0,
0
],
"volume_protocol_size_histogram_labels": [
"< 4KB",
"= 4KB",
"< 8KB",
"= 8KB",
"< 16KB",
"= 16KB",
"< 32KB",
"= 32KB",
"< 64KB",
"= 64KB",
"< 256KB",
"= 256KB",
"< 1024KB",
"= 1024KB",
"> 1024KB"
]
}
},
"status": "ok",
"throughput_raw": {
"read": 200,
"total": 1000,
"write": 100
},
"timestamp": "2017-01-25 06:20:13 -0500"
},
"status": [
"string"
],
"style": "string",
"svm": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"name": "svm1",
"uuid": "02c9e252-41be-11e9-81d5-00a0986138f7"
},
"tiering": {
"object_tags": [
"string"
],
"policy": "string",
"storage_class": "string"
},
"type": "string",
"uuid": "028baa66-41bd-11e9-81d5-00a0986138f7"
}
Response
Status: 202, Accepted
Name | Type | Description |
---|---|---|
job |
Example response
{
"job": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"uuid": "string"
}
}
Headers
Name | Description | Type |
---|---|---|
Location |
Useful for tracking the resource location |
string |
Error
Status: Default
ONTAP Error Response Codes
Error Code | Description |
---|---|
787140 |
One of "aggregates.uuid", "aggregates.name", or "style" must be provided. |
787141 |
The specified "aggregates.name" and "aggregates.uuid" refer to different aggregates. |
917526 |
The volume name specified is a duplicate. |
917829 |
Volume autosize grow threshold must be larger than autosize shrink threshold. |
917831 |
Volume minimum autosize must be smaller than the maximum autosize. |
917835 |
Maximum allowed snapshot.reserve_percent value during a volume creation is 90. Use PATCH to set it to a higher value after the volume has been created. |
918191 |
Flexvol tiering min cooling days requires an effective cluster version of ONTAP 9.4 or later. |
918194 |
Tiering min cooling days not supported for SVMDR. |
918195 |
Tiering min cooling days not supported for non data volumes. |
918196 |
Tiering min cooling days not allowed for the provided tiering policy. |
918215 |
FlexGroup tiering min cooling days requires an effective cluster version of ONTAP 9.5 or later. |
918233 |
The target field cannot be specified for this operation. |
918236 |
The specified "parent_volume.uuid" and "parent_volume.name" do not refer to the same volume. |
918240 |
The target style is an invalid volume style. |
918241 |
The target style is an unsupported volume style for volume creation. |
918242 |
When creating a flexible volume, exactly one aggregate must be specified via either "aggregates.name" or "aggregates.uuid". |
918243 |
The specified Snapshot copy UUID is not correct for the specified Snapshot copy name. |
918244 |
Invalid "volume.type" for clone volume. |
918246 |
"volume.clone.parent_volume.name" or "volume.clone.parent_volume.uuid" must be provided. |
918247 |
Specifying a value is not valid for a volume FlexClone creation. |
918252 |
"nas.path" is invalid. |
918290 |
cloud retrieval policy requires an effective cluster version of 9.8 or later. |
918291 |
Invalid volume cloud retrieval policy for the provided tiering policy. |
918292 |
cloud retrieval policy not supported for non data volume. |
918521 |
The volume maximum autosize must be smaller than or equal to the maximum volume size. |
918524 |
Volume minimum autosize must be less than or equal to the current volume size. |
2621706 |
The specified "svm.uuid" and "svm.name" do not refer to the same SVM. |
2621707 |
No SVM was specified. Either "svm.name" or "svm.uuid" must be supplied. |
13109258 |
Cannot enable granular data on volume "name" in Vserver "svm.name". This setting can only be enabled on FlexGroups. |
13109260 |
Failed to enable granular data on the volume. |
111411205 |
File system analytics requires an effective cluster version of 9.8 or later. |
111411206 |
The specified "analytics.state" is invalid. |
111411207 |
File system analytics cannot be enabled on volumes that contain LUNs. |
111411207 |
Volume file system analytics is not supported on volumes that contain LUNs. |
111411209 |
Volume file system analytics is not supported on FlexCache volumes. |
111411210 |
Volume file system analytics is not supported on audit staging volumes. |
111411211 |
Volume file system analytics is not supported on object store server volumes. |
111411212 |
Volume file system analytics is not supported on SnapMirror destination volumes. |
111411216 |
Enabling or disabling volume file system analytics is not supported on individual FlexGroup constituents. |
111411217 |
Volume file system analytics is not supported on SnapLock volumes. |
111411230 |
Volume file system analytics is not supported on volumes that contain NVMe namespaces. |
111411241 |
Volume file system analytics is not supported on All SAN Array clusters. |
124518405 |
Volume activity tracking is not supported on volumes that contain LUNs. |
124518407 |
Volume activity tracking is not supported on FlexCache volumes. |
124518408 |
Volume activity tracking is not supported on audit staging volumes. |
124518409 |
Volume activity tracking is not supported on object store server volumes. |
124518410 |
Volume activity tracking is not supported on SnapMirror destination volumes. |
124518411 |
Enabling or disabling volume activity tracking is not supported on individual FlexGroup constituents. |
124518412 |
Volume activity tracking is not supported on SnapLock volumes. |
124518414 |
Volume activity tracking is not supported on volumes that contain NVMe namespaces. |
124518422 |
Volume activity tracking is not supported on All SAN Array clusters. |
Name | Type | Description |
---|---|---|
error |
Example error
{
"error": {
"arguments": [
{
"code": "string",
"message": "string"
}
],
"code": "4",
"message": "entry doesn't exist",
"target": "uuid"
}
}
Definitions
See Definitions
href
Name | Type | Description |
---|---|---|
href |
string |
_links
Name | Type | Description |
---|---|---|
self |
unsupported_reason
Name | Type | Description |
---|---|---|
code |
string |
If volume activity tracking is not supported on the volume, this field provides an appropriate error code. |
message |
string |
If volume activity tracking is not supported on the volume, this field provides an error message detailing why this is the case. |
activity_tracking
Name | Type | Description |
---|---|---|
state |
string |
Activity tracking state of the volume. If this value is "on", ONTAP collects top metrics information for the volume in real time. There is a slight impact to I/O performance in order to collect this information. If this value is "off", no activity tracking information is collected or available to view.
|
supported |
boolean |
This field indicates whether or not volume activity tracking is supported on the volume. If volume activity tracking is not supported, the reason why is provided in the "activity_tracking.unsupported_reason" field. |
unsupported_reason |
aggregates
Aggregate
Name | Type | Description |
---|---|---|
_links |
||
name |
string |
|
uuid |
string |
initialization
Name | Type | Description |
---|---|---|
state |
string |
State of the analytics file system scan. |
unsupported_reason
Name | Type | Description |
---|---|---|
code |
string |
If file system analytics is not supported on the volume, this field provides the error code explaining why. |
message |
string |
If file system analytics is not supported on the volume, this field provides the error message explaining why. |
analytics
Name | Type | Description |
---|---|---|
initialization |
||
scan_progress |
integer |
Percentage of files in the volume that the file system analytics initialization scan has processed. Only returned when the state is |
state |
string |
File system analytics state of the volume. If this value is "on", ONTAP collects extra file system analytics information for all directories on the volume. There will be a slight impact to I/O performance to collect this information. If this value is "off", file system analytics information is not collected and not available to be viewed. If this value is "initializing", that means file system analytics was recently turned on, and the initialization scan to gather information for all existing files and directories is currently running. If this value is "initialization_paused", this means that the initialization scan is currently paused. If this value is 'unknown', this means that there was an internal error when determining the file system analytics state for the volume.
|