---
title: "IAM"
description: "The IAM actions and managed policies for instances, SSH keys, volumes, snapshots, network interfaces, IPv4 addresses and firewalls, and what a launch checks."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IAM

Compute's resources belong to four action namespaces: `compute` (instances, SSH keys), `blockstore`
(volumes, snapshots), `network` (network interfaces, IPv4 addresses, VPCs and subnets) and `firewall`. Access is
granted with [policies](/iam/policies), attached directly or through groups.

## Managed policies

| Policy | Grants |
| --- | --- |
| `ComputeFullAccess` | Launch, change, start, stop, reboot, resize and terminate instances, attach volumes and network interfaces, use their consoles, and manage SSH keys and compute settings |
| `ComputeReadOnlyAccess` | View instances, SSH keys, compute settings and operations. Not console output or consoles |
| `ComputeConsoleAccess` | View instances, read their console output and connect to their serial and VNC consoles |
| `BlockstoreFullAccess` | Create, change, resize, attach, detach and delete volumes; create, restore and delete snapshots |
| `BlockstoreReadOnlyAccess` | View volumes, snapshots and their operations |
| `NetworkFullAccess` | Create, change, attach and delete network interfaces, set their firewalls and manage their private addresses; manage VPCs and subnets; allocate, associate, disassociate and release IPv4 addresses |
| `NetworkReadOnlyAccess` | View network interfaces, IPv4 addresses, VPCs and subnets |
| `FirewallFullAccess` | Create, change and delete firewalls, edit their rules, and attach them to network interfaces and detach them |
| `FirewallReadOnlyAccess` | View firewalls, their rules and attachments, and network interfaces' effective rules |

`ReadOnlyAccess` has every list and view action here, but not console output or consoles: boot
output can hold secrets. `AdministratorAccess` has everything.

## Launching

A launch is checked as you, for every resource it makes or uses, before anything is reserved:

| Action | On |
| --- | --- |
| `compute.instances.create` | The project |
| `compute.sshKeys.use` | Each SSH key |
| `bots.pass` | The bot, when the launch attaches [one](/compute/instance-bots) |
| `images.images.resolve` | The project (in `ReadOnlyAccess` and `ImagesReadOnlyAccess`) |
| `blockstore.volumes.create`, `blockstore.volumes.attach` | The root volume and each new volume; `attach` on each existing volume |
| `blockstore.snapshots.restore` | The snapshot, for a root volume restored from one |
| `network.networkInterfaces.create` | The project, for each new interface, private ones included |
| `network.publicIps.allocate` | The project, for each new interface with IPv4 |
| `network.networkInterfaces.attach` | Each existing interface |
| `firewall.firewalls.attach` | Each firewall, the default firewall included |

So launching needs `ComputeFullAccess`, `BlockstoreFullAccess`, `NetworkFullAccess`,
`FirewallFullAccess` and `ReadOnlyAccess` (or `ImagesReadOnlyAccess`), or a policy with these
actions. A denial is `403 access_denied` naming the action. Attaching and detaching a volume or
interface later also needs both sides: `compute.instances.attachVolume` and
`blockstore.volumes.attach`, for example.

## Resource names

Actions are checked against the resource, so a policy can grant them on one instance, volume or
firewall. A resource's name is on its page in the console, and in its `resourceName`:

```
ezgh:us-west-1:org_k3f9a0x2m7qp:prj_g7h8i9j0k1l2:ins_7k2m9x0a4qpe
```

| Resource | Pattern |
| --- | --- |
| Instance | `…:prj_<project>:ins_<id>` |
| SSH key | `…:prj_<project>:ssh_<id>` |
| Volume | `…:prj_<project>:vol_<id>` |
| Snapshot | `…:prj_<project>:snp_<id>` |
| Network interface | `…:prj_<project>:eni_<id>` |
| IPv4 address | `…:prj_<project>:pip_<id>` |
| Firewall | `…:prj_<project>:fwl_<id>` |

For example, to let a bot stop and start the instances in a project but nothing else:

```json
{
  "statements": [
    {
      "effect": "allow",
      "actions": ["compute.instances.list", "compute.instances.get", "compute.instances.start", "compute.instances.stop"],
      "resources": ["ezgh:*:org_k3f9a0x2m7qp:prj_g7h8i9j0k1l2", "ezgh:us-west-1:org_k3f9a0x2m7qp:prj_g7h8i9j0k1l2:ins_*"]
    }
  ]
}
```

