Get a List of Configuration Element Instances
get
/{versionId}/configuration/deviceConfigs/{deviceId}/configElements
Use this (GET) method to retrieve a list of configuration element instances for a specific element type (refer to Get an Element by Its Type). For example, requesting configuration element instances for NetworkInterface returns all the network-interface instances currently existing in the targeted device configuration.
Request
Path Parameters
Query Parameters
Back to Top
Response
200 Response
400 Response
The user input is invalid.
401 Response
The session ID is invalid.
404 Response
The object (resource URI, device, and so on) of your input request cannot be found.
Examples
Example of Accessing the API with cURL
The following example shows how to get a list of configuration element instances by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL.
curl -X GET \
-b sessionid.txt \
--header "Accept: application/xml" \
"https://example.com:8443/rest/v1.3/configuration/deviceConfigs/{deviceId}/configElements"Example of Accessing the API with Python
The following example shows how to get a list of configuration element instances by submitting a GET request on the REST resource using Python. This example assumes the cookie variable contains a valid authentication cookie. For an example of authenticating with Python, see Authenticate.
import requests
url = "https://example.com:8443/rest/v1.3/configuration/deviceConfigs/{deviceId}/configElements"
headers = { "Accept":"application/xml", "Cookie":cookie }
resp = requests.get(url, headers=headers)Example of the Response Body
This endpoint does not return a response body.