Skip to main content
A newer release of this product is available.

Retrieve details of a collection or consistency group

Contributors
PDFs

GET /application/consistency-groups

Introduced In: 9.10

Retrieve details of a collection or a specific consistency group.

Notes

When volume granular properties, such as, the storage SLC, Fabric Pool tiering are not the same for all the existing volumes of a consistency group, the corresponding property is not reported at consistency group granularity. It is only reported if all the volumes of the consistency group have the same value for that property.

If this consistency group instance is part of a replication relationship, the "replicated" parameter will be true. Otherwise, it is false. Also, the "replicated" parameter will not be present in the output for Nested-consistency groups, it is included only for single and top-level consistency groups. If this consistency group instance is the source of a replication relationship, the "replication_source" parameter will be true. Otherwise, it is false.

Expensive properties

There is an added cost to retrieving values for these properties. They are not included by default in GET results and must be explicitly requested using the fields query parameter. See DOC Requesting specific fields to learn more.

  • volumes

  • luns

  • namespaces

Parameters

Name Type In Required Description

qos.policy.min_throughput_iops

integer

query

False

Filter by qos.policy.min_throughput_iops

qos.policy.max_throughput_iops

integer

query

False

Filter by qos.policy.max_throughput_iops

qos.policy.uuid

string

query

False

Filter by qos.policy.uuid

qos.policy.min_throughput_mbps

integer

query

False

Filter by qos.policy.min_throughput_mbps

qos.policy.max_throughput_mbps

integer

query

False

Filter by qos.policy.max_throughput_mbps

qos.policy.name

string

query

False

Filter by qos.policy.name

replication_source

boolean

query

False

Filter by replication_source

consistency_groups.space.used

integer

query

False

Filter by consistency_groups.space.used

consistency_groups.space.size

integer

query

False

Filter by consistency_groups.space.size

consistency_groups.space.available

integer

query

False

Filter by consistency_groups.space.available

consistency_groups.qos.policy.min_throughput_iops

integer

query

False

Filter by consistency_groups.qos.policy.min_throughput_iops

consistency_groups.qos.policy.max_throughput_iops

integer

query

False

Filter by consistency_groups.qos.policy.max_throughput_iops

consistency_groups.qos.policy.uuid

string

query

False

Filter by consistency_groups.qos.policy.uuid

consistency_groups.qos.policy.min_throughput_mbps

integer

query

False

Filter by consistency_groups.qos.policy.min_throughput_mbps

consistency_groups.qos.policy.max_throughput_mbps

integer

query

False

Filter by consistency_groups.qos.policy.max_throughput_mbps

consistency_groups.qos.policy.name

string

query

False

Filter by consistency_groups.qos.policy.name

consistency_groups.name

string

query

False

Filter by consistency_groups.name

consistency_groups.uuid

string

query

False

Filter by consistency_groups.uuid

consistency_groups.snapshot_policy.name

string

query

False

Filter by consistency_groups.snapshot_policy.name

consistency_groups.snapshot_policy.uuid

string

query

False

Filter by consistency_groups.snapshot_policy.uuid

consistency_groups.luns.serial_number

string

query

False

Filter by consistency_groups.luns.serial_number

  • maxLength: 12

  • minLength: 12

consistency_groups.luns.qos.policy.max_throughput_iops

integer

query

False

Filter by consistency_groups.luns.qos.policy.max_throughput_iops

consistency_groups.luns.qos.policy.min_throughput_iops

integer

query

False

Filter by consistency_groups.luns.qos.policy.min_throughput_iops

consistency_groups.luns.qos.policy.max_throughput_mbps

integer

query

False

Filter by consistency_groups.luns.qos.policy.max_throughput_mbps

consistency_groups.luns.qos.policy.name

string

query

False

Filter by consistency_groups.luns.qos.policy.name

consistency_groups.luns.qos.policy.uuid

string

query

False

Filter by consistency_groups.luns.qos.policy.uuid

consistency_groups.luns.qos.policy.min_throughput_mbps

integer

query

False

Filter by consistency_groups.luns.qos.policy.min_throughput_mbps

