F5 BIG-IP AS3 (3.50.0)

Download OpenAPI specification:Download

This reference describes the BIG-IP AS3 API and available endpoints.

Configuration

Apply BIG-IP AS3 configuration

Use POST to deploy a configuration to a target ADC, or for certain other actions, including retrieve. You must supply a request document with each POST. The request document may be a proper request or a ADC-only declaration

query Parameters
async
boolean

async=: true causes BIG-IP AS3 to respond with a 202 status and a request ID which you can later use in a GET request to a new /task endpoint to get the results. Default is false.

controls.dryRun
boolean

BIG-IP AS3 3.30+: Using controls.dryRun=true sends the declaration through all validation checks but does not attempt to deploy the configuration on the target device. This can be useful for testing and debugging declarations. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.logLevel
string

BIG-IP AS3 3.30+: Determines the level of detail in logs using RFC 5424 severity levels. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is error.

controls.trace
boolean

BIG-IP AS3 3.30+: If true, BIG-IP AS3 creates a detailed trace of the configuration process for subsequent analysis (default false). Warning: Trace files may contain sensitive configuration data. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.traceResponse
boolean

BIG-IP AS3 3.30+: If true, the response will contain the trace files. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.userAgent
string

BIG-IP AS3 3.30+: User Agent information to include in TEEM report. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration.

show
string

show=: base means system returns the declaration as originally deployed (but with secrets like passphrases encrypted), full returns the declaration with all default schema properties populated, expanded includes all URLs, base64s, and other references expanded to their final static values. Default is base

showHash
boolean

If you set showHash=true, the results include an optimisticLockKey for each tenant. Attempts to change/update any of the tenants without the correct optimisticLockKey will fail. The default is false.

Request Body schema: application/json
body

Responses

Request samples

Content type
application/json
{
  • "class": "ADC",
  • "schemaVersion": "3.0.0",
  • "tenant": {
    }
}

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "declaration": {
    }
}

Read current BIG-IP AS3 configuration

Retrieve a declaration (with all or just some Tenants) or an index of stored declarations.

query Parameters
show
string

base means system returns the declaration as originally deployed (but with secrets like passphrases encrypted), full returns the declaration with all default schema properties populated, expanded includes all URLs, base64s, and other references expanded to their final static values. The default is base.

integer or string

?age=0-15 asks for a declaration of the given age (0 means most-recently deployed), and "list" asks for a list of available declarations with their ages. By default, list only shows 4 declarations, this is configurable using historyLimit in the BIG-IP AS3 class. The default is 0.

filterClass
string

You can use filterClass to retrieve results for only a specific BIG-IP AS3 class. For example ?filterClass=HTTP_Profile only returns the HTTP Profile portions of the declaration. You can only use filterClass once in a single GET request.

Responses

Response samples

Content type
application/json
{
  • "class": "ADC",
  • "schemaVersion": "3.0.0",
  • "tenant": {
    },
  • "id": "autogen_1d77bb4f-cd46-453b-917f-897bd2c278f7",
  • "updateMode": "selective"
}

Update current BIG-IP AS3 configuration

You can use the PATCH method to modify the configuration produced by a previously-sent declaration without having to resend the entire declaration

query Parameters
show
string

base means system returns the declaration as originally deployed (but with secrets like passphrases encrypted), full returns the declaration with all default schema properties populated, expanded includes all URLs, base64s, and other references expanded to their final static values. The default is base.

async
boolean

Setting async to true causes BIG-IP AS3 to respond with a 202 status and a request ID which you can later use in a GET request to a new /task endpoint to get the results.

Responses

Response samples

Content type
application/json
{}

Remove current BIG-IP AS3 configuration

Use DELETE to remove configurations for one or more declared Tenants from the target ADC.

query Parameters
show
string

base means system returns the declaration as originally deployed (but with secrets like passphrases encrypted), full returns the declaration with all default schema properties populated, expanded includes all URLs, base64s, and other references expanded to their final static values. The default is base.

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "declaration": {
    }
}

