From af5be2c4318694793fa435a751d395ccaa823716 Mon Sep 17 00:00:00 2001 From: Brian Boucheron Date: Mon, 30 Mar 2026 16:01:28 -0400 Subject: [PATCH 1/2] update droplet actions permissions table --- .../droplets/dropletActions_post.yml | 36 +++++++++---------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/specification/resources/droplets/dropletActions_post.yml b/specification/resources/droplets/dropletActions_post.yml index cbdc641e1..622e2e16f 100644 --- a/specification/resources/droplets/dropletActions_post.yml +++ b/specification/resources/droplets/dropletActions_post.yml @@ -5,26 +5,26 @@ summary: Initiate a Droplet Action description: | To initiate an action on a Droplet send a POST request to `/v2/droplets/$DROPLET_ID/actions`. In the JSON body to the request, - set the `type` attribute to on of the supported action types: + set the `type` attribute to one of the supported action types: - | Action | Details | Additionally Required Permission | + | Action | Details | Required Permissions | | ---------------------------------------- | ----------- | ----------- | - | `enable_backups` | Enables backups for a Droplet | | - | `disable_backups` | Disables backups for a Droplet | | - | `change_backup_policy` | Update the backup policy for a Droplet | | - | `reboot` | Reboots a Droplet. A `reboot` action is an attempt to reboot the Droplet in a graceful way, similar to using the `reboot` command from the console. | | - | `power_cycle` | Power cycles a Droplet. A `powercycle` action is similar to pushing the reset button on a physical machine, it's similar to booting from scratch. | | - | `shutdown` | Shutsdown a Droplet. A shutdown action is an attempt to shutdown the Droplet in a graceful way, similar to using the `shutdown` command from the console. Since a `shutdown` command can fail, this action guarantees that the command is issued, not that it succeeds. The preferred way to turn off a Droplet is to attempt a shutdown, with a reasonable timeout, followed by a `power_off` action to ensure the Droplet is off. | | - | `power_off` | Powers off a Droplet. A `power_off` event is a hard shutdown and should only be used if the `shutdown` action is not successful. It is similar to cutting the power on a server and could lead to complications. | | - | `power_on` | Powers on a Droplet. | | - | `restore` | Restore a Droplet using a backup image. The image ID that is passed in must be a backup of the current Droplet instance. The operation will leave any embedded SSH keys intact. | droplet:admin | - | `password_reset` | Resets the root password for a Droplet. A new password will be provided via email. It must be changed after first use. | droplet:admin | - | `resize` | Resizes a Droplet. Set the `size` attribute to a size slug. If a permanent resize with disk changes included is desired, set the `disk` attribute to `true`. | droplet:create | - | `rebuild` | Rebuilds a Droplet from a new base image. Set the `image` attribute to an image ID or slug. | droplet:admin | - | `rename` | Renames a Droplet. | | - | `change_kernel` | Changes a Droplet's kernel. Only applies to Droplets with externally managed kernels. All Droplets created after March 2017 use internal kernels by default. | | - | `enable_ipv6` | Enables IPv6 for a Droplet. Once enabled for a Droplet, IPv6 can not be disabled. When enabling IPv6 on an existing Droplet, [additional OS-level configuration](https://docs.digitalocean.com/products/networking/ipv6/how-to/enable/#on-existing-droplets) is required. | | - | `snapshot` | Takes a snapshot of a Droplet. | image:create | + | `enable_backups` | Enables backups for a Droplet | `droplet:update` | + | `disable_backups` | Disables backups for a Droplet | `droplet:update` | + | `change_backup_policy` | Update the backup policy for a Droplet | `droplet:update` | + | `reboot` | Reboots a Droplet. A `reboot` action is an attempt to reboot the Droplet in a graceful way, similar to using the `reboot` command from the console. | `droplet:update` | + | `power_cycle` | Power cycles a Droplet. A `powercycle` action is similar to pushing the reset button on a physical machine, it's similar to booting from scratch. | `droplet:update` | + | `shutdown` | Shuts down a Droplet. A shutdown action is an attempt to shutdown the Droplet in a graceful way, similar to using the `shutdown` command from the console. Since a `shutdown` command can fail, this action guarantees that the command is issued, not that it succeeds. The preferred way to turn off a Droplet is to attempt a shutdown, with a reasonable timeout, followed by a `power_off` action to ensure the Droplet is off. | `droplet:update` | + | `power_off` | Powers off a Droplet. A `power_off` event is a hard shutdown and should only be used if the `shutdown` action is not successful. It is similar to cutting the power on a server and could lead to complications. | `droplet:update` | + | `power_on` | Powers on a Droplet. | `droplet:update` | + | `restore` | Restore a Droplet using a backup image. The image ID that is passed in must be a backup of the current Droplet instance. The operation will leave any embedded SSH keys intact. | `droplet:update` and `droplet:admin` | + | `password_reset` | Resets the root password for a Droplet. A new password will be provided via email. It must be changed after first use. | `droplet:update` and `droplet:admin` | + | `resize` | Resizes a Droplet. Set the `size` attribute to a size slug. If a permanent resize with disk changes included is desired, set the `disk` attribute to `true`. | `droplet:update` and `droplet:create` | + | `rebuild` | Rebuilds a Droplet from a new base image. Set the `image` attribute to an image ID or slug. | `droplet:update` and `droplet:admin` | + | `rename` | Renames a Droplet. | `droplet:update` | + | `change_kernel` | Changes a Droplet's kernel. Only applies to Droplets with externally managed kernels. All Droplets created after March 2017 use internal kernels by default. | `droplet:update` | + | `enable_ipv6` | Enables IPv6 for a Droplet. Once enabled for a Droplet, IPv6 can not be disabled. When enabling IPv6 on an existing Droplet, [additional OS-level configuration](https://docs.digitalocean.com/products/networking/ipv6/how-to/enable/#on-existing-droplets) is required. | `droplet:update` | + | `snapshot` | Takes a snapshot of a Droplet. | `droplet:update` and `image:create` | tags: - Droplet Actions From 2464d7153d7a400879fabf9ff4a6dd3eb689be41 Mon Sep 17 00:00:00 2001 From: Brian Boucheron Date: Mon, 30 Mar 2026 16:06:05 -0400 Subject: [PATCH 2/2] clean up formatting --- .../droplets/dropletActions_post.yml | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/specification/resources/droplets/dropletActions_post.yml b/specification/resources/droplets/dropletActions_post.yml index 622e2e16f..734b1a7e3 100644 --- a/specification/resources/droplets/dropletActions_post.yml +++ b/specification/resources/droplets/dropletActions_post.yml @@ -9,22 +9,22 @@ description: | | Action | Details | Required Permissions | | ---------------------------------------- | ----------- | ----------- | - | `enable_backups` | Enables backups for a Droplet | `droplet:update` | - | `disable_backups` | Disables backups for a Droplet | `droplet:update` | - | `change_backup_policy` | Update the backup policy for a Droplet | `droplet:update` | - | `reboot` | Reboots a Droplet. A `reboot` action is an attempt to reboot the Droplet in a graceful way, similar to using the `reboot` command from the console. | `droplet:update` | - | `power_cycle` | Power cycles a Droplet. A `powercycle` action is similar to pushing the reset button on a physical machine, it's similar to booting from scratch. | `droplet:update` | - | `shutdown` | Shuts down a Droplet. A shutdown action is an attempt to shutdown the Droplet in a graceful way, similar to using the `shutdown` command from the console. Since a `shutdown` command can fail, this action guarantees that the command is issued, not that it succeeds. The preferred way to turn off a Droplet is to attempt a shutdown, with a reasonable timeout, followed by a `power_off` action to ensure the Droplet is off. | `droplet:update` | - | `power_off` | Powers off a Droplet. A `power_off` event is a hard shutdown and should only be used if the `shutdown` action is not successful. It is similar to cutting the power on a server and could lead to complications. | `droplet:update` | - | `power_on` | Powers on a Droplet. | `droplet:update` | - | `restore` | Restore a Droplet using a backup image. The image ID that is passed in must be a backup of the current Droplet instance. The operation will leave any embedded SSH keys intact. | `droplet:update` and `droplet:admin` | - | `password_reset` | Resets the root password for a Droplet. A new password will be provided via email. It must be changed after first use. | `droplet:update` and `droplet:admin` | - | `resize` | Resizes a Droplet. Set the `size` attribute to a size slug. If a permanent resize with disk changes included is desired, set the `disk` attribute to `true`. | `droplet:update` and `droplet:create` | - | `rebuild` | Rebuilds a Droplet from a new base image. Set the `image` attribute to an image ID or slug. | `droplet:update` and `droplet:admin` | - | `rename` | Renames a Droplet. | `droplet:update` | - | `change_kernel` | Changes a Droplet's kernel. Only applies to Droplets with externally managed kernels. All Droplets created after March 2017 use internal kernels by default. | `droplet:update` | - | `enable_ipv6` | Enables IPv6 for a Droplet. Once enabled for a Droplet, IPv6 can not be disabled. When enabling IPv6 on an existing Droplet, [additional OS-level configuration](https://docs.digitalocean.com/products/networking/ipv6/how-to/enable/#on-existing-droplets) is required. | `droplet:update` | - | `snapshot` | Takes a snapshot of a Droplet. | `droplet:update` and `image:create` | + | `enable_backups` | Enables backups for a Droplet | `droplet:update` | + | `disable_backups` | Disables backups for a Droplet | `droplet:update` | + | `change_backup_policy` | Update the backup policy for a Droplet | `droplet:update` | + | `reboot` | Reboots a Droplet. A `reboot` action is an attempt to reboot the Droplet in a graceful way, similar to using the `reboot` command from the console. | `droplet:update` | + | `power_cycle` | Power cycles a Droplet. A `powercycle` action is similar to pushing the reset button on a physical machine, it's similar to booting from scratch. | `droplet:update` | + | `shutdown` | Shuts down a Droplet. A shutdown action is an attempt to shutdown the Droplet in a graceful way, similar to using the `shutdown` command from the console. Since a `shutdown` command can fail, this action guarantees that the command is issued, not that it succeeds. The preferred way to turn off a Droplet is to attempt a shutdown, with a reasonable timeout, followed by a `power_off` action to ensure the Droplet is off. | `droplet:update` | + | `power_off` | Powers off a Droplet. A `power_off` event is a hard shutdown and should only be used if the `shutdown` action is not successful. It is similar to cutting the power on a server and could lead to complications. | `droplet:update` | + | `power_on` | Powers on a Droplet. | `droplet:update` | + | `restore` | Restore a Droplet using a backup image. The image ID that is passed in must be a backup of the current Droplet instance. The operation will leave any embedded SSH keys intact. | `droplet:update`
`droplet:admin` | + | `password_reset` | Resets the root password for a Droplet. A new password will be provided via email. It must be changed after first use. | `droplet:update`
`droplet:admin` | + | `resize` | Resizes a Droplet. Set the `size` attribute to a size slug. If a permanent resize with disk changes included is desired, set the `disk` attribute to `true`. | `droplet:update`
`droplet:create` | + | `rebuild` | Rebuilds a Droplet from a new base image. Set the `image` attribute to an image ID or slug. | `droplet:update`
`droplet:admin` | + | `rename` | Renames a Droplet. | `droplet:update` | + | `change_kernel` | Changes a Droplet's kernel. Only applies to Droplets with externally managed kernels. All Droplets created after March 2017 use internal kernels by default. | `droplet:update` | + | `enable_ipv6` | Enables IPv6 for a Droplet. Once enabled for a Droplet, IPv6 can not be disabled. When enabling IPv6 on an existing Droplet, [additional OS-level configuration](https://docs.digitalocean.com/products/networking/ipv6/how-to/enable/#on-existing-droplets) is required. | `droplet:update` | + | `snapshot` | Takes a snapshot of a Droplet. | `droplet:update`
`image:create` | tags: - Droplet Actions