获取日志下载链接

  • Article

通过该API可以获取CDN节点日志下载链接。日志下载链接可以无需鉴权直接访问，有效期10天。

请求

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

URI参数

参数名 描述
subscriptionId 订阅唯一标识
endpointId 节点唯一标识
startTime 日志下载链接查询起始时间，必须符合'yyyy-MM-ddTHH:mm:ssZ’格式的UTC时间
endTime 日志下载链接查询结束时间，必须符合'yyyy-MM-ddTHH:mm:ssZ’格式的UTC时间

请求 Headers

请求包头 描述
x-azurecdn-request-date 必填。符合yyyy-MM-dd HH:mm:ss格式的UTC当前请求时间
Authorization 必填。授权头请参考[CDN API签名机制](./cdn-api-signature.md)。

请求 Body

无

响应

响应由状态码，响应 headers以及响应 body组成。

状态码

状态码 描述
200 表明服务器成功接受请求
其他 表示出错的通用回复

响应 Headers

响应包头 描述
X-Correlation-Id 该请求唯一标识，用于追踪请求信息。

响应 Body

请求成功的JSON示例:

{
    "Data": [
        {
            "StartTime": "2020-08-29T07:00:00+08:00",
            "EndTime": "2020-08-29T07:59:59+08:00",
            "LogUri": "https://logsystemprod.blob.core.chinacloudapi.cn/endpointlogs-prod-9769e4fb-e682-11ea-8d58-a0725c773fd4/2020-08-29/7293b26a-fb43-4f64-a888-bd9a429c631f-20200829_0700-0759.csv.gz",
            "FileSize": 4998
        },
        {
            "StartTime": "2020-08-29T06:00:00+08:00",
            "EndTime": "2020-08-29T06:59:59+08:00",
            "LogUri": "https://logsystemprod.blob.core.chinacloudapi.cn/endpointlogs-prod-9769e4fb-e682-11ea-8d58-a0725c773fd4/2020-08-29/bc486b62-d8b2-4594-b44c-9489d4e5b70c-20200829_0600-0659.csv.gz",
            "FileSize": 4537
        },
        {
            "StartTime": "2020-08-29T05:00:00+08:00",
            "EndTime": "2020-08-29T05:59:59+08:00",
            "LogUri": "https://logsystemprod.blob.core.chinacloudapi.cn/endpointlogs-prod-9769e4fb-e682-11ea-8d58-a0725c773fd4/2020-08-29/d82296db-5f0e-42b1-be7b-98e96500e611-20200829_0500-0559.csv.gz",
            "FileSize": 4514
        },
        {
            "StartTime": "2020-08-29T04:00:00+08:00",
            "EndTime": "2020-08-29T04:59:59+08:00",
            "LogUri": "https://logsystemprod.blob.core.chinacloudapi.cn/endpointlogs-prod-9769e4fb-e682-11ea-8d58-a0725c773fd4/2020-08-29/016ab7a5-13c7-4198-b96d-d8fbfc2e8b84-20200829_0400-0459.csv.gz",
            "FileSize": 4521
        },
        {
            "StartTime": "2020-08-29T03:00:00+08:00",
            "EndTime": "2020-08-29T03:59:59+08:00",
            "LogUri": "https://logsystemprod.blob.core.chinacloudapi.cn/endpointlogs-prod-9769e4fb-e682-11ea-8d58-a0725c773fd4/2020-08-29/ccc219f1-e44a-4dda-bd20-f9d09dad81b1-20200829_0300-0359.csv.gz",
            "FileSize": 6713
        },
        {
            "StartTime": "2020-08-29T02:00:00+08:00",
            "EndTime": "2020-08-29T02:59:59+08:00",
            "LogUri": "https://logsystemprod.blob.core.chinacloudapi.cn/endpointlogs-prod-9769e4fb-e682-11ea-8d58-a0725c773fd4/2020-08-29/f4665095-1e80-4677-af8c-767d300e930a-20200829_0200-0259.csv.gz",
            "FileSize": 9419
        },
        {
            "StartTime": "2020-08-29T01:00:00+08:00",
            "EndTime": "2020-08-29T01:59:59+08:00",
            "LogUri": "https://logsystemprod.blob.core.chinacloudapi.cn/endpointlogs-prod-9769e4fb-e682-11ea-8d58-a0725c773fd4/2020-08-29/7f58a47e-2dd9-4350-b622-084a42c3b0f6-20200829_0100-0159.csv.gz",
            "FileSize": 11271
        },
        {
            "StartTime": "2020-08-29T00:00:00+08:00",
            "EndTime": "2020-08-29T00:59:59+08:00",
            "LogUri": "https://logsystemprod.blob.core.chinacloudapi.cn/endpointlogs-prod-9769e4fb-e682-11ea-8d58-a0725c773fd4/2020-08-29/aaf04431-b0f6-4dbf-b61b-7176314362bd-20200829_0000-0059.csv.gz",
            "FileSize": 18655
        }
    ],
    "Succeeded": true,
    "ErrorInfo": null,
    "IsAsync": false,
    "AsyncInfo": null
}
参数名称 描述
StartTime 起始时间
EndTime 结束时间
LogUri 下载链接
FileSize 文件大小

请求失败的JSON示例:

{
  "Succeeded": false,
  "ErrorInfo": {
    "Type": "MissingAuthorizationHeader",
    "Message": "Missing authorization header."
  }
}
参数名称 描述
Type 错误类型
  • CredentialInvalid:凭据不合法
  • ParameterMissing:缺少参数
  • ParameterInvalid：参数不合法
  • MissingAuthorizationHeader:缺少Authorization请求头
  • InvalidRequestDateHeader:请求时间不合法
  • MissingRequestDateHeader：缺少请求时间头
  • AuthorizationHeaderExpired:Authorization请求头已失效
  • InvalidAuthorizationHeader:Authorization请求头不合法
  • ApiKeyNotFound：API密钥不存在
  • InvalidApiKey:API密钥不合法
  • WrongSignature:签名不对
  • SubscriptionNotFound：订阅不存在
  • EndpointDoesNotBelongToSubscription：节点不属于订阅
  • EndpointNotInActiveState：节点不处于活跃状态
  • EndpointNotFound：节点不存在
  • MaliciousItemPathDetected：检查到恶意路径
  • PermissionDenied：权限不够
  • RequestThrottled：请求被限流
  • CertificateAndKeyNotMatch：证书和密钥不匹配
  • CertificateAndEndpointNotMatch：证书和节点不匹配
  • SelfSignedCertificate：不支持自签名证书
  • CertificateDoesNotBelongToSubscription：证书不属于改订阅
Message 错误信息