Querying Workspace Bandwidth Control
Function
Queries Workspace bandwidth control.
Debugging
You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.
URI
GET /v2/{project_id}/bandwidths/{bandwidth_id}/control-list
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID. |
bandwidth_id |
Yes |
String |
Workspace bandwidth ID. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
desktop_id |
No |
String |
Desktop ID. |
desktop_name |
No |
String |
Desktop name. |
user_name |
No |
String |
Users to whom desktops are assigned. |
control_mode |
No |
String |
Control method. Options:
|
offset |
No |
Integer |
Where the pagination query starts. The value starts from 0. |
limit |
No |
Integer |
Limits the quantity of returned desktops in pagination query. If this parameter is not specified, all records that meet the search criteria are returned. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
No |
String |
User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
control_mode |
String |
Control method.
|
control_list |
Array of ControlItem objects |
Desktops in control. |
total_count |
Integer |
Total number. |
Parameter |
Type |
Description |
---|---|---|
desktop_id |
String |
Desktop ID. |
desktop_name |
String |
Desktop name. |
desktop_status |
String |
Desktop status. |
pool_id |
String |
Pool ID. |
attach_user_infos |
Array of AttachInstancesUserInfo objects |
List of users to whom desktops have been assigned. |
Parameter |
Type |
Description |
---|---|---|
user_id |
String |
If type is set to USER, enter the user ID. If type is set to GROUP, enter the user group ID. The backend service checks whether the group ID exists. |
user_name |
String |
Name of the object assigned with a desktop. If type is set to USER, enter the username. If type is set to GROUP, enter the user group name.
|
user_group |
String |
Specifies the user group to which the desktop user belongs.
|
type |
String |
Object type. Options:
|
Status code: default
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code, which is returned upon failure. |
error_msg |
String |
Error description. |
error_detail |
String |
Error details. |
encoded_authorization_message |
String |
Encrypted detailed reason for rejection. You can call the API decode-authorization-message of STS to decrypt the reason. |
Example Requests
None
Example Responses
Status code: 200
Response to the request for querying Workspace bandwidth control.
{ "control_mode" : "string", "control_list" : [ { "desktop_id" : "string", "desktop_name" : "string", "desktop_status" : "string", "pool_id" : "string", "attach_user_infos" : [ { "user_id" : "string", "user_name" : "string", "user_group" : "string", "type" : "USER" } ] } ], "total_count" : 0 }
Status Codes
Status Code |
Description |
---|---|
200 |
Response to the request for querying Workspace bandwidth control. |
default |
Default response. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot