请求
方法
| 请求 URI
|
---|
GET |
https://restapi.cdn.azure.cn/subscriptions/{subscriptionId}/endpoints/{endpointId}/accesscontrol?apiVersion=1.0 |
URI 参数
参数名称
| 描述
|
---|
subscriptionId |
订阅唯一标识符 |
endpointId |
目标节点唯一标识符 |
请求标头 |
说明 |
x-azurecdn-request-date |
必需。 以 yyyy-MM-dd hh:mm:ss 格式输入当前 UTC 请求时间。 |
授权 |
必需。 有关授权标头,请参阅 CDN API 签名机制。 |
请求正文
无
响应
响应包括状态代码、响应头和响应正文。
状态代码
状态代码
| 描述
|
---|
200 |
指示服务器已成功返回响应。 |
其他 |
指示发生错误的一般响应。 |
响应头
|
描述
|
---|
X-Correlation-Id |
请求的唯一标识符,用于跟踪请求信息。 |
响应正文
请求成功的 JSON 示例:
{
"ForbiddenIps": [
"192.160.1.1",
"220.100.100.100"
],
"RefererControl": {
"Enabled": "true",
"PathPatterns": [
"/test1/test1.jpg"
],
"Referers": [
"http://www.abc.com",
"http://www.micorosft.com"
],
"RefererControlType": "AllowList"
}
}
参数名称
| 描述
|
---|
ForbiddenIps |
禁用的 IP 列表 |
PathPatterns |
防盗链接文件路径连接 |
Referers |
防盗链接连接 |
RefererControlType |
防盗链类型
- AllowList:允许列表,仅允许匹配的引用方的链接访问匹配的 PathPatterns 路径。
- BlockList:这是一个黑名单,其中包含指向匹配的引用方的链接,如果他们尝试访问匹配的 PathPatterns 路径,将被拒绝访问。
|
请求失败的 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:请求中止
|
消息 |
错误信息 |