Reset the landing zone to resolve drift
When you create your landing zone, the landing zone and all the organizational units (OUs), accounts, and resources are compliant with the governance rules enforced by your chosen controls. As you and your organization members use the landing zone, changes in this compliance status may occur. These changes are called drift.
To identify if your landing zone is in drift, you can call the GetLandingZone
API. This API returns
the landing zone's drift status of DRIFTED
or IN_SYNC
.
To resolve drift within your landing zone you can use the ResetLandingZone
API to reset the landing zone back to its original configuration.
For example, AWS Control Tower enables IAM Identity Center by default to help you manage your AWS accounts-- but if you configure your
original landing zone parameters with IAM Identity Center disabled, calling ResetLandingZone
maintains that disabled IAM Identity Center configuration.
You can only use the ResetLandingZone
API if you are using the latest available landing zone version. You can call the
GetLandingZone
API and compare your landing zone version with the latest available version. If necessary,
you can Update your landing zone so your landing zone uses the latest available version. In these examples, we are using version 3.3 as the latest version.
-
Call the
GetLandingZone
API. If the API returns a drift status ofDRIFTED
, your landing zone is in drift. -
Call the
ResetLandingZone
API to reset your landing zone to its original configuration.aws controltower reset-landing-zone --landing-zone-identifier "arn:aws:controltower:us-west-2:123456789123:landingzone/1A2B3C4D5E6F7G8H"
Output:
{ "operationIdentifier": "55XXXXXX-e2XX-41XX-a7XX-446XXXXXXXXX" }
Note
Resetting the landing zone does not update the landing zone version. Review Update your landing zone for details about updating the landing zone version.