Roles and permissions
These are the built-in roles for the Topology service. Each row lists a role, what it
grants, and the exact permissions it includes. Roles are system-defined (built-in) or
custom; permissions are system-defined and read-only. The platform-wide Viewer,
Editor, and Admin roles also apply across every service; see the
roles and permissions catalogue. You can also compose
a custom role from any of these permissions.
Two things are specific to topology. Regions are managed by discovery, so they are
read-only: there is no permission to create, update, or delete a region, only to read one.
And the location lifecycle (approve, enable, disable) is the write surface that
moves a region, zone, or multi-region between pending, active, and disabled.
| Role | Included permissions |
|---|---|
| Topology Viewer Read-only access to all topology resources | topology.location.gettopology.location.listtopology.multiregion.gettopology.multiregion.listtopology.node.gettopology.node.listtopology.nodepool.gettopology.nodepool.listtopology.operation.gettopology.operation.listtopology.region.gettopology.region.listtopology.zone.gettopology.zone.list |
| Topology Editor Read and write access (no deletes or lifecycle approvals) | topology.location.gettopology.location.listtopology.multiregion.createtopology.multiregion.gettopology.multiregion.listtopology.multiregion.updatetopology.node.createtopology.node.gettopology.node.listtopology.node.updatetopology.nodepool.createtopology.nodepool.gettopology.nodepool.listtopology.nodepool.updatetopology.operation.gettopology.operation.listtopology.region.gettopology.region.listtopology.zone.createtopology.zone.gettopology.zone.listtopology.zone.update |
| Topology Admin Full access to all topology resources | topology.location.approvetopology.location.disabletopology.location.enabletopology.location.gettopology.location.listtopology.multiregion.createtopology.multiregion.deletetopology.multiregion.gettopology.multiregion.listtopology.multiregion.updatetopology.node.createtopology.node.deletetopology.node.gettopology.node.listtopology.node.updatetopology.nodepool.createtopology.nodepool.deletetopology.nodepool.gettopology.nodepool.listtopology.nodepool.updatetopology.operation.gettopology.operation.listtopology.region.gettopology.region.listtopology.zone.createtopology.zone.deletetopology.zone.gettopology.zone.listtopology.zone.update |
| Location Viewer Read locations and resolve placement | topology.location.gettopology.location.listtopology.operation.gettopology.operation.list |
| Location Editor Read and run the location lifecycle (approve, enable, disable) | topology.location.approvetopology.location.disabletopology.location.enabletopology.location.gettopology.location.listtopology.operation.gettopology.operation.list |
| Location Admin Full access to locations (locations have no destructive operation, so this matches Location Editor) | topology.location.approvetopology.location.disabletopology.location.enabletopology.location.gettopology.location.listtopology.operation.gettopology.operation.list |
| Region Viewer View regions (regions are discovery-managed and read-only) | topology.operation.gettopology.operation.listtopology.region.gettopology.region.list |
| MultiRegion Viewer View multi-regions | topology.multiregion.gettopology.multiregion.listtopology.operation.gettopology.operation.list |
| MultiRegion Editor View and manage multi-regions | topology.multiregion.createtopology.multiregion.gettopology.multiregion.listtopology.multiregion.updatetopology.operation.gettopology.operation.list |
| MultiRegion Admin Full access to multi-regions | topology.multiregion.createtopology.multiregion.deletetopology.multiregion.gettopology.multiregion.listtopology.multiregion.updatetopology.operation.gettopology.operation.list |
| Zone Viewer View zones | topology.operation.gettopology.operation.listtopology.zone.gettopology.zone.list |
| Zone Editor View and manage zones | topology.operation.gettopology.operation.listtopology.zone.createtopology.zone.gettopology.zone.listtopology.zone.update |
| Zone Admin Full access to zones | topology.operation.gettopology.operation.listtopology.zone.createtopology.zone.deletetopology.zone.gettopology.zone.listtopology.zone.update |
| NodePool Viewer View node pools | topology.nodepool.gettopology.nodepool.listtopology.operation.gettopology.operation.list |
| NodePool Editor View and manage node pools | topology.nodepool.createtopology.nodepool.gettopology.nodepool.listtopology.nodepool.updatetopology.operation.gettopology.operation.list |
| NodePool Admin Full access to node pools | topology.nodepool.createtopology.nodepool.deletetopology.nodepool.gettopology.nodepool.listtopology.nodepool.updatetopology.operation.gettopology.operation.list |
| Node Viewer View nodes | topology.node.gettopology.node.listtopology.operation.gettopology.operation.list |
| Node Editor View and manage nodes | topology.node.createtopology.node.gettopology.node.listtopology.node.updatetopology.operation.gettopology.operation.list |
| Node Admin Full access to nodes | topology.node.createtopology.node.deletetopology.node.gettopology.node.listtopology.node.updatetopology.operation.gettopology.operation.list |