Skip to main content

Retrieve a collection of plexes for an aggregate

Contributors

GET /storage/aggregates/{aggregate.uuid}/plexes

Introduced In: 9.6

Retrieves the collection of plexes for the specified aggregate.

  • storage aggregate plex show

Parameters

Name Type In Required Description

aggregate.uuid

string

path

True

Aggregate UUID

aggregate.name

string

query

False

Filter by aggregate.name

pool

string

query

False

Filter by pool

state

string

query

False

Filter by state

resync.active

boolean

query

False

Filter by resync.active

resync.percent

integer

query

False

Filter by resync.percent

resync.level

string

query

False

Filter by resync.level

raid_groups.reconstruct.active

boolean

query

False

Filter by raid_groups.reconstruct.active

  • Introduced in: 9.7

raid_groups.reconstruct.percent

integer

query

False

Filter by raid_groups.reconstruct.percent

  • Introduced in: 9.7

raid_groups.degraded

boolean

query

False

Filter by raid_groups.degraded

  • Introduced in: 9.7

raid_groups.disks.disk.name

string

query

False

Filter by raid_groups.disks.disk.name

  • Introduced in: 9.7

raid_groups.disks.state

string

query

False

Filter by raid_groups.disks.state

  • Introduced in: 9.7

raid_groups.disks.usable_size

integer

query

False

Filter by raid_groups.disks.usable_size

  • Introduced in: 9.7

raid_groups.disks.type

string

query

False

Filter by raid_groups.disks.type

  • Introduced in: 9.7

raid_groups.disks.position

string

query

False

Filter by raid_groups.disks.position

  • Introduced in: 9.7

raid_groups.cache_tier

boolean

query

False

Filter by raid_groups.cache_tier

  • Introduced in: 9.7

raid_groups.recomputing_parity.percent

integer

query

False

Filter by raid_groups.recomputing_parity.percent

  • Introduced in: 9.7

raid_groups.recomputing_parity.active

boolean

query

False

Filter by raid_groups.recomputing_parity.active

  • Introduced in: 9.7

raid_groups.raid_type

string

query

False

Filter by raid_groups.raid_type

  • Introduced in: 9.9

raid_groups.name

string

query

False

Filter by raid_groups.name

  • Introduced in: 9.7

online

boolean

query

False

Filter by online

name

string

query

False

Filter by name

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.

  • Default value: 1

  • Max value: 120

  • Min value: 0

order_by

array[string]

query

False

Order results by specified fields and optional [asc

Response

Status: 200, Ok
Name Type Description

_links

_links

error

error

num_records

integer

Number of records

records

array[plex]

Example response
{
  "_links": {
    "next": {
      "href": "/api/resourcelink"
    },
    "self": {
      "href": "/api/resourcelink"
    }
  },
  "error": {
    "arguments": [
      {
        "code": "string",
        "message": "string"
      }
    ],
    "code": "4",
    "message": "entry doesn't exist"
  },
  "num_records": 1,
  "records": [
    {
      "aggregate": {
        "_links": {
          "self": {
            "href": "/api/resourcelink"
          }
        },
        "name": "aggr1",
        "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
      },
      "name": "plex0",
      "pool": "string",
      "raid_groups": [
        {
          "disks": [
            {
              "disk": {
                "_links": {
                  "self": {
                    "href": "/api/resourcelink"
                  }
                },
                "name": "1.0.1"
              },
              "position": "string",
              "state": "string",
              "type": "ssd",
              "usable_size": 947912704
            }
          ],
          "name": "rg0",
          "raid_type": "raid_dp",
          "recomputing_parity": {
            "percent": 10
          },
          "reconstruct": {
            "percent": 10
          }
        }
      ],
      "resync": {
        "level": "string",
        "percent": 10
      },
      "state": "string"
    }
  ]
}

Error

Status: Default, Error
Name Type Description

error

returned_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

error_arguments

Name Type Description

code

string

Argument code

message

string

Message argument

error

Name Type Description

arguments

array[error_arguments]

Message arguments

code

string

Error code

message

string

Error message

Name Type Description

self

href

aggregate

Aggregate

Name Type Description

_links

_links

name

string

uuid

string

disk

Disk

Name Type Description

_links

_links

name

string

raid_group_disk

Name Type Description

disk

disk

Disk

position

string

The position of the disk within the RAID group.

state

string

The state of the disk within the RAID group.

type

string

Disk interface type

usable_size

integer

Size in bytes that is usable by the aggregate.

recomputing_parity

Name Type Description

active

boolean

RAID group is recomputing parity

percent

integer

Recomputing parity percentage

reconstruct

Name Type Description

active

boolean

One or more disks in this RAID group are being reconstructed.

percent

integer

Reconstruct percentage

raid_group

Name Type Description

cache_tier

boolean

RAID group is a cache tier

degraded

boolean

RAID group is degraded. A RAID group is degraded when at least one disk from that group has failed or is offline.

disks

array[raid_group_disk]

name

string

RAID group name

raid_type

string

RAID type of the raid group.

recomputing_parity

recomputing_parity

reconstruct

reconstruct

resync

Name Type Description

active

boolean

Plex is being resynchronized to its mirrored plex

level

string

Plex resyncing level

percent

integer

Plex resyncing percentage

plex

Name Type Description

aggregate

aggregate

Aggregate

name

string

Plex name

online

boolean

Plex is online

pool

string