Apply BIG-IP AS3 configuration for a specific tenant or tenants

Use POST to deploy a configuration to a target ADC, or for certain other actions, including retrieve. You must supply a request document with each POST. The request document may be a proper request or a ADC-only declaration

path Parameters
tenant
required
string

Only use the specified tenants. Other tenants in the declaration will be ignored. May be a comma separated list.

query Parameters
async
boolean

async=: true causes BIG-IP AS3 to respond with a 202 status and a request ID which you can later use in a GET request to a new /task endpoint to get the results. Default is false.

controls.dryRun
boolean

BIG-IP AS3 3.30+: Using controls.dryRun=true sends the declaration through all validation checks but does not attempt to deploy the configuration on the target device. This can be useful for testing and debugging declarations. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.logLevel
string

BIG-IP AS3 3.30+: Determines the level of detail in logs using RFC 5424 severity levels. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is error.

controls.trace
boolean

BIG-IP AS3 3.30+: If true, BIG-IP AS3 creates a detailed trace of the configuration process for subsequent analysis (default false). Warning: Trace files may contain sensitive configuration data. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.traceResponse
boolean

BIG-IP AS3 3.30+: If true, the response will contain the trace files. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.userAgent
string

BIG-IP AS3 3.30+: User Agent information to include in TEEM report. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration.

show
string

show=: base means system returns the declaration as originally deployed (but with secrets like passphrases encrypted), full returns the declaration with all default schema properties populated, expanded includes all URLs, base64s, and other references expanded to their final static values. Default is base

showHash
boolean

If you set showHash=true, the results include an optimisticLockKey for each tenant. Attempts to change/update any of the tenants without the correct optimisticLockKey will fail. The default is false.

Request Body schema: application/json
body

Responses

Request samples

Content type
application/json
{
  • "class": "ADC",
  • "schemaVersion": "3.0.0",
  • "tenant": {
    }
}

Response samples

Content type
application/json
{
  • "successResponse": {
    }
}

Apply BIG-IP AS3 configuration on a per-application basis

Use POST to deploy a configuration to a target ADC, or for certain other actions, including retrieve. You must supply a request document with each POST. The request document may be a proper request or a ADC-only declaration

path Parameters
tenant
required
string

Tenant in which to create the application. Tenant will be created if it doesn't exist.

query Parameters
async
boolean

async=: true causes BIG-IP AS3 to respond with a 202 status and a request ID which you can later use in a GET request to a new /task endpoint to get the results. Default is false.

controls.dryRun
boolean

BIG-IP AS3 3.30+: Using controls.dryRun=true sends the declaration through all validation checks but does not attempt to deploy the configuration on the target device. This can be useful for testing and debugging declarations. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.logLevel
string

BIG-IP AS3 3.30+: Determines the level of detail in logs using RFC 5424 severity levels. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is error.

controls.trace
boolean

BIG-IP AS3 3.30+: If true, BIG-IP AS3 creates a detailed trace of the configuration process for subsequent analysis (default false). Warning: Trace files may contain sensitive configuration data. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.traceResponse
boolean

BIG-IP AS3 3.30+: If true, the response will contain the trace files. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.userAgent
string

BIG-IP AS3 3.30+: User Agent information to include in TEEM report. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration.

show
string

show=: base means system returns the declaration as originally deployed (but with secrets like passphrases encrypted), full returns the declaration with all default schema properties populated, expanded includes all URLs, base64s, and other references expanded to their final static values. Default is base

showHash
boolean

If you set showHash=true, the results include an optimisticLockKey for each tenant. Attempts to change/update any of the tenants without the correct optimisticLockKey will fail. The default is false.

Request Body schema: application/json
body

Responses

Request samples

Content type
application/json
Example
{
  • "application1": {
    },
  • "controls": {
    }
}

Response samples