consistency_groups.luns.lun_maps.igroup.os_type

string

query

False

Filter by consistency_groups.luns.lun_maps.igroup.os_type

consistency_groups.luns.lun_maps.igroup.protocol

string

query

False

Filter by consistency_groups.luns.lun_maps.igroup.protocol

consistency_groups.luns.lun_maps.igroup.igroups.uuid

string

query

False

Filter by consistency_groups.luns.lun_maps.igroup.igroups.uuid

consistency_groups.luns.lun_maps.igroup.igroups.name

string

query

False

Filter by consistency_groups.luns.lun_maps.igroup.igroups.name

  • maxLength: 96

  • minLength: 1

consistency_groups.luns.lun_maps.igroup.initiators.name

string

query

False

Filter by consistency_groups.luns.lun_maps.igroup.initiators.name

consistency_groups.luns.lun_maps.igroup.initiators.comment

string

query

False

Filter by consistency_groups.luns.lun_maps.igroup.initiators.comment

  • maxLength: 254

  • minLength: 0

consistency_groups.luns.lun_maps.igroup.comment

string

query

False

Filter by consistency_groups.luns.lun_maps.igroup.comment

  • Introduced in: 9.11

  • maxLength: 254

  • minLength: 0

consistency_groups.luns.lun_maps.igroup.name

string

query

False

Filter by consistency_groups.luns.lun_maps.igroup.name

  • maxLength: 96

  • minLength: 1

consistency_groups.luns.lun_maps.igroup.uuid

string

query

False

Filter by consistency_groups.luns.lun_maps.igroup.uuid

consistency_groups.luns.lun_maps.logical_unit_number

integer

query

False

Filter by consistency_groups.luns.lun_maps.logical_unit_number

consistency_groups.luns.space.guarantee.reserved

boolean

query

False

Filter by consistency_groups.luns.space.guarantee.reserved

  • Introduced in: 9.11

consistency_groups.luns.space.guarantee.requested

boolean

query

False

Filter by consistency_groups.luns.space.guarantee.requested

  • Introduced in: 9.11

consistency_groups.luns.space.size

integer

query

False

Filter by consistency_groups.luns.space.size

  • Max value: 140737488355328

  • Min value: 4096

consistency_groups.luns.space.used

integer

query

False

Filter by consistency_groups.luns.space.used

consistency_groups.luns.os_type

string

query

False

Filter by consistency_groups.luns.os_type

consistency_groups.luns.enabled

boolean

query

False

Filter by consistency_groups.luns.enabled

consistency_groups.luns.comment

string

query

False

Filter by consistency_groups.luns.comment

  • maxLength: 254

  • minLength: 0

consistency_groups.luns.name

string

query

False

Filter by consistency_groups.luns.name

consistency_groups.luns.uuid

string

query

False

Filter by consistency_groups.luns.uuid

consistency_groups.luns.create_time

string

query

False

Filter by consistency_groups.luns.create_time

consistency_groups.svm.uuid

string

query

False

Filter by consistency_groups.svm.uuid

consistency_groups.svm.name

string

query

False

Filter by consistency_groups.svm.name

consistency_groups.volumes.tiering.policy

string

query

False

Filter by consistency_groups.volumes.tiering.policy

consistency_groups.volumes.name

string

query

False

Filter by consistency_groups.volumes.name

  • maxLength: 203

  • minLength: 1

consistency_groups.volumes.comment

string

query

False

Filter by consistency_groups.volumes.comment

  • maxLength: 1023

  • minLength: 0

consistency_groups.volumes.snapshot_policy.name

string

query

False

Filter by consistency_groups.volumes.snapshot_policy.name

consistency_groups.volumes.snapshot_policy.uuid

string

query

False

Filter by consistency_groups.volumes.snapshot_policy.uuid

consistency_groups.volumes.uuid

string

query

False

Filter by consistency_groups.volumes.uuid

consistency_groups.volumes.qos.policy.min_throughput_iops

integer

query

False

Filter by consistency_groups.volumes.qos.policy.min_throughput_iops

consistency_groups.volumes.qos.policy.max_throughput_iops

integer

