调用PreCreateEnsService创建边缘服务预览结果。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String PreCreateEnsService

系统规定参数,取值:PreCreateEnsService

BandwidthType String 95BandwidthByMonth

带宽计费方式。取值:

  • BandwidthByDay:日峰值带宽。
  • 95BandwidthByMonth:月95峰值带宽。
  • PayByBandwidth:固定规格带宽。
  • PayByBandwidth4thMonth:月第四峰值。
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格式,参数说明如下:

  • buyResourcesDetail:边缘服务资源明细。
  • netDistrictCode:地域。支持东北、华东、华北、华中、华南、西南、西北。
  • instanceInfo:实例信息。
  • carrier:运营商。支持cmcc(移动)、unicom(联通)、telecom(电信)。
  • instanceCount:实例数量。
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

网络层级。取值:

  • Big(默认值):大区。
  • Middle:省级。
  • Small:城市。
SchedulingStrategy String Disperse

节点调度分散度策略。取值:

  • Disperse(默认值):城市分散。
  • Concentrate:城市集中。
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

自定义数据,以#!开头。目前,最长支持256字符,最大支持16KB。传参内容仅支持自定义数据Script,不支持InstanceMetaData渲染。

您可传入自定义数据。数据以Base64的方式编码。调用API发起请求时,不会加密您设置的自定义数据,建议您不要以明文方式传入机密的信息,例如:密码和私钥等。如果需要传入密码和私钥等内容,请您对内容进行加密后,然后以Base64的方式编码后再传入。在实例内部以同样的方式反解密。

详情请参见数据格式

SchedulingPriceStrategy String PriceLowPriority

节点调度价格策略。取值:

  • PriceHighPriority(默认值):优先高价。
  • 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

网络层级。取值:

  • Big:大区。
  • Middle:省级。
  • 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. 没有足够的权限,请联系云账号管理员授予您相应权限。

访问错误中心查看更多错误码。