更新系统日志轮换配置
此端点更新MongoDB Agent系统日志轮换配置。 此请求完成后, MongoDB Ops Manager会修改代理配置并保存更新版本。
所需角色
此资源需要 Project Automation Admin
角色。
Resource
基本 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
PUT /groups/{PROJECT-ID}/automationConfig/systemLogRotateConfig
请求
路径参数
名称 | 类型 | 必要性 | 说明 |
---|---|---|---|
PROJECT-ID | 字符串 | 必需 | 拥有自动化配置的项目的唯一标识符。 |
查询参数
以下查询参数为可选参数:
名称 | 类型 | 必要性 | 说明 | 默认 | ||||||
---|---|---|---|---|---|---|---|---|---|---|
pretty | 布尔 | Optional | 指示响应正文是否应采用 美观打印 的标志 格式。 | false | ||||||
envelope | 布尔 | Optional | 指示是否将响应包装在信封中的标志。 某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题,可在查询中设置 envelope=true。 对于返回一个结果的端点,响应体包括:
| false |
正文参数
注意
如果传递空请求正文, MongoDB Ops Manager将禁用日志轮换。 填充的请求正文至少需要sizeThresholdMB
和timeThresholdHrs
字段。 MongoDB Ops Manager将任何其他 null 或未填充的请求正文字段设置为系统默认。
名称 | 类型 | 必要性 | 说明 |
---|---|---|---|
sizeThresholdMB | float | Optional | 轮换前单个日志文件的最大大小(以 MB 为单位)。 注意:除非您传递空请求正文以禁用日志轮换,否则此参数为必填项。 |
timeThresholdHrs | int | Optional | 轮换之前单个日志文件的最长时间(以小时为单位)。 注意:除非您传递空请求正文以禁用日志轮换,否则此参数为必填项。 |
numUncompressed | int | Optional | 保持未压缩的日志文件总数的最大数量,包括当前日志文件。 默认值为 5 。 如果日志文件的数量超过最大未压缩数量,则按日期排序,然后继续压缩最旧的文件,直到满足限制。 |
percentOfDiskspace | float | Optional | 删除前所有日志文件应占用的最大磁盘空间百分比。 默认值为 .02 。 如果日志文件大小占用的总磁盘空间超过最大百分比,则按日期排序,然后继续删除最旧的文件,直到达到限制为止。 |
numTotal | int | Optional | 日志文件总数。 如果磁盘上的日志文件数量大于此数量,则最早的文件将被删除。 如果未指定数字,则默认为0 ,并由其他设置确定。 |
响应
事件请求成功, MongoDB Ops Manager将返回一个空的JSON对象。
请求示例
1 curl --user "{publicApiKey}:{privateApiKey}" --digest \ 2 --header "Accept: application/json" \ 3 --header "Content-Type: application/json" \ 4 --include \ 5 --request PUT "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig/systemLogRotateConfig?pretty=true" \ 6 --data ' { 7 "sizeThresholdMB": 5005.5, 8 "timeThresholdHrs": 13, 9 "numUncompressed": 10, 10 "percentOfDiskspace": 0.1, 11 "numTotal": 15 12 }'
响应示例
响应标头
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/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
响应体
{ }