corestack_ external_ db_ sources_ set
Set the allowed addresses.
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
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
At least 1.
Each {"cidr": "203.0.113.10/: a public IPv4 address or block from /32 to /28, written from its first address.
Fields of each item
A public IPv4 address or block from /32 to /28, e.g. 203.0.113.10/32.
What the address is, e.g. "Order system".
Example 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
| Reason | What to do |
|---|---|
invalid_arguments | An address breaks the rules, a duplicate, more than 10, or an empty list while access is on; fields names each. |
external_db_unchanged | The list is already exactly this. |
external_db_not_on | External access is not on; send the addresses with corestack_external_db_enable. |
external_db_failed | The last change to external access failed; Corefinity support retries or releases it. |
busy | Another change to this environment is applying. |
deleted | The site is deleted (in its grace period). |
provisioning | The site is still being created. |
managed_elsewhere | Another 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_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. |