2.3.3 ChangeDiskSize (Increases Data Disk Capacity)

This API increases the capacity of the data disk of a server.

This API is executed asynchronously. If this API is successfully executed, the L-Platform status switches into RECONFIG_ING during the execution of the process. When the process is completed, the L-Platform status switches back to NORMAL.
When the L-Platform status is RECONFIG_ING, operation of the L-Platform is not possible.
Monitor the status of the L-Platform using GetLPlatformStatus and wait for the status to change to NORMAL before performing the next operation.

This API can only be used if the server virtualization software on the server is VMware or Hyper-V.

This API cannot be executed in the following case:

When the target server is a server for which configuration modification or deletion cannot be performed
For the servers for which configuration modification and deletion cannot be performed, refer to "8.3.18 L-Platform Reconfiguration" in the "User's Guide for Tenant Administrators CE".
When the target server has snapshots on it
When disks not managed by ROR, such as RDM (Raw Device Mapping), are connected to the server
When the server virtualization software is Hyper-V, and the server is running

Request Parameters

Parameter Name	Item	Item Description
Version	Description	The version ID of the L-Platform API
	Type	ASCII string
	Value	Fixed Specify "2.0".
Locale	Description	The language for communicating with the L-Platform API. This parameter is specified using the language codes stipulated by ISO 639.
	Type	ASCII string
	Value	Select one of the following: - en: English - zh: Chinese
Action	Description	The name of the L-Platform API to be executed
	Type	ASCII string
	Value	Fixed. Specify "ChangeDiskSize".
userId	Description	The user ID of the user that executes the L-Platform API
	Type	ASCII string
	Value	No more than 31 characters
orgId	Description	The tenant name of the user that executes the L-Platform API
	Type	ASCII string
	Value	No more than 32 characters
lplatformId	Description	The L-Platform ID of the L-Platform containing the target server
	Type	ASCII string
	Value	No more than 32 characters
lserverId	Description	The server ID of the target server
	Type	ASCII string
	Value	No more than 32 characters
diskId	Description	The ID of the disk
	Type	ASCII string
	Value	No more than 32 characters
diskSize	Description	The size of the disk.
	Type	decimal
	Value	Specify a value larger than the current disk size. The size can be specified in GB, using up to one decimal place.

Response

The API returns "200 OK" if it terminates normally.

<XML>

<?xml version="1.0" encoding="UTF-8"?>
<ChangeDiskSizeResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>[Message]</responseMessage>
  <responseStatus>[Status]</responseStatus>
</ChangeDiskSizeResponse>

Element Name	Item	Item Description
ChangeDiskSizeResponse	Description	Element holding the response information
	Type	None
	Number of occurrences	1
responseMessage	Description	Message. This element indicates whether the request has been processed correctly. Refer to "Chapter 15 Messages Starting with PAPI" in "Messages" for message details.
	Type	UTF-8 string
	Number of occurrences	1
responseStatus	Description	Status. This element indicates whether the request has been processed normally. "SUCCESS" is returned if the request is processed normally. Otherwise, an error code is returned. Refer to the "Appendix A List of Response Status Error Codes(L-Platform APIs)" for information on error codes.
	Type	ASCII string
	Number of occurrences	1

Sample Response

<?xml version="1.0" encoding="UTF-8"?>
<ChangeDiskSizeResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage> PAPI00000 Processing was completed.</responseMessage>
  <responseStatus> SUCCESS </responseStatus>
</ChangeDiskSizeResponse>