Docs
api
Server Migration Center(USMC)
ListUSMCAgent

Get the current user’s Agent list - ListUSMCAgent

Overview

Get the current user’s Agent list

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is ListUSMCAgent.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
PlanIdstringMigration Plan IDYes
AgentIdsstringAgent ID, multiple IDs separated by commasNo
OffsetstringList start position offset, default is 0No
LimitstringReturn data length, default is 20, maximum 100No

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
Dataarray[ListAgentItem][ ]ListAgentItemYes

Data Model

ListAgentItem

Field NameTypeDescription InformationRequired
AgentIdstringClient IDNo
NamestringClient NameNo
StatusstringClient StatusNo
OsDataOSData[]OSDataNo
ResourceDataHostResourceDataHostResourceDataNo
HostNamestringHost NameNo
IpstringIP AddressNo
MacstringMAC AddressNo
AgentVerionstringClient Version NumberNo
DiskItemsarray[DiskItem]DiskItemNo
NetworkTypeintNetwork Type, 10: Public Network, 20: Private Network, 30: Dedicated LineNo
TargetRegionstringTarget RegionNo
TargetZonestringTarget Availability ZoneNo
TargetVPCIdstringTarget VPC IDNo
TargetSubnetIdstringTarget Subnet IDNo
CreateTimeintCreation TimeNo

OSData

Field NameTypeDescription InformationRequired
OsTypestringOperating System TypeNo
ArchTypestringOperating System ArchitectureNo
PlatformTypestringOperating System PlatformNo
LinuxVerstringLinux version, only valid for Linux systemNo
WinVerstringWindows version number, only valid for Windows systemNo
KernelVersionstringKernel Version NumberNo

HostResourceData

Field NameTypeDescription InformationRequired
CpuNumsintCPU CoresYes
MemSizeintMemory SizeYes
MachineTypestringMachine TypeYes

DiskItem

Field NameTypeDescription InformationRequired
SizeintDisk CapacityNo
IsBootbooleanIs it a system disk?No
DiskTypestringDisk TypeNo

Example

Request Example

https://api.dezai.com/?Action=ListUSMCAgent
&Region=cn-zj
&Zone=cn-zj-01
&ProjectId=EOjyHBuq
&Offset=4
&Limit=9
&Region=BfVjoVSf
&SetId=ZxmoUssh
&AgentIds=oClQQgPk
&AgentIds=tuoDzvuT
&Region=sVvGRkEd

Response Example

{
  "Action": "ListUSMCAgentResponse",
  "Data": {},
  "RetCode": 0
}