使用此端点下载 .tar.gz 存档,其中包含Ops Manager为指定作业收集的每个日志文件。您无法从状态为 IN_PROGRESS 或 EXPIRED 的作业中下载。如果作业部分失败,则存档仅包含Ops Manager成功收集的日志文件。
基本 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /admin/omLogCollectionJobs/{JOB-ID}:download
所需角色
要求调用此端点的 API密钥具有 Global Read Only角色。
请求参数
请求路径参数
名称 | 类型 | 必要性 | 说明 |
|---|---|---|---|
| 字符串 | 必需 | 唯一的24 -十六进制数字字符串,用于标识Ops Manager服务器日志集合作业。要查找作业ID,请调用获取所有Ops Manager服务器日志集合作业。 |
请求查询参数
以下查询参数为可选参数:
名称 | 类型 | 必要性 | 说明 | 默认 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
pretty | 布尔 | Optional | 指示响应正文是否应采用 美观打印 格式的标志。 |
| ||||||
envelope | 布尔 | Optional | 指示是否将响应包装在信封中的标志。 某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题,可在查询中设置 envelope=true。 对于返回一个结果的端点,响应体包括:
|
|
请求正文参数
此端点不使用 HTTP 请求正文参数。
响应
此端点返回一个具有 Content-Type: application/gzip 和文件名格式 om-logs_{timestamp}.tar.gz 的二进制流。存档使用以下布局:
om-server-1.example.com/ application/ mms0.log mms0.20260412.log http_access/ mms0-access.log migration/ mms-migration.log om-server-2.example.com/ application/ mms0.log http_access/ mms0-access.log mms0-access.20260412.log
重要
使用 curl 调用此端点时,必须传递 --output 和文件名。否则,curl 会将二进制存档写入终端。
请求示例
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/gzip" \ --output om-logs.tar.gz \ --request GET \ "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/omLogCollectionJobs/{JOB-ID}:download"
响应示例
响应标头
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/gzip Content-Disposition: attachment; filename="om-logs_{timestamp}.tar.gz" Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
响应体
此端点不返回JSON响应正文。