CorefinityCorefinityDocs
Open the Control PanelControl Panel
Database · 12 of 12

corestack_external_db_sources_set

Set the allowed addresses.

Scope writeRuns as a taskNo secrets returnedCoreCluster
On this page

When to use it

Replace the list of addresses allowed to reach an environment's external database access: add an outside system's new address, or remove one that is no longer used. Send the whole list each time, every address to keep included (read it with corestack_external_db_get). The change applies within about a minute, and the firewall, the database proxy and the network policy all take the same list.

The list is never empty while access is on: there is no database open to the whole internet. To stop all outside access, turn it off with corestack_external_db_disable.

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_external_db_sources_set with site_id 4211, sources [{"cidr":"203.0.113.10/32","label":"Order system"},{"cidr":"198.51.100.64/29","label":"Reporting"}]. (Set the allowed addresses.) Tell me what it returned.

Inputs

site_idintegerRequired

At least 1.

sourcesarray of objectsRequired

Each {"cidr": "203.0.113.10/32", "label": "Order system"}: a public IPv4 address or block from /32 to /28, written from its first address.

Fields of each item
cidrstringRequired

A public IPv4 address or block from /32 to /28, e.g. 203.0.113.10/32.

labelstring or null

What the address is, e.g. "Order system".

Example call

tools/call
{
  "name": "corestack_external_db_sources_set",
  "arguments": {
    "site_id": 4211,
    "sources": [
      {
        "cidr": "203.0.113.10/32",
        "label": "Order system"
      },
      {
        "cidr": "198.51.100.64/29",
        "label": "Reporting"
      }
    ]
  }
}

If it is refused

ReasonWhat to do
invalid_argumentsAn address breaks the rules, a duplicate, more than 10, or an empty list while access is on; fields names each.
external_db_unchangedThe list is already exactly this.
external_db_not_onExternal access is not on; send the addresses with corestack_external_db_enable.
external_db_failedThe last change to external access failed; Corefinity support retries or releases it.
busyAnother change to this environment is applying.
deletedThe site is deleted (in its grace period).
provisioningThe site is still being created.
managed_elsewhereAnother control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
tenant_mismatchThe object does not exist or the token may not see it. Check the id.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe 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_limitedToo many calls. Wait for the number of seconds the answer names.
temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT