VM Related Interfaces

Get VM RDP Status

GET/zstack/v1/vm-instances/{uuid}/rdp

Get VM RDP switch status. Return value is true or false

Headers

Authorization: OAuth the-session-uuid
curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth c38710f23af942819cc2c431bd94407b" \
-X GET http://localhost:8080/zstack/v1/vm-instances/78494eb669424e97b6f18920a920adbf/rdp

Parameter List

NameTypeLocationDescriptionAllowed ValuesStarting Version
uuidStringurlResource UUID, uniquely identifies the resource 2.1
systemTags (Optional)Listquery  2.1
userTags (Optional)Listquery  2.1

API Response

Response Example

{
  "enable": true
}
NameTypeDescriptionStarting Version
enablebooleanWhether VM RDP switch is enabled2.1
errorErrorCodeError code. If not null, the operation failed. When the operation succeeds, this field is null. For details, see error2.1

error

NameTypeDescriptionStarting Version
codeStringError code number, a globally unique identifier of the error, for example SYS.1000, HOST.10012.1
descriptionStringBrief description of the error2.1
detailsStringDetailed error information2.1
elaborationStringReserved field, defaults to null2.1
opaqueLinkedHashMapReserved field, defaults to null2.1
causeErrorCodeRoot cause. The error that triggered the current error. If there is no original error, this field is null2.1

SDK Examples

Java SDK

GetVmRDPAction action = new GetVmRDPAction();
action.uuid = "2503d2eb486e43469fef0e4864fb6c90";
action.sessionId = "380901023c664283a2a3edc0c52817f2";
GetVmRDPAction.Result res = action.call();

Python SDK

GetVmRDPAction action = GetVmRDPAction()
action.uuid = "4cec955330e44ac980b99f20c811f1cc"
action.sessionId = "2971ac1171da458b964bf689032ba778"
GetVmRDPAction.Result res = action.call()