corestack_ enterprise_ copy_ preview
Preview a CoreStack Enterprise copy.
When to use it
Before copying a CoreStack Enterprise environment into one of your CoreCluster sites, ask what the copy would meet. The
answer names the environment (its platform, versions and measured size), the site it would land in, every reason it
cannot be copied now (blockers, the first being the one a create would refuse with), anything worth knowing
(warnings), and confirm: the site's name, which the create and the re-sync take as confirm_target_site. Nothing is
written, on the environment or the site.
A copy lands only in an existing site of the same company as the environment, on one of its own CoreClusters (never a
CoreStack platform cluster): ready, of the same platform, with crons off, no domain attached, no sending domain of its own,
and protected by HTTP authentication over the whole environment (an enabled rule for /, with a user, opening no path).
Copied data is never public and never sends email.
The public API's GET / answers the same.
Ask for it
Using the Corefinity MCP server, call corestack_enterprise_copy_preview with enterprise_env_id 1530, target_site_id 217. (Preview a CoreStack Enterprise copy.) Tell me what it returned.Inputs
The CoreStack Enterprise environment to copy from. 1 to 2147483647.
The CoreCluster site to copy into. 1 to 2147483647.
Example call
{
"name": "corestack_enterprise_copy_preview",
"arguments": {
"enterprise_env_id": 1530,
"target_site_id": 217
}
}If it is refused
| Reason | What to do |
|---|---|
tenant_mismatch | The environment or the site does not exist or is not yours to copy, or the environment was deleted (an agency acting for a client cannot copy into the client's CoreCluster sites). |
pin_refused | A token limited to some sites cannot reach a CoreStack Enterprise environment. |
rate_limited | Previews read the environment, so they have their own budget (10 a minute, shared with the public API). |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
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. |
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. |
other_company | The site belongs to another organisation than the environment. Copy into a site of the environment's own organisation. |
platform_cluster | The cluster is the CoreStack platform, which has no settings or sites of its own to change this way. Change or create the site itself instead. |
target_not_ready | The site to copy into is not ready to take a copy. Read the message: wait until it is ready, or choose another site. |
target_live | The site to copy into has a domain attached, and a copy never overwrites a live site. Choose a site that is not live. |
target_sends_mail | The site to copy into sends email through its own sending domain, and a copy must never send email. Choose another site. |
platform_mismatch | The site and the environment run different platforms. Copy into a site of the same platform. |
target_unprotected | The site to copy into is not protected by HTTP authentication over the whole environment. Protect it first: copied data must never be public. |
target_crons_on | The site to copy into has its scheduled tasks on. Switch them off before copying into it. |
copy_exists | The target already has an unfinished copy. Finish or re-sync that one. |
target_busy | The environment to copy or restore into is busy with another change. Nothing was changed. Wait, then try again. |
target_moving | The site to copy into is part of an environment move. Copy into it once the move is settled. |
source_moving | The environment has a move open, or has moved to CoreStack. Copy it once the move is settled, or copy from its new site. |
target_too_small | See how this server works. |
source_unsupported | See how this server works. |
ssh_unreachable | See how this server works. |
no_mail_neutraliser | Copies of sites of this platform are not available: their email cannot be switched off on the copy. Contact support. |
The preview itself refuses only when the environment or the site is not one you can reach: