corestack_ site_ clone_ preview
Preview a copy.
When to use it
What copying a row's files and / or database onto one of the site's environments or its production row would move, the steps, the fix-ups and what blocks it now. The target is busy while the copy runs; the copy's task shows its steps.
Ask for it
Using the Corefinity MCP server, call corestack_site_clone_preview with site_id 4211, target_type environment. (Preview a copy.) Tell me what it returned.Inputs
scopestring
What to copy (files_db).
files_dbdbfilessite_idintegerRequired
The source row. At least 1.
snapshot_idinteger
Copy from a ready snapshot of the source instead. At least 1.
target_idinteger
With target_type environment: the environment's row. At least 1.
target_typestringRequired
environmentproductionExample call
{
"name": "corestack_site_clone_preview",
"arguments": {
"site_id": 4211,
"target_type": "environment"
}
}If it is refused
| Reason | What to do |
|---|---|
snapshot_transfer | In blockers[] (message: "A saved snapshot can be copied only to an environment on the same servers for now, and these two environments are on different servers. Copy the live environment instead, or restore the snapshot to an environment on the same servers."): the chosen snapshot_id cannot be copied to the target, which runs on other servers than the source; corestack_site_clone would refuse it on snapshot_id. Tell the person they can copy the live environment instead (leave out snapshot_id), or restore the snapshot to an environment on the same servers. Where it is switched on and both servers can, a saved snapshot on other servers is sent to the target environment's servers first instead: the preview shows transport sent_local, its estimated_seconds include the send, and expected_switch.note says so. snapshot_transfer stays for a snapshot the servers cannot send. |
too_small | In blockers[]: the target environment's disk is too small for the data; the message names the size to resize it to, or says production's package or support is needed. target_growth then gives the size (size, label, disk_bytes, needed_bytes) with automatic false: ask the person to resize the target first (corestack_environment_resize, priced with corestack_billing_quote_preview); nothing is bought for them. |
target_growth | With automatic true and no size blocker: the company turned on automatic upgrades, so starting the copy resizes the target to label first, priced as a resize (monthly_delta a month more, when known) within the company's monthly limit; message says so ("The target grows to Medium (100 GB) first, as an automatic upgrade you turned on."). Tell the person before you start it. |
invalid_arguments | The arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again. |
tenant_mismatch | The object does not exist or the token may not see it. Check the id. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
pin_refused | The grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it. |
rate_limited | Too many calls. Wait for the number of seconds the answer names. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
internal_error | Something went wrong on our side. Quote the trace id to support. |
- A copy that cannot be made is answered, not refused:
blockers[]lists each reason with its message andcan_proceedis false. - A copy that only has to wait is not blocked:
waits[]lists what it would wait for (clone_in_progress: another copy on either site, or one queued there before it;busy/target_busy: a change in progress on the source or the target, or one still being set up;cluster_migrating;snapshot_slot), each with the words the person sees ("Waiting for another copy on this site to finish. It starts on its own."),queuesis true andcan_proceedstays true.corestack_site_clonethen queues the copy and it starts on its own.copy_queuedinblockers[]means a copy onto that target is already waiting: it must start, or be cancelled, before another is queued.not_offeredthere with "This WordPress site is built with Bedrock, so it can only be copied to a site that deploys the same way. For a staging copy, use a branch (Git) environment." means the target deploys another way;corestack_site_clonewould refuse it.
The same task elsewhere
Was this helpful?