query

False

Filter by consistency_groups.volumes.qos.policy.max_throughput_iops

consistency_groups.volumes.qos.policy.uuid

string

query

False

Filter by consistency_groups.volumes.qos.policy.uuid

consistency_groups.volumes.qos.policy.min_throughput_mbps

integer

query

False

Filter by consistency_groups.volumes.qos.policy.min_throughput_mbps

consistency_groups.volumes.qos.policy.max_throughput_mbps

integer

query

False

Filter by consistency_groups.volumes.qos.policy.max_throughput_mbps

consistency_groups.volumes.qos.policy.name

string

query

False

Filter by consistency_groups.volumes.qos.policy.name

consistency_groups.volumes.language

string

query

False

Filter by consistency_groups.volumes.language

consistency_groups.volumes.space.size

integer

query

False

Filter by consistency_groups.volumes.space.size

consistency_groups.volumes.space.available

integer

query

False

Filter by consistency_groups.volumes.space.available

consistency_groups.volumes.space.used

integer

query

False

Filter by consistency_groups.volumes.space.used

consistency_groups.parent_consistency_group.name

string

query

False

Filter by consistency_groups.parent_consistency_group.name

consistency_groups.parent_consistency_group.uuid

string

query

False

Filter by consistency_groups.parent_consistency_group.uuid

consistency_groups.tiering.policy

string

query

False

Filter by consistency_groups.tiering.policy

space.used

integer

query

False

Filter by space.used

space.size

integer

query

False

Filter by space.size

space.available

integer

query

False

Filter by space.available

svm.uuid

string

query

False

Filter by svm.uuid

svm.name

string

query

False

Filter by svm.name

parent_consistency_group.name

string

query

False

Filter by parent_consistency_group.name

parent_consistency_group.uuid

string

query

False

Filter by parent_consistency_group.uuid

name

string

query

False

Filter by name

snapshot_policy.name

string

query

False

Filter by snapshot_policy.name

snapshot_policy.uuid

string

query

False

Filter by snapshot_policy.uuid

luns.serial_number

string

query

False

Filter by luns.serial_number

  • maxLength: 12

  • minLength: 12

luns.qos.policy.max_throughput_iops

integer

query

False

Filter by luns.qos.policy.max_throughput_iops

luns.qos.policy.min_throughput_iops

integer

query

False

Filter by luns.qos.policy.min_throughput_iops

luns.qos.policy.max_throughput_mbps

integer

query

False

Filter by luns.qos.policy.max_throughput_mbps

luns.qos.policy.name

string

query

False

Filter by luns.qos.policy.name

luns.qos.policy.uuid

string

query

False

Filter by luns.qos.policy.uuid

luns.qos.policy.min_throughput_mbps

integer

query

False

Filter by luns.qos.policy.min_throughput_mbps

luns.lun_maps.igroup.os_type

string

query

False

Filter by luns.lun_maps.igroup.os_type

luns.lun_maps.igroup.protocol

string

query

False

Filter by luns.lun_maps.igroup.protocol

luns.lun_maps.igroup.igroups.uuid

string

query

False

Filter by luns.lun_maps.igroup.igroups.uuid

luns.lun_maps.igroup.igroups.name

string

query

False

Filter by luns.lun_maps.igroup.igroups.name

  • maxLength: 96

  • minLength: 1

luns.lun_maps.igroup.initiators.name

string

query

False

Filter by luns.lun_maps.igroup.initiators.name

luns.lun_maps.igroup.initiators.comment

string

query

False

Filter by luns.lun_maps.igroup.initiators.comment

  • maxLength: 254

  • minLength: 0

luns.lun_maps.igroup.comment

string

query

False

Filter by luns.lun_maps.igroup.comment

  • Introduced in: 9.11

  • maxLength: 254

  • minLength: 0

luns.lun_maps.igroup.name

string

query

False

Filter by luns.lun_maps.igroup.name

  • maxLength: 96

  • minLength: 1

luns.lun_maps.igroup.uuid

string

query

False

Filter by luns.lun_maps.igroup.uuid

luns.lun_maps.logical_unit_number

integer

