Creates an office network of the convenience account type. Elastic Desktop Service supports the following types of accounts: convenience accounts and enterprise AD accounts.
Debugging
Authorization information
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| RegionId | string | Yes | The region ID. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
| CidrBlock | string | No | The IPv4 CIDR block that you want the office network to use in the virtual private cloud (VPC) of the office network. The system automatically creates a VPC for the office network based on the IPv4 CIDR block. We recommend that you set this parameter to one of the following CIDR blocks and their subnets:
| 172.16.0.0/12 |
| CenId | string | No | The Cloud Enterprise Network (CEN) instance ID. Note
If you want end users to connect to cloud computers from Alibaba Cloud Workspace clients over VPCs, you can attach the office network to a CEN instance. The CEN instance is the one that connects to your on-premises network over VPN Gateway or Express Connect.
| cen-3gwy16dojz1m65**** |
| CenOwnerId | long | No | The ID of the Alibaba Cloud account to which the Cloud Enterprise Network (CEN) instance belongs.
| 118272523431**** |
| VerifyCode | string | No | The verification code. If the CEN instance that you specify for the CenId parameter belongs to another Alibaba Cloud account, you must call the SendVerifyCode operation to obtain the verification code. | 123456 |
| Bandwidth | integer | No | The maximum public bandwidth. Value range: 10 to 200. Unit: Mbit/s. This parameter is available if you set | 10 |
| OfficeSiteName | string | No | The office network name. The name must be 2 to 255 characters in length. It can contain digits, colons (:), underscores (_), and hyphens (-). It must start with a letter and cannot start with | TestOfficeSite_Simple |
| EnableInternetAccess | boolean | No | Specifies whether to enable Internet access. Valid values:
| false |
| EnableAdminAccess | boolean | No | Specifies whether to grant the local administrator permissions to users that are authorized to use cloud computers in the office network. Valid values:
| true |
| DesktopAccessType | string | No | The method to connect to cloud computers from Alibaba Cloud Workspace clients. Note
The VPC connection depends on Alibaba Cloud PrivateLink. You can use PrivateLink for free. When you set this parameter to VPC or Any, PrivateLink is automatically activated.````
| Internet |
| NeedVerifyZeroDevice | boolean | No | Specifies whether to enable trusted device verification. | true |
| VSwitchId | array | No | The IDs of the vSwitches that you want to specify in VPCs. This parameter is required only when you create CloudBox-based office networks. | |
| string | No | The ID of the vSwitch that you want to specify in a VPC. This parameter is required only when you create a CloudBox-based office network. | vsw-bp12mw1f8k3jgy**** | |
| CloudBoxOfficeSite | boolean | No | Specifies whether to create a CloudBox-based office network. Valid values:
| false |
| VpcType | string | No | The network type of the office network. Valid values:
| standard |
Response parameters
Examples
Sample success responses
JSONformat
{
"OfficeSiteId": "cn-hangzhou+os-c5cy7q578s8jc****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}Error codes
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation |
|---|---|---|
| 2023-11-15 | The request parameters of the API has changed | View Change Details |
| 2021-10-28 | The request parameters of the API has changed | View Change Details |