华为云用户手册

响应示例 状态码： 200 正常 { "bind_list" : [ { "id" : "8ac225c2781edb0d01781edde3f4xxxx", "mac" : "AA-BB-CC-DD-EE-FF", "desktop_name" : "test01", "description" : "test" } ], "total_num" : 1 }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 bind_list Array of TerminalsBindingDesktopsInfo objects MAC绑定VM信息列表 total_num Integer 返回结果总条数 表5 TerminalsBindingDesktopsInfo 参数 参数类型 描述 id String MAC绑定策略ID mac String 终端MAC地址 desktop_name String 虚拟机名称 description String 描述 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 404 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。

URI GET /v2/{project_id}/terminals/binding-desktops 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 computer_name 否 String 桌面名。 mac 否 String mac地址。 offset 是 Integer 起始数。 limit 是 Integer 数量。 count_only 否 Boolean 是否只查询结果总条数

响应示例 状态码： 200 正常。 { "otp_devices" : [ { "id" : "5311a768c22f4d30914fe50ffdfd1ba5", "user_id" : "8a2c3f9579d240820179d51e6caf0001", "user_name" : "zhangsan", "status" : "UNREGISTER", "create_time" : "2020-04-10 06:45:14" } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 otp_devices Array of OtpDevice objects otp设备。 表4 OtpDevice 参数 参数类型 描述 id String 用户otp 信息id。 user_id String 用户id。 user_name String 用户名。 status String 用户otp设备状态 UNREGISTER: 未绑定 REGISTERED：已绑定 create_time String 用户otp设备绑定时间。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 405 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 503 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 否 String 发送的实体的MIME类型。 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 desktop_volumes 否 Array of AddDesktopVolumesReq objects 新增磁盘参数。 表4 AddDesktopVolumesReq 参数 是否必选 参数类型 描述 desktop_id 否 String 桌面Id。 volumes 否 Array of Volume objects 待新增的磁盘信息，每个桌面的数据盘数量不超过10个。 表5 Volume 参数 是否必选 参数类型 描述 type 是 String 桌面数据盘对应的磁盘类型，需要与系统所提供的磁盘类型相匹配。 -SAS：高IO。 -SSD：超高IO。 size 是 Integer 磁盘容量，单位GB。系统盘大小范围[80-32760]，数据盘范围[10-32760]，大小为10的倍数。

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 job_id String 增加磁盘任务ID 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 401 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 403 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 404 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 409 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 500 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。

响应参数 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 404 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求示例 PUT /v2/fb2e5ec048384c8f9469d22db0037908/assist-auth-config/method-config { "auth_type" : "OTP", "otp_config_info" : { "enable" : true, "receive_mode" : "VMFA", "apply_rule" : { "rule_type" : "AC CES S_MODE", "rule" : "INTERNET" } } } PUT /v2/fb2e5ec048384c8f9469d22db0037908/assist-auth-config/method-config { "auth_type" : "OTP", "otp_config_info" : { "enable" : true, "receive_mode" : "HMFA", "auth_url" : "https://10.0.0.128:8443/api/um/login", "app_id" : 123, "app_secret" : 123, "auth_server_access_mode" : "DEDICATED", "cert_content" : "cert_content", "apply_rule" : { "rule_type" : "ACCESS_MODE", "rule" : "INTERNET" } } }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Content-Type 是 String 发送的实体的MIME类型 表3 请求Body参数 参数 是否必选 参数类型 描述 auth_type 否 String 认证类型。 OTP：OTP辅助认证 otp_config_info 否 OtpConfigInfo object OTP辅助认证方式配置 表4 OtpConfigInfo 参数 是否必选 参数类型 描述 enable 否 Boolean 是否启用 receive_mode 否 String 验证码接收模式 VMFA：虚拟MFA设备 HMFA：硬件MFA设备 auth_url 否 String 辅助认证服务器地址 app_id 否 String 认证服务接入账号 app_secret 否 String 认证服务接入密码 auth_server_access_mode 否 String 辅助认证服务接入模式 INTERNET：互联网接入 DEDICATED：专线接入 SYSTEM_DEFAULT：系统默认 cert_content 否 String pem格式证书内容 apply_rule 否 ApplyRuleInfo object 认证应用对象信息，为null时代表对所有应用对象生效。 表5 ApplyRuleInfo 参数 是否必选 参数类型 描述 rule_type 否 String 认证应用对象类型。 ACCESS_MODE：接入类型 rule 否 String 认证应用对象。 INTERNET：互联网接入，rule_type为ACCESS_MODE时可选该值 PRIVATE：专线接入，rule_type为ACCESS_MODE时可选该值

响应参数 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 405 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 503 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Content-Type 是 String 发送的实体的MIME类型，如：application/json。 表3 请求Body参数 参数 是否必选 参数类型 描述 users 是 Array of CreateUserRequest objects 创建单个用户请求。 表4 CreateUserRequest 参数 是否必选 参数类型 描述 user_name 是 String 用户名称。 user_email 否 String 用户邮箱。 account_expires 否 String 账户过期时间，0表示永远不过期。时间格式：yyyy-MM-ddTHH:mm:ssZ或yyyy-MM-ddTHH:mm:ss.SSSZ。 active_type 否 String 激活类型，默认为用户激活。 USER_ACTIVATE： 用户激活 ADMIN_ACTIVATE： 管理员激活 user_phone 否 String 用户手机号。 password 否 String 用户初始密码。管理员激活模式需要输入。 enable_change_password 否 Boolean 是否允许用户更改密码，缺省值为true，后续此字段无效，创建时都为true。 next_login_change_password 否 Boolean 下次登录是否必须更改密码，缺省值为true。后续此字段无效，创建时都为true。 group_ids 否 Array of strings 用户组的专有ID列表。 description 否 String 用户描述，字符串长度区间[0, 255]。 alias_name 否 String 别名。

响应参数 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 404 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 405 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 503 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Content-Type 是 String 发送的实体的MIME类型，如：application/json。 表3 请求Body参数 参数 是否必选 参数类型 描述 group_ids 是 Array of strings 用户组ID列表。

响应参数 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 404 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 否 String 发送的实体的MIME类型。 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 tc_bind_switch 是 String 绑定开关,只取值on或off

请求示例 PUT /v2/fb2e5ec048384c8f9469d22db0037908/workspaces { "access_mode" : "BOTH" } { "ad_domains" : { "domain_type" : "LOCAL_AD", "domain_admin_account" : "vdsadmin", "active_domain_ip" : "192.161.43.66", "standby_domain_ip" : "192.161.43.67", "domain_name" : "vdesktop.huawei.com", "domain_password" : "xxxxxxxxxx@", "active_domain_name" : "AD-xxx-0001.vdesktop.huawei.com", "active_dns_ip" : "192.161.43.66", "standby_domain_name" : "AD-xxx-0002.vdesktop.huawei.com", "standby_dns_ip" : "192.161.43.67", "use_ldaps" : true, "tls_config" : { "cert_pem" : "-----BEGIN CERTIFICATE-----\\nMIIDiTCCAnGgAwIBAgIQQdj2u+x1LJ9Dc34un\\n-----END CERTIFICATE" } } } { "access_mode" : "DEDICATED", "dedicated_subnets" : "192.168.0.0/24;10.0.0.0/16" } { "is_send_email" : false }

响应参数 状态码： 200 表8 响应Body参数 参数 参数类型 描述 job_id String 修改云办公服务属性的任务ID enterprise_id String 企业ID dc_vnc_ip String 专线vnc访问的ip 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 401 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 403 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 404 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码： 500 表13 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Content-Type 是 String 发送的实体的MIME类型。 表3 请求Body参数 参数 是否必选 参数类型 描述 ad_info 否 AdDomainInfo object 域信息。 ad_domains 否 AdDomain object 域信息。 access_mode 否 String 接入模式。 INTERNET：互联网接入。 DEDICATED：专线接入。 BOTH：代表两种接入方式都支持。 dedicated_subnets 否 String 专线接入网段列表，多个网段信息用分号隔开，列表长度不超过5。 subnet_ids 否 Array of strings 子网的网络ID列表。 internet_access_port 否 String 互联网接入端口。 enterprise_id 否 String 企业ID。 is_send_email 否 Boolean 桌面退订是否发送邮件通知。 dc_vnc_ip 否 String 开通专线访问VNC功能，如果传入的是default则自动创建，如果传入的自定义的dc_vnc_ip则直接使用，如果传入的是close表示关闭自定义VNC authorized_collect_log 否 Boolean 是否授权收集日志。 authorized_hda_upgrade 否 Boolean 是否授权hda升级。 apply_dedicated_standby_network_param 否 ApplyDedicatedStandbyNetworkParam object 开通专线备用线路入参 表4 AdDomainInfo 参数 是否必选 参数类型 描述 domain_type 是 String 域类型。 LITE_AS：LiteAS。 LOCAL_AD：本地AD。 说明：域类型为“LOCAL_AD”时，请确保所选VPC网络与“LOCAL_AD”所属网络可连通。 domain_admin_account 是 String 域管理员帐号。 domain_password 是 String 域管理员账号密码。 表5 AdDomain 参数 是否必选 参数类型 描述 domain_type 是 String 域类型。 LITE_AS：本地认证。 LOCAL_AD：本地AD。 说明：域类型为“LOCAL_AD”时，请确保所选VPC网络与AD所属网络可连通。 domain_name 否 String 域名 称。域类型为LOCAL_AD时需要配置。 域名必须为AD服务器上已经存在的域名，且长度不超过55。 domain_admin_account 否 String 域管理员帐号。域类型为LOCAL_AD时需要配置。 必须为AD服务器上已经存在的域管理员帐号。 domain_password 否 String 域管理员账号密码。域类型为LOCAL_AD时需要配置。 active_domain_ip 否 String 主域控制器IP地址。域类型为LOCAL_AD时需要配置。 active_domain_name 否 String 主域控制器名称。域类型为LOCAL_AD时需要配置。 standby_domain_ip 否 String 备域控制器IP地址。域类型为LOCAL_AD时且配置备节点时需要配置。 standby_domain_name 否 String 备域控制器名称。域类型为LOCAL_AD时且配置备节点时需要配置。 active_dns_ip 否 String 主DNS IP地址。域类型为LOCAL_AD时需要配置。 standby_dns_ip 否 String 备DNS IP地址。域类型为LOCAL_AD时且配置备节点时需要配置。 delete_computer_object 否 Integer 是否在删除桌面的同时删除AD上对应的计算机对象，0代表不删除，1代表删除。 use_ldaps 否 Boolean 是否开启LDAPS。 tls_config 否 TlsConfig object TLS信息。 表6 TlsConfig 参数 是否必选 参数类型 描述 cert_pem 否 String pem内容, 有则更新，无则上传。查询不返回。 cert_start_time 否 String 证书生效开始时间，时间参考样例 2022-01-25T09:24:27。 cert_end_time 否 String 证书生效截止时间，时间参考样例 2022-01-25T09:24:27。 表7 ApplyDedicatedStandbyNetworkParam 参数 是否必选 参数类型 描述 address 否 String 租户指定的专线备用地址 port 否 Integer 租户指定的专线备用地址端口 availability_zone 否 Array of strings 开通服务资源使用的可用分区，默认随机使用2个可用区

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Content-Type 是 String 发送的实体的MIME类型，如：application/json。 表3 请求Body参数 参数 是否必选 参数类型 描述 description 否 String 用户描述。 user_email 否 String 用户邮箱。 user_phone 否 String 手机号。 active_type 否 String 激活类型，默认为用户激活。 USER_ACTIVATE： 用户激活 ADMIN_ACTIVATE： 管理员激活 account_expires 否 String 账户过期时间，0表示永远不过期。 enable_change_password 否 Boolean 是否允许修改密码，true表示允许，false表示不允许。 next_login_change_password 否 Boolean 下次登录是否需要重置密码，true表示需要重置密码，false表示不需要。 password_never_expired 否 Boolean 密码是否永不过期，true表示密码永不过期，false表示密码会过期。 disabled 否 Boolean 账户是否禁用，true表示被禁用，false表示未禁用。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 id String 用户id。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 405 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 503 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

响应示例 状态码： 200 查询桌面用户详细信息响应。 { "user_detail" : { "description" : "api测试用户。", "id" : "8a2c3f9579d240820179d51e6caf0001", "user_name" : "api-test", "user_email" : "test@huawei.com", "object_sid" : "8a2c3f9579d240820179d51e6caf0001", "sam_account_name" : "api-test", "full_name" : "api-test", "distinguished_name" : "api-test", "account_type" : 0, "when_created" : "2021-06-03T19:43:31.000Z", "account_expires" : 0, "user_expired" : false, "locked" : false, "enabled_change_password" : true, "password_never_expired" : false, "next_login_change_password" : true, "disabled" : false, "group_names" : [ "DomainUsers" ], "total_desktops" : 0 } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 user_detail UserDetail object 用户详情。 表4 UserDetail 参数 参数类型 描述 description String 用户描述。 id String 用户id。 user_name String 桌面用户名。 user_email String 用户邮箱。 user_phone String 手机号。 active_type String 激活类型，默认为用户激活。 USER_ACTIVATE： 用户激活 ADMIN_ACTIVATE： 管理员激活 object_sid String 用户sid。 sam_account_name String 登录名(windows以前版本)。 user_principal_name String 用户登录名。 full_name String 全名。 distinguished_name String 用户在域树上的唯一位置。 account_type Integer 帐号类型(0：用户；1：用户组)。 when_created String UTC时间毫秒数对应的字符，格式为：yyyy-MM-ddTHH:mm:ss.SSSZ。 account_expires Long 账号有效期最后一天对应的UTC时间，以毫秒为单位。 is_pre_user Boolean 是否是预创建的用户，true表示是预创建用户，false表示不是预创建用户 user_expired Boolean 账户是否过期，true表示过期，false表示未过期。 locked Boolean 账户是否被锁定，true表示被锁定，false表示未锁定。 enabled_change_password Boolean 是否允许修改密码，true表示允许修改密码，false表示不允许。 password_never_expired Boolean 密码是否永不过期，true表示密码永不过期，false表示密码会过期。 next_login_change_password Boolean 下次登录是否需要重置密码，true表示需要重置密码，false表示不需要。 disabled Boolean 账户是否禁用，true表示被禁用，false表示未禁用。 group_names Array of strings 加入的组列表。 total_desktops Integer 用户绑定桌面云总数。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 405 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 503 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

URI GET /v2/{project_id}/connections/desktops/export 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 start_time 否 String 查询的起始时间。指定该参数后，返回的结果为此时间之后的所有登录记录。时间格式如：“2016-08-20T21:11Z”。终止时间不为空时，起始时间为必填参数。 end_time 否 String 查询的终止时间。指定该参数后，返回的结果为此时间之前的所有登录记录。时间格式如：“2016-08-20T21:11Z”。起始时间不为空时，终止时间为必填参数。 user_name 否 String 登录桌面的用户名。 computer_name 否 String 计算机名（操作系统信息中可见）。 terminal_type 否 String 登录桌面的终端系统类型。 language 否 String 导出语言，默认英文。 zh_CN：中文 en_US：英文

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 - File 导出用户登录信息文件。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 405 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 503 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Content-Type 是 String 发送的实体的MIME类型。 表3 请求Body参数 参数 是否必选 参数类型 描述 desktop_ids 否 Array of strings 待解绑EIP的桌面id。

响应示例 状态码： 200 查询用户组响应。 { "total_count" : 2, "user_groups" : [ { "id" : "99558194716db7d601719f9b61850042", "sid" : "99558194716db7d601719f9b61850042", "name" : "group1", "realm_id" : "695581943266db7a601719f9e61850058", "domian" : "local.com", "description" : "for test", "platform_type" : "LOCAL", "create_time" : "2023-02-15T02:27:05.000Z", "user_quantity" : 10 }, { "id" : "99558194716db7d601719f9b61850000", "sid" : "99558194716db7d601719f9b61850000", "name" : "group2", "realm_id" : "453381943266db7a601719f9e61850044", "domian" : "local.com", "description" : "for test2", "platform_type" : "LOCAL", "create_time" : "2023-01-16T02:27:05.000Z", "user_quantity" : 20 } ] }

URI GET /v2/{project_id}/groups 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 String 用于分页查询，返回用户组数量限制。如果不指定或为0，则使用默认值100，从1开始，最大100。 offset 否 String 用于分页查询，查询的起始记录序号，从0开始，默认值0，必须与limit同时使用。 keyword 否 String 用来匹配用户组的搜索关键字。例如根据组名模糊查询。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total_count Integer 满足条件的用户组总数。 user_groups Array of UserGroupInfo objects 用户组列表。 表5 UserGroupInfo 参数 参数类型 描述 name String 用户组名。 id String 用户组ID。 create_time String 用户组对应的创建时间，UTC时间：yyyy-MM-ddTHH:mm:ss.SSSZ。 description String 用户组描述。 user_quantity Integer 用户列表中用户数。 parent UserGroupInfo object 用户组上级用户组。 realm_id String 用户组域Id。 platform_type String 用户组类型。 AD： AD域用户组 LOCAL： 本地liteAs用户组 group_dn String 用户组专有名。 domain String 用户组域名。 sid String 用户组sid。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 404 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 405 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 503 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 job_id String 扩容磁盘任务ID。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 404 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 409 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码： 500 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。