Cloud Failover (CF) Extension (0.9.1)

Download OpenAPI specification:Download

F5 Cloud Failover (CF) is an iControl LX Extension delivered as a TMOS-independent RPM file. Installing the TS Extension on BIG-IP enables you to declaratively configure BIG-IP devices for automatic failover in cloud environments by POSTing a single JSON declaration to CF’s declarative REST API endpoint.

Authentication

BasicAuth

Security scheme type: HTTP
HTTP Authorization Scheme basic

Information

List extension information

Authorizations:

Responses

200

Information Response

default

Unexpected Error

get /info
https://192.0.2.1:443/mgmt/shared/cloud-failover/info

Response samples

Content type
application/json; charset=UTF-8
Copy
Expand all Collapse all
{
  • "version": "0.9.1",
  • "release": "1",
  • "schemaCurrent": "0.9.1",
  • "schemaMinimum": "0.9.0"
}

Configuration

List configuration

Authorizations:

Responses

200

Configuration Response

default

Unexpected Error

get /declare
https://192.0.2.1:443/mgmt/shared/cloud-failover/declare

Response samples

Content type
application/json; charset=UTF-8
Copy
Expand all Collapse all
{
  • "message": "string",
  • "declaration":
    {
    }
}

Update configuration

Authorizations:
Request Body schema: application/json
class
string
Default: "Cloud_Failover"
environment
string
Enum:"azure" "aws" "gcp"
schemaVersion
string
externalStorage
object
failoverAddresses
object
failoverRoutes
object

Responses

200

Configuration response

default

Unexpected Error

post /declare
https://192.0.2.1:443/mgmt/shared/cloud-failover/declare

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "class": "Cloud_Failover",
  • "environment": "azure",
  • "externalStorage":
    {
    },
  • "failoverAddresses":
    {
    },
  • "failoverRoutes":
    {
    }
}

Response samples

Content type
application/json; charset=UTF-8
Copy
Expand all Collapse all
{
  • "message": "success",
  • "declaration":
    {
    }
}

Trigger

Trigger failover

Authorizations:
Request Body schema: application/json
action
string

Responses

200

Configuration response

500

Failover task failed

default

Unexpected Error

post /trigger
https://192.0.2.1:443/mgmt/shared/cloud-failover/trigger

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "action": "execute"
}

Response samples

Content type
application/json; charset=UTF-8
Copy
Expand all Collapse all
{
  • "taskState": "RUNNING",
  • "timestamp": "string",
  • "instance": "string",
  • "failoverOperations":
    {
    },
  • "code": "string"
}

Running failover task state

Authorizations:

Responses

200

Failover task was successful

202

Failover task is running

400

Failover task failed

default

Unexpected Error

get /trigger
https://192.0.2.1:443/mgmt/shared/cloud-failover/trigger

Response samples

Content type
application/json; charset=UTF-8
Copy
Expand all Collapse all
{
  • "taskState": "SUCCEEDED",
  • "message": "Failover Completed Successfully",
  • "timestamp": "2019-09-25T23:44:44.381Z",
  • "instance": "failover0.local",
  • "failoverOperations":
    {
    },
  • "code": 200
}

Reset

Reset failover state file

Authorizations:
Request Body schema: application/json
resetStateFile
boolean

Responses

200

Reset State Response

default

Unexpected Error

post /reset
https://192.0.2.1:443/mgmt/shared/cloud-failover/reset

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "resetStateFile": true
}

Response samples

Content type
application/json; charset=UTF-8
Copy
Expand all Collapse all
{
  • "message": "string"
}