CreateEpc（ 创建裸金属服务器）

Request Parameters(请求参数)

AvailabilityZone

• 可用区的名称
• 类型:String
• 是否可缺省: 否

HostType

• 裸金属服务器机型
• 有效值:
  • 计算型
    • CAL：标准计算型
    • CAL-III：标准计算III型
    • CAL-IV：标准计算IV型
    • CAL-V：标准计算V型
    • MI-I1：标准计算II型
    • MI-R1：标准计算III型
    • DB：标准存储型
    • DB-I：存储I型
    • DB-II：标准存储II型
    • DB-III：标准存储III型
    • DB-IV：标准存储IV型
    • DB-VI：标准存储VI型
    • DB-VII：标准存储VII型
    • DB-III-I：标准存储III型-I
    • SSD：计算优化型
    • SSD-III：计算效能型
    • SSD-VI：计算效能II型
    • MI-I2：存储优化型
    • SSD-III-II：计算效能型-II
    • DB-V：标准存储V型
    • MEM-I：内存I型
    • DB-VIII：标准存储VIII型
    • EIO-I：极致IO型
    • EC-I：高性能计算型
    • EIO-III：极致IO型-III
    • EIOS：极致IO存储型
    • SSDS-II：存储优化II型
    • SSDS-III：存储优化III型
  • GPU型
    • GPU-I：GPU I型
    • P3E：GPU裸金属服务器实例标准型
    • P3E-R：GPU裸金属服务器实例标准集群型
    • P3X：GPU裸金属服务器实例效能型
    • P3X-R：GPU裸金属服务器实例效能集群型
    • P3S：GPU裸金属服务器实例性能型
    • P3IE：GPU裸金属服务器实例推理型
    • P4E.56F8：标准计算型
    • P4X.56D8：效能计算型
    • GN6-I：推理II型-I
    • GN6-II：推理II型-II
    • GN6-III：推理II型-III
    • GN3-II：推理I型-II
    • GN3-III：推理I型-III
    • GND5：效能V型
    • CMLU1：寒武纪I型
• 类型： String
• 是否必填：是

Raid

• 数据盘Raid级别，和数据盘的数量直接相关，服务器中有NVME SSD不支持RAID，传RAID1
• 有效值：
  • Raid1：数据盘数量必须是2的倍数
  • Raid5：数据盘的数量必须大于3
  • Raid10：数据盘数量必须是4的倍数
  • Raid50：数据盘的数量必须大于6且是2的倍数
  • SRaid0：仅针对大数据业务自身有冗余的场景
• 类型： String
• 是否必填：是

ImageId

• 镜像资源ID，参见GetEpcImage
• 类型： String
• 是否必填：是

NetworkInterfaceMode

• 网卡模式
• 类型： String
• 有效值：
  • bond4：BOND模式
  • single ：非BOND模式
  • dual：双网卡模式
• 是否必填：是

SubnetId

• 裸金属服务器的子网ID
• 类型： String
• 是否必填：是

PrivateIpAddress

• 服务器的网卡在VPC中的IP
• 类型:String
• 是否必填：否
• 缺省值：DHCP自动分配

SecurityGroupId.N

• 裸金属服务器关联的安全组ID，一个裸金属服务器最多可以支持3个安全组
• 类型： String
• 是否必填：是

DNS1

• DNS 1的值，当通过该接口进行修改网络配置时不填写此参数，保持与之前不变。
• 类型： String
• 是否必填：否

DNS2

• DNS 2的值，当通过该接口进行修改网络配置时不填写此参数，保持与之前不变。
• 类型： String
• 是否必填：否

KeyId

• 用户密钥对的资源ID
• 类型： String
• 是否必填：是
• 格式：固定长度36字符串

HostName

• 裸金属服务器名称
• 类型： String
• 是否必填：否
• 缺省值：ksc_epc
• 格式：2-128个字符，支持中英文数字特殊符号

ChargeType

• 主机计费类型，包年包月Monthly，按日月结Daily
• 有效值：Monthly | Daily
• 类型： String
• 是否必填：是

PurchaseTime

• 购买时长,只有包年包月计费方式需要填写，可取值1到36，单位为月
• 类型：Integer
• 可取值：1-36
• 是否必填：否

Password

• 系统的登录密码
• 类型：String
• 是否必填：是

SecurityAgent

• 安全组件类型
• 类型：String
• 可取值：
  • classic：经典版
  • no：不开启
• 是否必填：否
• 缺省值：no

CloudMonitorAgent

• 监控组件类型
• 类型：String
• 可取值：
  • classic：经典版
  • no：不开启
• 是否必填：否
• 缺省值：no

ExtensionSubnetId

• 从网卡的子网ID ，NetworkInterfaceMode为dual时必填
• 类型： String
• 是否必填：否

ExtensionPrivateIpAddress

• 从网卡在VPC中的IP，NetworkInterfaceMode为dual时必填
• 类型:String
• 是否必填：否
• 缺省值：DHCP自动分配

ExtensionSecurityGroupId.N

• 裸金属服务器关联的安全组ID，一个裸金属服务器最多可以支持3个安全组，NetworkInterfaceMode为dual时必填
• 类型： String
• 是否必填：否

ExtensionDNS1

• DNS 1的值，当通过该接口进行修改网络配置时不填写此参数，保持与之前不变。
• 类型： String
• 是否必填：否

ExtensionDNS2

• DNS 2的值，当通过该接口进行修改网络配置时不填写此参数，保持与之前不变。
• 类型： String
• 是否必填：否

SystemFileType

• 系统盘文件格式
• 类型: String
• 有效值：
  • EXT4
  • XFS
• 是否可缺省: 是
• 缺省值: EXT4

