DigitalOcean
Restrict how your agents can use DigitalOcean.
Require agents to confirm every new Droplet, or let them run only the Droplets you pick.
DigitalOceanOps agent · Acmekc_…c21e
| Permission | Access | Droplets | Only when |
|---|---|---|---|
Droplet · Read droplet.read | Allowed | All Droplets | Any request |
Droplets · Act on every Droplet with a tag droplets.actOnTag | Ask meWaits up to 24 hours | Whole account | Any request |
Database clusters · Read with passwords databases.readConnections | Ask meWaits up to 24 hours | Whole account | Any request |
Allowed goes straight throughAsk me waits for your confirmation
What you can control
Permissions
Each row of a key's DigitalOcean access is one of these, set to Allowed or Ask me. Permissions on a Droplet cover all your Droplets or only the ones you pick.
| Permission | Name in the API |
|---|---|
| Droplet · Read | droplet. |
| Droplet · Reboot | droplet. |
| Droplet · Power cycle | droplet. |
| Droplet · Shut down | droplet. |
| Droplet · Power off | droplet. |
| Droplet · Power on | droplet. |
| Droplet · Rename | droplet. |
| Droplet · Resize | droplet. |
| Droplet · Rebuild | droplet. |
| Droplet · Restore | droplet. |
| Droplet · Snapshot | droplet. |
| Droplet · Turn on backups | droplet. |
| Droplet · Change backup schedule | droplet. |
| Droplet · Turn off backups | droplet. |
| Droplet · Reset root password | droplet. |
| Droplet · Change kernel | droplet. |
| Droplet · Turn on IPv6 | droplet. |
| Droplet · Delete | droplet. |
| Droplet · Delete with chosen resources | droplet. |
| Droplet · Delete with every resource | droplet. |
| Droplets · Read | droplets. |
| Droplets · Create | droplets. |
| Droplets · Act on every Droplet with a tag | droplets. |
| Droplets · Delete every Droplet with a tag | droplets. |
| Autoscale pools · Read | autoscalePools. |
| Autoscale pools · Create | autoscalePools. |
| Autoscale pools · Change | autoscalePools. |
| Autoscale pools · Delete | autoscalePools. |
| Autoscale pools · Delete with its Droplets | autoscalePools. |
| Images · Read | images. |
| Images · Import | images. |
| Images · Change | images. |
| Images · Delete | images. |
| Images · Copy to region | images. |
| Images · Convert to snapshot | images. |
| Images · Give to another account | images. |
| Images · Accept or decline | images. |
| Snapshots · Read | snapshots. |
| Snapshots · Delete | snapshots. |
| Snapshots · Delete a region's copy | snapshots. |
| SSH keys · Read | sshKeys. |
| SSH keys · Add | sshKeys. |
| SSH keys · Rename | sshKeys. |
| SSH keys · Delete | sshKeys. |
| 1-Click apps · Read | oneClicks. |
| 1-Click apps · Install on a cluster | oneClicks. |
| Kubernetes clusters · Read | kubernetes. |
| Kubernetes clusters · Run checks | kubernetes. |
| Kubernetes clusters · Read credentials | kubernetes. |
| Kubernetes clusters · Create | kubernetes. |
| Kubernetes clusters · Change | kubernetes. |
| Kubernetes clusters · Upgrade | kubernetes. |
| Kubernetes clusters · Delete | kubernetes. |
| Kubernetes clusters · Delete with chosen resources | kubernetes. |
| Kubernetes clusters · Delete with every resource | kubernetes. |
| Kubernetes clusters · Connect registries | kubernetes. |
| Kubernetes clusters · Disconnect registries | kubernetes. |
| Kubernetes clusters · Delete a node | kubernetesNodes. |
| Kubernetes clusters · Recycle nodes | kubernetesNodes. |
| Node pools · Create | nodePools. |
| Node pools · Change | nodePools. |
| Node pools · Delete | nodePools. |
| Apps · Read | apps. |
| Apps · Read logs | apps. |
| Apps · Read specs | apps. |
| Apps · Open a console | apps. |
| Apps · Create | apps. |
| Apps · Check a spec | apps. |
| Apps · Change | apps. |
| Apps · Delete | apps. |
| Apps · Deploy | apps. |
| Apps · Restart | apps. |
| Apps · Cancel | apps. |
| Apps · Roll back | apps. |
| Apps · Change alert destinations | apps. |
| Functions namespaces · Read | functions. |
| Functions namespaces · Create | functions. |
| Functions namespaces · Delete | functions. |
| Function triggers · Read | functionTriggers. |
| Function triggers · Create | functionTriggers. |
| Function triggers · Change | functionTriggers. |
| Function triggers · Delete | functionTriggers. |
| Function access keys · Read | functionKeys. |
| Function access keys · Create | functionKeys. |
| Function access keys · Rename | functionKeys. |
| Function access keys · Delete | functionKeys. |
| Database clusters · Read | databases. |
| Database clusters · Read with passwords | databases. |
| Database clusters · Change configuration | databases. |
| Database clusters · Resize | databases. |
| Database clusters · Change autoscaling | databases. |
| Database clusters · Move to another region | databases. |
| Database clusters · Migrate in | databases. |
| Database clusters · Change maintenance window | databases. |
| Database clusters · Install updates | databases. |
| Database clusters · Upgrade version | databases. |
| Database clusters · Delete | databases. |
| Database clusters · Create | databaseAccess. |
| Database clusters · Change trusted sources | databaseAccess. |
| Read-only replicas · Create | databaseReplicas. |
| Read-only replicas · Promote | databaseReplicas. |
| Read-only replicas · Delete | databaseReplicas. |
| Database users · Create | databaseUsers. |
| Database users · Change | databaseUsers. |
| Database users · Reset password | databaseUsers. |
| Database users · Delete | databaseUsers. |
| Databases · Create | databaseDbs. |
| Databases · Delete | databaseDbs. |
| Connection pools · Create | databasePools. |
| Connection pools · Change | databasePools. |
| Connection pools · Delete | databasePools. |
| Kafka topics · Create | kafkaTopics. |
| Kafka topics · Change | kafkaTopics. |
| Kafka topics · Delete | kafkaTopics. |
| Kafka schemas · Create | kafkaSchemas. |
| Kafka schemas · Change compatibility | kafkaSchemas. |
| Kafka schemas · Delete | kafkaSchemas. |
| Database log sinks · Read | databaseLogsinks. |
| Database log sinks · Create | databaseLogsinks. |
| Database log sinks · Change | databaseLogsinks. |
| Database log sinks · Delete | databaseLogsinks. |
| Database metrics credentials · Read | databaseMetricsCredentials. |
| Database metrics credentials · Change | databaseMetricsCredentials. |
| OpenSearch indexes · Delete | openSearchIndexes. |
| Volumes · Read | volumes. |
| Volumes · Create | volumes. |
| Volumes · Resize | volumes. |
| Volumes · Snapshot | volumes. |
| Volumes · Delete | volumes. |
| Volumes · Delete snapshot | volumes. |
| Volumes · Attach | volumeDroplets. |
| Volumes · Detach | volumeDroplets. |
| NFS shares · Read | nfs. |
| NFS shares · Create | nfs. |
| NFS shares · Resize | nfs. |
| NFS shares · Snapshot | nfs. |
| NFS shares · Attach to a VPC | nfs. |
| NFS shares · Detach from a VPC | nfs. |
| NFS shares · Move to another VPC | nfs. |
| NFS shares · Change performance | nfs. |
| NFS shares · Delete | nfs. |
| NFS shares · Delete snapshot | nfs. |
| NFS shares · Create access point | nfs. |
| NFS shares · Delete access point | nfs. |
| Spaces keys · Read | spacesKeys. |
| Spaces keys · Create | spacesKeys. |
| Spaces keys · Change | spacesKeys. |
| Spaces keys · Delete | spacesKeys. |
| Container registries · Read | registries. |
| Container registries · Read credentials | registries. |
| Container registries · Create | registries. |
| Container registries · Change plan | registries. |
| Container registries · Delete repositories and tags | registries. |
| Container registries · Run garbage collection | registries. |
| Container registries · Delete | registries. |
| VPCs · Read | vpcs. |
| VPCs · Create | vpcs. |
| VPCs · Change | vpcs. |
| VPCs · Delete | vpcs. |
| VPC peerings · Read | vpcPeerings. |
| VPC peerings · Create | vpcPeerings. |
| VPC peerings · Rename | vpcPeerings. |
| VPC peerings · Delete | vpcPeerings. |
| VPC NAT gateways · Read | natGateways. |
| VPC NAT gateways · Create | natGateways. |
| VPC NAT gateways · Change | natGateways. |
| VPC NAT gateways · Delete | natGateways. |
| Firewalls · Read | firewalls. |
| Firewalls · Add tags | firewalls. |
| Firewalls · Remove tags | firewalls. |
| Firewalls · Delete | firewalls. |
| Firewalls · Create | firewallDroplets. |
| Firewalls · Change | firewallDroplets. |
| Firewalls · Add Droplets | firewallDroplets. |
| Firewalls · Remove Droplets | firewallDroplets. |
| Firewalls · Add rules | firewallDroplets. |
| Firewalls · Remove rules | firewallDroplets. |
| Load balancers · Read | loadBalancers. |
| Load balancers · Add forwarding rules | loadBalancers. |
| Load balancers · Remove forwarding rules | loadBalancers. |
| Load balancers · Purge CDN cache | loadBalancers. |
| Load balancers · Delete | loadBalancers. |
| Load balancers · Create | loadBalancerDroplets. |
| Load balancers · Change | loadBalancerDroplets. |
| Load balancers · Add Droplets | loadBalancerDroplets. |
| Load balancers · Remove Droplets | loadBalancerDroplets. |
| Reserved IPs · Read | reservedIps. |
| Reserved IPs · Delete | reservedIps. |
| Reserved IPs · Create | reservedIpsDroplets. |
| Reserved IPs · Assign | reservedIpsDroplets. |
| Reserved IPs · Unassign | reservedIpsDroplets. |
| Floating IPs · Read | floatingIps. |
| Floating IPs · Delete | floatingIps. |
| Floating IPs · Create | floatingIpsDroplets. |
| Floating IPs · Assign | floatingIpsDroplets. |
| Floating IPs · Unassign | floatingIpsDroplets. |
| Reserved IPv6 addresses · Read | reservedIpv6. |
| Reserved IPv6 addresses · Create | reservedIpv6. |
| Reserved IPv6 addresses · Delete | reservedIpv6. |
| Reserved IPv6 addresses · Assign | reservedIpv6Droplets. |
| Reserved IPv6 addresses · Unassign | reservedIpv6Droplets. |
| BYOIP prefixes · Read | byoipPrefixes. |
| BYOIP prefixes · Create | byoipPrefixes. |
| BYOIP prefixes · Change advertising | byoipPrefixes. |
| BYOIP prefixes · Delete | byoipPrefixes. |
| Partner attachments · Read | partnerAttachments. |
| Partner attachments · Read keys | partnerAttachments. |
| Partner attachments · Create | partnerAttachments. |
| Partner attachments · Change | partnerAttachments. |
| Partner attachments · Replace service key | partnerAttachments. |
| Partner attachments · Delete | partnerAttachments. |
| DNS domains · Read | domains. |
| DNS domains · Create | domains. |
| DNS domains · Delete | domains. |
| DNS records · Create | domainRecords. |
| DNS records · Change | domainRecords. |
| DNS records · Delete | domainRecords. |
| CDN endpoints · Read | cdnEndpoints. |
| CDN endpoints · Create | cdnEndpoints. |
| CDN endpoints · Change | cdnEndpoints. |
| CDN endpoints · Purge cache | cdnEndpoints. |
| CDN endpoints · Delete | cdnEndpoints. |
| Certificates · Read | certificates. |
| Certificates · Create | certificates. |
| Certificates · Delete | certificates. |
| Monitoring · Read | monitoring. |
| Monitoring · Read other metrics | monitoring. |
| Monitoring · Delete alert policy | monitoring. |
| Monitoring · Create log destination | monitoring. |
| Monitoring · Change log destination | monitoring. |
| Monitoring · Delete log destination | monitoring. |
| Monitoring · Read log sinks | monitoring. |
| Monitoring · Create log sink | monitoring. |
| Monitoring · Delete log sink | monitoring. |
| Monitoring · Read Droplet metrics | monitoringDroplets. |
| Monitoring · Create alert policy | monitoringDroplets. |
| Monitoring · Change alert policy | monitoringDroplets. |
| Insights · Read | insights. |
| Insights · Query telemetry | insights. |
| Insights · Create alert rule | insights. |
| Insights · Change alert rule | insights. |
| Insights · Delete alert rule | insights. |
| Insights · Create dashboard | insights. |
| Insights · Change dashboard | insights. |
| Insights · Delete dashboard | insights. |
| Insights · Create notification channel | insights. |
| Insights · Change notification channel | insights. |
| Insights · Delete notification channel | insights. |
| Insights · Change telemetry | insights. |
| Uptime checks · Read | uptime. |
| Uptime checks · Create | uptime. |
| Uptime checks · Change | uptime. |
| Uptime checks · Delete | uptime. |
| Uptime checks · Create alert | uptime. |
| Uptime checks · Change alert | uptime. |
| Uptime checks · Delete alert | uptime. |
| Projects · Read | projects. |
| Projects · Create | projects. |
| Projects · Change | projects. |
| Projects · Delete | projects. |
| Projects · Move resources | projectResources. |
| Tags · Read | tags. |
| Tags · Create | tags. |
| Tags · Delete | tags. |
| Tags · Tag resources | tagResources. |
| Tags · Untag resources | tagResources. |
| Security scans · Read | security. |
| Security scans · Run a scan | security. |
| Security scans · Ignore findings | security. |
| Security scans · Change plan | security. |
| Secrets · Read | secrets. |
| Secrets · Read values | secrets. |
| Secrets · Create | secrets. |
| Secrets · Change | secrets. |
| Secrets · Revert | secrets. |
| Secrets · Delete | secrets. |
| Add-ons · Read | addOns. |
| Add-ons · Rename | addOns. |
| Add-ons · Change plan | addOns. |
| Add-ons · Delete | addOns. |
| Add-ons · Create | addOnDroplets. |
| Account · Read | account. |
| Account · Read actions | account. |
| Account · Read regions and sizes | account. |
| Billing · Read | billing. |
| Teams · Read | teams. |
| Teams · Create | teams. |
| Custom rule: a method and a path that you choose. | |
| Rows can be limited to Droplets. A request is about every Droplet it names, and a row covers it only when every one is in it. | |
| Permissions that read passwords and keys, such as Database clusters · Read with passwords, start as Ask me with a warning. The agent gets DigitalOcean's answer unchanged. | |
| Secrets the agent sends, such as an app's secret environment values, are hidden on the confirm screen until you choose Show. | |
| Acting on every Droplet with a tag reaches Droplets the row may leave out, so it shows in red before you allow or approve it. | |
| Reach DigitalOcean's AI and agent products, and its products in Public Preview, with custom rules. | |