调用PreCreateEnsService创建边缘服务预览结果。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | PreCreateEnsService |
系统规定参数,取值:PreCreateEnsService。 |
BandwidthType | String | 是 | 95BandwidthByMonth |
带宽计费方式。取值:
|
BuyResourcesDetail | String | 是 | {"buyResourcesDetail":[{"netDistrictCode":"华北","instanceInfo":[{"carrier":"cmcc","instanceCount":2},{"carrier":"telecom","instanceCount":4},{"carrier":"multiCarrier","instanceCount":3}]},{"netDistrictCode":"华南","instanceInfo":[{"carrier":"cmcc","instanceCount":2},{"carrier":"telecom","instanceCount":4}]}]} |
需求明细。内容为JSON格式,参数说明如下:
|
EnsServiceName | String | 是 | testName |
边缘服务名称,仅支持填写一个。 |
ImageId | String | 是 | centos_6_09_64_20G_alibase_**** |
镜像ID,仅支持传单个ID。 支持自定义镜像和公共镜像。 |
InstanceBandwithdLimit | String | 是 | 40 |
单实例公网带宽限制,单位:Mbps。 |
InstanceSpec | String | 是 | ens.sn1.stiny |
实例规格。 实例规格详情请参见使用限制。 |
NetLevel | String | 是 | Big |
网络层级。取值:
|
SchedulingStrategy | String | 是 | Disperse |
节点调度分散度策略。取值:
|
SystemDiskSize | String | 是 | 100 |
系统盘大小,单位:GB。取值:10的倍数,最小为20。 |
Version | String | 是 | 2017-11-10 |
版本号。取值:2017-11-10。 |
DataDiskSize | String | 否 | 100 |
数据盘大小,单位:GB。取值:10的倍数,最小为20。 |
Password | String | 否 | testPassword |
实例登录密码。 8~30个字符,至少包含大写字母、小写字母、数字和特殊字符中的3种。不包括以下字符:
|
KeyPairName | String | 否 | TestKeyPairName |
密钥对名称。仅支持传单个名称。 |
UserData | String | 否 | #!/bin/sh echo "Hello World. The time is now $(date -R)!" | tee /root/output.txt |
自定义数据,以 您可传入自定义数据。数据以Base64的方式编码。调用API发起请求时,不会加密您设置的自定义数据,建议您不要以明文方式传入机密的信息,例如:密码和私钥等。如果需要传入密码和私钥等内容,请您对内容进行加密后,然后以Base64的方式编码后再传入。在实例内部以同样的方式反解密。 详情请参见数据格式。 |
SchedulingPriceStrategy | String | 否 | PriceLowPriority |
节点调度价格策略。取值:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
BuyResourcesDetail | String | [ { "NetDistrictCode":"610100", "InstanceInfo":[ { "InstanceCount":1, "Carrier":"cmcc" }, { "InstanceCount":1, "Carrier":"unicom" }, { "InstanceCount":1, "Carrier":"multiCarrier" } ], "EnsRegionIds":[ { "EnsRegionId":"cn-xian-unicom", "EnsRegionName":"西安联通" }, { "EnsRegionId":"cn-xian-cmcc", "EnsRegionName":"西安移动" }, { "EnsRegionId":"cn-xian-telcom_unicom_cmcc", "EnsRegionName":"西安电信联通移动" } ] } ] |
资源明细。 |
Code | Integer | 0 |
业务码,成功返回0。 |
EnsServiceId | String | ens-20190806**** |
服务ID。 |
NetLevel | String | Small |
网络层级。取值:
|
RequestId | String | 9AF02B43-2D08-49D3-8AAF-65B9C792ED14 |
请求ID。 |
示例
请求示例
https://ens.aliyuncs.com/?Action=PreCreateEnsService
&BandwidthType=95BandwidthByMonth
&BuyResourcesDetail={"buyResourcesDetail":[{"netDistrictCode":"华北","instanceInfo":[{"carrier":"cmcc","instanceCount":2},{"carrier":"telecom","instanceCount":4},{"carrier":"multiCarrier","instanceCount":3}]},{"netDistrictCode":"华南","instanceInfo":[{"carrier":"cmcc","instanceCount":2},{"carrier":"telecom","instanceCount":4}]}]}
&EnsServiceName=testName
&ImageId=centos_xxxx
&InstanceBandwithdLimit=40
&InstanceSpec=ens.sn1.stiny
&NetLevel=Big
&Password=testPassword
&SchedulingStrategy=Disperse
&SystemDiskSize=100
&SchedulingPriceStrategy=PriceLowPriority
&<公共请求参数>
正常返回示例
XML
格式
<PreCreateEnsServiceResponse>
<EnsServiceId>ens-20190806****</EnsServiceId>
<RequestId>9AF02B43-2D08-49D3-8AAF-65B9C792ED14</RequestId>
<BuyResourcesDetail>
<NetDistrictCode>610100</NetDistrictCode>
<InstanceInfo>
<InstanceCount>1</InstanceCount>
<Carrier>cmcc</Carrier>
</InstanceInfo>
<InstanceInfo>
<InstanceCount>1</InstanceCount>
<Carrier>unicom</Carrier>
</InstanceInfo>
<InstanceInfo>
<InstanceCount>1</InstanceCount>
<Carrier>multiCarrier</Carrier>
</InstanceInfo>
<EnsRegionIds>
<EnsRegionId>cn-xian-unicom</EnsRegionId>
<EnsRegionName>西安联通</EnsRegionName>
</EnsRegionIds>
<EnsRegionIds>
<EnsRegionId>cn-xian-cmcc</EnsRegionId>
<EnsRegionName>西安移动</EnsRegionName>
</EnsRegionIds>
<EnsRegionIds>
<EnsRegionId>cn-xian-telcom_unicom_cmcc</EnsRegionId>
<EnsRegionName>西安电信联通移动</EnsRegionName>
</EnsRegionIds>
</BuyResourcesDetail>
<NetLevel>Small</NetLevel>
<Code>0</Code>
</PreCreateEnsServiceResponse>
JSON
格式
{
"EnsServiceId":"ens-20190806****",
"RequestId":"9AF02B43-2D08-49D3-8AAF-65B9C792ED14",
"BuyResourcesDetail":[
{
"NetDistrictCode":"610100",
"InstanceInfo":[
{
"InstanceCount":1,
"Carrier":"cmcc"
},
{
"InstanceCount":1,
"Carrier":"unicom"
},
{
"InstanceCount":1,
"Carrier":"multiCarrier"
}
],
"EnsRegionIds":[
{
"EnsRegionId":"cn-xian-unicom",
"EnsRegionName":"西安联通"
},
{
"EnsRegionId":"cn-xian-cmcc",
"EnsRegionName":"西安移动"
},
{
"EnsRegionId":"cn-xian-telcom_unicom_cmcc",
"EnsRegionName":"西安电信联通移动"
}
]
}
],
"NetLevel":"Small",
"Code":0
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | NoPermission | Permission denied. | 没有足够的权限,请联系云账号管理员授予您相应权限。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交