Docs
api
Cloud Disk(UDisk)
DescribeUDiskUpgradePrice

Get the price for cloud disk upgrade - DescribeUDiskUpgradePrice

Overview

Get UDisk upgrade price information

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is DescribeUDiskUpgradePrice.Yes
PublicKeystringThe user's public key can be obtained from Console (opens in a new tab)Yes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
RegionstringRegion. See List of Regions and Availability ZonesYes
ZonestringAvailability Zone. See Availability Zone ListYes
ProjectIdstringProject ID. If not filled in, the default project is used, sub-accounts must be filled in. Please refer to the GetProjectList interface.No
SizeintPurchase UDisk size, unit: GB, ordinary data disk: range [1~8000]; SSD data disk: range [1~8000]; ordinary system disk: range [1~8000]; SSD system disk: range [1~4000]; RSSD data disk: range [1~32000]; RSSD system disk: range [1~4000]; high-efficiency data disk: range [1~32000]; high-efficiency system disk: range [1~500].Yes
SourceIdstringUpgrade Target UDisk IDYes
UDataArkModestring[Data Ark Access Has Been Disabled] Do you want to enable Data Ark? Yes: Enable, No: Disable, Default value: NoNo
SnapshotServicestringWhether to enable snapshot service (Enabling snapshot service can activate UDataArk for free). Yes: Enable, No: Do not enable, Default value: No. Only the price of enabling snapshot service can be queried.No
DiskTypestring[Deprecated] UDisk Types: DataDisk (Ordinary Data Disk), SSDDataDisk (SSD Data Disk), RSSDDataDisk (RSSD Data Disk), EfficiencyDataDisk (High-Efficiency Data Disk), SystemDisk (Ordinary System Disk), SSDSystemDisk (SSD System Disk), RSSDSystemDisk(RSSD System Disk), EfficiencySystemDisk (High-Efficiency System Disk), Default Value (DataDisk)No
MachineTypestring[Deprecated] Cloud host model (V2.0), enumeration values ["N", "C", "G", "O", "OM"]. Refer to Cloud host model description.No
BackupModestringSnapshot Service Backup Strategy. The basic package is activated by default, 'Base': Basic Edition, 'Ultimate': Flagship Edition, 'Custom': Custom Backup Chain.No
JournalintWhen BackupMode is set to Custom, settings are made based on multiples of 12 hours in seconds, such as 12, 24, 36, 48.No
HourintWhen BackupMode is set to Custom, settings are made on a 24-hour basis and multiplied, such as 24, 48, 72, 96.No
DayintWhen BackupMode is set to Custom, settings are made based on a multiple of 5 days, such as 5, 10, 15, 20, 25, 30.No

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
PriceintPriceNo
OriginalPriceintUser discounted price (corresponding to billing CustomPrice)No

Example

Request Example

https://api.ucloud-global.com/udisk/?Action=DescribeUDiskUpgradePrice
&Region=cn-bj2
&Zone=cn-bj2-04
&Size=1   
&SourceId=bsm-xxx
&UDataArkMode =Yes
&DiskType = DataDisk
&MachineType=bSHaETUa
&SnapshotService=pYhGDMfE
&BackupMode=VfqsKIzi
&Journal=5
&Hour=5
&Day=7

Response Example

{
  "Action": "DescribeUDiskUpgradePriceResponse",
  "CustomPrice": 7,
  "Price": 222,
  "RetCode": 0
}