query

False

Filter by luns.lun_maps.logical_unit_number

luns.space.guarantee.reserved

boolean

query

False

Filter by luns.space.guarantee.reserved

  • Introduced in: 9.11

luns.space.guarantee.requested

boolean

query

False

Filter by luns.space.guarantee.requested

  • Introduced in: 9.11

luns.space.size

integer

query

False

Filter by luns.space.size

  • Max value: 140737488355328

  • Min value: 4096

luns.space.used

integer

query

False

Filter by luns.space.used

luns.os_type

string

query

False

Filter by luns.os_type

luns.enabled

boolean

query

False

Filter by luns.enabled

luns.comment

string

query

False

Filter by luns.comment

  • maxLength: 254

  • minLength: 0

luns.name

string

query

False

Filter by luns.name

luns.uuid

string

query

False

Filter by luns.uuid

luns.create_time

string

query

False

Filter by luns.create_time

volumes.tiering.policy

string

query

False

Filter by volumes.tiering.policy

volumes.name

string

query

False

Filter by volumes.name

  • maxLength: 203

  • minLength: 1

volumes.comment

string

query

False

Filter by volumes.comment

  • maxLength: 1023

  • minLength: 0

volumes.snapshot_policy.name

string

query

False

Filter by volumes.snapshot_policy.name

volumes.snapshot_policy.uuid

string

query

False

Filter by volumes.snapshot_policy.uuid

volumes.uuid

string

query

False

Filter by volumes.uuid

volumes.qos.policy.min_throughput_iops

integer

query

False

Filter by volumes.qos.policy.min_throughput_iops

volumes.qos.policy.max_throughput_iops

integer

query

False

Filter by volumes.qos.policy.max_throughput_iops

volumes.qos.policy.uuid

string

query

False

Filter by volumes.qos.policy.uuid

volumes.qos.policy.min_throughput_mbps

integer

query

False

Filter by volumes.qos.policy.min_throughput_mbps

volumes.qos.policy.max_throughput_mbps

integer

query

False

Filter by volumes.qos.policy.max_throughput_mbps

volumes.qos.policy.name

string

query

False

Filter by volumes.qos.policy.name

volumes.language

string

query

False

Filter by volumes.language

volumes.space.size

integer

query

False

Filter by volumes.space.size

volumes.space.available

integer

query

False

Filter by volumes.space.available

volumes.space.used

integer

query

False

Filter by volumes.space.used

tiering.policy

string

query

False

Filter by tiering.policy

uuid

string

query

False

Filter by uuid

replicated

boolean

query

False

Filter by replicated

fields

array[string]

query

False

Specify the fields to return.

max_records

integer

query

False

Limit the number of records returned.

return_records

boolean

query

False

The default is true for GET calls. When set to false, only the number of records is returned.

  • Default value: 1

return_timeout

integer

query

False

The number of seconds to allow the call to execute before returning. When iterating over a collection, the default is 15 seconds. ONTAP returns earlier if either max records or the end of the collection is reached.

  • Max value: 120

  • Min value: 0

  • Default value: 1

order_by

array[string]

query

False

