Locations show the available geographical locations for each of the following cloud providers:
Amazon Web Services (AWS)
Google Cloud Platform (GCP)
Microsoft Azure
Oracle Cloud Infrastructure (OCI)
Locations are scoped to an org, and an org administrator enables or disables the ones a GVC may select.A new org is seeded with a working subset of the built-in catalog, and every location present in an org starts enabled. Disabling a location removes the workloads running in it; enabling one provisions every workload whose GVC selects it.
If a company is restricted for legal or compliance reasons to only use certain cloud providers, disabling those providers will ensure that workloads will not be deployed to those providers.
Control Plane can enable any cloud provider location.If a location is not shown, email support@controlplane.com with the provider and location and it will be provisioned.
CPLN BYOK enables you to add new locations by registering your own Kubernetes clusters as locations in the Control Plane platform.
For a guide on how to create new BYOK locations and further details, refer to the BYOK documentation.
The location list endpoint and location-specific endpoint return the location object with the ipRanges property.See the Get All Locations API endpoint for details.
The list of IPs may be required by external services that restrict which IPs are allowed to access them.The IPs may change when underlying infrastructure changes. Control Plane recommends automating location API checks and updating external services’ allowed IP address lists when changes occur.
Displays the permissions granted to principals for the location. See Access Report for what each entry shows, how to open it from the Console, CLI, or API, and how groups, query targets, and implied permissions appear in it.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Control Plane","description":"Documentation for Control Plane, a hybrid multi-cloud platform for deploying and managing workloads, Kubernetes, networking, secrets, logs, and infrastructure across AWS, GCP, Azure, and private clouds.","colors":{"primary":"#1563ff","light":"#64a5ef","dark":"#1563ff"},"logo":{"light":"https://mintcdn.com/controlplanecorporation/hwvJiAoqIziVJ3gK/logos/dark.svg?fit=max\u0026auto=format\u0026n=hwvJiAoqIziVJ3gK\u0026q=85\u0026s=ec7b5a4bb958adc4d92dedfb41ab2e3c","dark":"https://mintcdn.com/controlplanecorporation/hwvJiAoqIziVJ3gK/logos/light.svg?fit=max\u0026auto=format\u0026n=hwvJiAoqIziVJ3gK\u0026q=85\u0026s=4904ca0b5a8c55fa87495b8edd04aadc"},"favicon":"https://mintcdn.com/controlplanecorporation/hwvJiAoqIziVJ3gK/logos/favicon.png?fit=max\u0026auto=format\u0026n=hwvJiAoqIziVJ3gK\u0026q=85\u0026s=11640a5f7b1a462c233be7a72afa72d7","api":{"openapi":["https://api.cpln.io/openapi.json","https://audit.cpln.io/openapi.json"],"mdx":{"auth":{"method":"bearer"},"server":"https://api.cpln.io"}},"navbar":{"links":[{"href":"https://console.cpln.io/signin","label":"Sign in"}],"primary":{"type":"button","label":"Sign up","href":"https://console.cpln.io/signup"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/control-plane-corporation","youtube":"https://www.youtube.com/@controlplanecorporation","reddit":"https://www.reddit.com/r/controlplane"}},"search":{"prompt":"Search Control Plane docs..."},"seo":{"indexing":"navigable"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity",{"title":"Install MCP Server","description":"Connect the Control Plane MCP Server to your AI tool","icon":"plug","href":"https://docs.controlplane.com/ai/overview"}],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"compass","href":"https://controlplane.com"},{"anchor":"Status","icon":"signal","href":"https://status.cpln.io/"},{"anchor":"Blog","icon":"newspaper","href":"https://controlplane.com/blog"},{"anchor":"FAQ","icon":"question","href":"https://controlplane.com/faq"},{"anchor":"Product Demos","icon":"video","href":"https://controlplane.com/product-demos"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"controlplanecorporation","hasAudioNarration":false,"actualSubdomain":"controlplanecorporation","customDomains":["docs.controlplane.com"],"gitSource":{"type":"github","owner":"controlplane-docs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae3d8d1a6d51aa4658d8422","collectionId":"07e6ba87-b8c4-43e0-9584-3cb1e7cb1e7f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae3d8d1a6d51aa4658d8422"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae3d8d1a6d51aa4658d8422","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":173},{"language":"default","tag":"Core API","count":164},{"language":"default","tag":"Template Catalog","count":100},{"language":"default","tag":"Templates","count":90},{"language":"default","tag":"Home","count":79},{"language":"default","tag":"How-to Guides","count":71},{"language":"default","tag":"CLI Reference","count":66},{"language":"default","tag":"Reference","count":49},{"language":"default","tag":"Commands","count":38},{"language":"default","tag":"Workload","count":24}],"searchSettings":{"maxResults":5}},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"global.css","content":"html{overflow-y:scroll}"},{"filePath":"style.css","content":"img[src*=\"/icons/mcp-sidebar.svg\"]{filter:brightness(0) saturate(100%) invert(69%) sepia(9%) saturate(309%) hue-rotate(176deg) brightness(95%) contrast(87%)!important}a[aria-current=page] img[src*=\"/icons/mcp-sidebar.svg\"],img[src*=\"/icons/mcp.svg\"]{filter:brightness(0) saturate(100%) invert(28%) sepia(98%) saturate(3000%) hue-rotate(213deg) brightness(102%) contrast(101%)!important}.dark img[src*=\"/icons/mcp-sidebar.svg\"]{filter:brightness(0) saturate(100%) invert(47%) sepia(8%) saturate(420%) hue-rotate(177deg) brightness(94%) contrast(85%)!important}img.sidebar-group-icon[src*=\"/icons/mcp-sidebar.svg\"]{filter:brightness(0)!important}.dark img.sidebar-group-icon[src*=\"/icons/mcp-sidebar.svg\"]{filter:brightness(0) invert(1)!important}.dark a[aria-current=page] img[src*=\"/icons/mcp-sidebar.svg\"],.dark img[src*=\"/icons/mcp.svg\"]{filter:brightness(0) saturate(100%) invert(63%) sepia(74%) saturate(380%) hue-rotate(186deg) brightness(98%) contrast(91%)!important}.dark img[src*=\"/icons/chatgpt.svg\"],.dark img[src*=\"/icons/codex.svg\"],.dark img[src*=\"/icons/cursor.svg\"],.dark img[src*=\"/icons/opencode.svg\"]{filter:invert(1)!important}"}],"page":{"pagePath":"reference/location","slug":"/reference/location","pageMetadata":{"title":"Location","description":"Available geographical locations across AWS, GCP, Azure, and OCI that can be enabled or disabled for GVC workload deployment.","keywords":["region","cloud region","frankfurt","us-east","eu-west","tokyo","singapore","enabled regions","cpln location","byok location"],"href":"/reference/location"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Available geographical locations across AWS, GCP, Azure, and OCI that can be enabled or disabled for GVC workload deployment.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Tab,Table,Tabs,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`Locations show the available geographical locations for each of the following cloud providers:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Amazon Web Services (AWS)`}),`\n`,_jsx(_components.li,{children:`Google Cloud Platform (GCP)`}),`\n`,_jsx(_components.li,{children:`Microsoft Azure`}),`\n`,_jsx(_components.li,{children:`Oracle Cloud Infrastructure (OCI)`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Locations are scoped to an `,_jsx(_components.a,{href:`/reference/org`,children:`org`}),`, and an org administrator enables or disables the ones a `,_jsx(_components.a,{href:`/reference/gvc`,children:`GVC`}),` may select.`]}),`\n`,_jsxs(_components.p,{children:[`A new org is seeded with a working subset of the built-in catalog, and every location present in an org starts enabled. Disabling a location removes the `,_jsx(_components.a,{href:`/concepts/workload`,children:`workloads`}),` running in it; enabling one provisions every workload whose GVC selects it.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`If a company is restricted for legal or compliance reasons to only use certain cloud providers, disabling those providers will ensure that workloads will not be deployed to those providers.`})}),`\n`,_jsx(Heading,{level:`2`,id:`locations`,children:`Locations`}),`\n`,_jsx(_components.p,{children:`Control Plane can enable any cloud provider location.`}),`\n`,_jsxs(_components.p,{children:[`If a location is not shown, email `,_jsx(_components.a,{href:`mailto:support@controlplane.com`,children:`support@controlplane.com`}),` with the provider and location and it will be provisioned.`]}),`\n`,_jsx(Heading,{level:`2`,id:`custom-locations`,children:`Custom Locations`}),`\n`,_jsxs(_components.p,{children:[`CPLN BYOK enables you to add new locations by registering your own Kubernetes clusters as locations in the Control Plane platform.\nFor a guide on how to create new BYOK locations and further details, `,_jsx(_components.a,{href:`/byok/overview`,children:`refer to the BYOK documentation`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`built-in-tags`,children:`Built-in Tags`}),`\n`,_jsxs(_components.p,{children:[`Each location has the following built-in `,_jsx(_components.a,{href:`/core/misc#tags`,children:`tags`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`cpln/city=VALUE`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`cpln/state=VALUE`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`cpln/country=VALUE`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`cpln/continent=VALUE`})}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`These are set from the location’s geographic coordinates, so a `,_jsx(_components.a,{href:`/reference/gvc`,children:`GVC`}),` can select locations with a `,_jsx(_components.a,{href:`/core/query`,children:`query`}),` on them instead of naming each one.`]}),`\n`,_jsx(Heading,{level:`2`,id:`public-ips`,children:`Public IPs`}),`\n`,_jsx(_components.p,{children:`The list of public IPs for each cloud provider and region can be obtained.`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Console UI`,id:`console-ui`,children:_jsxs(_components.p,{children:[`Navigate to the `,_jsx(_components.code,{children:`Locations`}),` list page from the main navigation bar.\nSelect a location to view the IP ranges listed on the `,_jsx(_components.code,{children:`Info`}),` page.`]})}),_jsxs(Tab,{title:`CLI`,id:`cli`,children:[_jsx(_components.p,{children:`Use the command below to view the IP ranges of all locations.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cpln`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` location`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` get`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` json`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`The output can also be formatted as YAML by using the flag `,_jsx(_components.code,{children:`-o yaml`}),` instead of `,_jsx(_components.code,{children:`-o json`}),`.`]}),_jsx(_components.p,{children:`To view a single location, name it:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cpln`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` location`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` get`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` aws-us-west-2`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` json`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/cli-reference/commands/location`,children:`CLI location command reference`}),` for more details.`]})]}),_jsxs(Tab,{title:`API`,id:`api`,children:[_jsxs(_components.p,{children:[`The location list endpoint and location-specific endpoint return the location object with the `,_jsx(_components.code,{children:`ipRanges`}),` property.`]}),_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/api-reference/location/get-all-locations`,children:`Get All Locations API endpoint`}),` for details.`]})]})]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.p,{children:`The list of IPs may be required by external services that restrict which IPs are allowed to access them.`}),_jsx(_components.p,{children:`The IPs may change when underlying infrastructure changes. Control Plane recommends automating location API checks and updating external services’ allowed IP address lists when changes occur.`})]}),`\n`,_jsx(Heading,{level:`2`,id:`permissions`,children:`Permissions`}),`\n`,_jsxs(_components.p,{children:[`The permissions below are used to define `,_jsx(_components.a,{href:`/reference/policy`,children:`policies`}),` together with one or more of the four `,_jsx(_components.a,{href:`/concepts/access-control`,children:`principal types`}),`:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Permission`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Description`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Implies`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`create`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Create new locations`}),_jsx(_components.td,{style:{textAlign:`left`}})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`delete`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Delete BYOK locations`}),_jsx(_components.td,{style:{textAlign:`left`}})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`edit`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Modify existing locations`}),_jsx(_components.td,{style:{textAlign:`left`},children:`view`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`manage`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Full access`}),_jsx(_components.td,{style:{textAlign:`left`},children:`create, delete, edit, use, view`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`use`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Use this location for workload placement`}),_jsx(_components.td,{style:{textAlign:`left`},children:`view`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`view`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Read-only access`}),_jsx(_components.td,{style:{textAlign:`left`}})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`access-report`,children:`Access Report`}),`\n`,_jsxs(_components.p,{children:[`Displays the permissions granted to principals for the location. See `,_jsx(_components.a,{href:`/concepts/access-control#access-report`,children:`Access Report`}),` for what each entry shows, how to open it from the Console, CLI, or API, and how groups, query targets, and implied permissions appear in it.`]}),`\n`,_jsx(Heading,{level:`2`,id:`cli`,children:`CLI`}),`\n`,_jsxs(_components.p,{children:[`To view the CLI documentation for locations, see the `,_jsx(_components.a,{href:`/cli-reference/commands/location`,children:`Location CLI reference`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Location","description":"Available geographical locations across AWS, GCP, Azure, and OCI that can be enabled or disabled for GVC workload deployment.","keywords":["region","cloud region","frankfurt","us-east","eu-west","tokyo","singapore","enabled regions","cpln location","byok location"],"href":"/reference/location"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Locations","slug":"locations","depth":2,"children":[]},{"title":"Custom Locations","slug":"custom-locations","depth":2,"children":[]},{"title":"Built-in Tags","slug":"built-in-tags","depth":2,"children":[]},{"title":"Public IPs","slug":"public-ips","depth":2,"children":[]},{"title":"Permissions","slug":"permissions","depth":2,"children":[]},{"title":"Access Report","slug":"access-report","depth":2,"children":[]},{"title":"CLI","slug":"cli","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/controlplanecorporation/20452e834d3719a6/content/legacy-cli-hash-redirects.js","/_mintlify/custom/controlplanecorporation/dd1961f62f732454/content/sync-tabs.js"],"subdomain":"controlplanecorporation","siteName":"Control Plane","title":"Location - Control Plane","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-15T04:52:49.130Z","originalFileLocation":"reference/location.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Available geographical locations across AWS, GCP, Azure, and OCI that can be enabled or disabled for GVC workload deployment.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Control Plane\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/controlplanecorporation/N_jUg8p-q778yjKC/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/controlplanecorporation/N_jUg8p-q778yjKC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/controlplanecorporation/N_jUg8p-q778yjKC/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/controlplanecorporation/N_jUg8p-q778yjKC/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/controlplanecorporation/N_jUg8p-q778yjKC/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/controlplanecorporation/N_jUg8p-q778yjKC/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/controlplanecorporation/N_jUg8p-q778yjKC/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/controlplanecorporation/N_jUg8p-q778yjKC/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/controlplanecorporation/N_jUg8p-q778yjKC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Location - Control Plane\">\u003cmeta data-mint-head property=\"og:description\" content=\"Available geographical locations across AWS, GCP, Azure, and OCI that can be enabled or disabled for GVC workload deployment.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Control Plane\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.controlplane.com/reference/location\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://controlplanecorporation.mintlify.app/_mintlify/api/og/v2?division=Reference\u0026amp;title=Location\u0026amp;description=Available+geographical+locations+across+AWS%2C+GCP%2C+Azure%2C+and+OCI+that+can+be+enabled+or+disabled+for+GVC+workload+deployment.\u0026amp;theme=5c8c59bec2193070854fc823\u0026amp;signature=4f42e4dee0bb877581f6351c744a015ee17ef7ec69688f063bf5ca695f637309\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Location - Control Plane\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Available geographical locations across AWS, GCP, Azure, and OCI that can be enabled or disabled for GVC workload deployment.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://controlplanecorporation.mintlify.app/_mintlify/api/og/v2?division=Reference\u0026amp;title=Location\u0026amp;description=Available+geographical+locations+across+AWS%2C+GCP%2C+Azure%2C+and+OCI+that+can+be+enabled+or+disabled+for+GVC+workload+deployment.\u0026amp;theme=5c8c59bec2193070854fc823\u0026amp;signature=4f42e4dee0bb877581f6351c744a015ee17ef7ec69688f063bf5ca695f637309\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/controlplanecorporation/N_jUg8p-q778yjKC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Control Plane\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1563ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.controlplane.com/reference/location\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/location.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.controlplane.com/#organization\",\"name\":\"Control Plane\",\"url\":\"https://docs.controlplane.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/controlplanecorporation/hwvJiAoqIziVJ3gK/logos/dark.svg?fit=max\u0026auto=format\u0026n=hwvJiAoqIziVJ3gK\u0026q=85\u0026s=ec7b5a4bb958adc4d92dedfb41ab2e3c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.controlplane.com#website\",\"name\":\"Control Plane\",\"url\":\"https://docs.controlplane.com\",\"publisher\":{\"@id\":\"https://docs.controlplane.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.controlplane.com/reference/location#webpage\",\"url\":\"https://docs.controlplane.com/reference/location\",\"name\":\"Location\",\"description\":\"Available geographical locations across AWS, GCP, Azure, and OCI that can be enabled or disabled for GVC workload deployment.\",\"dateModified\":\"2026-10-15T04:52:49.130Z\",\"isPartOf\":{\"@id\":\"https://docs.controlplane.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.controlplane.com/reference/location#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.controlplane.com/reference/location#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.controlplane.com/reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Location\",\"item\":\"https://docs.controlplane.com/reference/location\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.controlplane.com/reference/location#article\",\"headline\":\"Location\",\"name\":\"Location\",\"description\":\"Available geographical locations across AWS, GCP, Azure, and OCI that can be enabled or disabled for GVC workload deployment.\",\"url\":\"https://docs.controlplane.com/reference/location\",\"mainEntityOfPage\":{\"@id\":\"https://docs.controlplane.com/reference/location#webpage\"},\"dateModified\":\"2026-10-15T04:52:49.130Z\",\"keywords\":\"region, cloud region, frankfurt, us-east, eu-west, tokyo, singapore, enabled regions, cpln location, byok location\",\"publisher\":{\"@id\":\"https://docs.controlplane.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.controlplane.com#website\"}}]}\u003c/script>","siteName":"Control Plane","nav":{"global":{"anchors":[{"anchor":"Website","icon":"compass","href":"https://controlplane.com"},{"anchor":"Status","icon":"signal","href":"https://status.cpln.io/"},{"anchor":"Blog","icon":"newspaper","href":"https://controlplane.com/blog"},{"anchor":"FAQ","icon":"question","href":"https://controlplane.com/faq"},{"anchor":"Product Demos","icon":"video","href":"https://controlplane.com/product-demos"}]},"tabs":[{"tab":"Home","groups":[{"group":"Getting Started","icon":"circle-play","pages":[{"title":"Introduction","href":"/introduction"},{"title":"What is Control Plane?","href":"/whatis"},{"title":"Release Notes","href":"/releases"},{"title":"Compliance","href":"/compliance"}]},{"group":"Quickstart","icon":"rocket","pages":[{"title":"Quickstart","sidebarTitle":"Overview","href":"/quickstart/overview"},{"title":"1. Deploy your first workload","href":"/quickstart/deploy-workload"},{"title":"2. Deploy your own application","href":"/quickstart/deploy-application"},{"title":"3. Service-to-service communication","sidebarTitle":"3. Connect two workloads","href":"/quickstart/connect-workloads"},{"title":"4. Add a database and wire its secret","sidebarTitle":"4. Add a database and secret","href":"/quickstart/database-and-secrets"},{"title":"5. Observe your workload","href":"/quickstart/observe-workload"},{"title":"6. Configure a custom domain","sidebarTitle":"6. Custom domain","tag":"Optional","href":"/quickstart/custom-domain"}]},{"group":"Concepts","icon":"lightbulb","pages":[{"title":"Access Control","href":"/concepts/access-control"},{"title":"Billing Account","href":"/concepts/billing"},{"title":"Command","href":"/concepts/command"},{"title":"Deployment","href":"/concepts/deployment"},{"title":"GVC (Global Virtual Cloud)","href":"/concepts/gvc"},{"title":"Identity","href":"/concepts/identity"},{"title":"Location","href":"/concepts/location"},{"title":"Org (Organization)","href":"/concepts/org"},{"title":"Quota","href":"/concepts/quota"},{"title":"Replica","href":"/concepts/replica"},{"title":"Resource Model","href":"/concepts/resource-model"},{"title":"Workload","href":"/concepts/workload"}]},{"group":"Core","icon":"toolbox","pages":[{"title":"Audit Trail","href":"/core/audittrail"},{"title":"Authentication","href":"/core/authentication"},{"title":"Kubernetes Operator","href":"/core/kubernetes-operator"},{"title":"Logs","href":"/core/logs"},{"title":"Misc","href":"/core/misc"},{"title":"Query","href":"/core/query"},{"title":"Security","href":"/core/security"}]},{"group":"Reference","icon":"book-open","pages":[{"title":"Overview","href":"/reference/overview"},{"title":"Agent","href":"/reference/agent"},{"title":"Audit Context","href":"/reference/auditctx"},{"title":"Billing API","href":"/reference/billing-api"},{"title":"Certificate Generator","href":"/reference/certificategenerator"},{"title":"Cloud Account","href":"/reference/cloudaccount"},{"title":"Deployment","href":"/reference/deployment"},{"title":"Domain","href":"/reference/domain"},{"title":"Error Messages","href":"/reference/error-messages"},{"title":"Event Log","href":"/reference/events"},{"title":"Group","href":"/reference/group"},{"title":"GVC (Global Virtual Cloud)","href":"/reference/gvc"},{"title":"Identity","href":"/reference/identity"},{"title":"Image","href":"/reference/image"},{"title":"IP Set","description":"Reserve and manage public IP addresses per GVC location for workloads, including binding, permissions, and configuration options.","href":"/reference/ipset"},{"title":"Location","href":"/reference/location"},{"group":"Org","pages":[{"title":"Org (Organization)","sidebarTitle":"Overview","description":"Reference for orgs, the top-level isolated context encompassing all Control Plane resources including domains, images, workloads, and users.","href":"/reference/org"},{"group":"External Logging","pages":[{"title":"Overview","href":"/external-logging/overview"},{"title":"Amazon S3","href":"/external-logging/s3"},{"title":"CloudWatch","href":"/external-logging/cloudwatch"},{"title":"Coralogix","href":"/external-logging/coralogix"},{"title":"Datadog","href":"/external-logging/datadog"},{"title":"Elastic","href":"/external-logging/elastic"},{"title":"Fluentd","href":"/external-logging/fluentd"},{"title":"Logz.io","href":"/external-logging/logz-io"},{"title":"Loki","href":"/external-logging/loki"},{"title":"Stackdriver","href":"/external-logging/stackdriver"},{"title":"Syslog","href":"/external-logging/syslog"},{"title":"OpenTelemetry","href":"/external-logging/opentelemetry"}]}]},{"title":"Policy","href":"/reference/policy"},{"title":"Quota","href":"/reference/quota"},{"title":"Secret","href":"/reference/secret"},{"title":"Service Account","href":"/reference/serviceaccount"},{"title":"Usage API","href":"/reference/usage-api"},{"title":"User","href":"/reference/user"},{"title":"Volume Set","href":"/reference/volumeset"},{"group":"Workload","pages":[{"title":"General","href":"/reference/workload/general"},{"title":"Autoscaling","href":"/reference/workload/autoscaling"},{"title":"Capacity AI","href":"/reference/workload/capacity"},{"title":"Containers","href":"/reference/workload/containers"},{"title":"Custom Metrics","href":"/reference/workload/custom-metrics"},{"title":"Firewall","href":"/reference/workload/firewall"},{"title":"JWT Authentication","href":"/reference/workload/jwt-auth"},{"title":"Load Balancing","href":"/reference/workload/load-balancing"},{"title":"Security","href":"/reference/workload/security"},{"title":"Termination Sequence","href":"/reference/workload/termination"},{"title":"Types","href":"/reference/workload/types"},{"title":"Virtual Machines","href":"/reference/workload/vm"},{"title":"Volumes","href":"/reference/workload/volumes"}]}]}]},{"tab":"How-to Guides","pages":[{"title":"How-to Guides","href":"/guides/overview"}]},{"tab":"Template Catalog","pages":[{"title":"Template Catalog","href":"/template-catalog/overview"}]},{"tab":"Managed Kubernetes","pages":[{"title":"Managed Kubernetes","href":"/mk8s/overview"}]},{"tab":"CPLN BYOK","pages":[{"title":"CPLN BYOK","href":"/byok/overview"}]},{"tab":"AI Agents","pages":[{"title":"AI Agents","href":"/ai/overview"}]},{"tab":"Infra as Code","pages":[{"title":"Infra as Code","href":"/iac/overview"}]},{"tab":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli-reference/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/api"}]}]},"basePath":"","title":"Location - Control Plane","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}
