调用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. 没有足够的权限，请联系云账号管理员授予您相应权限。

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