Order results by specified fields and optional [asc

Response

Status: 200, Ok
Name Type Description

_links

collection_links

num_records

integer

Number of records.

records

array[records]
Example response 
{
  "_links": {
    "next": {
      "href": "/api/resourcelink"
    },
    "self": {
      "href": "/api/resourcelink"
    }
  },
  "records": [
    {
      "_links": {
        "self": {
          "href": "/api/resourcelink"
        }
      },
      "consistency_groups": [
        {
          "_links": {
            "self": {
              "href": "/api/resourcelink"
            }
          },
          "luns": [
            {
              "clone": {
                "source": {
                  "name": "/vol/volume1/lun1",
                  "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
                }
              },
              "comment": "string",
              "create_time": "2018-06-04T19:00:00Z",
              "lun_maps": [
                {
                  "igroup": {
                    "comment": "string",
                    "igroups": [
                      {
                        "_links": {
                          "self": {
                            "href": "/api/resourcelink"
                          }
                        },
                        "name": "igroup1",
                        "uuid": "4ea7a442-86d1-11e0-ae1c-123478563412"
                      }
                    ],
                    "initiators": [
                      {
                        "comment": "my comment",
                        "name": "iqn.1998-01.com.corp.iscsi:name1"
                      }
                    ],
                    "name": "igroup1",
                    "os_type": "string",
                    "protocol": "string",
                    "uuid": "4ea7a442-86d1-11e0-ae1c-123478563412"
                  }
                }
              ],
              "name": "/vol/volume1/lun1",
              "os_type": "string",
              "provisioning_options": {
                "action": "string"
              },
              "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"
                }
              },
              "serial_number": "string",
              "space": {
                "size": 1073741824
              },
              "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
            }
          ],
          "name": "string",
          "namespaces": [
            {
              "comment": "string",
              "create_time": "2018-06-04T19:00:00Z",
              "name": "/vol/volume1/qtree1/namespace1",
              "os_type": "string",
              "provisioning_options": {
                "action": "string"
              },
              "subsystem_map": [
                {
                  "_links": {
                    "self": {
                      "href": "/api/resourcelink"
                    }
                  },
                  "anagrpid": "00103050h",
                  "nsid": "00000001h",
                  "subsystem": {
                    "_links": {
                      "self": {
                        "href": "/api/resourcelink"
                      }
                    },
                    "name": "string",
                    "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
                  }
                }
              ],
              "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
            }
          ],
          "parent_consistency_group": {
            "_links": {
              "self": {
                "href": "/api/resourcelink"
              }
            },
            "name": "my_consistency_group",
            "uuid": "02c9e252-41be-11e9-81d5-00a0986138f7"
          },
          "provisioning_options": {
            "action": "string",
            "storage_service": {
              "name": "string"
            }
          },
          "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"
            }
          },
          "restore_to": {
            "snapshot": {
              "name": "string",
              "uuid": "string"
            }
          },
          "snapshot_policy": {
            "_links": {
              "self": {
                "href": "/api/resourcelink"
              }
            },
            "name": "default",
            "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
          },
          "space": {
            "available": 5737418,
            "size": 1073741824,
            "used": 5737418
          },
          "svm": {
            "_links": {
              "self": {
                "href": "/api/resourcelink"
              }
            },
            "name": "svm1",
            "uuid": "02c9e252-41be-11e9-81d5-00a0986138f7"
          },
          "tiering": {
            "control": "string",
            "policy": "string"
          },
          "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412",
          "volumes": [
            {
              "comment": "string",
              "language": "string",
              "name": "vol_cs_dept",
              "provisioning_options": {
                "action": "string",
                "storage_service": {
                  "name": "string"
                }
              },
              "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"
                }
              },
              "snapshot_policy": {
                "_links": {
                  "self": {
                    "href": "/api/resourcelink"
                  }
                },
                "name": "default",
                "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
              },
              "tiering": {
                "control": "string",
                "policy": "string"
              },
              "uuid": "028baa66-41bd-11e9-81d5-00a0986138f7"
            }
          ]
        }
      ],
      "luns": [
        {
          "clone": {
            "source": {
              "name": "/vol/volume1/lun1",
              "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
            }
          },
          "comment": "string",
          "create_time": "2018-06-04T19:00:00Z",
          "lun_maps": [
            {
              "igroup": {
                "comment": "string",
                "igroups": [
                  {
                    "_links": {
                      "self": {
                        "href": "/api/resourcelink"
                      }
                    },
                    "name": "igroup1",
                    "uuid": "4ea7a442-86d1-11e0-ae1c-123478563412"
                  }
                ],
                "initiators": [
                  {
                    "comment": "my comment",
                    "name": "iqn.1998-01.com.corp.iscsi:name1"
                  }
                ],
                "name": "igroup1",
                "os_type": "string",
                "protocol": "string",
                "uuid": "4ea7a442-86d1-11e0-ae1c-123478563412"
              }
            }
          ],
          "name": "/vol/volume1/lun1",
          "os_type": "string",
          "provisioning_options": {
            "action": "string"
          },
          "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"
            }
          },
          "serial_number": "string",
          "space": {
            "size": 1073741824
          },
          "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
        }
      ],
      "name": "string",
      "namespaces": [
        {
          "comment": "string",
          "create_time": "2018-06-04T19:00:00Z",
          "name": "/vol/volume1/qtree1/namespace1",
          "os_type": "string",
          "provisioning_options": {
            "action": "string"
          },
          "subsystem_map": [
            {
              "_links": {
                "self": {
                  "href": "/api/resourcelink"
                }
              },
              "anagrpid": "00103050h",
              "nsid": "00000001h",
              "subsystem": {
                "_links": {
                  "self": {
                    "href": "/api/resourcelink"
                  }
                },
                "name": "string",
                "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
              }
            }
          ],
          "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
        }
      ],
      "parent_consistency_group": {
        "_links": {
          "self": {
            "href": "/api/resourcelink"
          }
        },
        "name": "my_consistency_group",
        "uuid": "02c9e252-41be-11e9-81d5-00a0986138f7"
      },
      "provisioning_options": {
        "action": "string",
        "storage_service": {
          "name": "string"
        }
      },
      "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"
        }
      },
      "restore_to": {
        "snapshot": {
          "name": "string",
          "uuid": "string"
        }
      },
      "snapshot_policy": {
        "_links": {
          "self": {
            "href": "/api/resourcelink"
          }
        },
        "name": "default",
        "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
      },
      "space": {
        "available": 5737418,
        "size": 1073741824,
        "used": 5737418
      },
      "svm": {
        "_links": {
          "self": {
            "href": "/api/resourcelink"
          }
        },
        "name": "svm1",
        "uuid": "02c9e252-41be-11e9-81d5-00a0986138f7"
      },
      "tiering": {
        "control": "string",
        "policy": "string"
      },
      "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412",
      "volumes": [
        {
          "comment": "string",
          "language": "string",
          "name": "vol_cs_dept",
          "provisioning_options": {
            "action": "string",
            "storage_service": {
              "name": "string"
            }
          },
          "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"
            }
          },
          "snapshot_policy": {
            "_links": {
              "self": {
                "href": "/api/resourcelink"
              }
            },
            "name": "default",
            "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
          },
          "tiering": {
            "control": "string",
            "policy": "string"
          },
          "uuid": "028baa66-41bd-11e9-81d5-00a0986138f7"
        }
      ]
    }
  ]
}

