Skip to main content

actions

Overview

Nameactions
TypeResource
Iddigitalocean.floating_ips.actions

Fields

NameDatatypeDescription
idintegerA unique numeric ID that can be used to identify and reference an action.
completed_atstringA time value given in ISO8601 combined date and time format that represents when the action was completed.
regionobject
region_slugstringA human-readable string that is used as a unique identifier for each region.
resource_idintegerA unique identifier for the resource that the action is associated with.
resource_typestringThe type of resource that the action is associated with.
started_atstringA time value given in ISO8601 combined date and time format that represents when the action was initiated.
statusstringThe current status of the action. This can be "in-progress", "completed", or "errored".
typestringThis is the type of action that the object represents. For example, this could be "transfer" to represent the state of an image transfer action.

Methods

NameAccessible byRequired ParamsDescription
floatingIPsAction_getSELECTaction_id, floating_ipTo retrieve the status of a floating IP action, send a GET request to /v2/floating_ips/$FLOATING_IP/actions/$ACTION_ID.
floatingIPsAction_listSELECTfloating_ipTo retrieve all actions that have been executed on a floating IP, send a GET request to /v2/floating_ips/$FLOATING_IP/actions.
floatingIPsAction_postINSERTfloating_ipTo initiate an action on a floating IP send a POST request to
/v2/floating_ips/$FLOATING_IP/actions. In the JSON body to the request,
set the type attribute to on of the supported action types:

| Action | Details
|------------|--------
| assign | Assigns a floating IP to a Droplet
| unassign | Unassign a floating IP from a Droplet
_floatingIPsAction_getEXECaction_id, floating_ipTo retrieve the status of a floating IP action, send a GET request to /v2/floating_ips/$FLOATING_IP/actions/$ACTION_ID.
_floatingIPsAction_listEXECfloating_ipTo retrieve all actions that have been executed on a floating IP, send a GET request to /v2/floating_ips/$FLOATING_IP/actions.