> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/cn/zec/byo-asn/createbyoasn.md).

# CreateByoAsn

## 1. 接口描述

本接口(CreateByoAsn)用于提交自带ASN并获取用于归属校验的校验码。

{% hint style="info" %}
**注意事项**

* `asn` 支持2字节与4字节ASN，最大值 **4294967295**（2^32-1），超过该值的请求会被拒绝。具体哪些ASN号可接入（私有段、保留段等）由底层判定。
* 本接口只生成校验码，不代表ASN已可用。需要客户按响应中的`exportDeclaration`在管理该ASN的RIR（ARIN、RIPE NCC、APNIC等）上完成声明后，调用 [VerifyByoAsn](/api-reference/cn/zec/byo-asn/verifybyoasn.md) 确认归属，状态变为`AVAILABLE`才能用于创建BYOIP。
  {% endhint %}

## 2. 请求参数

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

| 参数名称            | 必选 | 类型                                                                      | 描述                                                                                |
| --------------- | -- | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| asn             | 是  | Integer                                                                 | <p>待接入的公网ASN号。</p><p>支持2字节与4字节ASN，最大值4294967295。</p><p>可选值范围：\[-, 4294967295]</p> |
| resourceGroupId | 否  | String                                                                  | <p>创建后BYO ASN所在的资源组ID。</p><p>如不指定则放入默认资源组。</p>                                    |
| tags            | 否  | [TagAssociation](/api-reference/cn/zec/datastructure.md#tagassociation) | <p>创建BYO ASN时关联的标签。</p><p>注意：关联「标签键」不能重复。</p>                                     |

## 3. 响应结果

| 参数名称              | 类型                                                                  | 描述                                                           |
| ----------------- | ------------------------------------------------------------------- | ------------------------------------------------------------ |
| requestId         | String                                                              | <p>唯一请求 ID。</p><p>每次请求都会返回。定位问题时需要提供该次请求的 requestId。</p>     |
| byoAsnId          | String                                                              | 新建BYO ASN的ID。                                                |
| asn               | Integer                                                             | ASN号。                                                        |
| status            | [ByoAsnStatus](/api-reference/cn/zec/datastructure.md#byoasnstatus) | 当前状态。                                                        |
| verifyCode        | String                                                              | <p>校验码。</p><p>需要客户将其写入RIR上该ASN的aut-num对象。</p>                |
| exportDeclaration | String                                                              | <p>完整的export声明语句。</p><p>客户直接复制该语句写入RIR上该ASN的aut-num对象即可。</p> |
| createTime        | String                                                              | 创建时间。                                                        |

## 4. 代码示例

{% tabs %}
{% tab title="示例" %}
**1. 提交自带ASN并获取校验码。**

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

Request：
{
  "asn": 12340
}

Response：
{
  "requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
  "response": {
    "requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
    "byoAsnId": "byoasn-3JK29DKS",
    "asn": 12340,
    "status": "VERIFYING",
    "verifyCode": "62610:831522",
    "exportDeclaration": "export: to AS62610 action community .= {62610:831522}; announce AS12340",
    "createTime": "2026-09-03T07:21:17Z"
  }
}
```

{% endtab %}
{% endtabs %}

## 5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的[开发工具集（SDK）](/api-reference/cn/api-introduction/toolkit.md)，未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

## 6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见[公共错误码](/api-reference/cn/api-introduction/instruction/commonerrorcode.md)

| HTTP状态码 | 错误码                                | 说明        |
| ------- | ---------------------------------- | --------- |
| 400     | INVALID\_BYO\_ASN\_ALREADY\_EXISTS | ASN号已被使用。 |