创建站点

1. 接口描述

接口请求域名： teo.tencentcloudapi.com 。

EdgeOne 为您提供 CNAME、NS 和无域名接入三种接入方式，您需要先通过此接口完成站点创建。CNAME 和 NS 接入站点的场景可参考 从零开始快速接入 EdgeOne; 无域名接入的场景可参考 快速启用四层代理服务。

建议您在账号下已存在套餐时调用本接口创建站点，请在入参时传入 PlanId ，直接将站点绑定至该套餐；不传入 PlanId 时，创建出来的站点会处于未激活状态，无法正常服务，您需要通过 BindZoneToPlan 完成套餐绑定之后，站点才可正常提供服务 。若您当前没有可绑定的套餐时，请前往控制台购买套餐完成站点创建。

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 创建 NS 接入类型的站点

创建NS接入模式站点 example.com，服务区域为中国大陆可用区，绑定套餐 edgeone-37q0w6qali10。接口将返回 DNS 服务器信息，您需要前往域名注册商处修改，可参考 修改 DNS 服务器。

输入示例

POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateZone
<公共请求参数>

{
    "Type": "full",
    "ZoneName": "example.com",
    "Area": "mainland",
    "PlanId": "edgeone-37q0w6qali10"
}

输出示例

{
    "Response": {
        "ZoneId": "zone-27q0p0bali16",
        "OwnershipVerification": {
            "DnsVerification": null,
            "FileVerification": null,
            "NsVerification": {
                "NameServers": [
                    "ns1.teodns.com",
                    "ns2.teodns.com"
                ]
            }
        },
        "RequestId": "9kl50bew-89ga-44f4-91ce-78125d53vd2a"
    }
}

示例2 创建无域名接入模式站点

创建无域名接入模式站点，绑定套餐 edgeone-37q0w6qali10。接口将返回站点 ID。有关无域名接入模式的相关信息，可参考 快速启用四层代理服务。

输入示例

POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateZone
<公共请求参数>

{
    "Type": "noDomainAccess",
    "PlanId": "edgeone-37q0w6qali10"
}

输出示例

{
    "Response": {
        "ZoneId": "zone-27q0p0bali16",
        "RequestId": "9kl50bew-89ga-44f4-91ce-78125d53vd2a"
    }
}

示例3 创建 CNAME 接入类型的站点

创建 CNAME 接入类型的站点 example.com，服务区域为全球可用区，绑定套餐 edgeone-37q0w6qali10。接口将返回站点 ID 和站点归属权验证信息。您可以对站点进行归属权验证，可参考 站点/域名归属权验证。

输入示例

POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateZone
<公共请求参数>

{
    "Type": "partial",
    "ZoneName": "example.com",
    "Area": "global",
    "PlanId": "edgeone-37q0w6qali10"
}

输出示例

{
    "Response": {
        "ZoneId": "zone-27q0p0bali16",
        "OwnershipVerification": {
            "DnsVerification": {
                "Subdomain": "edgeonereclaim",
                "RecordType": "TXT",
                "RecordValue": "reclaim-a24aba2420cf4ce8b7bff7c8be6d337f"
            },
            "FileVerification": {
                "Path": "/.well-known/teo-verification/vd4ewuqa9n.txt",
                "Content": "88v24mnnljwbhaohrpfx80f63duhdnjx"
            },
            "NsVerification": null
        },
        "RequestId": "9kl50bew-89ga-44f4-91ce-78125d53vd2a"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。