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.

RegionId String Yes cn-hangzhou

The ID of the region.

CidrBlock String Yes 172.16.0.0/12

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

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 a VPC, you can attach the network of the workspace to the CEN instance. The CEN instance is connected to the on-premises network over VPN Gateway or Express Connect.
CenOwnerId Long No 1234567890123456

The ID of the Alibaba Cloud account to which the CEN instance belongs.

  • If you do not specify the CenId parameter, or the CEN instance that is specified by the CenId parameter belongs to the current Alibaba Cloud account, skip this parameter.
  • If you specify the CenId parameter and the CEN instance that is specified by the CenId parameter belongs to another Alibaba Cloud account, enter the ID of the exact Alibaba Cloud account.
VerifyCode String No 123456

The verification code. If the CEN instance that is specified by the CenId parameter belongs to another Alibaba Cloud account, you must call SendVerifyCode to obtain the verification code.

Bandwidth Integer No 1

The peak value of the public bandwidth. Valid values: 0 to 200.

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

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 (-).

Default value: null.

EnableInternetAccess Boolean No false

Specifies whether to enable the Internet access feature.

EnableAdminAccess Boolean No true

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

DesktopAccessType String No Internet

The method that you use to connect clients to cloud desktops. Valid values:

  • Internet: connects clients to cloud desktops only over the Internet.
  • VPC: connects clients to cloud desktops only over a VPC.
  • Any: connects clients to cloud desktops over the Internet or a VPC. You can select a connection method when you connect clients to cloud desktops.

Default value: Internet.

Note The VPC connection method is provided by Alibaba Cloud PrivateLink. You are not charged for PrivateLink. If you set this parameter 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.

Examples

Sample requests

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

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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