Content type
application/json
{
  • "application1": {
    },
  • "controls": {
    },
  • "id": "autogen_1d77bb4f-cd46-453b-917f-897bd2c278f7"
}

Read all current BIG-IP AS3 application configurations

Retrieve the declarations for all applications under a tenant

Responses

Response samples

Content type
application/json
{
  • "application1": {
    },
  • "application2": {
    },
  • "controls": {
    }
}

Read current BIG-IP AS3 application configuration

Retrieve the declaration for a specific application under a tenant

Responses

Response samples

Content type
application/json
{
  • "application1": {
    },
  • "controls": {
    },
  • "id": "autogen_1d77bb4f-cd46-453b-917f-897bd2c278f7"
}

Delete current BIG-IP AS3 application configuration

Delete the configuration for a single application

path Parameters
tenant
required
string

Tenant in which to create the application. Tenant will be created if it doesn't exist.

application
required
string

Application to read/update.

query Parameters
async
boolean

async=: true causes BIG-IP AS3 to respond with a 202 status and a request ID which you can later use in a GET request to a new /task endpoint to get the results. Default is false.

controls.dryRun
boolean

BIG-IP AS3 3.30+: Using controls.dryRun=true sends the declaration through all validation checks but does not attempt to deploy the configuration on the target device. This can be useful for testing and debugging declarations. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.logLevel
string

BIG-IP AS3 3.30+: Determines the level of detail in logs using RFC 5424 severity levels. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is error.

controls.trace
boolean

BIG-IP AS3 3.30+: If true, BIG-IP AS3 creates a detailed trace of the configuration process for subsequent analysis (default false). Warning: Trace files may contain sensitive configuration data. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.traceResponse
boolean

BIG-IP AS3 3.30+: If true, the response will contain the trace files. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration. The default is false.

controls.userAgent
string

BIG-IP AS3 3.30+: User Agent information to include in TEEM report. Using this query parameter overwrites any Controls in the ADC class you specified in the declaration.

show
string

show=: base means system returns the declaration as originally deployed (but with secrets like passphrases encrypted), full returns the declaration with all default schema properties populated, expanded includes all URLs, base64s, and other references expanded to their final static values. Default is base

showHash
boolean

If you set showHash=true, the results include an optimisticLockKey for each tenant. Attempts to change/update any of the tenants without the correct optimisticLockKey will fail. The default is false.

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "declaration": {
    }
}

Information

/mgmt/shared/appsvcs/info

This returns version and release information for the instance of BIG-IP AS3 you are using. It also shows current and minimum required versions of the BIG-IP AS3 schema.

Responses

Response samples

Content type
application/json
{
  • "version": "3.20.0",
  • "release": 2,
  • "schemaCurrent": "3.20.0",
  • "schemaMinimum": "3.0.0"
}

Task

A collection of asynchronous tasks

If you used the ?async=true query parameter to send a large declaration, you can use a GET request to the /task endpoint with the recordId returned by the POST to see the status of the processing (and the results if it is finished). Old task records are removed if the record is older than one week or more than 25 records exist.

Responses

Response samples

Content type
application/json
Example
{
  • "id": "c8b8be98-1a55-443e-acd2-ec4b09fb2fc3",
  • "results": [
    ],
  • "declaration": {
    }
}

Settings

Update BIG-IP AS3 settings

Use POST to deploy simple settings changes in BIG-IP AS3. You must supply a schema appropriate JSON object as the body of the request.

Request Body schema: application/json
object (F5 BIG-IP AS3 Settings Declaration)

A declarative configuration for BIG-IP AS3

Responses

Request samples

Content type
application/json
{
  • "value": {
    }
}

Response samples

Content type
application/json
{
  • "burstHandlingEnabled": true,
  • "value": {
    }
}

Get current BIG-IP AS3 settings

Returns the current configuration of BIG-IP AS3.

Responses

Response samples

Content type
application/json
{
  • "value": {
    }
}