diff --git a/DO_OPENAPI_COMMIT_SHA.txt b/DO_OPENAPI_COMMIT_SHA.txt index 76cae071..452cc909 100644 --- a/DO_OPENAPI_COMMIT_SHA.txt +++ b/DO_OPENAPI_COMMIT_SHA.txt @@ -1 +1 @@ -1e369f0 +8adfe72 diff --git a/src/pydo/aio/operations/_operations.py b/src/pydo/aio/operations/_operations.py index fee4c4f2..5d73a33d 100644 --- a/src/pydo/aio/operations/_operations.py +++ b/src/pydo/aio/operations/_operations.py @@ -135951,78 +135951,78 @@ async def post( 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: .. list-table:: :header-rows: 1 * - Action - Details - - Additionally Required Permission + - Required Permissions * - :code:``enable_backups`` - Enables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``disable_backups`` - Disables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``change_backup_policy`` - Update the backup policy for a Droplet - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``shutdown`` - - Shutsdown a Droplet. A shutdown action is an attempt to shutdown the Droplet in a + - 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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``power_on`` - Powers on a Droplet. - - + - :code:``droplet:update`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:create`` * - :code:``rebuild`` - Rebuilds a Droplet from a new base image. Set the ``image`` attribute to an image ID or slug. - - droplet:admin + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``rename`` - Renames a Droplet. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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 `_ is required. - - + - :code:``droplet:update`` * - :code:``snapshot`` - Takes a snapshot of a Droplet. - - image:create. + - :code:``droplet:update``:code:`
`:code:``image:create``. :param droplet_id: A unique identifier for a Droplet instance. Required. :type droplet_id: int @@ -136113,78 +136113,78 @@ async def post( 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: .. list-table:: :header-rows: 1 * - Action - Details - - Additionally Required Permission + - Required Permissions * - :code:``enable_backups`` - Enables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``disable_backups`` - Disables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``change_backup_policy`` - Update the backup policy for a Droplet - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``shutdown`` - - Shutsdown a Droplet. A shutdown action is an attempt to shutdown the Droplet in a + - 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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``power_on`` - Powers on a Droplet. - - + - :code:``droplet:update`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:create`` * - :code:``rebuild`` - Rebuilds a Droplet from a new base image. Set the ``image`` attribute to an image ID or slug. - - droplet:admin + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``rename`` - Renames a Droplet. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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 `_ is required. - - + - :code:``droplet:update`` * - :code:``snapshot`` - Takes a snapshot of a Droplet. - - image:create. + - :code:``droplet:update``:code:`
`:code:``image:create``. :param droplet_id: A unique identifier for a Droplet instance. Required. :type droplet_id: int @@ -136270,78 +136270,78 @@ async def post( 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: .. list-table:: :header-rows: 1 * - Action - Details - - Additionally Required Permission + - Required Permissions * - :code:``enable_backups`` - Enables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``disable_backups`` - Disables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``change_backup_policy`` - Update the backup policy for a Droplet - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``shutdown`` - - Shutsdown a Droplet. A shutdown action is an attempt to shutdown the Droplet in a + - 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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``power_on`` - Powers on a Droplet. - - + - :code:``droplet:update`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:create`` * - :code:``rebuild`` - Rebuilds a Droplet from a new base image. Set the ``image`` attribute to an image ID or slug. - - droplet:admin + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``rename`` - Renames a Droplet. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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 `_ is required. - - + - :code:``droplet:update`` * - :code:``snapshot`` - Takes a snapshot of a Droplet. - - image:create. + - :code:``droplet:update``:code:`
`:code:``image:create``. :param droplet_id: A unique identifier for a Droplet instance. Required. :type droplet_id: int @@ -137114,6 +137114,15 @@ async def list( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value + is True. An optional boolean indicating whether the Droplets should + be created with public networking or not. By default, all Droplets + are created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not + have any public static or Reserved IPv4 or IPv6 address, nor can one + be assigned later. If explicitly set to ``false``"" , ``ipv6`` must + also be ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` @@ -137269,6 +137278,14 @@ async def create( in the autoscale pool. "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is True. An + optional boolean indicating whether the Droplets should be created with + public networking or not. By default, all Droplets are created with public + networking available. If explicitly set to ``false``"" , only private + networking will be enabled, and public networking will be disabled; currently + this means that it will not have any public static or Reserved IPv4 or IPv6 + address, nor can one be assigned later. If explicitly set to ``false``"" , + ``ipv6`` must also be ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -137319,6 +137336,15 @@ async def create( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -137413,6 +137439,15 @@ async def create( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -137492,6 +137527,14 @@ async def create( in the autoscale pool. "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is True. An + optional boolean indicating whether the Droplets should be created with + public networking or not. By default, all Droplets are created with public + networking available. If explicitly set to ``false``"" , only private + networking will be enabled, and public networking will be disabled; currently + this means that it will not have any public static or Reserved IPv4 or IPv6 + address, nor can one be assigned later. If explicitly set to ``false``"" , + ``ipv6`` must also be ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -137542,6 +137585,15 @@ async def create( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -137700,6 +137752,15 @@ async def get(self, autoscale_pool_id: str, **kwargs: Any) -> JSON: "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -137875,6 +137936,14 @@ async def update( in the autoscale pool. "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is True. An + optional boolean indicating whether the Droplets should be created with + public networking or not. By default, all Droplets are created with public + networking available. If explicitly set to ``false``"" , only private + networking will be enabled, and public networking will be disabled; currently + this means that it will not have any public static or Reserved IPv4 or IPv6 + address, nor can one be assigned later. If explicitly set to ``false``"" , + ``ipv6`` must also be ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -137925,6 +137994,15 @@ async def update( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -138031,6 +138109,15 @@ async def update( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -138124,6 +138211,14 @@ async def update( in the autoscale pool. "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is True. An + optional boolean indicating whether the Droplets should be created with + public networking or not. By default, all Droplets are created with public + networking available. If explicitly set to ``false``"" , only private + networking will be enabled, and public networking will be disabled; currently + this means that it will not have any public static or Reserved IPv4 or IPv6 + address, nor can one be assigned later. If explicitly set to ``false``"" , + ``ipv6`` must also be ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -138174,6 +138269,15 @@ async def update( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. diff --git a/src/pydo/operations/_operations.py b/src/pydo/operations/_operations.py index b466b618..8b8d24d7 100644 --- a/src/pydo/operations/_operations.py +++ b/src/pydo/operations/_operations.py @@ -150059,78 +150059,78 @@ def post( 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: .. list-table:: :header-rows: 1 * - Action - Details - - Additionally Required Permission + - Required Permissions * - :code:``enable_backups`` - Enables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``disable_backups`` - Disables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``change_backup_policy`` - Update the backup policy for a Droplet - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``shutdown`` - - Shutsdown a Droplet. A shutdown action is an attempt to shutdown the Droplet in a + - 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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``power_on`` - Powers on a Droplet. - - + - :code:``droplet:update`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:create`` * - :code:``rebuild`` - Rebuilds a Droplet from a new base image. Set the ``image`` attribute to an image ID or slug. - - droplet:admin + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``rename`` - Renames a Droplet. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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 `_ is required. - - + - :code:``droplet:update`` * - :code:``snapshot`` - Takes a snapshot of a Droplet. - - image:create. + - :code:``droplet:update``:code:`
`:code:``image:create``. :param droplet_id: A unique identifier for a Droplet instance. Required. :type droplet_id: int @@ -150221,78 +150221,78 @@ def post( 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: .. list-table:: :header-rows: 1 * - Action - Details - - Additionally Required Permission + - Required Permissions * - :code:``enable_backups`` - Enables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``disable_backups`` - Disables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``change_backup_policy`` - Update the backup policy for a Droplet - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``shutdown`` - - Shutsdown a Droplet. A shutdown action is an attempt to shutdown the Droplet in a + - 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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``power_on`` - Powers on a Droplet. - - + - :code:``droplet:update`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:create`` * - :code:``rebuild`` - Rebuilds a Droplet from a new base image. Set the ``image`` attribute to an image ID or slug. - - droplet:admin + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``rename`` - Renames a Droplet. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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 `_ is required. - - + - :code:``droplet:update`` * - :code:``snapshot`` - Takes a snapshot of a Droplet. - - image:create. + - :code:``droplet:update``:code:`
`:code:``image:create``. :param droplet_id: A unique identifier for a Droplet instance. Required. :type droplet_id: int @@ -150378,78 +150378,78 @@ def post( 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: .. list-table:: :header-rows: 1 * - Action - Details - - Additionally Required Permission + - Required Permissions * - :code:``enable_backups`` - Enables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``disable_backups`` - Disables backups for a Droplet - - + - :code:``droplet:update`` * - :code:``change_backup_policy`` - Update the backup policy for a Droplet - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``shutdown`` - - Shutsdown a Droplet. A shutdown action is an attempt to shutdown the Droplet in a + - 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. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``power_on`` - Powers on a Droplet. - - + - :code:``droplet:update`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``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 + - :code:``droplet:update``:code:`
`:code:``droplet:create`` * - :code:``rebuild`` - Rebuilds a Droplet from a new base image. Set the ``image`` attribute to an image ID or slug. - - droplet:admin + - :code:``droplet:update``:code:`
`:code:``droplet:admin`` * - :code:``rename`` - Renames a Droplet. - - + - :code:``droplet:update`` * - :code:``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. - - + - :code:``droplet:update`` * - :code:``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 `_ is required. - - + - :code:``droplet:update`` * - :code:``snapshot`` - Takes a snapshot of a Droplet. - - image:create. + - :code:``droplet:update``:code:`
`:code:``image:create``. :param droplet_id: A unique identifier for a Droplet instance. Required. :type droplet_id: int @@ -151222,6 +151222,15 @@ def list( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value + is True. An optional boolean indicating whether the Droplets should + be created with public networking or not. By default, all Droplets + are created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not + have any public static or Reserved IPv4 or IPv6 address, nor can one + be assigned later. If explicitly set to ``false``"" , ``ipv6`` must + also be ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` @@ -151377,6 +151386,14 @@ def create( in the autoscale pool. "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is True. An + optional boolean indicating whether the Droplets should be created with + public networking or not. By default, all Droplets are created with public + networking available. If explicitly set to ``false``"" , only private + networking will be enabled, and public networking will be disabled; currently + this means that it will not have any public static or Reserved IPv4 or IPv6 + address, nor can one be assigned later. If explicitly set to ``false``"" , + ``ipv6`` must also be ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -151427,6 +151444,15 @@ def create( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -151521,6 +151547,15 @@ def create( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -151600,6 +151635,14 @@ def create( in the autoscale pool. "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is True. An + optional boolean indicating whether the Droplets should be created with + public networking or not. By default, all Droplets are created with public + networking available. If explicitly set to ``false``"" , only private + networking will be enabled, and public networking will be disabled; currently + this means that it will not have any public static or Reserved IPv4 or IPv6 + address, nor can one be assigned later. If explicitly set to ``false``"" , + ``ipv6`` must also be ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -151650,6 +151693,15 @@ def create( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -151808,6 +151860,15 @@ def get(self, autoscale_pool_id: str, **kwargs: Any) -> JSON: "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -151983,6 +152044,14 @@ def update( in the autoscale pool. "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is True. An + optional boolean indicating whether the Droplets should be created with + public networking or not. By default, all Droplets are created with public + networking available. If explicitly set to ``false``"" , only private + networking will be enabled, and public networking will be disabled; currently + this means that it will not have any public static or Reserved IPv4 or IPv6 + address, nor can one be assigned later. If explicitly set to ``false``"" , + ``ipv6`` must also be ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -152033,6 +152102,15 @@ def update( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -152139,6 +152217,15 @@ def update( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -152232,6 +152319,14 @@ def update( in the autoscale pool. "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is True. An + optional boolean indicating whether the Droplets should be created with + public networking or not. By default, all Droplets are created with public + networking available. If explicitly set to ``false``"" , only private + networking will be enabled, and public networking will be disabled; currently + this means that it will not have any public static or Reserved IPv4 or IPv6 + address, nor can one be assigned later. If explicitly set to ``false``"" , + ``ipv6`` must also be ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope. @@ -152282,6 +152377,15 @@ def update( "project_id": "str", # Optional. The project that the Droplets in the autoscale pool will belong to. Requires ``project:read`` scope. + "public_networking": True, # Optional. Default value is + True. An optional boolean indicating whether the Droplets should be + created with public networking or not. By default, all Droplets are + created with public networking available. If explicitly set to + ``false``"" , only private networking will be enabled, and public + networking will be disabled; currently this means that it will not have + any public static or Reserved IPv4 or IPv6 address, nor can one be + assigned later. If explicitly set to ``false``"" , ``ipv6`` must also be + ``false``. "tags": [ "str" # Optional. The tags to apply to each of the Droplets in the autoscale pool. Requires ``tag:read`` scope.