Get plan activity

GET /deployments/{deployment_id}/{resource_kind}/{ref_id}/activity/{attempt_id}

Retrieves details for a single plan activity for the given resource.

Path parameters

  • deployment_id string Required

    Identifier for the Deployment

  • resource_kind string Required

    The kind of resource

    Values are elasticsearch, kibana, apm, appsearch, enterprise_search, or integrations_server.

  • ref_id string Required

    User-specified RefId for the Resource (or '_main' if there is only one)

  • attempt_id string Required

    Attempt id for the activity

Responses

  • Returning the single plan activity for the specified resource

    Hide response attributes Show response attributes object
    • healthy boolean Required
    • attempt_start_time string(date-time)
    • attempt_end_time string(date-time)
    • plan_end_time string(date-time)
    • plan object

      Additional properties are allowed.

    • plan_attempt_log array[object] Required
      Hide plan_attempt_log attributes Show plan_attempt_log attributes object
      • step_id string Required

        ID of current step

      • started string(date-time) Required

        When the step started (ISO format in UTC)

      • completed string(date-time)

        When the step completed (ISO format in UTC)

      • duration_in_millis integer(int64)

        The duration of the step in MS

      • status string Required

        The status of the step (success, warning, error - warning means something didn't go as expected but it was not serious enough to abort the plan)

        Values are success, warning, error, or pending.

      • stage string Required

        Current stage that the step is in

        Values are starting, completed, or in_progress.

      • info_log array[object] Required

        Human readable summaries of the step, including messages for each stage of the step

        Hide info_log attributes Show info_log attributes object
        • timestamp string(date-time) Required

          Timestamp marking on info log of step

        • delta_in_millis integer(int64)

          Time in milliseconds since previous log message

        • stage string Required

          Stage that info log message takes place in

          Values are starting, completed, or in_progress.

        • message string Required

          Human readable log message

        • details object Required

          A map with details for the log about what happened during the step execution. Keys and values for are always both strings, representing the name of the detail and its value, respectively.

          Hide details attribute Show details attribute object
          • * string Additional properties
        • A json object with sensitive details for the log, visible only to admins. May contain nested json objects.

          Hide internal_details attribute Show internal_details attribute object
          • * string Additional properties
        • The failure type, in case the step failed

    • source object

      Information describing the source that facilitated the plans current state

      Additional properties are allowed.

      Hide source attributes Show source attributes object
      • facilitator string Required

        The service where the change originated from

      • action string Required

        The type of plan change that was initiated

      • date string(date-time) Required

        The time the change was initiated

      • user_id string

        The user that requested the change

      • admin_id string

        The admin user that requested the change

      • remote_addresses array[string]

        The host addresses of the user that originated the change

    • warnings array[object] Required
      Hide warnings attributes Show warnings attributes object
      • code string Required

        A unique warning code

      • message string Required

        A description of the warning

      • step_id string

        The ID of the step which produced a warning, if any

    • error object

      Information about an error during a plan attempt.

      Additional properties are allowed.

      Hide error attributes Show error attributes object
      • timestamp string(date-time) Required

        Timestamp marking on info log of step

      • message string Required

        Human readable error message

      • details object Required

        A map with details regarding the error. Both the keys and values are always strings, representing the name of the detail and its value, respectively.

        Hide details attribute Show details attribute object
        • * string Additional properties
      • The failure type

    • The Deployment specified by {deployment_id} cannot be found. (code: deployments.deployment_not_found)
    • The Resource specified by {ref_id} cannot be found. (code: deployments.deployment_resource_not_found)
    Hide headers attribute Show headers attribute
    • The error codes associated with the response

      Values are deployments.deployment_not_found or deployments.deployment_resource_not_found.

    Hide response attribute Show response attribute object
    • errors array[object] Required

      A list of errors that occurred in the failing request

      Hide errors attributes Show errors attributes object
      • code string Required

        A structured code representing the error type that occurred

      • message string Required

        A human readable message describing the error that occurred

      • fields array[string]

        If the error can be tied to a specific field or fields in the user request, this lists those fields

GET /deployments/{deployment_id}/{resource_kind}/{ref_id}/activity/{attempt_id}
curl \
 -X GET https://{{hostname}}/api/v1/deployments/{deployment_id}/{resource_kind}/{ref_id}/activity/{attempt_id}
Response examples (200)
{
  "plan_attempt_id": "string",
  "plan_attempt_name": "string",
  "healthy": true,
  "attempt_start_time": "2024-05-04T09:42:00+00:00",
  "attempt_end_time": "2024-05-04T09:42:00+00:00",
  "plan_end_time": "2024-05-04T09:42:00+00:00",
  "plan": {},
  "plan_attempt_log": [
    {
      "step_id": "string",
      "started": "2024-05-04T09:42:00+00:00",
      "completed": "2024-05-04T09:42:00+00:00",
      "duration_in_millis": 42,
      "status": "success",
      "stage": "starting",
      "info_log": [
        {
          "timestamp": "2024-05-04T09:42:00+00:00",
          "delta_in_millis": 42,
          "stage": "starting",
          "message": "string",
          "details": {
            "additionalProperty1": "string",
            "additionalProperty2": "string"
          },
          "internal_details": {
            "additionalProperty1": "string",
            "additionalProperty2": "string"
          },
          "failure_type": "string"
        }
      ]
    }
  ],
  "source": {
    "facilitator": "string",
    "action": "string",
    "date": "2024-05-04T09:42:00+00:00",
    "user_id": "string",
    "admin_id": "string",
    "remote_addresses": [
      "string"
    ]
  },
  "warnings": [
    {
      "code": "string",
      "message": "string",
      "step_id": "string"
    }
  ],
  "error": {
    "timestamp": "2024-05-04T09:42:00+00:00",
    "message": "string",
    "details": {
      "additionalProperty1": "string",
      "additionalProperty2": "string"
    },
    "failure_type": "string"
  }
}
Response examples (404)
# Headers
x-cloud-error-codes: deployments.deployment_not_found

# Payload
{
  "errors": [
    {
      "code": "string",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}