## Actions

### Compute

| Action | Allows | Checked against | Managed policies |
| --- | --- | --- | --- |
| `compute.instances.list` | List instances | The project | `ReadOnlyAccess`, `ComputeFullAccess`, `ComputeReadOnlyAccess` |
| `compute.instances.get` | View instances and their operations | The instance | `ReadOnlyAccess`, `ComputeFullAccess`, `ComputeReadOnlyAccess`, `ComputeConsoleAccess` |
| `compute.instances.create` | Launch instances | The project | `ComputeFullAccess` |
| `compute.instances.update` | Rename and tag instances | The instance | `ComputeFullAccess` |
| `compute.instances.start` | Start instances | The instance | `ComputeFullAccess` |
| `compute.instances.stop` | Stop instances | The instance | `ComputeFullAccess` |
| `compute.instances.reboot` | Reboot instances | The instance | `ComputeFullAccess` |
| `compute.instances.resize` | Change instances' instance type | The instance | `ComputeFullAccess` |
| `compute.instances.terminate` | Terminate instances | The instance | `ComputeFullAccess` |
| `compute.instances.getConsoleOutput` | Read instances' console output | The instance | `ComputeFullAccess`, `ComputeConsoleAccess` |
| `compute.instances.connectSerialConsole` | Connect to instances' serial consoles | The instance | `ComputeFullAccess`, `ComputeConsoleAccess` |
| `compute.instances.connectVncConsole` | Connect to instances' VNC consoles | The instance | `ComputeFullAccess`, `ComputeConsoleAccess` |
| `compute.instances.attachVolume` | Attach volumes to stopped instances | The instance | `ComputeFullAccess` |
| `compute.instances.detachVolume` | Detach volumes from stopped instances | The instance | `ComputeFullAccess` |
| `compute.instances.attachNetworkInterface` | Attach network interfaces to stopped instances | The instance | `ComputeFullAccess` |
| `compute.instances.detachNetworkInterface` | Detach network interfaces from stopped instances | The instance | `ComputeFullAccess` |
| `compute.sshKeys.list` | List SSH keys | The project | `ReadOnlyAccess`, `ComputeFullAccess`, `ComputeReadOnlyAccess` |
| `compute.sshKeys.get` | View SSH keys | The SSH key | `ReadOnlyAccess`, `ComputeFullAccess`, `ComputeReadOnlyAccess` |
| `compute.sshKeys.create` | Import SSH keys | The project | `ComputeFullAccess` |
| `compute.sshKeys.update` | Rename and tag SSH keys | The SSH key | `ComputeFullAccess` |
| `compute.sshKeys.delete` | Delete SSH keys | The SSH key | `ComputeFullAccess` |
| `compute.sshKeys.use` | Launch instances with SSH keys | The SSH key | `ComputeFullAccess` |
| `compute.settings.get` | View a project's compute settings | The project | `ReadOnlyAccess`, `ComputeFullAccess`, `ComputeReadOnlyAccess` |
| `compute.settings.update` | Change a project's compute settings | The project | `ComputeFullAccess` |
| `compute.operations.list` | List compute operations | The organization | `ReadOnlyAccess`, `ComputeFullAccess`, `ComputeReadOnlyAccess` |

### Block Storage

