Modifying Drive Settings

PATCH /drive/{drive_id}

Introduction

Modifies the specified Drive setting.

Caution

  • You cannot specify more than one setting item to modify.

  • Tenant users cannot execute this command.

Request Examples

  • This is an example of registering Drive ID 0204 as a Hot Spare.

    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X PATCH "https://192.168.1.1:5665/api/v1/drive/0204"
-d
'{"is_hotspare" : true}'

Response Examples

{
  "job_id": 8192001,
  "job_href": "/api/v1/job/8192001"
}

Parameters

PATH PARAMETERS

drive_id

(required)

string

Drive ID.

Format is as follows:

  • Drive in CE w0yy

    • w - Hexadecimal CE ID (0 to b)

    • yy - Hexadecimal Slot ID (00 to 17)

  • Drive in DE xxyy

    • xx - Hexadecimal DE ID (00 to ff)

    • yy - Hexadecimal Slot ID (00 to 17)

REQUEST BODY

is_hotspare

(required)

boolean

Hot Spare registration/release for a Drive.

If true, the drive is registered as a Hot Spare.

If false, the drive is released from being used as a Hot Spare.

Input criteria:

  • If you specify a Drive that is in use, you cannot specify true.

  • If you specify a Drive that is registered as Hot Spare, you cannot specify true.

  • If you specify a Drive that is not registered as Hot Spare, you cannot specify false.

  • Dedicated Hot Spares cannot be registered or released. If you want to modify the setting, use ETERNUS Web GUI or ETERNUS CLI.

Responses

If successful, the HTTP status code is 202 (Accepted) and the response body is returned.

RESPONSE BODY

job_id

integer

Job ID.
job_href

string

Resource link of the job.