帮助与文档

搜索
  • 云服务器
  • 弹性IP
  • VPC
  • CDN
  • IAM

文档中心

云物理主机(EPC)

金山云 > 文档中心 > 云物理主机(EPC) > API文档 > EPC相关接口

创建云物理主机

最近更新时间：2020-06-08 10:38:45

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

  • 云物理主机名称，默认为epc
  • 类型： String
  • 是否必填：否
  • 缺省值：ksc_epc
  • 格式：2-128个字符，支持中英文数字特殊符号

ChargeType

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

PurchaseTime

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

Sn

  • 指定SN开机时传入的机器SN号
  • 类型：Integer
  • 是否必填：否

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>

金山云，开启您的云计算之旅

免费注册