floating_ip_actions

Creates, updates, deletes, gets or lists a floating_ip_actions resource.

Overview

Name	floating_ip_actions
Type	Resource
Id	digitalocean.network.floating_ip_actions

Fields

The following fields are returned by SELECT queries:

floating_ips_action_get

The response will be an object with a key called action. The value of this will be an object that contains the standard floating IP action attributes.

Name	Datatype	Description
action	object

floating_ips_action_list

The results will be returned as a JSON object with an actions key. This will be set to an array filled with action objects containing the standard floating IP action attributes.

Name	Datatype	Description
id	integer	A unique numeric ID that can be used to identify and reference an action.
resource_id	integer	A unique identifier for the resource that the action is associated with.
completed_at	string (date-time)	A time value given in ISO8601 combined date and time format that represents when the action was completed. (example: 2020-11-14T16:30:06Z)
region	object
region_slug	string	A human-readable string that is used as a unique identifier for each region. (example: nyc3)
resource_type	string	The type of resource that the action is associated with. (example: droplet)
started_at	string (date-time)	A time value given in ISO8601 combined date and time format that represents when the action was initiated. (example: 2020-11-14T16:29:21Z)
status	string	The current status of the action. This can be "in-progress", "completed", or "errored". (example: completed, default: in-progress)
type	string	This is the type of action that the object represents. For example, this could be "transfer" to represent the state of an image transfer action. (example: create)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
floating_ips_action_get	select	floating_ip, action_id		To retrieve the status of a floating IP action, send a GET request to /v2/floating_ips/$FLOATING_IP/actions/$ACTION_ID.
floating_ips_action_list	select	floating_ip		To retrieve all actions that have been executed on a floating IP, send a GET request to /v2/floating_ips/$FLOATING_IP/actions.
floating_ips_action_post	exec	floating_ip		To 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

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
action_id	integer	A unique numeric ID that can be used to identify and reference an action. (example: 36804636)
floating_ip	string (ipv4)	A floating IP address. (example: 45.55.96.47)

SELECT examples

floating_ips_action_get

To retrieve the status of a floating IP action, send a GET request to /v2/floating_ips/$FLOATING_IP/actions/$ACTION_ID.

SELECT
action
FROM digitalocean.network.floating_ip_actions
WHERE floating_ip = '{{ floating_ip }}' -- required
AND action_id = '{{ action_id }}' -- required;

floating_ips_action_list

To retrieve all actions that have been executed on a floating IP, send a GET request to /v2/floating_ips/$FLOATING_IP/actions.

SELECT
id,
resource_id,
completed_at,
region,
region_slug,
resource_type,
started_at,
status,
type
FROM digitalocean.network.floating_ip_actions
WHERE floating_ip = '{{ floating_ip }}' -- required;

Lifecycle Methods

floating_ips_action_post

To 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

EXEC digitalocean.network.floating_ip_actions.floating_ips_action_post 
@floating_ip='{{ floating_ip }}' --required;