/2016-07/recipes/:id

Get the details of a specific recipe.

A recipe is a process, or processes, which performs a task; in this case, that task is deprovisioning. When the API returns a recipe, it gives the id and status information about that process and its current status. The recipe runs asynchronously and this endpoint allows applications to poll for the current status of any recipe.

Returned JSON

Key

Description

id

The recipe id - it should be the same as the id in the request parameter.

template

A reference name for the recipe being performed. This is configured by Compose engineering.

status

The status of this recipe. It can be running, waiting, complete or failed.

status_details

A descriptive string which provides further details of the current status, designed to be shown to the user.

account_id

The id of the account associated with the running of this recipe.

deployment_id

The id of the deployment that this recipe is working on. Recipes work on a single deployment.

parent_id

The id of this recipe's parent, if this recipe is a sub-recipe.

name

A short descriptive name of the recipe's purpose.

recipes[]

An array of recipe objects, like this one, if the recipe has sub-recipes.

created_at

Date & time when the recipe was created (ISO8601 format)

updated_at

Date & time when the recipe was last updated (ISO8601 format)

operations_complete

The number of recipe operations that have been completed (see below).

operations_total

The total number of operations that this recipe will run (see below).

Recipe Operations

Operations are the discrete steps that take place in the process of completing a recipe. Each operation will increment the operations_complete field and may update the status_detail field as it is run. The total number of expected operations to be run for completion of the recipe is available in operations_total.

These values, operations_complete and operations_total can be used as an approximate indicator of progress but note that completion of a recipe is only realized when the status field shows completed.

This is because sub-recipes may be included in the recipe. A recipes' sub-recipes will each have their own operations_complete and operations_total. Only when all sub-recipes are also complete - and the parent recipe has run all its operations - will the parent recipe be labelled as complete.

Language
Authentication
Header
Click Try It! to start a request and see the response here!