Error

Status: Default, Error
Name Type Description

error

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
Name Type Description

next

href

self

href
Name Type Description

self

href

source

The source LUN for a LUN clone operation. This can be specified using property clone.source.uuid or clone.source.name. If both properties are supplied, they must refer to the same LUN.

Valid in POST to create a new LUN as a clone of the source.

Valid in PATCH to overwrite an existing LUN's data as a clone of another.

Name Type Description

name

string

The fully qualified path name of the clone source LUN composed of a "/vol" prefix, the volume name, the (optional) qtree name, and base name of the LUN. Valid in POST and PATCH.

uuid

string

The unique identifier of the clone source LUN. Valid in POST and PATCH.

clone

This sub-object is used in POST to create a new LUN as a clone of an existing LUN, or PATCH to overwrite an existing LUN as a clone of another. Setting a property in this sub-object indicates that a LUN clone is desired. Consider the following other properties when cloning a LUN: auto_delete, qos_policy, space.guarantee.requested and space.scsi_thin_provisioning_support_enabled.

When used in a PATCH, the patched LUN's data is over-written as a clone of the source and the following properties are preserved from the patched LUN unless otherwise specified as part of the PATCH: class, auto_delete, lun_maps, serial_number, status.state, and uuid.

Persistent reservations for the patched LUN are also preserved.

Name Type Description

source

source

The source LUN for a LUN clone operation. This can be specified using property clone.source.uuid or clone.source.name. If both properties are supplied, they must refer to the same LUN.

Valid in POST to create a new LUN as a clone of the source.

Valid in PATCH to overwrite an existing LUN's data as a clone of another.

igroups

Name Type Description

_links

self_link

name

string

The name of the initiator group.

uuid

string

