更新节点详细信息
使用该 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:请求中止
|
消息 |
错误信息 |