Stay organized with collections
Save and categorize content based on your preferences.
Organization and project are the two available contexts within the
Google Distributed Cloud (GDC) air-gapped appliance resource hierarchy. You can switch
between organizations and projects using gdcloud CLI properties.
View the existing settings
After you initialize the gdcloud CLI, view the existing settings for
your organization and project using the following commands.
List gdcloud CLI properties for the currently active
configuration:
gdcloudconfiglist
Print the organization console URL:
gdcloudconfiggetorganization_console_url
Print the project property:
gdcloudconfiggetproject
Switch between contexts
If you want to switch to a new organization or project context, you can set the
properties either in your active configuration, or in another named
configuration.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThe Google Distributed Cloud (GDC) air-gapped appliance resource hierarchy uses organizations and projects as its two main contexts.\u003c/p\u003e\n"],["\u003cp\u003eYou can view current organization and project settings using \u003ccode\u003egdcloud config list\u003c/code\u003e, \u003ccode\u003egdcloud config get organization_console_url\u003c/code\u003e, and \u003ccode\u003egdcloud config get project\u003c/code\u003e commands.\u003c/p\u003e\n"],["\u003cp\u003eSwitch to a new organization or project within the currently active configuration with the commands \u003ccode\u003egdcloud config set organization_console_url <ORGANIZATION_CONSOLE_URL>\u003c/code\u003e and \u003ccode\u003egdcloud config set project <PROJECT_ID>\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can also create and switch to a new named configuration with its own specific organization and project settings using \u003ccode\u003egdcloud config configurations create\u003c/code\u003e, \u003ccode\u003egdcloud config set\u003c/code\u003e, and \u003ccode\u003egdcloud config configurations activate\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# View and switch context\n\nOrganization and project are the two available contexts within the\nGoogle Distributed Cloud (GDC) air-gapped appliance resource hierarchy. You can switch\nbetween organizations and projects using gdcloud CLI properties.\n\nView the existing settings\n--------------------------\n\nAfter you initialize the gdcloud CLI, view the existing settings for\nyour organization and project using the following commands.\n\nList gdcloud CLI properties for the currently active\n[configuration](/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-manage-configurations): \n\n gdcloud config list\n\nPrint the organization console URL: \n\n gdcloud config get organization_console_url\n\nPrint the project property: \n\n gdcloud config get project\n\nSwitch between contexts\n-----------------------\n\nIf you want to switch to a new organization or project context, you can set the\nproperties either in your active configuration, or in another named\nconfiguration.\n\n### Set properties in the active configuration\n\nSwitch to a new organization: \n\n gdcloud config set organization_console_url \u003cvar translate=\"no\"\u003eORGANIZATION_CONSOLE_URL\u003c/var\u003e\n\nSwitch to a new project: \n\n gdcloud config set project \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\n### Set properties in a new named configuration\n\nAssume you have created a new named configuration `example` which has been set\nwith specific `https://console.example-org.com` and `example-project`: \n\n gdcloud config configurations create \u003cvar translate=\"no\"\u003eexample\u003c/var\u003e\n\n gdcloud config set organization_console_url \u003cvar translate=\"no\"\u003ehttps://console.example-org.com\u003c/var\u003e\n gdcloud config set project \u003cvar translate=\"no\"\u003eexample-project\u003c/var\u003e\n\nThen you can switch to use such contexts by activating the configuration\n`example`: \n\n gdcloud config configurations activate \u003cvar translate=\"no\"\u003eexample\u003c/var\u003e"]]