GET /api/config_reports
列出所有报告

示例

GET /api/config_reports
200
{
  "total": 1,
  "subtotal": 1,
  "page": 1,
  "per_page": 20,
  "search": "",
  "sort": {
    "by": null,
    "order": null
  },
  "results": [
    {
      "metrics": {
        "time": {
          "schedule": 0.00083,
          "service": 0.149739,
          "mailalias": 0.000283,
          "cron": 0.000419,
          "config_retrieval": 16.3637869358063,
          "package": 0.003989,
          "filebucket": 0.000171,
          "file": 0.007025,
          "exec": 0.000299
        },
        "resources": {
          "total": 33
        },
        "changes": {},
        "events": {
          "total": 0
        }
      },
      "created_at": "2019-11-07 08:49:51 UTC",
      "updated_at": "2019-11-07 08:49:51 UTC",
      "id": 1,
      "host_id": 1,
      "host_name": "host1393",
      "reported_at": "2019-11-07 08:49:51 UTC",
      "status": {
        "applied": 0,
        "restarted": 0,
        "failed": 0,
        "failed_restarts": 0,
        "skipped": 0,
        "pending": 0
      }
    }
  ]
}

参数

参数名字 描述
location_id
选填

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
选填

Set the current organization context for the request

Validations:

  • Must be a Integer

search
选填

过滤结果

Validations:

  • Must be a String

order
选填

排序项和顺序,例如 ‘id DESC’

Validations:

  • Must be a String

page
选填

页号,从 1 开始

Validations:

  • Must be a number.

per_page
选填

每页中显示的返回结果数

Validations:

  • Must be a number.

搜索字段

字段名 类型 可能的值
applied integer
environment string
eventful true, false
failed integer
failed_restarts integer
host string
host_id integer
hostgroup string
hostgroup_fullname string
hostgroup_title string
last_report datetime
location string
log text
organization string
origin string
pending integer
reported datetime
resource text
restarted integer
skipped integer

GET /api/config_reports/:id
显示报告

示例

GET /api/config_reports/40
404
{
  "error": {
    "message": "Resource config_report not found by id '40'"
  }
}

参数

参数名字 描述
location_id
选填

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
选填

Set the current organization context for the request

Validations:

  • Must be a Integer

id
必填

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.


POST /api/config_reports
创建报告

示例

POST /api/config_reports
{
  "config_report": {
    "host": "rhel6n01.corp.com",
    "reported_at": "2010-11-19 02:39:04 UTC",
    "metrics": {},
    "status": {
      "applied": 0,
      "failed": 0,
      "failed_restarts": 0,
      "pending": 0,
      "restarted": 0,
      "skipped": 0
    },
    "logs": [
      {
        "log": {
          "sources": {
            "source": "Puppet"
          },
          "messages": {
            "message": "Could not retrieve catalog from remote server: Error 400 on SERVER: Could not find node 'rhel6n01.corp.com'; cannot compile"
          },
          "level": "err"
        }
      },
      {
        "log": {
          "sources": {
            "source": "Puppet"
          },
          "messages": {
            "message": "Using cached catalog"
          },
          "level": "notice"
        }
      },
      {
        "log": {
          "sources": {
            "source": "Puppet"
          },
          "messages": {
            "message": "Could not retrieve catalog; skipping run"
          },
          "level": "err"
        }
      }
    ]
  }
}
201
{
  "metrics": {},
  "created_at": "2019-11-07 08:35:22 UTC",
  "updated_at": "2019-11-07 08:35:22 UTC",
  "id": 34,
  "host_id": 46,
  "host_name": "rhel6n01.corp.com",
  "reported_at": "2010-11-19 02:39:04 UTC",
  "status": {
    "applied": 0,
    "restarted": 0,
    "failed": 0,
    "failed_restarts": 0,
    "skipped": 0,
    "pending": 0
  },
  "logs": [
    {
      "level": "err",
      "source": {
        "source": "Puppet"
      },
      "message": {
        "message": "Could not retrieve catalog from remote server: Error 400 on SERVER: Could not find node 'rhel6n01.corp.com'; cannot compile"
      }
    },
    {
      "level": "notice",
      "source": {
        "source": "Puppet"
      },
      "message": {
        "message": "Using cached catalog"
      }
    },
    {
      "level": "err",
      "source": {
        "source": "Puppet"
      },
      "message": {
        "message": "Could not retrieve catalog; skipping run"
      }
    }
  ],
  "summary": "Success"
}

参数

参数名字 描述
location_id
选填

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
选填

Set the current organization context for the request

Validations:

  • Must be a Integer

config_report
必填

Validations:

  • Must be a Hash

config_report[host]
必填

主机名或证书名称

Validations:

  • Must be a String

config_report[reported_at]
必填

报告的 UTC 时间

Validations:

  • Must be a String

config_report[status]
必填

状态类型哈希总计

Validations:

  • Must be a Hash

config_report[metrics]
必填

报告指标哈希,可只为 {}

Validations:

  • Must be a Hash

config_report[logs]
选填 , 允许空值

日志哈希的自选阵列

Validations:

  • Must be an array of any type


DELETE /api/config_reports/:id
删除报告

示例

DELETE /api/config_reports/41
{
  "config_report": {}
}
404
{
  "error": {
    "message": "Resource config_report not found by id '41'"
  }
}

参数

参数名字 描述
location_id
选填

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
选填

Set the current organization context for the request

Validations:

  • Must be a Integer

id
必填

Validations:

  • Must be a String


GET /api/hosts/:host_id/config_reports/last
显示主机的最新报告

示例

GET /api/hosts/134/config_reports/last
404
{
  "error": {
    "message": "Resource config_report not found by id ''"
  }
}

参数

参数名字 描述
location_id
选填

Set the current location context for the request

Validations:

  • Must be a Integer

organization_id
选填

Set the current organization context for the request

Validations:

  • Must be a Integer

id
必填

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.