To upgrade the infra organization "root" to version "1.14.3-gdch.1000-1", run:
gdcloud organization upgrade rollout --version=1.14.3-gdch.1000-1 --names=root
To upgrade an organizations "org-1" and "org-2" to version "1.14.3-gdch.1000-1", run:
gdcloud organization upgrade rollout --version=1.14.3-gdch.1000-1 --names=org-1,org-2,... --zone=zone1
To upgrade all eligible organizations in zone1 to version "1.14.3-gdch.1000-1", run:
gdcloud organization upgrade rollout --version=1.14.3-gdch.1000-1 --all --zone=zone1
Root organization must be at the new version or greater, before a version is available to any other organizations in a zone.
OPTIONAL FLAGS
-a, --all Upgrade all organizations in the given zone.
--direct Rollout OC changes to the specified organization(s) directly.
--distribute-artifacts Distribute artifacts to a tenant org before rolling out to the org directly.
--ignore-maintenance-window Ignore maintenance window for tenant organization upgrade.
-n, --names strings Comma-separated list of organizations to trigger upgrade for.
--skip-checks Skip preflight and postflight checks for organization upgrade.
--version string Version to upgrade to.
-z, --zone string Zone to rollout upgrade for.
GDCLOUD WIDE FLAGS
These flags are available to all commands: --configuration, --format, --help, --project, --quiet.
[[["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-08-29 UTC."],[[["\u003cp\u003eThe \u003ccode\u003egdcloud organizations upgrade rollout\u003c/code\u003e command initiates an upgrade to a specified version for selected organizations.\u003c/p\u003e\n"],["\u003cp\u003eYou can target specific organizations for upgrade using the \u003ccode\u003e--names\u003c/code\u003e flag, listing them in a comma-separated format.\u003c/p\u003e\n"],["\u003cp\u003eUpgrading all eligible organizations within a zone is possible using the \u003ccode\u003e--all\u003c/code\u003e flag in conjunction with \u003ccode\u003e--zone\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e--version\u003c/code\u003e flag determines the target version for the upgrade, and the root organization must be upgraded before any others in a zone.\u003c/p\u003e\n"],["\u003cp\u003eThe --zone flag is used to specify the zone that you are targeting.\u003c/p\u003e\n"]]],[],null,["# gdcloud organizations upgrade rollout\n\nNAME\n----\n\ngdcloud organizations upgrade rollout - Trigger an upgrade to a new version for the specified organization(s).\n\nSYNOPSIS\n--------\n\n gdcloud organizations upgrade rollout --version=VERSION --names=ORG_NAME1,ORG_NAME2,... --zone=ZONE_NAME [flags]\n\n### EXAMPLES\n\n\n To upgrade the infra organization \"root\" to version \"1.14.3-gdch.1000-1\", run:\n\n gdcloud organization upgrade rollout --version=1.14.3-gdch.1000-1 --names=root\n\n To upgrade an organizations \"org-1\" and \"org-2\" to version \"1.14.3-gdch.1000-1\", run:\n\n gdcloud organization upgrade rollout --version=1.14.3-gdch.1000-1 --names=org-1,org-2,... --zone=zone1\n\n To upgrade all eligible organizations in zone1 to version \"1.14.3-gdch.1000-1\", run:\n\n gdcloud organization upgrade rollout --version=1.14.3-gdch.1000-1 --all --zone=zone1\n\n Root organization must be at the new version or greater, before a version is available to any other organizations in a zone.\n\n### OPTIONAL FLAGS\n\n -a, --all Upgrade all organizations in the given zone.\n --direct Rollout OC changes to the specified organization(s) directly.\n --distribute-artifacts Distribute artifacts to a tenant org before rolling out to the org directly.\n --ignore-maintenance-window Ignore maintenance window for tenant organization upgrade.\n -n, --names strings Comma-separated list of organizations to trigger upgrade for.\n --skip-checks Skip preflight and postflight checks for organization upgrade.\n --version string Version to upgrade to.\n -z, --zone string Zone to rollout upgrade for.\n\n### GDCLOUD WIDE FLAGS\n\nThese flags are available to all commands: `--configuration`, `--format`, `--help`, `--project`, `--quiet`.\n\nFor more information, see the [gdcloud CLI reference overview](/distributed-cloud/hosted/docs/latest/gdch/resources/gdcloud-reference/gdcloud) page."]]
