文档首页/ 云化数据中心 CloudDC/ API参考/ API/ 物理服务器管理/ 导出服务器日志请求
更新时间：2025-07-25 GMT+08:00
在线调试
CLI示例
查看PDF
分享

导出服务器日志请求

功能介绍

创建服务器日志导出异步任务。根据ShowLogsExportStatus查询status，当status状态为completed时，调用DownloadServerLogs下载日志文件。

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/physicalservers/{id}/logs/exports

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID

约束限制：

不涉及

取值范围：

账号的项目ID

默认取值：

不涉及

id

是

String

参数解释：

服务器ID

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

调用接口的认证方式分为Token，如果您使用的Token方式，此参数为必填，请填写Token的值

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

响应参数

状态码：202

表3 响应Header参数

参数

参数类型

描述

Content-Disposition

String

格式为 "attachment; filename=${id}-dump.tar.gz"，id为服务器唯一标识SN

Content-Transfer-Encoding

String

固定为 binary

Content-Type

String

固定为 application/octet-stream;charset=UTF-8
表4 响应Body参数

参数

参数类型

描述

export_id

String

export task id

status

String

参数解释：

导出进度

约束限制：

不涉及

取值范围：

  • processing：导出中

  • completed： 导出完成

默认取值：

不涉及

percentage

Integer

参数解释：

导出进度百分比

约束限制：

不涉及

取值范围：

0-100

默认取值：

不涉及

created_at

DateTime

参数解释：

导出开始时间，

约束限制：

不涉及

取值范围：

时间戳格式为ISO 8601，例如：2025-03-20T02:48:06+00:00

默认取值：

不涉及

状态码：401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

error_msg

String

参数解释：

错误描述

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

状态码：429

表6 响应Body参数

参数

参数类型

描述

-

String

-

状态码：500

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

error_msg

String

参数解释：

错误描述

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

请求示例

导出服务器日志请求

POST https://{endpoint}/v1/{project_id}/physicalservers/{id}/logs/exports

{ }

响应示例

状态码：202

日志压缩包流文件

{
  "export_id" : "1",
  "status" : "Running",
  "percentage" : "30%",
  "created_at" : "2024-07-01T11:32:49Z",
  "Content-Type" : "application/json; charset=utf-8"
}

状态码

状态码

描述

202

日志压缩包流文件

401

请求未鉴权

429

请求过载

500

服务端内部错误

错误码

请参见错误码。

父主题： 物理服务器管理