创建节点
使用该 API 可以创建内容分发网络节点。
注意
为终结点创建的配置无法立即可用。
为了确保输入的自定义域名和 ICP 号匹配且有效，必须先进行审核。 此过程最多可能需要一个工作日才能完成。 如果详细信息未通过网络内容提供商 (ICP) 的审核，请删除你创建的内容分发网络终结点，然后使用正确的自定义域名和 ICP 号创建新的终结点。 如果详细信息通过 ICP 审核，内容分发网络服务将在 60 分钟内注册，以便在网络中传播。 同时，还必须按照界面提示配置 CNAME 映射详细信息，然后才能最终通过自定义域名访问缓存内容。
请求
| 方法 | 请求 URI
|
|---|---|
| POST | https://restapi.cdn.azure.cn/subscriptions/{subscriptionId}/endpoints?apiVersion=1.0 |
URI 参数
| 参数名称 | 描述
|
|---|---|
| subscriptionId | 订阅唯一标识符 |
请求头
| 请求标头 | 说明 |
|---|---|
| x-azurecdn-request-date | 必需。 以 yyyy-MM-dd hh:mm:ss 格式输入当前 UTC 请求时间。 |
| 授权 | 必需。 请参阅 CDN API 签名机制以了解授权标头。 |
| Content-Type | 必需。 application/json |
请求正文
若要创建内容分发网络节点，请指定以下参数。 示例 JSON 文件如下：
{
"CustomDomain": "www.example.com",
"Host": "www.example.com",
"ICP": "ICP123456",
"Origin": {
"Addresses": [
"www.origin.com"
]
},
"ServiceType": "Web"
}
| 参数名称 | 描述 |
|---|---|
| 自定义域 | 加速域名 |
| 主机 | 回源主机头 |
| ICP | ICP 备案号 |
| 地址 | 回源地址集合 |
| ServiceType | 加速类型。
|
响应
响应包括状态代码、响应头和响应正文。
状态代码
| 状态代码 | 描述 |
|---|---|
| 202 | 表明服务器已成功接受请求。 |
| 其他 | 指示发生错误的一般响应。 |
响应标头
| 响应头 | 描述 |
|---|---|
| X-Correlation-Id | 请求的唯一标识符，用于跟踪请求信息。 |
响应正文
请求成功的 JSON 示例：
{
"EndpointID": "779bff4d-ef38-4fce-82d8-6b50cc4c183b",
"Setting": {
"CustomDomain": "www.example.com",
"Host": "string",
"ICP": "ICP123456",
"Origin": {
"Addresses": [
"www.origin.com"
]
},
"ServiceType": "Web"
},
"Status": {
"Enabled": "false",
"IcpVerifyStatus": "IcpVerifying",
"LifetimeStatus": "Creating",
"CNameConfigured": "false",
"FreeTrialExpired": "false",
"TimeLastUpdated": "2017-04-28T07:34:54.849Z"
}
}
| 参数名称 | 描述 |
|---|---|
| EndpointID | 节点唯一标识符 |
| Enabled | 任务状态
|
| IcpVerifyStatus | ICP 备案验证信息
|
| LifetimeStatus | 节点状态
|
| CNameConfigured | 指示是否已配置加速域名 CNAME 记录。 |
| FreeTrialExpired | 指示试用期是否已过。 |
| TimeLastUpdated | 上次更新时间。 |
请求失败的 JSON 示例：
{
"Succeeded": false,
"ErrorInfo": {
"Type": "MissingAuthorizationHeader",
"Message": "Missing authorization header."
}
}
| 参数名称 | 描述 |
|---|---|
| 类型 | 错误类型
|
| 消息 | 错误信息 |