Docs
api
Cloud PostgreSQL Database(UDB NVMe)
GetUPgSQLInstance

Get the description of the cloud database instance - GetUPgSQLInstance

Overview

Get PG Cloud Database Instance Description

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is GetUPgSQLInstance.Yes
PublicKeystringThe user’s public key can be obtained from ConsoleYes
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 ListNo
ProjectIdstringProject ID. If not filled in, the default project is used, sub-accounts must be filled in. Please refer to the GetProjectList interface.No
InstanceIDstringResource IDYes

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
DataSetUDBInstanceYes

Data Model

UDBInstance

Field NameTypeDescription InformationRequired
ZonestringAvailability Zone of the DB InstanceNo
BackupZonestringBackup Availability ZoneNo
InstanceIDstringDB Instance idNo
NamestringInstance NameNo
DBVersionstringDB VersionNo
ParamGroupIDintConfiguration parameter group id used by the DB instanceNo
AdminUserstringAdministrator account name, default is rootNo
IPstringThe text “DBip” doesn’t seem to be a standard Chinese phrase or term related to cloud computing. Could you please provide more context or check if there might be a typo?No
PortintDB PortNo
VPCIDstringID of VPCNo
SubnetIDstringSubnet IDNo
RemarkstringNoteNo
BackupCountintThe number of backup files retained, default is 7 timesNo
BackupBeginTimeintBackup start time, measured in hours, default is 3 o’clock.No
BackupTimeRangeintBackup time period, range [0,23]No
BackupDatestringThe backup date tag used for setting up the backup strategy. There are 7 bits in total, each representing the backup status of one day of the week. 0 means the backup is turned off for that day, 1 means the backup is turned on. The rightmost bit is the backup switch for Sunday, and the rest from right to left are the backup configuration switches for Monday to Saturday, respectively. At least two days of backup must be set each week. For example: 1100000 means the automatic backup function for Saturday and Friday is turned on.No
StatestringDB Status Tags Init: Initializing, Fail: Installation Failed, Starting: Starting Up, Running: Running, Shutdown: Shutting Down, Shutoff: Shut Off, Delete: Deleted, Upgrading: Upgrading, Promoting: Promoting to Standalone Database in Progress, Recovering: Recovering, Recover fail: Recovery FailedNo
CreateTimeintDB instance creation time, using UTC timestampNo
ModifyTimeintDB instance modification time, using UTC timestampNo
ExpiredTimeintExpiration time of the DB instance, using UTC timestampNo
CpuintCPU Limit (Core), default according to configuration modelNo
MemoryLimitintMemory Limit (MB), default based on configuration modelNo
DiskSpaceintDisk Space (GB), default according to configuration modelNo
DiskUsedSizefloatUsed space of DB instance disk, unit GBNo
DataFileSizefloatSize of DB instance data file, in GBNo
SystemFileSizefloatSize of DB instance system file, unit GBNo
LogFileSizefloatSize of DB instance log file, in GBNo
InstanceModestringNormal/High AvailabilityNo
MachineTypestringConfiguration Model NameNo

Example

Request Example

https://api.dezai.com/?Action=GetUPgSQLInstance
&Region=cn-zj
&Zone=cn-zj-01
&ProjectId=NmpXWjBt
&InstanceID=zercJTxf

Response Example

{
  "Action": "GetUPgSQLInstanceResponse",
  "DataSet": {},
  "Message": "BTbgDWAl",
  "RetCode": 0
}