Upsert an asset criticality record Beta

POST /api/asset_criticality

Create or update an asset criticality record for a specific entity.

If a record already exists for the specified entity, that record is overwritten with the specified value. If a record doesn't exist for the specified entity, a new record is created.

application/json; Elastic-Api-Version=2023-10-31

Body Required

  • id_field string Required

    Values are host.name or user.name.

  • id_value string Required

    The ID value of the asset.

  • criticality_level string Required

    The criticality level of the asset.

    Values are low_impact, medium_impact, high_impact, or extreme_impact.

  • refresh string

    If 'wait_for' the request will wait for the index refresh.

    Value is wait_for.

Responses

  • 200 application/json; Elastic-Api-Version=2023-10-31

    Successful response

    Hide response attributes Show response attributes object

    The deleted record if it existed.

    • id_field string Required

      Values are host.name or user.name.

    • id_value string Required

      The ID value of the asset.

    • criticality_level string Required

      The criticality level of the asset.

      Values are low_impact, medium_impact, high_impact, or extreme_impact.

    • asset object Required

      Additional properties are allowed.

      Hide asset attribute Show asset attribute object
      • The criticality level of the asset.

        Values are low_impact, medium_impact, high_impact, or extreme_impact.

    • host object

      Additional properties are allowed.

      Hide host attributes Show host attributes object
      • asset object

        Additional properties are allowed.

        Hide asset attribute Show asset attribute object
        • criticality string Required

          The criticality level of the asset.

          Values are low_impact, medium_impact, high_impact, or extreme_impact.

      • name string Required
    • user object

      Additional properties are allowed.

      Hide user attributes Show user attributes object
      • asset object

        Additional properties are allowed.

        Hide asset attribute Show asset attribute object
        • criticality string Required

          The criticality level of the asset.

          Values are low_impact, medium_impact, high_impact, or extreme_impact.

      • name string Required
    • @timestamp string(date-time) Required

      The time the record was created or updated.

  • Invalid request

POST /api/asset_criticality
curl \
 -X POST https://<KIBANA_URL>/api/asset_criticality \
 -H "Content-Type: application/json; Elastic-Api-Version=2023-10-31"
Request examples
{
  "id_field": "host.name",
  "id_value": "string",
  "criticality_level": "low_impact",
  "refresh": "wait_for"
}
Response examples (200)
{
  "id_field": "host.name",
  "id_value": "string",
  "criticality_level": "low_impact",
  "asset": {
    "criticality": "low_impact"
  },
  "host": {
    "asset": {
      "criticality": "low_impact"
    },
    "name": "string"
  },
  "user": {
    "asset": {
      "criticality": "low_impact"
    },
    "name": "string"
  },
  "@timestamp": "2017-07-21T17:32:28Z"
}