Search for Device Groups

Before you begin

Before attempting to initiate device backup with this API, users must ensure any one of the ACF permission is available:

ADC > Backup & Restore > Backup now

This can be checked under Accounts > Role > Authorized Functions.

Request Structure


Endpoint:	`/adc-inventory-get-all-group-settings/backUpRestore`
Type:	`GET`
Sample URL:	`https://<IP/HostName/TenantName>:<GWPORT>/avxapi/adc-inventory-get-all-group-settings/backUpRestore?gwsource=external` To understand the elements of the sample URL, click here.
Headers:
Content-Type:	application/json

Table 1. Input Parameter
Name	Description
sessionId `Header`	(Mandatory) Specifies the session ID of the user session received after login. Type: String Constraints: The session ID is used when username and password are not provided.
username `Header`	(Mandatory) Specifies the login username used to access the AppViewX. Type: String Constraints: The username, along with the password, is used when the session ID is not provided.
password `Header`	(Mandatory) Specifies the login password used to access the AppViewX. Type: String Constraints: The password, along with the username, is used when the session ID is not provided.
Content-Type `Header`	(Mandatory) Specifies the format of the data in the payload. Type: String Constraints: The value of this param must be ‘application/json’.
gwsource `Query`	(Mandatory) Specifies the source from which the request is triggered. The options are: web external Type: String
payload `Body`	(Mandatory) Contains all the params to be sent in the request body for the post request. See Payload section for more details.

Payload


Name	Description
SearchParam `String`	(Optional) Filter for narrowing down results Constraints: It can contain only alphanumeric characters, ‘-’ , ’_’ , ‘.’ , ‘*’ , ‘\|’, ‘!’.

Response Structure

Status Code: 200 OK
Message: Successful
Headers:
- Content-Type: application/json


Name	Description
response `String`	Success message with device name or failure description in case of error.
message `String`	Success message or failure description in case of error.
appStatusCode `String`	Application-specific status code for the response. Will be non-null for failure response.
tags	More info in case of failure response.

Status Codes


HTTP Status Code	appStatusCode	Message	Possible remediation
200 Accepted	-	null	-
400 Bad Request	ADC_INV_2006	Invalid input.	Check if a non-null/non-empty value is given under field ‘payload’.

Sample Request/Response

Use Case

Get the device groups details based on the device name.

Request URL

https://<IP/HostName/TenantName>:<GWPORT>/avxapi/adc-inventory-get-all-group-settings/backUpRestore

Sample Request

{
}

Sample Response

{
    "response": {
        "backupnowPermission": true,
        "allBackUpSettings": [
            {
                "periodicSettings": {
                },
                "doClusterBackup": false,
                "category": "ADC",
                "description": "",
                "searchStrings": [
                ],
                "listOfSelectedDevices": [

                    {
                        "vendor": "F5",
                        "name": "BVT_ControlCenter_ADC_F5V13",
                        "_id": "6887a3f8c6f406522b24212f",
                        "category": "ADC"
                    }
                ],
                "isGenerateNow": true,
                "type": "DEVICE",
                "isEmailConfigured": false,
                "listOfStatusForEmail": [
                    "Success",
                    "Failure"
                ],
                "emailSummary": false,
                "settingsType": "backUpRestore",
                "isGenerateNowClicked": false,
                "name": "Default_Group",
                "triggered": false,
                "_id": "5ec7b2f9632af7d292580cab"
            }
        ],
        "deletePermission": true,
        "archiveSettings": {
            "_id": "backUpRestore",
            "noOfArchives": 3,
            "isWarningEnabled": false,
            "isObjectBackupEnabled": true,
            "archivesSplitUp": {
                "daily": 0,
                "weekly": 3,
                "monthly": 0,
                "yearly": 0
            },
            "isAdvancedSettingsEnabled": true
        },
        "maxNoOfArchives": 1,
        "groupsProgressStatus": [
        ]
    },
    "message": null,
    "appStatusCode": null,
    "tags": null,
    "headers": null
}

Reference

Understanding the sample URL:

IP/HostName/TenantName: Replace with the actual IP address, hostname, or tenant name based on the specific configuration in AppViewX.
- IP: A unique identifier assigned to each device connected to a computer network that uses the Internet Protocol for communication
  The IP address will be included in the endpoint URL for an on-prem deployment.
- HostName: A human-readable label assigned to a device (host) on a network
  The hostname will be included in the endpoint URL for an on-prem deployment.
- TenantName: An identifier label for a tenant given to indicate which tenant's data the API request will access/modify
  The tenant name will be included in the endpoint URL for a SaaS deployment.
GWPORT: AppViewX gateway port
A gateway port refers to a network port through which data is sent and received to communicate with a gateway in an on-prem deployment.
Example: 31443
avxapi: Path parameter value (static) that is part of the endpoint's URL
Endpoint: Endpoint of the API, for example: execute-hook
gwsource: Source or origin of a gateway, for example: external.

What's Next

Get Backup Details for a Device