{% extends "_layout.html" %} {% set title = "No image provides that software" %} {% set status = "422 Unprocessable Content" %} {% set description = "No image satisfies the job’s software. Names every requirement that failed and what is available." %} {% set also_on_a_job = true %} {% block main %}
No live image on this deployment satisfies the job’s software requirements — a SiliconCompiler version, a Python library, or a tool version. The body lists every requirement that failed, each with what the images do hold, so you can ask for something that exists. A SiliconCompiler version no image offers is this type too, naming siliconcompiler: it covers what version-skew meant at create, which is retired.
reason. unavailable: the requirements listed are held by no image at all, SiliconCompiler’s own version included. On a deployment that runs every node in the job’s image, so is a tool or interpreter that no image meeting the python requirements also holds, though another image may. combination: each is held by some image, and no single image holds them together. uninstallable: while staging, the job’s Python packages cannot be installed for a target — nothing in a package’s release line installs for it, or a requirement needs another version of a distribution the image holds; available is [] and detail names each package, its version and the target Python and platform, or the host. A package no configured index has is not this: the job is sent back for its wheel. unknown_class: while staging, a node runs a task class the job’s resolved environment does not provide; unresolved names each as <module>/<Class> and detail names the node. A task’s own setup runs on the node, so it is never run as its base class instead. An unrecognised value means act on the type alone.unresolved: one entry per failed requirement, with kind — where it came from — requirement — your alternatives, exactly as sent — and available, the versions this deployment’s images hold. An empty available means none holds it.unavailable, ask for a version in available. For combination, choose versions that exist in one image together.GET /v1’s software lists what is on offer before you submit, name by name. It cannot show which names share an image, which is why combination exists.Present but reports no version. A tool an image holds but that does not report its version is listed under the date the image was published, and such an entry satisfies no version requirement. If the name is in available and you still got this, ask for it without a version.
{
"type": "https://sc.example.com/server-errors/software-unavailable",
"title": "No image provides that software",
"status": 422,
"detail": "...",
"instance": "/v1/jobs/01J9...",
"reason": "unavailable", // REQUIRED on this type
"unresolved": [{"kind": "tools", "name": "openroad", "requirement": [">=24.3.2011", "==2.0"], "available": ["2.1.0"]}], // REQUIRED on this type
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
| Member | ||
|---|---|---|
reason | REQUIRED | unavailable, combination, uninstallable or unknown_class. |
unresolved | REQUIRED | A list of {kind, name, requirement, available}, one per requirement that failed. kind says where it came from: python, tools or interpreter for that requested_versions key as spelled, class for a task class and package for one of the job’s Python packages, so a Python distribution and a tool of one name stay apart. requirement is the list of alternatives as sent — a requirement is met if any one resolves — and available what the live images hold; [] if none. |
trace_id | optional | The request’s W3C trace id. Quote it in a support request. |
detail is prose and may be reworded at any time. Branch on type, and read the members above for the specifics — never parse detail.
POST /v1/jobs |
The descriptor’s requested_versions cannot be met, a requested_versions.python name no live image holds included. |
while staging |
The flow the manifest’s read reports cannot be placed — a job missing two tools lists both — unknown_class, and uninstallable when the job’s Python packages are installed. The job is rejected, and this is the type of its error on GET /v1/jobs/{id}. |
resource-unavailable is the same answer for data rather than images: a PDK, library or FPGA device this deployment does not hold and cannot supply.
declared-mismatch is a manifest whose SiliconCompiler version does not satisfy the job’s own requested_versions.python.siliconcompiler: the job asked for one version and sent another.