The unique identifier of the initiator group.

initiators

The initiators that are members of the initiator group.

Name Type Description

comment

string

A comment available for use by the administrator.

name

string

Name of initiator that is a member of the initiator group.

igroup

The initiator group that directly owns the initiator, which is where modification of the initiator is supported. This property will only be populated when the initiator is a member of a nested initiator group.

Name Type Description

comment

string

A comment available for use by the administrator. Valid in POST and PATCH.

igroups

array[igroups]

Separate igroup definitions to include in this igroup.

initiators

array[initiators]

The initiators that are members of the group.

name

string

The name of the initiator group. Required in POST; optional in PATCH.

os_type

string

The host operating system of the initiator group. All initiators in the group should be hosts of the same operating system. Required in POST; optional in PATCH.

protocol

string

The protocols supported by the initiator group. This restricts the type of initiators that can be added to the initiator group. Optional in POST; if not supplied, this defaults to mixed.

The protocol of an initiator group cannot be changed after creation of the group.

uuid

string

The unique identifier of the initiator group.

lun_maps

A LUN map is an association between a LUN and an initiator group.

When a LUN is mapped to an initiator group, the initiator group's initiators are granted access to the LUN. The relationship between a LUN and an initiator group is many LUNs to many initiator groups.

Name Type Description

igroup

igroup

The initiator group that directly owns the initiator, which is where modification of the initiator is supported. This property will only be populated when the initiator is a member of a nested initiator group.

logical_unit_number

integer

The logical unit number assigned to the LUN when mapped to the specified initiator group. The number is used to identify the LUN to initiators in the initiator group when communicating through the Fibre Channel Protocol or iSCSI. Optional in POST; if no value is provided, ONTAP assigns the lowest available value.

  • Introduced in: 9.6

  • readCreate: 1

provisioning_options

Options that are applied to the operation.

Name Type Description

action

string

Operation to perform

count

integer

Number of elements to perform the operation on.

policy

The QoS policy

Name Type Description

_links

self_link

max_throughput_iops

integer

Specifies the maximum throughput in IOPS, 0 means none. This is mutually exclusive with name and UUID during POST and PATCH.

max_throughput_mbps

integer

Specifies the maximum throughput in Megabytes per sec, 0 means none. This is mutually exclusive with name and UUID during POST and PATCH.

min_throughput_iops

integer

Specifies the minimum throughput in IOPS, 0 means none. Setting "min_throughput" is supported on AFF platforms only, unless FabricPool tiering policies are set. This is mutually exclusive with name and UUID during POST and PATCH.

min_throughput_mbps

integer

Specifies the minimum throughput in Megabytes per sec, 0 means none. This is mutually exclusive with name and UUID during POST and PATCH.

name

string

The QoS policy group name. This is mutually exclusive with UUID and other QoS attributes during POST and PATCH.

uuid

string

The QoS policy group UUID. This is mutually exclusive with name and other QoS attributes during POST and PATCH.

qos

Name Type Description

policy

policy

The QoS policy

guarantee

Properties that request and report the space guarantee for the LUN.

Name Type Description

requested

boolean

The requested space reservation policy for the LUN. If true, a space reservation is requested for the LUN; if false, the LUN is thin provisioned. Guaranteeing a space reservation request for a LUN requires that the volume in which the LUN resides is also space reserved and that the fractional reserve for the volume is 100%. Valid in POST and PATCH.

reserved

boolean

Reports if the LUN is space guaranteed.

If true, a space guarantee is requested and the containing volume and aggregate support the request. If false, a space guarantee is not requested or a space guarantee is requested and either the containing volume or aggregate do not support the request.

space

The storage space related properties of the LUN.

Name Type Description

guarantee

guarantee

Properties that request and report the space guarantee for the LUN.

size

integer

The total provisioned size of the LUN. The LUN size can be increased but not reduced using the REST interface. The maximum and minimum sizes listed here are the absolute maximum and absolute minimum sizes, in bytes. The actual minimum and maxiumum sizes vary depending on the ONTAP version, ONTAP platform, and the available space in the containing volume and aggregate. For more information, see Size properties in the docs section of the ONTAP REST API documentation.

  • example: 1073741824

  • format: int64

  • Max value: 140737488355328

  • Min value: 4096

  • Introduced in: 9.6