DataFileType

• 数据盘文件格式
• 类型: String
• 有效值：
  • EXT4
  • XFS
• 是否可缺省: 是
• 缺省值: XFS

DataDiskCatalogue

• 数据盘目录
• 类型: String
• 有效值：
  • /DATA/disk：在系统的DATA目录下，系统里展示内容如/DATA/disk1，/DATA/disk2
  • /data：在系统的根目录下，系统里展示内容如/data1，/data2
• 是否可缺省: 是
• 缺省值: /DATA/disk

DataDiskCatalogueSuffix

• 数据盘目录后缀属性
• 类型: String
• 有效值：
  • NoSuffix ：不使用后缀，只有在数据盘有一块的时候，可以使用此参数
  • NaturalNumber：后缀从1递增的整数
  • NaturalNumberFromZero：后缀从0递增的整数
• 是否可缺省: 是
• 缺省值: NaturalNumber

AddressBandWidth

• 弹性IP的带宽
• 类型: Integer
• 是否可缺省: 是

LineId

• 弹性IP的链路类型的ID
• 类型: String
• 是否可缺省: 是，购买弹性IP时不可缺省

AddressChargeType

• 弹性IP的计费类型
• 类型: String
• 有效值:
  • PrePaidByMonth ：包年包月，有到期时间，只能升带宽
  • PostPaidByPeak：按峰值月结，无到期时间，可升降带宽
  • PostPaidByDay：按日月结，无到期时间，可升降带宽
  • PostPaidByTransfer：按流量月结，无到期时间，可升降带宽
  • PostPaidByHour：按小时月结，无到期时间，可升降带宽
• 是否可缺省: 是，购买弹性IP时不可缺省

AddressPurchaseTime

• 购买时长，只有购买包年包月弹性IP时不可缺省。
• 类型: Integer
• 是否可缺省: 是

AddressProjectId

• 弹性IP项目的ID
• 类型: String
• 是否可缺省: 是
• 缺省值: 默认项目

ContainerAgent

• 容器引擎组件类型
• 类型：String
• 有效值：
  • supported
  • unsupported
• 是否必填：否
• 缺省值：unsupported

Response Elements(返回值)

RequestId

• 请求ID
• 类型： String

Host

• 裸金属服务器的信息
• 类型：Host

Examples（举例）

Sample Request(请求)

http://epc.region.api.ksyun.com/?Version=2015-11-01&Action=CreateEpc
&AvailabilityZone=region
&HostType=CAL
&Raid=Raid1
&ImageId=prt13eddaa9-5c35-4734-b177-b83f39fe450c
&NetworkInterfaceMode=bond4
&SubnetId=32caccdd-9d43-42ca-9df2-c92c48f13b40
&ChargeType=Daily
&Password=ABCabc123
&KeyId=9348505e-4320-47d0-86a1-403bccdf7965
&SecurityGroupId.1=3c9ab8f2-9b55-4ceb-af13-d72128481cfb

Sample Response（返回）

<CreateEpcResponse>
    <RequestId>2253ff4f-083e-48d2-aefd-660e43b1507b</RequestId>
    <Host>
        <CreateTime>2017-10-30 17:29:33</CreateTime>
        <HostName>ksc_epc</HostName>
        <HostId>c5b67560-0190-44bc-987f-f640d3cc0cf8</HostId>
        <Sn>216388577</Sn>
        <Raid>Raid10</Raid>
        <ImageId>prt825b6d6a-c50e-4f56-b002-8cea26b41a43</ImageId>
        <KeyId>8a8db606-7814-40a4-b28e-81465aa73c63</KeyId>
        <ProductType>1</ProductType>
        <OsName>jinxu-image</OsName>
        <Memory>128G</Memory>
        <Cpu>
            <Model>Intel_E5_2620V4 * 2</Model>
            <Frequence>2.5GHZ</Frequence>
            <Count>2</Count>
            <CoreCount>32</CoreCount>
        </Cpu>
        <DiskSet>
            <item>
                <DiskType>System</DiskType>
                <Raid>Raid1</Raid>
                <Space>300GB</Space>
            </item>
            <item>
                <DiskType>Data</DiskType>
                <Raid>Raid10</Raid>
                <Space>4TB</Space>
            </item>
        </DiskSet>
        <NetworkInterfaceAttributeSet>
            <item>
                <VpcId>fa1a0025-3d70-4105-b53f-a0db25449303</VpcId>
                <NetworkInterfaceId>c5b67560-0190-44bc-987f-f640d3cc0cf8</NetworkInterfaceId>
                <SubnetId>32caccdd-9d43-42ca-9df2-c92c48f13b40</SubnetId>
                <PrivateIpAddress>10.0.24.59</PrivateIpAddress>
                <DNS1>198.18.224.10</DNS1>
                <DNS2>198.18.224.11</DNS2>
                <Mac>6c:92:bf:26:bc:c2</Mac>
                <SecurityGroupSet>
                    <item>
                        <SecurityGroupId>3c9ab8f2-9b55-4ceb-af13-d72128481cfb</SecurityGroupId>
                    </item>
                </SecurityGroupSet>
                <NetworkInterfaceType>primary</NetworkInterfaceType>
            </item>
        </NetworkInterfaceAttributeSet>
        <AvailabilityZone>cn-shanghai-3a</AvailabilityZone>
        <CloudMonitorAgent>no</CloudMonitorAgent>
        <HostStatus>Running</HostStatus>
        <HostType>CAL</HostType>
        <NetworkInterfaceMode>bond4</NetworkInterfaceMode>
        <SecurityAgent>no</SecurityAgent>
        <EnableBond>true</EnableBond>
    </Host>
</CreateEpcResponse>