Get a cron entry

GET 
/node/:hostname/schedule/cron/:name

Get a specific cron drop-in entry by name on the target node.

Request

Path Parameters

hostname stringrequired

Possible values: non-empty

Target agent hostname, reserved routing value (_any, _all), or label selector (key:value).

name stringrequired

Possible values: non-empty, Value must match regular expression ^[a-zA-Z0-9_-]+$

Cron entry name. Must contain only alphanumeric characters, underscores, and hyphens.

Responses

200

Cron entry detail.

application/json

Schema

Schema

job_id uuid

The job ID used to process this request.

results

object[]

required

Array [

hostname stringrequired

Hostname of the agent that reported this entry.

status stringrequired

Possible values: [ok, failed, skipped]

The status of the operation for this host.

name string

Cron entry name.

object string

Object store name for the deployed content.

schedule string

Cron schedule expression. Present for /etc/cron.d/ entries.

interval string

Possible values: [hourly, daily, weekly, monthly]

Periodic interval (hourly, daily, weekly, monthly). Present for /etc/cron.{interval}/ entries.

source string

Where the entry lives: "cron.d", "hourly", "daily", "weekly", or "monthly".

user string

User the cron entry runs as.

error string

Error message if the agent failed to retrieve this entry.

]

Example (from schema)

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "results": [
    {
      "hostname": "string",
      "status": "ok",
      "name": "string",
      "object": "string",
      "schedule": "string",
      "interval": "hourly",
      "source": "string",
      "user": "string",
      "error": "string"
    }
  ]
}

400

Bad request - validation error.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

401

Unauthorized - API key required

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

403

Forbidden - Insufficient permissions

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

404

Cron entry not found.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

500

Error retrieving cron entry.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

Loading...