used

integer

The amount of space consumed by the main data stream of the LUN.

This value is the total space consumed in the volume by the LUN, including filesystem overhead, but excluding prefix and suffix streams. Due to internal filesystem overhead and the many ways SAN filesystems and applications utilize blocks within a LUN, this value does not necessarily reflect actual consumption/availability from the perspective of the filesystem or application. Without specific knowledge of how the LUN blocks are utilized outside of ONTAP, this property should not be used as an indicator for an out-of-space condition.

For more information, see Size properties in the docs section of the ONTAP REST API documentation.

  • format: int64

  • Introduced in: 9.6

  • readOnly: 1

luns

A LUN is the logical representation of storage in a storage area network (SAN).

In ONTAP, a LUN is located within a volume. Optionally, it can be located within a qtree in a volume.

A LUN can be created to a specified size using thin or thick provisioning. A LUN can then be renamed, resized, cloned, and moved to a different volume. LUNs support the assignment of a quality of service (QoS) policy for performance management or a QoS policy can be assigned to the volume containing the LUN. See the LUN object model to learn more about each of the properties supported by the LUN REST API.

A LUN must be mapped to an initiator group to grant access to the initiator group's initiators (client hosts). Initiators can then access the LUN and perform I/O over a Fibre Channel (FC) fabric using the Fibre Channel Protocol or a TCP/IP network using iSCSI.

Name Type Description

clone

clone

This sub-object is used in POST to create a new LUN as a clone of an existing LUN, or PATCH to overwrite an existing LUN as a clone of another. Setting a property in this sub-object indicates that a LUN clone is desired. Consider the following other properties when cloning a LUN: auto_delete, qos_policy, space.guarantee.requested and space.scsi_thin_provisioning_support_enabled.

When used in a PATCH, the patched LUN's data is over-written as a clone of the source and the following properties are preserved from the patched LUN unless otherwise specified as part of the PATCH: class, auto_delete, lun_maps, serial_number, status.state, and uuid.

Persistent reservations for the patched LUN are also preserved.

comment

string

A configurable comment available for use by the administrator. Valid in POST and PATCH.

create_time

string

The time the LUN was created.

enabled

boolean

The enabled state of the LUN. LUNs can be disabled to prevent access to the LUN. Certain error conditions also cause the LUN to become disabled. If the LUN is disabled, you can consult the state property to determine if the LUN is administratively disabled (offline) or has become disabled as a result of an error. A LUN in an error condition can be brought online by setting the enabled property to true or brought administratively offline by setting the enabled property to false. Upon creation, a LUN is enabled by default. Valid in PATCH.

lun_maps

array[lun_maps]

An array of LUN maps.

A LUN map is an association between a LUN and an initiator group. When a LUN is mapped to an initiator group, the initiator group's initiators are granted access to the LUN. The relationship between a LUN and an initiator group is many LUNs to many initiator groups.

name

string

The fully qualified path name of the LUN composed of the "/vol" prefix, the volume name, the qtree name (optional), and the base name of the LUN. Valid in POST and PATCH.

os_type

string

The operating system type of the LUN.

Required in POST when creating a LUN that is not a clone of another. Disallowed in POST when creating a LUN clone.

provisioning_options

provisioning_options

Options that are applied to the operation.

qos

qos

serial_number

string

The LUN serial number. The serial number is generated by ONTAP when the LUN is created.

  • maxLength: 12

  • minLength: 12

  • readOnly: 1

  • Introduced in: 9.10

space

space

The storage space related properties of the LUN.

uuid

string

The unique identifier of the LUN. The UUID is generated by ONTAP when the LUN is created.

  • example: 1cd8a442-86d1-11e0-ae1c-123478563412

  • readOnly: 1

  • Introduced in: 9.10

_links

Name Type Description

self

href

nvme_subsystem_reference

An NVMe subsystem maintains configuration state and NVMe namespace access control for a set of NVMe-connected hosts.