You can call this operation to reassign users to a cloud desktop.


  • The cloud desktop must be in the Running state.
  • The user to be reassigned must have the AliyunECDRamUserAccess permission. If the user does not have this permission, the user is unable to connect to the cloud desktop by using the cloud desktop client.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer automatically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyEntitlement

The operation that you want to perform. Set the value to ModifyEntitlement.

DesktopId String Yes ecd-7w78ozhjcwa3u****

The ID of the cloud desktop.

EndUserId.N RepeatList Yes 123456789

The ID of user N. You can specify one or more user IDs.

  • For a RAM user, the value is the UID of the user.
  • For an AD user, the value is the sAMAccountName of Windows logon user N.
RegionId String Yes cn-hangzhou

The ID of the region.

Response parameters

Parameter Type Example Description
RequestId String 8F851208-C0EA-4CDD-9074-DBE70CB430DA

The ID of the request.


Sample requests
&<Common request parameters>

Sample success responses

XML format


JSON format


Error codes

For a list of error codes, visit the API Error Center.