Creates a workspace of the convenience account type.

Debugging

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

Request parameters

Parameter Type Required Example Description
Action String Yes CreateSimpleOfficeSite

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

CidrBlock String Yes 172.16.0.0/12

The IPv4 CIDR block in the secure office network corresponding to the workspace. The system creates a virtual private cloud (VPC) based on the specified IPv4 CIDR block. We recommend that you specify the IPv4 CIDR block as 10.0.0.0/12, 172.16.0.0/12, 192.168.0.0/16, or a subnet of these CIDR blocks. If you specify an IPv4 CIDR block of 10.0.0.0/12 or 172.16.0.0/12, the mask is 12 to 24 bits in length. If you specify an IPv4 CIDR block of 192.168.0.0/16, the mask is 16 to 24 bits in length.

RegionId String Yes cn-hangzhou

The ID of the region.

CenId String No cen-3gwy16dojz1m65****

The ID of the Cloud Enterprise Network (CEN) instance.

Note If you want to connect to your cloud desktops over VPCs, you can attach the network of the workspace to an CEN instance. The CEN instance is connected to the on-premises network by using VPN or leased lines.
EnableAdminAccess Boolean No true

Specifies whether to grant the permissions of the local administrator to the desktop users. Default value: true.

OfficeSiteName String No test

The name of the workspace. The name must be 2 to 255 characters in length. It must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), and hyphens (-).

This parameter is empty by default.

EnableInternetAccess Boolean No false

Specifies whether to enable Internet access.

Bandwidth Integer No 1

The maximum public bandwidth value. Valid values: 0 to 200.

You can specify this parameter when EnableInternetAccess is set to true. If this parameter is not specified or if it is set to 0, Internet access is disabled.

DesktopAccessType String No Internet

The method used to connect to cloud desktops. Valid values:

  • Internet: allows clients to connect to cloud desktops only over the Internet.
  • VPC: allows only clients in VPCs to connect to cloud desktops.
  • Any: allows both connections over the Internet and VPCs. You can select a connection method when you use a client to connect to a cloud desktop.

Default value: Internet.

Note The VPC connection method depends on Alibaba Cloud PrivateLink, which is free of charge. When this parameter is set to VPC or Any, PrivateLink is automatically activated.

Response parameters

Parameter Type Example Description
OfficeSiteId String cn-hangzhou+os-c5cy7q578s8jc****

The ID of the workspace.

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

The ID of the request.

Samples

Sample requests

https://ecd.cn-hangzhou.aliyuncs.com/?Action=CreateSimpleOfficeSite
&CidrBlock=172.16.0.0/12
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success response

XML format

<CreateSimpleOfficeSiteResponse>
      <OfficeSiteId>cn-hangzhou+os-c5cy7q578s8jc****</OfficeSiteId>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</CreateSimpleOfficeSiteResponse>

JSON format

{
    "OfficeSiteId": "cn-hangzhou+os-c5cy7q578s8jc****",
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}