刷新缓存

接口描述

功能说明:刷新节点上的文件内容。刷新指定URL内容至Cache节点,支持URL文件、目录批量刷新。

使用说明:

  • 每个URL必须以http://或https://开头
  • 每个URL所在的域名必须是该用户在美团云的域名
  • 请求方式为POST

请求URL:

https://mosapi.meituan.com/mcs/v1?
   Action=RefreshObjectCaches&
   请求参数&
   AUTHDATA

请求参数

参数名 类型 说明 可选值
ObjectPath String 刷新对象路径,可以单个也可以多个, 多个使用英文逗号分隔 必选
ObjectType Integer 标识目录或文件,0表示目录,1表示文件,默认是1 可选

返回参数

参数名 类型 说明
Code Integer 公共错误码,“Success”表示成功,其他值表示失败,详见下文错误状态码说明
Message String 模块错误信息描述,与接口相关
FailedUrl String 刷新失败的URL,返回具体的失败URL
TaskId String 此次刷新任务对应的ID,可用于查询刷新进度

返回示例

Json示例:

{
    "Message": "Success",
    "Code": "Success",
    "TaskId": "1450346063"
}

预热缓存

接口描述

功能说明:将源站的内容主动预热到边缘节点上,用户首次访问可直接命中缓存,缓解源站压力。

使用说明:

  • 每个URL必须以http://或https://开头
  • 每个URL所在的域名必须是该用户在美团云的域名
  • 请求方式为POST

请求URL:

https://mosapi.meituan.com/mcs/v1?
    Action=PreloadObjectCaches&
    请求参数&
    AUTHDATA

请求参数

参数名 类型 说明 可选值
ObjectPath String 预热对象路径,可以单个也可以多个, 多个使用英文逗号分隔 必选

返回参数

参数名 类型 说明
Code Integer 公共错误码,“Success”表示成功,其他值表示失败,详见下文错误状态码说明
Message String 模块错误信息描述,与接口相关
FailedUrl String 预热失败的URL,返回具体的失败URL
TaskId String 此次预热任务对应的ID,可用于查询预热进度

返回示例

Json示例:

{
    "Code": "Success",
    "Message": "Success",
    "TaskId": "1450346063"
}

查询刷新进度

接口描述

功能说明:用于刷新进度查询,查看刷新任务是否在全网生效。

使用说明:

  • 支持根据刷新任务ID查询,反馈任务ID下所有的记录和进度
  • 支持基于加速域名和时间查询,目前反馈最新的500条刷新纪录和进度
  • 请求方式为POST

请求URL:

https://mosapi.meituan.com/mcs/v1?
    Action=QueryRefreshTasks&
    请求参数&
    AUTHDATA

请求参数

参数名 类型 说明 可选值
TaskId String 刷新任务对应的ID,按任务ID查询 可选
Domain String 需要查询的加速域名 可选
SearchDate String 查询的日期,格式为YYYY-MM-DD,默认为当天 可选
Type String 标识查询目标为目录或文件,0表示目录,1表示文件,默认是1 可选

返回参数

参数名 类型 说明
Code Integer 公共错误码,“Success”表示成功,其他值表示失败,详见下文错误状态码说明
Message String 模块错误信息描述,与接口相关
TotalCountl String 返回的URL总条数
Tasks Task数组 TaskItem组成的Task任务列表

TaskItem结构

参数名 类型 说明
ObjectPath String 刷新对象路径
CreatedAt String 任务对象创建时间
Status String 刷新状态,值分别是Complete(完成)、Refreshing(进行中)、Failed(失败)、Pending(等待中)

特殊错误码

Code Message 错误信息 HTTP 状态 语义
InvalIdTaskId Specified TaskId is malformed. 400 TaskId格式错误
OperationDenied Your CDN service is suspended. 403 CDN服务已被停止
Throttling Request was denied due to request throttling. 503 请求被流量控制限制

返回示例

Json示例:

{
    "Code": "Success",
    "Message": "Success.",
    "TotalCount": 4,
    "Tasks": [
        {
            "ObjectPath": "http:\\/\\/news.ifeng.com\\/1.txt",
            "CreatedAt": "2014-11-27T08:23:22Z",
            "Status": "Complete"
        },
        {
            "ObjectPath": "http:\\/\\/news.ifeng.com\\/1.txt",
            "CreatedAt": "2014-11-27T08:18:38Z",
            "Status": "Complete"
        },
        {
            "ObjectPath": "http:\\/\\/news.ifeng.com\\/static\\/",
            "CreatedAt": "2014-11-27T07:58:58Z",
            "Status": "Complete"
        },
        {
            "ObjectPath": "http:\\/\\/haitao.smzdm.com\\/1.txt",
            "CreatedAt": "2014-11-27T04:06:27Z",
            "Status": "Complete"
        }
    ]
}

查询预热进度

接口描述

功能说明:用于预热进度查询,查看预热任务是否在全网生效。

使用说明:

  • 支持根据预热任务ID查询,反馈任务ID下所有的记录和进度
  • 支持基于加速域名和时间查询,目前反馈最新的500条预热纪录和进度
  • 请求方式为POST

请求URL:

https://mosapi.meituan.com/mcs/v1?
    Action=QueryPreloadTasks&
    请求参数&
    AUTHDATA

请求参数

参数名 类型 说明 可选值
TaskId String 预热任务对应的ID,按任务ID查询 可选
Domain String 需要查询的加速域名 可选
SearchDate String 查询的日期,格式为YYYY-MM-DD,默认为当天 可选

返回参数

参数名 类型 说明
Code Integer 公共错误码,“Success”表示成功,其他值表示失败,详见下文错误状态码说明
Message String 模块错误信息描述,与接口相关
TotalCountl String 返回的URL总条数
Tasks Task数组 TaskItem组成的Task任务列表

TaskItem结构

参数名 类型 说明
ObjectPath String 预热对象路径
CreatedAt String 任务对象创建时间
Status String 预热状态,值分别是Complete(完成)、Refreshing(进行中)、Failed(失败)、Pending(等待中)

特殊错误码

Code Message 错误信息 HTTP 状态 语义
InvalIdTaskId Specified TaskId is malformed. 400 TaskId格式错误
OperationDenied Your CDN service is suspended. 403 CDN服务已被停止
Throttling Request was denied due to request throttling. 503 请求被流量控制限制

返回示例

Json示例:

{
    "Code": "Success",
    "Message": "Success.",
    "TotalCount": 4,
    "Tasks": [
        {
            "ObjectPath": "http:\\/\\/news.ifeng.com\\/1.txt",
            "CreatedAt": "2014-11-27T08:23:22Z",
            "Status": "Complete"
        },
        {
            "ObjectPath": "http:\\/\\/news.ifeng.com\\/1.txt",
            "CreatedAt": "2014-11-27T08:18:38Z",
            "Status": "Complete"
        },
        {
            "ObjectPath": "http:\\/\\/news.ifeng.com\\/static\\/",
            "CreatedAt": "2014-11-27T07:58:58Z",
            "Status": "Complete"
        },
        {
            "ObjectPath": "http:\\/\\/haitao.smzdm.com\\/1.txt",
            "CreatedAt": "2014-11-27T04:06:27Z",
            "Status": "Complete"
        }
    ]
}