CreateByoip

1. 接口描述

本接口(CreateByoip)用于提交自带 IP 段（BYOIP）创建 CIDR。返回 RPKI/IRR 校验失败列表。

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

参数名称	必选	类型	描述
byoipList	是	Array of ByoipCreateItem	待创建的 BYOIP 列表。
marketingInfo	否	MarketingInfo	市场营销相关选项。
resourceGroupId	否	String	创建后 BYOIP 所在的资源组ID。 如不指定则放入默认资源组。
tags	否	TagAssociation	创建 BYOIP 时关联的标签。 注意：关联「标签键」不能重复。

3. 响应结果

参数名称	类型	描述
requestId	String	唯一请求 ID。 每次请求都会返回。定位问题时需要提供该次请求的 requestId。
rpkiFailedList	Array of String	RPKI 校验失败的 BYOIP 列表。
irrFailedList	Array of String	IRR 校验失败的 BYOIP 列表。
byoipIds	Array of String	创建成功的 BYOIP ID 列表。

4. 代码示例

示例

1. 创建 BYOIP。

POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: CreateByoip
<Common Request Params>

Request：
{
  "byoipList": [
    {
      "cidrBlock": "88.0.2.0/24",
      "networkType": "PremiumBGP",
      "regionId": "asia-east-1",
      "asn": 62610
    }
  ]
}

Response：
{
  "requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
  "response": {
    "requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
    "rpkiFailedList": [],
    "irrFailedList": [],
    "byoipIds":["<byoipId1>"]
  }
}

5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的开发工具集（SDK），未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见公共错误码

HTTP状态码	错误码	说明
400	INVALID_BYOIP_ASN_INVALID	BYOIP ASN号非法。
400	INVALID_BYOIP_DUPLICATE	BYOIP 重复指定。
400	INVALID_BYOIP_ALREADY_DECLARED_BY_SELF	BYOIP 已在自己名下宣告，不支持重复宣告。
400	INVALID_BYOIP_OVERLAP_WITH_OTHERS	BYOIP 与其他 cid/team 已宣告的地址段重叠。
400	INVALID_CIDR_ADDRESS	IP地址不合法。
400	INVALID_CIDR_FORMAT	指定的cidr格式不正确。
400	INVALID_IPV6_CIDR_RANGE	CIDR地址段范围不合法。
400	INVALID_IPV6_SUBNET_MASK_LENGTH	IPv6子网掩码长度不符合范围。
404	INVALID_REGION_NOT_FOUND	区域不存在。
400	OPERATION_DENIED_EIP_UNSUPPORTED_NETWORK_TYPE	EIP网络计费方式不支持。
400	OPERATION_DENIED_NOT_SUPPORT_BYOIP_SELF	当前所选 BYOIP 网络类型在指定区域不支持自助宣告。