调用CreateCen接口创建云企业网实例。
使用说明
CreateCen接口属于异步接口,即系统会先返回一个云企业网实例ID,但该云企业网实例并未创建完成,系统后台的创建任务仍在进行。您可以调用DescribeCens接口查询云企业网实例的状态。
- 当云企业网实例处于Creating状态时,表示云企业网实例正在创建中,在该状态下,您只能对云企业网实例执行查询操作,不能执行其他操作。
- 当云企业网实例处于Active状态时,表示云企业网实例创建完成。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | CreateCen |
系统规定参数。取值:CreateCen。 |
| ClientToken | String | 否 | 02fb3da4-130e-11e9-8e44-001**** |
客户端Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。 说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
|
| Name | String | 否 | testname |
云企业网实例的名称。 长度为2~128个字符,必须以大小写字母或中文开头,可包含数字、下划线(_)和短划线(-),但不能以 |
| Description | String | 否 | testdesc |
云企业网实例的描述信息。 长度为2~256个字符,必须以大小写字母或中文开头,但不能以 |
| ProtectionLevel | String | 否 | REDUCED |
设置网段重叠的级别。 取值:REDUCED(默认值),表示网段可以有重叠,但是不能完全相同。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| CenId | String | cen-dc4vwznpwbobrl**** |
云企业网实例的ID。 |
| RequestId | String | 0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50 |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=CreateCen
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&Name=testname
&Description=testdesc
&ProtectionLevel=REDUCED
&公共请求参数
正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateCenResponse>
<CenId>cen-dc4vwznpwbobrl****</CenId>
<RequestId>0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50</RequestId>
</CreateCenResponse>
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"CenId" : "cen-dc4vwznpwbobrl****",
"RequestId" : "0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50"
}
错误码
访问错误中心查看更多错误码。