Skip to main content

We've Moved!

Product Documentation has moved to docs.hitachivantara.com
Hitachi Vantara Knowledge

Getting configuration information (including additional information) from the storage system cache

You can get configuration information (including additional information) from the storage system cache held on the SVP and update the cache data of storage systems.

About the acquisition of additional information

This section describes the operation to get configuration information, including additional information, from the storage system cache held on the SVP, after you perform an operation such as changing the configuration.

You can perform this operation on the following storage systems:

  • VSP 5000 series

The following indicates the configuration when configuration information, including additional information, is obtained from the storage system cache held on the SVP.

GUID-E61B86F4-FCD9-41F1-B852-596DD2A0DBA4-low.gif

The API requests that get information from the storage system cache can be used to get configuration information including additional information or get information about copy pairs:

  • API requests that can get configuration information, including additional information:

    • Summary information about storage systems
    • Channel board information
  • API requests that can get configuration information, including additional information, by specifying a query parameter:

    • Information about parity groups
    • Information about external parity groups
    • Information about drives
    • Information about volumes
    • Information about ports
    • Information about pools
    • Information about remote copy groups
    • Information about hardware installed on a storage system#
  • API requests that can get information about copy pairs:

    • Getting information about all of ShadowImage pairs
    • Getting information about all of Thin Image pairs
    • Getting information about all of remote copy pairs (TrueCopy/Universal Replicator)
    • Getting information about all of remote copy pairs (global-active device)
  • API requests that can add and get detailed information about copy pairs, by specifying a query parameter:

    • Getting a list of copy groups (ShadowImage)
    • Getting information about Thin Image pairs in units of snapshot groups
    • Getting a list of remote copy groups (TrueCopy/Universal Replicator)
    • Getting a list of remote copy groups (global-active device)
    • Getting a list of copy groups (Volume Migration)

#: Of the information about the hardware installed in the storage system, only additional information is obtained from the storage system cache.

It usually takes from one to five minutes (but can take as long as an hour) before the latest information is applied to the cache. To obtain the latest information, run the API request that updates the cache of storage system configuration information to refresh the cache data, and then run the API request for getting information.

Updating the cache of storage system configuration information

The following API request updates the cache of storage system configuration information.

The procedure for obtaining information about resources after performing operations such as changing the configuration of resources is as follows.

  1. Run the API request that changes the configuration of resources described in the explanation about getting additional information.
  2. Run the API request that updates the cache of storage system configuration information.

    It takes about 10 seconds or longer to update the cache information. Depending on the storage system usage status, it might take as long as 20 minutes to receive a response for this API request. Also, if multiple operations for changing the configuration are running concurrently, it might take a long time to receive a response for this API request.

    We recommend that you lock the target resources before running this API request.

    Note

    This API request might fail depending on the number of configuration change operations and the number of resources such as LDEVs. If such a failure occurs, the HTTP status code 503 will be returned. In such a case, wait a while, and then run the request again.

  3. Run the API request that obtains information about the resources whose configuration has been changed.
Execution permission

Storage Administrator (View)

Request line
POST base-URL/v1/services/storage-cache-service/actions/refresh/invoke
Request message
  • Object ID

    None.

  • Query parameters

    None.

  • Body

    None.

Response message
  • Body

    None.

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 https://192.0.2.100/ConfigurationManager/v1/services/storage-cache-service/actions/refresh/invoke -d ""