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

Retrieve a storage pool specified by the UUID

Contributors

GET /storage/pools/{uuid}

Introduced In: 9.11

Retrieves the storage pool specified by the UUID.

  • storage pool show -storage-pool-uuid

Parameters

Name Type In Required Description

uuid

string

path

True

Storage pool UUID.

fields

array[string]

query

False

Specify the fields to return.

Response

Status: 200, Ok
Name Type Description

_links

_links

capacity

capacity

health

health

Properties that outline shared storage pool health.

name

string

Storage pool name.

nodes

array[node_reference]

Nodes that can use this storage pool for their aggregates.

storage_type

string

Storage type for the disks used to create the storage pool.

uuid

string

Storage pool UUID.

Example response
{
  "_links": {
    "self": {
      "href": "/api/resourcelink"
    }
  },
  "capacity": {
    "disks": [
      {
        "disk": {
          "_links": {
            "self": {
              "href": "/api/resourcelink"
            }
          },
          "name": "1.0.1"
        },
        "total_size": 0,
        "usable_size": 0
      }
    ],
    "remaining": 0,
    "spare_allocation_units": [
      {
        "available_size": 0,
        "node": {
          "_links": {
            "self": {
              "href": "/api/resourcelink"
            }
          },
          "name": "node1",
          "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
        },
        "size": 0,
        "syncmirror_pool": "string"
      }
    ],
    "total": 0,
    "used_allocation_units": [
      {
        "aggregate": {
          "_links": {
            "self": {
              "href": "/api/resourcelink"
            }
          },
          "name": "aggr1",
          "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
        },
        "current_usage": 0,
        "node": {
          "_links": {
            "self": {
              "href": "/api/resourcelink"
            }
          },
          "name": "node1",
          "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
        }
      }
    ]
  },
  "health": {
    "state": "string",
    "unhealthy_reason": {
      "arguments": [
        {
          "code": "string",
          "message": "string"
        }
      ],
      "code": "4",
      "message": "entry doesn't exist",
      "target": "uuid"
    }
  },
  "name": "string",
  "nodes": [
    {
      "_links": {
        "self": {
          "href": "/api/resourcelink"
        }
      },
      "name": "node1",
      "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
    }
  ],
  "storage_type": "string",
  "uuid": "string"
}

Error

Status: Default

ONTAP Error Response Codes

Error Code Description

11206662

There is no storage pool matching the specified UUID or name.

11215856

The specified storage pool is not healthy.

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

self

href

disk

Reference to the constituent disk object.

Name Type Description

_links

_links

name

string

storage_pool_disk

Name Type Description

disk

disk

Reference to the constituent disk object.

total_size

integer

Raw capacity of the disk, in bytes.

usable_size

integer

Usable capacity of this disk, in bytes.

node

Specifies what node can use this set of allocation units.

Name Type Description

_links

_links

name

string

uuid

string

storage_pool_spare_allocation_unit

Name Type Description

available_size

integer

The usable capacity of this set of allocation units.

count

integer

The number of spare allocation units on this node.

node

node

Specifies what node can use this set of allocation units.

size

integer

Size of each allocation unit.

syncmirror_pool

string

The RAID SyncMirror Pool to which this allocation unit is assigned.

aggregate

The aggregate that is using this cache capacity.

Name Type Description

_links

_links

name

string

uuid

string

node

The node hosting the aggregate using this set of allocation units.

Name Type Description

_links

_links

name

string

uuid

string

storage_pool_used_allocation_unit

Name Type Description

aggregate

aggregate

The aggregate that is using this cache capacity.

count

integer

The number of allocation units used by this aggregate.

current_usage

integer

The amount of cache space used by this aggregate.

node

node

The node hosting the aggregate using this set of allocation units.

capacity

Name Type Description

disk_count

integer

The number of disks in the storage pool.

disks

array[storage_pool_disk]

Properties of each disk used in the shared storage pool.

remaining

integer

Remaining usable capacity in the flash pool, in bytes.

spare_allocation_units

array[storage_pool_spare_allocation_unit]

Properties of spare allocation units.

total

integer

Total size of the flash pool, in bytes.

used_allocation_units

array[storage_pool_used_allocation_unit]

Information about the storage pool allocation units participating in the cache tier of an aggregate.

error_arguments

Name Type Description

code

string

Argument code

message

string

Message argument

error

Indicates why the storage pool is unhealthy. This property is not returned for healthy storage pools.

Name Type Description

arguments

array[error_arguments]

Message arguments

code

string

Error code

message

string

Error message

target

string

The target parameter that caused the error.

health

Properties that outline shared storage pool health.

Name Type Description

is_healthy

boolean

Indicates whether the storage pool is able to participate in provisioning operations.

state

string

The state of the shared storage pool.

unhealthy_reason

error

Indicates why the storage pool is unhealthy. This property is not returned for healthy storage pools.

node_reference

Name Type Description

_links

_links

name

string

uuid

string

error

Name Type Description

arguments

array[error_arguments]

Message arguments

code

string

Error code

message

string

Error message

target

string

The target parameter that caused the error.