更新节点详细信息

使用该 API 可以编辑源站域名或主机头。 如果主机头指示回源内容分发网络,主机字符串的值就是 HTTP 请求头。 该值通常是域名形式的字符串。 源站使用此域名来识别它是否与源站上配置的域名相同。

请求

方法 请求 URI
PUT https://restapi.cdn.azure.cn/subscriptions/{subscriptionId}/endpoints/{endpointId}?apiVersion=1.0

URI 参数

参数名称 描述
subscriptionId 订阅唯一标识符
endpointId 目标节点唯一标识符

请求头

请求标头 说明
x-azurecdn-request-date 必需。 以 yyyy-MM-dd hh:mm:ss 格式输入当前 UTC 请求时间。
授权 必需。 请参阅 CDN API 签名机制以了解授权标头。
Content-Type 必需。 application/json

请求正文

更新源站:

{
  "EndpointSettings": {
    "Origin": {
      "Addresses": [
        "www.neworigin.com"
      ]
    }
  },
  "UpdateFlag": "Origin"
}

更新回源主机头:

{
  "EndpointSettings": {
    "Host": "www.newhost.com"
  },
  "UpdateFlag": "HostHeader"
}

同时更新源域和回源主机头

{
  "EndpointSettings": {
    "Host": "www.newhost.com",
    "Origin": {
      "Addresses": [
        "www.neworigin.com"
      ]
    }
  },
  "UpdateFlag": "Origin,HostHeader"
}
参数名称 描述
Host 回源主机头
地址 回源地址集合
UpdateFlag 更新标志
  • Origin:源站
  • HostHeader:回源主机头

响应

响应包括状态代码、响应头和响应正文。

状态代码

状态代码 描述
202 表明服务器已成功接受请求。
其他 指示发生错误的一般响应。

响应标头

响应头 描述
X-Correlation-Id 请求的唯一标识符,用于跟踪请求信息。

响应正文

请求成功的 JSON 示例

{
  "Succeeded": true,
  "IsAsync": true,
  "AsyncInfo": {
    "TaskTrackId": "b520c544-ec34-4ac4-86f5-5394363919c3",
    "TaskStatus": "Processing"
  }
}
参数名称 描述
TaskTrackId 更新操作的唯一标识符,可用于查询更新进度。
TaskStatus 任务状态
  • NotSet:状态未知
  • Processing:正在处理
  • Succeeded:成功
  • Failed:失败

请求失败的 JSON 示例:

{
  "Succeeded": false,
  "ErrorInfo": {
    "Type": "MissingAuthorizationHeader",
    "Message": "Missing authorization header."
  }
}
参数名称 描述
类型 错误类型
  • CredentialInvalid:凭据无效
  • ParameterMissing:参数缺失
  • ParameterInvalid:参数无效
  • MissingAuthorizationHeader:授权标头缺失
  • InvalidRequestDateHeader:请求日期标头无效
  • MissingRequestDateHeader:请求日期标头缺失
  • AuthorizationHeaderExpired:授权标头过期
  • InvalidAuthorizationHeader:授权标头无效
  • ApiKeyNotFound:找不到 API 密钥
  • InvalidApiKey:API 密钥无效
  • WrongSignature:签名错误
  • SubscriptionNotFound:订阅不存在
  • EndpointDoesNotBelongToSubscription:终结点不属于订阅
  • EndpointNotInActiveState:终结点未处于活跃状态
  • EndpointNotFound:终结点不存在
  • MaliciousItemPathDetected:检测到恶意项路径
  • PermissionDenied:权限不足
  • RequestThrottled:请求中止

消息 错误信息