| Action | Allows | Checked against | Managed policies |
| --- | --- | --- | --- |
| `blockstore.volumes.list` | List volumes | The project | `ReadOnlyAccess`, `BlockstoreFullAccess`, `BlockstoreReadOnlyAccess` |
| `blockstore.volumes.get` | View volumes and their operations | The volume | `ReadOnlyAccess`, `BlockstoreFullAccess`, `BlockstoreReadOnlyAccess` |
| `blockstore.volumes.create` | Create volumes, including an instance's volumes at launch | The volume | `BlockstoreFullAccess` |
| `blockstore.volumes.update` | Rename and tag volumes and set their deletion protection | The volume | `BlockstoreFullAccess` |
| `blockstore.volumes.modify` | Grow volumes and change their IOPS and throughput | The volume | `BlockstoreFullAccess` |
| `blockstore.volumes.delete` | Delete volumes | The volume | `BlockstoreFullAccess` |
| `blockstore.volumes.attach` | Attach volumes to instances | The volume | `BlockstoreFullAccess` |
| `blockstore.volumes.detach` | Detach volumes from instances | The volume | `BlockstoreFullAccess` |
| `blockstore.snapshots.list` | List snapshots | The project | `ReadOnlyAccess`, `BlockstoreFullAccess`, `BlockstoreReadOnlyAccess` |
| `blockstore.snapshots.get` | View snapshots and their operations | The snapshot | `ReadOnlyAccess`, `BlockstoreFullAccess`, `BlockstoreReadOnlyAccess` |
| `blockstore.snapshots.create` | Create snapshots of volumes | The snapshot | `BlockstoreFullAccess` |
| `blockstore.snapshots.update` | Rename and tag snapshots | The snapshot | `BlockstoreFullAccess` |
| `blockstore.snapshots.delete` | Delete snapshots | The snapshot | `BlockstoreFullAccess` |
| `blockstore.snapshots.restore` | Restore snapshots to new volumes | The snapshot | `BlockstoreFullAccess` |
| `blockstore.operations.list` | List block storage operations | The organization | `ReadOnlyAccess`, `BlockstoreFullAccess`, `BlockstoreReadOnlyAccess` |

### Network

| Action | Allows | Checked against | Managed policies |
| --- | --- | --- | --- |
| `network.networkInterfaces.list` | List network interfaces | The project | `ReadOnlyAccess`, `NetworkFullAccess`, `NetworkReadOnlyAccess` |
| `network.networkInterfaces.get` | View network interfaces | The network interface | `ReadOnlyAccess`, `NetworkFullAccess`, `NetworkReadOnlyAccess` |
| `network.networkInterfaces.create` | Create network interfaces, including an instance's interfaces at launch | The project | `NetworkFullAccess` |
| `network.networkInterfaces.update` | Rename, describe and tag network interfaces | The network interface | `NetworkFullAccess` |
| `network.networkInterfaces.delete` | Delete network interfaces | The network interface | `NetworkFullAccess` |
| `network.networkInterfaces.attach` | Attach network interfaces to instances and detach them | The network interface | `NetworkFullAccess` |
| `network.networkInterfaces.setFirewalls` | Attach firewalls to network interfaces and detach them | The network interface | `NetworkFullAccess` |
| `network.publicIps.list` | List IPv4 addresses | The project | `ReadOnlyAccess`, `NetworkFullAccess`, `NetworkReadOnlyAccess` |
| `network.publicIps.get` | View IPv4 addresses | The IPv4 address | `ReadOnlyAccess`, `NetworkFullAccess`, `NetworkReadOnlyAccess` |
| `network.publicIps.allocate` | Allocate IPv4 addresses | The project | `NetworkFullAccess` |
| `network.publicIps.update` | Rename, tag and set auto-release on IPv4 addresses | The IPv4 address | `NetworkFullAccess` |
| `network.publicIps.associate` | Associate IPv4 addresses with network interfaces | The IPv4 address | `NetworkFullAccess` |
| `network.publicIps.disassociate` | Disassociate IPv4 addresses | The IPv4 address | `NetworkFullAccess` |
| `network.publicIps.release` | Release IPv4 addresses | The IPv4 address | `NetworkFullAccess` |

### Firewall

| Action | Allows | Checked against | Managed policies |
| --- | --- | --- | --- |
| `firewall.firewalls.list` | List firewalls, an interface's firewalls and its effective rules | The project | `ReadOnlyAccess`, `FirewallFullAccess`, `FirewallReadOnlyAccess` |
| `firewall.firewalls.get` | View firewalls and their attachments | The firewall | `ReadOnlyAccess`, `FirewallFullAccess`, `FirewallReadOnlyAccess` |
| `firewall.firewalls.create` | Create firewalls | The project | `FirewallFullAccess` |
| `firewall.firewalls.update` | Rename, describe and tag firewalls | The firewall | `FirewallFullAccess` |
| `firewall.firewalls.delete` | Delete firewalls | The firewall | `FirewallFullAccess` |
| `firewall.firewalls.updateRules` | Add, change, replace and delete firewall rules | The firewall | `FirewallFullAccess` |
| `firewall.firewalls.attach` | Attach firewalls to network interfaces | The firewall | `FirewallFullAccess` |
| `firewall.firewalls.detach` | Detach firewalls from network interfaces | The firewall | `FirewallFullAccess` |

Source: https://docs.ezghcloud.com/compute/iam/index.mdx
