Setting the priority levels of ALUA paths

REST API Reference Guide for Virtual Storage Platform 5000, Virtual Storage Platform E Series, and Virtual Storage Platform G/F Series

Version
93-07-0x
90-09-0x
88-08-10
Audience
anonymous
Part Number
MK-98RD9014-17
For a global-active device in a cross-path configuration (using a Fibre Channel connection), by enabling the ALUA attribute, you can set the priority levels of paths between a host and a storage system.

Execution permission

Storage Administrator (Provisioning)

Request line

POST base-URL/v1/services/lun-service/actions/change-asymmetric-access-state/invoke

Request message

Object ID
None.
Query parameters

None.

Body
{
  "parameters": {
    "portId" : "CL1-A",
    "hostGroupNumber" : 1,
    "asymmetricAccessState" : "Active/Optimized"
  }
}

Attribute

Type

Description

portId

string

(Required) Port number

hostGroupNumber

int

(Required) Host group number

asymmetricAccessState

string

(Required) Priority level of the ALUA path

  • Active/Optimized: Higher priority
  • Active/Non-Optimized: Lower priority

Response message

Body

A job object is returned. For details on attributes other than affectedResources, see the section explaining job objects.

Attribute

Description

affectedResources

URL for getting information about LU paths

You can get information about the priority level of an ALUA path by specifying lunOption=ALUA in the query parameters of the API function for getting information about LU paths.

Action template

None.

Status codes

For details on the status codes of the request for this operation, see the description of HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/v1/services/lun-service/actions/change-asymmetric-access-state/invoke