创建裸金属服务器

CreateEpc（ 创建裸金属服务器）

Request Parameters(请求参数)

AvailabilityZone

• 可用区的名称

• 类型:String

• 是否可缺省: 否

HostType

• 裸金属服务器机型

• 有效值:

  • 计算型

    • CAL：标准计算型

    • CAL-III：标准计算III型

    • CAL-IV：标准计算IV型

    • CAL-V：标准计算V型

    • MI-I1：标准计算II型

    • DB：标准存储型

    • DB-I：存储I型

    • DB-II：标准存储II型

    • DB-III：标准存储III型

    • DB-III-I：标准存储III型-I

    • DB-IV：标准存储IV型

    • DB-V：标准存储V型

    • DB-VI：标准存储VI型

    • DB-VII：标准存储VII型

    • DB-VIII：标准存储VIII型

    • SSD：计算优化型

    • SSD-III：计算效能型

    • SSD-III-II：计算效能型-II

    • SSD-VI：计算效能II型

    • MI-I2：存储优化型

    • MEM-I：内存I型

    • EC-I：高性能计算型

    • SSDS-II：存储优化II型

    • SSDS-III：存储优化III型

    • SSDS-V：存储优化V型

    • EC-I-V-III：高性能计算型-V-III

    • EC-I-V-V：高性能计算型-V-V

    • EC-I-V-VI：高性能计算型-V-VI

  • 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级别，和磁盘的数量直接相关。

• 有效值：

  • Raid1：磁盘数量必须是2的倍数

  • Raid5：磁盘的数量必须大于3

  • Raid10：磁盘数量必须是4的倍数

  • Raid50：磁盘的数量必须大于6且是2的倍数

  • SRaid0：仅针对大数据业务自身有冗余的场景

• 类型： String

• 是否必填：是

ImageId

• 镜像资源ID，参见GetEpcImage

• 类型： String

• 是否必填：是

NetworkInterfaceMode

• 网卡模式

• 类型： String

• 有效值：

  • bond4：BOND模式（bond0、bond1仅为不同名称，实际均为mode=4）

  • single ：非BOND模式（网卡仅支持一个网口）

  • dual：双网卡模式（可加入两个vpc）

• 是否必填：是

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

ComputerName

• 裸金属服务器系统内名称

• 类型：String

• 是否必填：否

• 缺省值：系统默认

• 格式：

  • Windows：2-15个字符，支持中文字母数字特殊符号

  • Linux：2-64个字符，支持字母数字特殊符号

ProjectId

• 项目的ID，6位数字，若指定分配请填写已存在的项目ID。

• 类型：String

• 是否可缺省：是

• 缺省值：默认项目

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>