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

Update disk ownership, change authentication keys, or sanitize disks

Contributors
PDFs

PATCH /storage/disks

Introduced In: 9.7

Updates disk ownership or authentication keys.

  • storage disk assign

  • storage encryption disk modify -data-key-id

  • security key-manager key query -key-type NSE-AK

Learn more

Parameters

Name Type In Required Description

name

string

query

False

Disk name

encryption_operation

string

query

False

Name of the operation to apply to encrypting disks.

  • enum: ["rekey_data_default", "rekey_data_auto_id"]

return_records

boolean

query

False

The default is false. If set to true, the records are returned.

  • Default value:

Request Body

Name Type Description

aggregates

array[aggregates]

List of aggregates sharing this disk

bay

integer

Disk shelf bay

class

string

Disk class

container_type

string

Type of overlying disk container

dr_node

dr_node

drawer

drawer

encryption_operation

string

Encryption operation to apply to the drives. Possible values are:

  • rekey_data_default

  • rekey_data_auto_id

fips_certified

boolean

firmware_version

string

home_node

home_node

key_id

key_id

model

string

name

string

Cluster-wide disk name

node

node

pool

string

Pool to which disk is assigned

protection_mode

string

Mode of drive data protection and FIPS compliance. Possible values are:

  • open - Disk is unprotected

  • data - Data protection only without FIPS compliance

  • part - Partial protection with FIPS compliance only

  • full - Full data and FIPS compliance protection

rated_life_used_percent

integer

Percentage of rated life used

rpm

integer

Revolutions per minute

self_encrypting

boolean

serial_number

string

shelf

shelf

state

string

State

type

string

Disk interface type

uid

string

The unique identifier for a disk

usable_size

integer

vendor

string
Example request 
{
  "aggregates": [
    {
      "_links": {
        "self": {
          "href": "/api/resourcelink"
        }
      },
      "name": "aggr1",
      "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
    }
  ],
  "bay": "1",
  "class": "solid_state",
  "container_type": "spare",
  "dr_node": {
    "name": "node1",
    "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
  },
  "encryption_operation": "string",
  "firmware_version": "NA51",
  "home_node": {
    "_links": {
      "self": {
        "href": "/api/resourcelink"
      }
    },
    "name": "node1",
    "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
  },
  "key_id": {
    "data": "string",
    "fips": "string"
  },
  "model": "X421_HCOBE450A10",
  "name": "1.0.1",
  "node": {
    "_links": {
      "self": {
        "href": "/api/resourcelink"
      }
    },
    "name": "node1",
    "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
  },
  "pool": "pool0",
  "protection_mode": "string",
  "rated_life_used_percent": "10",
  "rpm": "15000",
  "serial_number": "KHG2VX8R",
  "shelf": {
    "_links": {
      "self": {
        "href": "/api/resourcelink"
      }
    },
    "uid": "7777841915827391056"
  },
  "state": "present",
  "type": "ssd",
  "uid": "002538E5:71B00B2F:00000000:00000000:00000000:00000000:00000000:00000000:00000000:00000000",
  "usable_size": "959934889984",
  "vendor": "NETAPP"
}

Response

Status: 200, Ok

Error

Status: Default

ONTAP Error Response Codes

Error Code Description

721066

Node is outside the list of controllers for disk.

1441795

Setting the data key ID to the manufacture secure ID is not allowed when in FIPS-compliance mode.

14155777

The operation failed on one or more disks.

14155778

No self-encrypting disks were specified.

14155779

Status from a node shows that a conflicting operation has occurred. Some disk controls might have changed.

14155780

Could not retrieve the required key ID from the key manager.

14155786

Changes to encryption controls are not allowed with drive assignment.

Definitions

See Definitions

href

Name Type Description

href

string

_links

Name Type Description

self

href

aggregates

Aggregate

Name Type Description

_links

_links

name

string

uuid

string

dr_node

Name Type Description

name

string

uuid

string

drawer

Name Type Description

id

integer

slot

integer

home_node

Name Type Description

_links

_links

name

string

uuid

string

key_id

Name Type Description

data

string

Key ID of the data authentication key

fips

string

Key ID of the FIPS authentication key

node

Name Type Description

_links

_links

name

string

uuid

string

shelf

Name Type Description

_links

_links

uid

string

disk

Name Type Description

aggregates

array[aggregates]

List of aggregates sharing this disk

bay

integer

Disk shelf bay

class

string

Disk class

container_type

string

Type of overlying disk container

dr_node

dr_node

drawer

drawer

encryption_operation

string

Encryption operation to apply to the drives. Possible values are:

  • rekey_data_default

  • rekey_data_auto_id

fips_certified

boolean

firmware_version

string

home_node

home_node

key_id

key_id

model

string

name

string

Cluster-wide disk name

node

node

pool

string

Pool to which disk is assigned

protection_mode

string

Mode of drive data protection and FIPS compliance. Possible values are:

  • open - Disk is unprotected

  • data - Data protection only without FIPS compliance

  • part - Partial protection with FIPS compliance only

  • full - Full data and FIPS compliance protection

rated_life_used_percent

integer

Percentage of rated life used

rpm

integer

Revolutions per minute

self_encrypting

boolean

serial_number

string

shelf

shelf

state

string

State

type

string

Disk interface type

uid

string

The unique identifier for a disk

usable_size

integer

vendor

string