× Install ThecoreGrid App
Tap below and select "Add to Home Screen" for full-screen experience.
B2B Engineering Insights & Architectural Teardowns

Retained bridge share for AWS Organizations

Retained bridge share in AWS Organizations helps maintain access to resources when an account moves between organizations. In this scheme, not only the transition itself is important, but also how the system preserves the control plane without unnecessary duplication of permissions.

When accounts move between AWS Organizations, it is not the computational part that breaks, but the trust relationship. For resources managed by AWS Resource Access Manager (AWS RAM), this is critical: the organization-dependent association is removed as soon as the account leaves the original organization. As a result, the workload may continue to run, but management operations begin to fail. This is how degradation manifests: the data plane is alive, but the control plane has already lost access.

In the original scenario, the company was migrating 382 AWS accounts and simultaneously needed to retain AWS Lake Formation permissions. This was not an abstract refactoring of the structure. Amid the migration, there was a corporate split followed by an acquisition, so the margin for error was narrow. When the production wave terraform apply to the shared AWS Transit Gateway returned a permission error, the main limitation of such migration became evident: network traffic may not be interrupted, but the engineer can no longer change the shared resource. For infrastructure, this is more dangerous than it appears at first glance.

The choice was pragmatic: retained bridge share

AWS and the customer team chose the retained bridge share pattern. The idea is to create an external association for the same consumer account in advance, and only then move the account between organizations. Such a bridge is independent of membership in the original organization, so it survives the transition. After the migration, the account is returned to the original share, access is verified, and the temporary bridge is removed.

There is an important trade-off here. The bridge share maintains continuity, but it must not become a new source of truth. The source of truth remains the original AWS Lake Formation share. Otherwise, two permission paths may emerge, which could diverge. This would create drift, complicate auditing, and make it unclear which association is authoritative. Therefore, the bridge is needed only as a migration-only copy, not as a permanent layer of abstraction.

How it was implemented in practice

AWS and the customer team designed and validated the scheme in two weeks. Before production, they conducted 14 non-production waves, followed by a production pilot, 12 weekly production waves, and three additional contingency waves. This rhythm indicates that the issue was not with a single resource but with a repeatable migration mechanism. In a production environment, this is especially important because the test environment does not always cross the same trust boundary.

Technically, the scheme relied on the behavior of AWS RAM. For shares outside the organization, AWS RAM sends an invitation, and after acceptance, the association becomes external. Such an association is independent of membership and does not disappear when the account leaves the original organization. Later, AWS released the RetainSharingOnAccountLeaveOrganization setting for new shares. However, the customer confirmed that it does not retroactively apply to existing shares, so a parallel share was needed for already created resources. AWS RAM allows one resource to belong to multiple resource shares, and this became the foundation of the bridge pattern.

Part of the work involved AWS Glue Data Catalog and AWS Lake Formation, as well as shared databases, tables, and AWS Transit Gateway. This is an important detail: different services respond to the break in association differently. In some cases, the data plane continues to operate, while in others, separate recovery of control-plane access is required. Therefore, automation handled not only the transfer but also the restoration of principal-to-share mapping, dry-run and execute modes, and then the removal of the bridge only after verifying that the original share was active again and covered the necessary principals, resources, and permissions.

What the solution provided and where the boundaries remain

The result was practical rather than decorative. The customer completed the production migration of the embedded payments platform on July 21, 2026. The TSA with the former parent company ended on schedule in April 2026. There was no customer-facing outage, and no network drops were recorded during production waves. This is more important than any grand statements: the scheme preserved access at the moment when the organization was changing, and the control plane could have fallen out of management.

However, this solution has an operational discipline. After each move, principals must be returned to the original share, access and connectivity must be verified, and only then can the bridge be removed. Otherwise, the temporary permission path begins to live its own life. Additionally, the team utilized a weekly post-migration sweep, AWS RAM events in Amazon EventBridge, and AWS CloudTrail to monitor DisassociateResourceShare API calls. They also temporarily adjusted the service control policy that blocked ram:AcceptResourceShareInvitation during migration windows. This is a typical example of how migration between organizations requires not just one mechanism, but a combination of inventory, dry-run-first automation, and post-move validation.

The takeaway here is simple. If the production environment depends on AWS RAM, then it is necessary to check not only the compatibility of services but also the trust boundary itself. The bridge share does not resolve architectural complexity but provides a managed way to navigate through it without losing access. For enterprise migration, this is not a universal recipe but a careful, tested compromise.

Reference source

×

🚀 Deploy the Blocks

Controls: ← → to move, ↑ to rotate, ↓ to drop.
Mobile: use buttons below.