GET /api/config_reports
모든 보고서 나열

Examples

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-09-11 14:37:45 UTC",
      "updated_at": "2019-09-11 14:37:45 UTC",
      "id": 17,
      "host_id": 77,
      "host_name": "host574",
      "reported_at": "2019-09-11 14:37:45 UTC",
      "status": {
        "applied": 0,
        "restarted": 0,
        "failed": 0,
        "failed_restarts": 0,
        "skipped": 0,
        "pending": 0
      }
    }
  ]
}

Params

Param Name Description
location_id
Optional

위치 별 범위

Validations:

  • Must be a Integer

organization_id
Optional

조직 별 범위

Validations:

  • Must be a Integer

search
Optional

필터 결과

Validations:

  • Must be a String

order
Optional

Sort field and order, eg. ‘id DESC’

Validations:

  • Must be a String

page
Optional

1 부터 페이지 번호

Validations:

  • Must be a number.

per_page
Optional

반환할 페이지 당 결과 수

Validations:

  • Must be a number.

Search fields

Field name 유형 Possible values
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
보고서 표시

Examples

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

Params

Param Name Description
location_id
Optional

위치 별 범위

Validations:

  • Must be a Integer

organization_id
Optional

조직 별 범위

Validations:

  • Must be a Integer

id
Required

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
보고서 생성

Examples

POST /api/config_reports
{
  "config_report": {}
}
403
{
  "error": {
    "message": "Access denied",
    "details": "Missing one of the required permissions: upload_config_reports"
  }
}

Params

Param Name Description
location_id
Optional

위치 별 범위

Validations:

  • Must be a Integer

organization_id
Optional

조직 별 범위

Validations:

  • Must be a Integer

config_report
Required

Validations:

  • Must be a Hash

config_report[host]
Required

호스트 이름 또는 인증서 이름

Validations:

  • Must be a String

config_report[reported_at]
Required

보고서의 UTC 시간

Validations:

  • Must be a String

config_report[status]
Required

상태 유형의 해시 합계

Validations:

  • Must be a Hash

config_report[metrics]
Required

보고서 메트릭스의 해시는 {}이 될 수 있습니다

Validations:

  • Must be a Hash

config_report[logs]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

로그 해시 옵션 배열

Validations:

  • Must be an array of any type


DELETE /api/config_reports/:id
보고서 삭제

Examples

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

Params

Param Name Description
location_id
Optional

위치 별 범위

Validations:

  • Must be a Integer

organization_id
Optional

조직 별 범위

Validations:

  • Must be a Integer

id
Required

Validations:

  • Must be a String


GET /api/hosts/:host_id/config_reports/last
호스트의 마지막 보고서 표시

Examples

GET /api/hosts/host2546/config_reports/last
200
{
  "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-09-11 14:57:33 UTC",
  "updated_at": "2019-09-11 14:57:33 UTC",
  "id": 12,
  "host_id": 31,
  "host_name": "host2546",
  "reported_at": "2019-09-11 14:57:33 UTC",
  "status": {
    "applied": 0,
    "restarted": 0,
    "failed": 0,
    "failed_restarts": 0,
    "skipped": 0,
    "pending": 0
  },
  "logs": [],
  "summary": "Success"
}

Params

Param Name Description
location_id
Optional

위치 별 범위

Validations:

  • Must be a Integer

organization_id
Optional

조직 별 범위

Validations:

  • Must be a Integer

id
Required

Validations:

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