Releasing the spare drive setting

Storage Advisor Embedded User Guide

Version
93-07-2x
88-08-12
Audience
anonymous
Part Number
MK-97HM85022-25

The following request releases the spare drive setting with the specified number of drives. The drive can then be used as a normal drive.

Execution permission

Storage Administrator (Provisioning)

Request line

POST base-URL/simple/v1/objects/drives/actions/release-spare/invoke

Request message

Object ID
None.
Query parameters
None.
Body

The following is an example of releasing four spare drives that have the drive type code DKR5D-J600SS:

{
  "releasedSpareDrives": [
    {
      "driveTypeCode": "DKR5D-J600SS",
      "driveCount": 4
    }
  ]
}

Attribute

Type

Description

releasedSpareDrives

object[]

Drive information for which the spare drive setting is released:

  • (Required) driveTypeCode (string)

    Specify a drive type code consisting of 12 characters.*

    Example: DKR5D-J900SS

  • (Required) driveCount (int)

    Specify the number of data drives as an integer from 1 through 1440.

* The spare drive setting can be released for drives with a different drive type code, even if the drive conditions (drive type, drive interface, drive rotation speed, and drive capacity) are the same. The system releases the spare drive setting for drives that match the drive conditions, regardless of the drive type code you specify. You can check information about the drives for which the spare drive setting is released by running the API request for getting drive information.

Response message

Body

Attribute

Type

Description

statusResource

string

URL to use to obtain the results of drives for which the spare drive setting is released

Note:

Run the API function for obtaining information about the status of the API function that performs asynchronous processing. For details, see Getting status information about an API function that performs asynchronous processing.

Status codes

See HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/simple/v1/objects/drives/actions/release-spare/invoke