# -*- coding: utf-8 -*-
"""Cisco DNA Center Network Settings API wrapper.
Copyright (c) 2024 Cisco Systems.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
"""
from builtins import *
from ...restsession import RestSession
from ...utils import (
apply_path_params,
check_type,
dict_from_items_with_values,
dict_of_str,
)
[docs]class NetworkSettings(object):
"""Cisco DNA Center Network Settings API (version: 2.3.7.6).
Wraps the DNA Center Network Settings
API and exposes the API as native Python
methods that return native Python objects.
"""
def __init__(self, session, object_factory, request_validator):
"""Initialize a new NetworkSettings
object with the provided RestSession.
Args:
session(RestSession): The RESTful session object to be used for
API calls to the DNA Center service.
Raises:
TypeError: If the parameter types are incorrect.
"""
check_type(session, RestSession)
super(NetworkSettings, self).__init__()
self._session = session
self._object_factory = object_factory
self._request_validator = request_validator
[docs] def assign_device_credential_to_site_v1(
self,
site_id,
cliId=None,
httpRead=None,
httpWrite=None,
snmpV2ReadId=None,
snmpV2WriteId=None,
snmpV3Id=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""Assign Device Credential to a site. .
Args:
cliId(string): Network Settings's Cli Id.
httpRead(string): Network Settings's Http Read.
httpWrite(string): Network Settings's Http Write.
snmpV2ReadId(string): Network Settings's Snmp V2 Read Id.
snmpV2WriteId(string): Network Settings's Snmp V2 Write Id.
snmpV3Id(string): Network Settings's Snmp V3 Id.
site_id(str): siteId path parameter. site id to assign credential. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!assign-device-credential-to-site
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(site_id, str, may_be_none=False)
if headers is not None:
if "__persistbapioutput" in headers:
check_type(headers.get("__persistbapioutput"), str, may_be_none=False)
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"siteId": site_id,
}
_payload = {
"cliId": cliId,
"snmpV2ReadId": snmpV2ReadId,
"snmpV2WriteId": snmpV2WriteId,
"httpRead": httpRead,
"httpWrite": httpWrite,
"snmpV3Id": snmpV3Id,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_e4f91ea42515ccdbc24549b84ca1e90_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/credential-to-site/{siteId}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_e4f91ea42515ccdbc24549b84ca1e90_v2_3_7_6", json_data
)
[docs] def create_device_credentials_v1(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to create device credentials. This API has been deprecated and will not be available in a Cisco DNACenter
release after August 1st 2024 23:59:59 GMT. Please refer new Intent API : Create Global Credentials V2 .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!create-device-credentials
"""
check_type(headers, dict)
check_type(payload, dict)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_cf2cac6f150c9bee9ade37921b162_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/device-credential"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_cf2cac6f150c9bee9ade37921b162_v2_3_7_6", json_data
)
[docs] def update_device_credentials_v1(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to update device credentials. This API has been deprecated and will not be available in a Cisco DNACenter
release after August 1st 2024 23:59:59 GMT. Please refer new Intent API : Update Global Credentials V2 .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!update-device-credentials
"""
check_type(headers, dict)
check_type(payload, dict)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_d7161b33157dba957ba18eda440c2_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/device-credential"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_d7161b33157dba957ba18eda440c2_v2_3_7_6", json_data
)
[docs] def get_device_credential_details_v1(
self, site_id=None, headers=None, **request_parameters
):
"""API to get device credential details. This API has been deprecated and will not be available in a Cisco DNA
Center release after August 1st 2024 23:59:59 GMT. Please refer new Intent API : Get All Global
Credentials V2 .
Args:
site_id(str): siteId query parameter. Site id to retrieve the credential details associated with
the site. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!get-device-credential-details
"""
check_type(headers, dict)
check_type(site_id, str)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"siteId": site_id,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/device-credential"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_d8cf995d9d99bdc31707817456_v2_3_7_6", json_data
)
[docs] def delete_device_credential_v1(self, id, headers=None, **request_parameters):
"""Delete device credential. This API has been deprecated and will not be available in a Cisco DNACenter release
after August 1st 2024 23:59:59 GMT. Please refer new Intent API : Delete Global Credentials V2 .
Args:
id(str): id path parameter. global credential id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!delete-device-credential
"""
check_type(headers, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/device-credential/{id}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.delete(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.delete(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_e8e021f1c51eeaf0d102084481486_v2_3_7_6", json_data
)
[docs] def get_global_pool_v1(
self, limit=None, offset=None, headers=None, **request_parameters
):
"""API to get the global pool. .
Args:
offset(int): offset query parameter. Offset/starting row. Indexed from 1. Default value of 1. .
limit(int): limit query parameter. Number of Global Pools to be retrieved. Default is 25 if not
specified. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!get-global-pool
"""
check_type(headers, dict)
check_type(offset, int)
check_type(limit, int)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"offset": offset,
"limit": limit,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/global-pool"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_ebdcd84fc41754a69eaeacf7c0b0731c_v2_3_7_6", json_data
)
[docs] def update_global_pool_v1(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to update global pool .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!update-global-pool
"""
check_type(headers, dict)
check_type(payload, dict)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_c380301e3e05423bdc1857ff00ae77a_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/global-pool"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_c380301e3e05423bdc1857ff00ae77a_v2_3_7_6", json_data
)
[docs] def create_global_pool_v1(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to create global pool. .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!create-global-pool
"""
check_type(headers, dict)
check_type(payload, dict)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_eecf4323cb285985be72a7e061891059_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/global-pool"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_eecf4323cb285985be72a7e061891059_v2_3_7_6", json_data
)
[docs] def delete_global_ip_pool_v1(self, id, headers=None, **request_parameters):
"""API to delete global IP pool. .
Args:
id(str): id path parameter. global pool id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!delete-global-i-p-pool
"""
check_type(headers, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/global-pool/{id}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.delete(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.delete(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_f9079863c95acd945c51f728cbf81f_v2_3_7_6", json_data
)
[docs] def get_network_v1(self, site_id=None, headers=None, **request_parameters):
"""API to get DHCP and DNS center server details. .
Args:
site_id(str): siteId query parameter. Site id to get the network settings associated with the
site. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!get-network
"""
check_type(headers, dict)
check_type(site_id, str)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"siteId": site_id,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/network"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_b199c175281977a7e9e6bd9255b_v2_3_7_6", json_data
)
[docs] def create_network_v1(
self,
site_id,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to create a network for DHCP, Syslog, SNMP, NTP, Network AAA, Client and EndPoint AAA, and/or DNS center
server settings. .
Args:
settings(object): Network Settings's settings.
site_id(str): siteId path parameter. Site id to which site details to associate with the network
settings. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!create-network
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(site_id, str, may_be_none=False)
if headers is not None:
if "__persistbapioutput" in headers:
check_type(headers.get("__persistbapioutput"), bool)
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"siteId": site_id,
}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_eca62ef076b5627a85b2a5959613fb8_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/network/{siteId}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_eca62ef076b5627a85b2a5959613fb8_v2_3_7_6", json_data
)
[docs] def update_network_v1(
self,
site_id,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to update network settings for DHCP, Syslog, SNMP, NTP, Network AAA, Client and EndPoint AAA, and/or DNS
server settings. .
Args:
settings(object): Network Settings's settings.
site_id(str): siteId path parameter. Site id to update the network settings which is associated
with the site .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!update-network
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(site_id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"siteId": site_id,
}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_e1b8c435195d56368c24a54dcce007d0_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/network/{siteId}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_e1b8c435195d56368c24a54dcce007d0_v2_3_7_6", json_data
)
[docs] def get_reserve_ip_subpool_v1(
self,
group_name=None,
ignore_inherited_groups=None,
limit=None,
offset=None,
pool_usage=None,
site_id=None,
headers=None,
**request_parameters
):
"""API to get the ip subpool info. .
Args:
site_id(str): siteId query parameter. site id of site from which to retrieve associated reserve
pools. Either siteId (per site queries) or ignoreInheritedGroups must be used. They can
also be used together. .
offset(int): offset query parameter. offset/starting row. Indexed from 1. .
limit(int): limit query parameter. Number of reserve pools to be retrieved. Default is 25 if not
specified. Maximum allowed limit is 500. .
ignore_inherited_groups(str): ignoreInheritedGroups query parameter. Ignores pools inherited from
parent site. Either siteId or ignoreInheritedGroups must be passed. They can also be
used together. .
pool_usage(str): poolUsage query parameter. Can take values empty, partially-full or empty-
partially-full .
group_name(str): groupName query parameter. Name of the group .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!get-reserve-i-p-subpool
"""
check_type(headers, dict)
check_type(site_id, str)
check_type(offset, int)
check_type(limit, int)
check_type(ignore_inherited_groups, str)
check_type(pool_usage, str)
check_type(group_name, str)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"siteId": site_id,
"offset": offset,
"limit": limit,
"ignoreInheritedGroups": ignore_inherited_groups,
"poolUsage": pool_usage,
"groupName": group_name,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/reserve-ip-subpool"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_d84253559e9d3e81881a4bd2fc_v2_3_7_6", json_data
)
[docs] def release_reserve_ip_subpool_v1(self, id, headers=None, **request_parameters):
"""API to delete the reserved ip subpool .
Args:
id(str): id path parameter. Id of reserve ip subpool to be deleted. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!release-reserve-i-p-subpool
"""
check_type(headers, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/reserve-ip-subpool/{id}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.delete(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.delete(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_eabbb425255a57578e9db00cda1f303a_v2_3_7_6", json_data
)
[docs] def reserve_ip_subpool_v1(
self,
site_id,
ipv4DhcpServers=None,
ipv4DnsServers=None,
ipv4GateWay=None,
ipv4GlobalPool=None,
ipv4Prefix=None,
ipv4PrefixLength=None,
ipv4Subnet=None,
ipv4TotalHost=None,
ipv6AddressSpace=None,
ipv6DhcpServers=None,
ipv6DnsServers=None,
ipv6GateWay=None,
ipv6GlobalPool=None,
ipv6Prefix=None,
ipv6PrefixLength=None,
ipv6Subnet=None,
ipv6TotalHost=None,
name=None,
slaacSupport=None,
type=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to reserve an ip subpool from the global pool .
Args:
ipv4DhcpServers(list): Network Settings's IPv4 input for dhcp server ip example: ["1.1.1.1"] (list of
strings).
ipv4DnsServers(list): Network Settings's IPv4 input for dns server ip example: ["4.4.4.4"] (list of
strings).
ipv4GateWay(string): Network Settings's Gateway ip address details, example: 175.175.0.1 .
ipv4GlobalPool(string): Network Settings's IP v4 Global pool address with cidr, example: 175.175.0.0/16
.
ipv4Prefix(boolean): Network Settings's IPv4 prefix value is true, the ip4 prefix length input field is
enabled , if it is false ipv4 total Host input is enable .
ipv4PrefixLength(integer): Network Settings's The ipv4 prefix length is required when ipv4prefix value
is true. .
ipv4Subnet(string): Network Settings's IPv4 Subnet address, example: 175.175.0.0. Either ipv4Subnet or
ipv4TotalHost needs to be passed if creating IPv4 subpool. .
ipv4TotalHost(integer): Network Settings's IPv4 total host is required when ipv4prefix value is false. .
ipv6AddressSpace(boolean): Network Settings's If the value is omitted or false only ipv4 input are
required, otherwise both ipv6 and ipv4 are required .
ipv6DhcpServers(list): Network Settings's IPv6 format dhcp server as input example : ["2001:db8::1234"]
(list of strings).
ipv6DnsServers(list): Network Settings's IPv6 format dns server input example: ["2001:db8::1234"] (list
of strings).
ipv6GateWay(string): Network Settings's Gateway ip address details, example: 2001:db8:85a3:0:100::1 .
ipv6GlobalPool(string): Network Settings's IPv6 Global pool address with cidr this is required when
Ipv6AddressSpace value is true, example: 2001:db8:85a3::/64 .
ipv6Prefix(boolean): Network Settings's Ipv6 prefix value is true, the ip6 prefix length input field is
enabled , if it is false ipv6 total Host input is enable .
ipv6PrefixLength(integer): Network Settings's IPv6 prefix length is required when the ipv6prefix value
is true .
ipv6Subnet(string): Network Settings's IPv6 Subnet address, example :2001:db8:85a3:0:100::. Either
ipv6Subnet or ipv6TotalHost needs to be passed if creating IPv6 subpool. .
ipv6TotalHost(integer): Network Settings's IPv6 total host is required when ipv6prefix value is false. .
name(string): Network Settings's Name of the reserve ip sub pool .
slaacSupport(boolean): Network Settings's Slaac Support.
type(string): Network Settings's Type of the reserve ip sub pool . Available values are 'Generic',
'LAN', 'WAN', 'management' and 'service'.
site_id(str): siteId path parameter. Site id to reserve the ip sub pool. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!reserve-ip-subpool
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(site_id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"siteId": site_id,
}
_payload = {
"name": name,
"type": type,
"ipv6AddressSpace": ipv6AddressSpace,
"ipv4GlobalPool": ipv4GlobalPool,
"ipv4Prefix": ipv4Prefix,
"ipv4PrefixLength": ipv4PrefixLength,
"ipv4Subnet": ipv4Subnet,
"ipv4GateWay": ipv4GateWay,
"ipv4DhcpServers": ipv4DhcpServers,
"ipv4DnsServers": ipv4DnsServers,
"ipv6GlobalPool": ipv6GlobalPool,
"ipv6Prefix": ipv6Prefix,
"ipv6PrefixLength": ipv6PrefixLength,
"ipv6Subnet": ipv6Subnet,
"ipv6GateWay": ipv6GateWay,
"ipv6DhcpServers": ipv6DhcpServers,
"ipv6DnsServers": ipv6DnsServers,
"ipv4TotalHost": ipv4TotalHost,
"ipv6TotalHost": ipv6TotalHost,
"slaacSupport": slaacSupport,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator("jsd_cec6c85d9bb4bcc8f61f31296b_v2_3_7_6").validate(
_payload
)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/reserve-ip-subpool/{siteId}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_cec6c85d9bb4bcc8f61f31296b_v2_3_7_6", json_data
)
[docs] def update_reserve_ip_subpool_v1(
self,
id,
site_id,
ipv4DhcpServers=None,
ipv4DnsServers=None,
ipv4GateWay=None,
ipv6AddressSpace=None,
ipv6DhcpServers=None,
ipv6DnsServers=None,
ipv6GateWay=None,
ipv6GlobalPool=None,
ipv6Prefix=None,
ipv6PrefixLength=None,
ipv6Subnet=None,
ipv6TotalHost=None,
name=None,
slaacSupport=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to update ip subpool from the global pool .
Args:
ipv4DhcpServers(list): Network Settings's IPv4 input for dhcp server ip example: ["1.1.1.1"] (list of
strings).
ipv4DnsServers(list): Network Settings's IPv4 input for dns server ip example: ["4.4.4.4"] (list of
strings).
ipv4GateWay(string): Network Settings's Gateway ip address details, example: 175.175.0.1 .
ipv6AddressSpace(boolean): Network Settings's If the value is false only ipv4 input are required. NOTE
if value is false then any existing ipv6 subpool in the group will be removed. .
ipv6DhcpServers(list): Network Settings's IPv6 format dhcp server as input example : ["2001:db8::1234"]
(list of strings).
ipv6DnsServers(list): Network Settings's IPv6 format dns server input example: ["2001:db8::1234"] (list
of strings).
ipv6GateWay(string): Network Settings's Gateway ip address details, example: 2001:db8:85a3:0:100::1 .
ipv6GlobalPool(string): Network Settings's IPv6 Global pool address with cidr this is required when
Ipv6AddressSpace value is true, example: 2001:db8:85a3::/64 .
ipv6Prefix(boolean): Network Settings's Ipv6 prefix value is true, the ip6 prefix length input field is
enabled, if it is false ipv6 total Host input is enable .
ipv6PrefixLength(integer): Network Settings's IPv6 prefix length is required when the ipv6prefix value
is true .
ipv6Subnet(string): Network Settings's IPv6 Subnet address, example :2001:db8:85a3:0:100::. .
ipv6TotalHost(integer): Network Settings's Size of pool in terms of number of IPs. IPv6 total host is
required when ipv6prefix value is false. .
name(string): Network Settings's Name of the reserve ip sub pool .
slaacSupport(boolean): Network Settings's Slaac Support.
site_id(str): siteId path parameter. Site id of site to update sub pool. .
id(str): id query parameter. Id of subpool group .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!update-reserve-ip-subpool
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(id, str, may_be_none=False)
check_type(site_id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"id": id,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"siteId": site_id,
}
_payload = {
"name": name,
"ipv6AddressSpace": ipv6AddressSpace,
"ipv4DhcpServers": ipv4DhcpServers,
"ipv4DnsServers": ipv4DnsServers,
"ipv6GlobalPool": ipv6GlobalPool,
"ipv6Prefix": ipv6Prefix,
"ipv6PrefixLength": ipv6PrefixLength,
"ipv6Subnet": ipv6Subnet,
"ipv6TotalHost": ipv6TotalHost,
"ipv6GateWay": ipv6GateWay,
"ipv6DhcpServers": ipv6DhcpServers,
"ipv6DnsServers": ipv6DnsServers,
"slaacSupport": slaacSupport,
"ipv4GateWay": ipv4GateWay,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_fd6083b0c65d03b2d53f10b3ece59d_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/reserve-ip-subpool/{siteId}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_fd6083b0c65d03b2d53f10b3ece59d_v2_3_7_6", json_data
)
[docs] def get_service_provider_details_v1(self, headers=None, **request_parameters):
"""API to get service provider details (QoS). .
Args:
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!get-service-provider-details
"""
check_type(headers, dict)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/service-provider"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_dda850a0675b888048adf8d488aec1_v2_3_7_6", json_data
)
[docs] def create_sp_profile_v1(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to create Service Provider Profile(QOS). .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!create-sp-profile
"""
check_type(headers, dict)
check_type(payload, dict)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_ffa347eb411567a9c793696795250a5_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/service-provider"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_ffa347eb411567a9c793696795250a5_v2_3_7_6", json_data
)
[docs] def update_sp_profile_v1(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to update Service Provider Profile (QoS). .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!update-sp-profile
"""
check_type(headers, dict)
check_type(payload, dict)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_e22c99a82f5764828810acb45e7a9e_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/service-provider"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_e22c99a82f5764828810acb45e7a9e_v2_3_7_6", json_data
)
[docs] def sync_network_devices_credential_v1(
self,
deviceCredentialId=None,
siteId=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""When sync is triggered at a site with the credential that are associated to the same site, network devices in
impacted sites (child sites which are inheriting the credential) get managed in inventory with the
associated site credential. Credential gets configured on network devices before these get managed in
inventory. Please make a note that cli credential wouldn't be configured on AAA authenticated devices
but they just get managed with the associated site cli credential. .
Args:
deviceCredentialId(string): Network Settings's It must be cli/snmpV2Read/snmpV2Write/snmpV3 Id. .
siteId(string): Network Settings's Site Id. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!sync-network-devices-credential
"""
check_type(headers, dict)
check_type(payload, dict)
if headers is not None:
if "Content-Type" in headers:
check_type(headers.get("Content-Type"), str, may_be_none=False)
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
_payload = {
"deviceCredentialId": deviceCredentialId,
"siteId": siteId,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_e73b352ff2573aab906c2ad75c5a71_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/deviceCredentials/apply"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_e73b352ff2573aab906c2ad75c5a71_v2_3_7_6", json_data
)
[docs] def set_aaa_settings_for_a_site_v1(
self,
id,
aaaClient=None,
aaaNetwork=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""Set AAA settings for a site; `null` values indicate that the settings will be inherited from the parent site;
empty objects (`{}`) indicate that the settings is unset. .
Args:
aaaClient(object): Network Settings's aaaClient.
aaaNetwork(object): Network Settings's aaaNetwork.
id(str): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!set-aaa-settings-for-a-site
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "Content-Type" in headers:
check_type(headers.get("Content-Type"), str, may_be_none=False)
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
json_null = True
_payload = {
"aaaNetwork": aaaNetwork,
"aaaClient": aaaClient,
}
if payload == {}:
_payload = payload
json_null = False
if payload != None:
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator("jsd_cd2e825a78b6de087e991f6fe0_v2_3_7_6").validate(
_payload
)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/aaaSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url,
params=_params,
json_null=json_null,
json=_payload,
headers=_headers,
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json_null=json_null, json=_payload
)
return self._object_factory(
"bpm_cd2e825a78b6de087e991f6fe0_v2_3_7_6", json_data
)
[docs] def retrieve_aaa_settings_for_a_site_v1(
self, id, inherited=None, headers=None, **request_parameters
):
"""Retrieve AAA settings for a site; `null` values indicate that the setting will be inherited from the parent
site; empty objects (`{}`) indicate that the setting is unset at a site. .
Args:
id(str): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!retrieve-aaa-settings-for-a-site
"""
check_type(headers, dict)
check_type(inherited, bool)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"_inherited": inherited,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/aaaSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_c13899171d45b4f828423c6feaa1e46_v2_3_7_6", json_data
)
[docs] def retrieve_banner_settings_for_a_site_v1(
self, id, inherited=None, headers=None, **request_parameters
):
"""Retrieve banner settings for a site; `null` values indicate that the setting will be inherited from the parent
site; empty objects (`{}`) indicate that the setting is unset at a site. .
Args:
id(str): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!retrieve-banner-settings-for-a-site
"""
check_type(headers, dict)
check_type(inherited, bool)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"_inherited": inherited,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/bannerSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_b29d90ce0125ad898bc06bbceb07403_v2_3_7_6", json_data
)
[docs] def set_banner_settings_for_a_site_v1(
self,
id,
banner=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""Set banner settings for a site; `null` values indicate that the setting will be inherited from the parent site;
empty objects (`{}`) indicate that the settings is unset. .
Args:
banner(object): Network Settings's banner.
id(str): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!set-banner-settings-for-a-site
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
json_null = True
if banner == {}:
_payload = banner
json_null = False
else:
_payload = {
"banner": banner,
}
if banner == None and payload != None:
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_b3c4383ecc13514c85c6f3d8484f6d68_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/bannerSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url,
params=_params,
json=_payload,
json_null=json_null,
headers=_headers,
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json_null=json_null, json=_payload
)
return self._object_factory(
"bpm_b3c4383ecc13514c85c6f3d8484f6d68_v2_3_7_6", json_data
)
[docs] def get_device_credential_settings_for_a_site_v1(
self, id, inherited=None, headers=None, **request_parameters
):
"""Gets device credential settings for a site; `null` values indicate that the setting will be inherited from the
parent site; empty objects (`{}`) indicate that the credential is unset, and that no credential of that
type will be used for the site. .
Args:
id(str): id path parameter. Site Id, retrievable from the `id` attribute in
`/dna/intent/api/v1/sites` .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!get-device-credential-settings-for-a-site
"""
check_type(headers, dict)
check_type(inherited, bool)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"_inherited": inherited,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/deviceCredentials"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_e4e92f7adc845290b11168e59ab4c88b_v2_3_7_6", json_data
)
[docs] def update_device_credential_settings_for_a_site_v1(
self,
id,
cliCredentialsId=None,
httpReadCredentialsId=None,
httpWriteCredentialsId=None,
snmpv2cReadCredentialsId=None,
snmpv2cWriteCredentialsId=None,
snmpv3CredentialsId=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""Updates device credential settings for a site; `null` values indicate that the setting will be inherited from
the parent site; empty objects (`{}`) indicate that the credential is unset, and that no credential of
that type will be used for the site. .
Args:
cliCredentialsId(object): Network Settings's cliCredentialsId.
httpReadCredentialsId(object): Network Settings's httpReadCredentialsId.
httpWriteCredentialsId(object): Network Settings's httpWriteCredentialsId.
snmpv2cReadCredentialsId(object): Network Settings's snmpv2cReadCredentialsId.
snmpv2cWriteCredentialsId(object): Network Settings's snmpv2cWriteCredentialsId.
snmpv3CredentialsId(object): Network Settings's snmpv3CredentialsId.
id(str): id path parameter. Site Id, retrievable from the `id` attribute in
`/dna/intent/api/v1/sites` .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!update-device-credential-settings-for-a-site
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
_payload = {
"cliCredentialsId": cliCredentialsId,
"snmpv2cReadCredentialsId": snmpv2cReadCredentialsId,
"snmpv2cWriteCredentialsId": snmpv2cWriteCredentialsId,
"snmpv3CredentialsId": snmpv3CredentialsId,
"httpReadCredentialsId": httpReadCredentialsId,
"httpWriteCredentialsId": httpWriteCredentialsId,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_e481654675355408be8daff9a82f9a0_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/deviceCredentials"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_e481654675355408be8daff9a82f9a0_v2_3_7_6", json_data
)
[docs] def get_network_devices_credentials_sync_status_v1(
self, id, headers=None, **request_parameters
):
"""Get network devices credentials sync status at a given site. .
Args:
id(str): id path parameter. Site Id. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!get-network-devices-credentials-sync-status
"""
check_type(headers, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/deviceCredentials/status"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_be59a332e9e45f6991e96111743fd775_v2_3_7_6", json_data
)
[docs] def set_dhcp_settings_for_a_site_v1(
self,
id,
dhcp=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""Set DHCP settings for a site; `null` values indicate that the setting will be inherited from the parent site;
empty objects (`{}`) indicate that the settings is unset. .
Args:
dhcp(object): Network Settings's dhcp.
id(str): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!set-dhcp-settings-for-a-site
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "Content-Type" in headers:
check_type(headers.get("Content-Type"), str, may_be_none=False)
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
json_null = True
if dhcp == {}:
_payload = dhcp
json_null = False
else:
_payload = {
"dhcp": dhcp,
}
if dhcp == None and payload != None:
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_a15a2f83f975a6a9964e7da79a605de_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/dhcpSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url,
params=_params,
json_null=json_null,
json=_payload,
headers=_headers,
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json_null=json_null, json=_payload
)
return self._object_factory(
"bpm_a15a2f83f975a6a9964e7da79a605de_v2_3_7_6", json_data
)
[docs] def retrieve_d_h_c_p_settings_for_a_site_v1(
self, id, inherited=None, headers=None, **request_parameters
):
"""Retrieve DHCP settings for a site; `null` values indicate that the setting will be inherited from the parent
site; empty objects (`{}`) indicate that the setting is unset at a site. .
Args:
id(str): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!retrieve-dh-cp-settings-for-a-site
"""
check_type(headers, dict)
check_type(inherited, bool)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"_inherited": inherited,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/dhcpSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_fe723d00fce5700b8abe2a43b82f035_v2_3_7_6", json_data
)
[docs] def retrieve_d_n_s_settings_for_a_site_v1(
self, id, inherited=None, headers=None, **request_parameters
):
"""Retrieve DNS settings for a site; `null` values indicate that the setting will be inherited from the parent
site; empty objects (`{}`) indicate that the setting is unset at a site. .
Args:
id(str): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!retrieve-dns-settings-for-a-site
"""
check_type(headers, dict)
check_type(inherited, bool)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"_inherited": inherited,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/dnsSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_f32e172f454564ba92d7a410c63c164_v2_3_7_6", json_data
)
[docs] def set_d_n_s_settings_for_a_site_v1(
self,
id,
dns=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""Set DNS settings for a site; `null` values indicate that the setting will be inherited from the parent site;
empty objects (`{}`) indicate that the settings is unset. .
Args:
dns(object): Network Settings's dns.
id(str): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!set-dns-settings-for-a-site
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
json_null = True
if dns == {}:
_payload = dns
json_null = False
else:
_payload = {
"dns": dns,
}
if payload != None:
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_eb3b18894545315b25b94d0c0e2ec67_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/dnsSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url,
params=_params,
json_null=json_null,
json=_payload,
headers=_headers,
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json_null=json_null, json=_payload
)
return self._object_factory(
"bpm_eb3b18894545315b25b94d0c0e2ec67_v2_3_7_6", json_data
)
[docs] def set_image_distribution_settings_for_a_site_v1(
self,
id,
imageDistribution=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""Set image distribution settings for a site; `null` values indicate that the setting will be inherited from the
parent site; empty objects (`{}`) indicate that the settings is unset. .
Args:
imageDistribution(object): Network Settings's imageDistribution.
id(str): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!set-image-distribution-settings-for-a-site
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "Content-Type" in headers:
check_type(headers.get("Content-Type"), str, may_be_none=False)
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
_payload = {
"imageDistribution": imageDistribution,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_d02614492a2251c18de2e36c097e40ff_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/imageDistributionSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_d02614492a2251c18de2e36c097e40ff_v2_3_7_6", json_data
)
[docs] def retrieve_image_distribution_settings_for_a_site_v1(
self, id, inherited=None, headers=None, **request_parameters
):
"""Retrieve image distribution settings for a site; `null` values indicate that the setting will be inherited from
the parent site; empty objects (`{}`) indicate that the setting is unset at a site. .
Args:
id(str): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!retrieve-image-distribution-settings-for-a-site
"""
check_type(headers, dict)
check_type(inherited, bool)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"_inherited": inherited,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/imageDistributionSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_d0c5259b59bd5751994e2aa77a15f70e_v2_3_7_6", json_data
)
[docs] def set_n_t_p_settings_for_a_site_v1(
self,
id,
ntp=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""Set NTP settings for a site; `null` values indicate that the setting will be inherited from the parent site;
empty objects (`{}`) indicate that the settings is unset. .
Args:
ntp(object): Network Settings's ntp.
id(str): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!set-ntp-settings-for-a-site
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "Content-Type" in headers:
check_type(headers.get("Content-Type"), str, may_be_none=False)
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
json_null = True
if ntp == {}:
_payload = ntp
json_null = False
else:
_payload = {
"ntp": ntp,
}
if payload != None:
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_df9ec5aa58815a849b4853b223343e5e_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/ntpSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url,
params=_params,
json_null=json_null,
json=_payload,
headers=_headers,
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json_null=json_null, json=_payload
)
return self._object_factory(
"bpm_df9ec5aa58815a849b4853b223343e5e_v2_3_7_6", json_data
)
[docs] def retrieve_n_t_p_settings_for_a_site_v1(
self, id, inherited=None, headers=None, **request_parameters
):
"""Retrieve NTP settings for a site; `null` values indicate that the setting will be inherited from the parent
site; empty objects (`{}`) indicate that the setting is unset at a site. .
Args:
id(str): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!retrieve-ntp-settings-for-a-site
"""
check_type(headers, dict)
check_type(inherited, bool)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"_inherited": inherited,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/ntpSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_c49b666d3a305b509d0d3b356e912ab4_v2_3_7_6", json_data
)
[docs] def retrieve_telemetry_settings_for_a_site_v1(
self, id, inherited=None, headers=None, **request_parameters
):
"""Retrieves telemetry settings for the given site. `null` values indicate that the setting will be inherited from
the parent site. .
Args:
id(str): id path parameter. Site Id, retrievable from the `id` attribute in
`/dna/intent/api/v1/sites` .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!retrieve-telemetry-settings-for-a-site
"""
check_type(headers, dict)
check_type(inherited, bool)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"_inherited": inherited,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/telemetrySettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_af4b3c5d1dc6505cadd13bf41c894700_v2_3_7_6", json_data
)
[docs] def set_telemetry_settings_for_a_site_v1(
self,
id,
applicationVisibility=None,
snmpTraps=None,
syslogs=None,
wiredDataCollection=None,
wirelessTelemetry=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""Sets telemetry settings for the given site; `null` values indicate that the setting will be inherited from the
parent site. .
Args:
applicationVisibility(object): Network Settings's applicationVisibility.
snmpTraps(object): Network Settings's snmpTraps.
syslogs(object): Network Settings's syslogs.
wiredDataCollection(object): Network Settings's wiredDataCollection.
wirelessTelemetry(object): Network Settings's wirelessTelemetry.
id(str): id path parameter. Site Id, retrievable from the `id` attribute in
`/dna/intent/api/v1/sites` .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!set-telemetry-settings-for-a-site
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
json_null = True
_payload = {
"wiredDataCollection": wiredDataCollection,
"wirelessTelemetry": wirelessTelemetry,
"snmpTraps": snmpTraps,
"syslogs": syslogs,
"applicationVisibility": applicationVisibility,
}
if (
wiredDataCollection == None
and wirelessTelemetry == None
and snmpTraps == None
and syslogs == None
and applicationVisibility == None
):
_payload = {
"wiredDataCollection": None,
"wirelessTelemetry": None,
"snmpTraps": None,
"syslogs": None,
"applicationVisibility": None,
}
json_null = False
else:
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_bac0c488707959c182dfef18681bceda_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/telemetrySettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url,
params=_params,
json_null=json_null,
json=_payload,
headers=_headers,
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json_null=json_null, json=_payload
)
return self._object_factory(
"bpm_bac0c488707959c182dfef18681bceda_v2_3_7_6", json_data
)
[docs] def set_time_zone_for_a_site_v1(
self,
id,
timeZone=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""Set time zone settings for a site; `null` values indicate that the setting will be inherited from the parent
site; empty objects (`{}`) indicate that the settings is unset. .
Args:
timeZone(object): Network Settings's timeZone.
id(str): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!set-time-zone-for-a-site
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(id, str, may_be_none=False)
if headers is not None:
if "Content-Type" in headers:
check_type(headers.get("Content-Type"), str, may_be_none=False)
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
json_null = True
if timeZone == {}:
_payload = timeZone
json_null = False
else:
_payload = {
"timeZone": timeZone,
}
if payload != None:
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_c17432d928f755f8bb9f4edb83089d3e_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/timeZoneSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url,
params=_params,
json_null=json_null,
json=_payload,
headers=_headers,
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json_null=json_null, json=_payload
)
return self._object_factory(
"bpm_c17432d928f755f8bb9f4edb83089d3e_v2_3_7_6", json_data
)
[docs] def retrieve_time_zone_settings_for_a_site_v1(
self, id, inherited=None, headers=None, **request_parameters
):
"""Retrieve time zone settings for a site; `null` values indicate that the setting will be inherited from the
parent site; empty objects (`{}`) indicate that the setting is unset at a site. .
Args:
id(str): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!retrieve-time-zone-settings-for-a-site
"""
check_type(headers, dict)
check_type(inherited, bool)
check_type(id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"_inherited": inherited,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"id": id,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sites/{id}/timeZoneSettings"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_a03efc6bba51eeabcde938f0856074_v2_3_7_6", json_data
)
[docs] def delete_sp_profile_v1(self, sp_profile_name, headers=None, **request_parameters):
"""API to delete Service Provider Profile (QoS). .
Args:
sp_profile_name(str): spProfileName path parameter. sp profile name .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!delete-sp-profile
"""
check_type(headers, dict)
check_type(sp_profile_name, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"spProfileName": sp_profile_name,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v1/sp-profile/{spProfileName}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.delete(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.delete(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_a1d68f15e02adc37239b3fcbbb6_v2_3_7_6", json_data
)
[docs] def assign_device_credential_to_site_v2(
self,
site_id,
cliId=None,
httpRead=None,
httpWrite=None,
snmpV2ReadId=None,
snmpV2WriteId=None,
snmpV3Id=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to assign Device Credential to a site. .
Args:
cliId(string): Network Settings's CLI Credential Id .
httpRead(string): Network Settings's HTTP(S) Read Credential Id .
httpWrite(string): Network Settings's HTTP(S) Write Credential Id .
snmpV2ReadId(string): Network Settings's SNMPv2c Read Credential Id .
snmpV2WriteId(string): Network Settings's SNMPv2c Write Credential Id .
snmpV3Id(string): Network Settings's SNMPv3 Credential Id .
site_id(str): siteId path parameter. Site Id to assign credential. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!assign-device-credential-to-site-v2
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(site_id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"siteId": site_id,
}
_payload = {
"cliId": cliId,
"snmpV2ReadId": snmpV2ReadId,
"snmpV2WriteId": snmpV2WriteId,
"snmpV3Id": snmpV3Id,
"httpRead": httpRead,
"httpWrite": httpWrite,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_a3954b27e5eeb82789ed231e0557f_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v2/credential-to-site/{siteId}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_a3954b27e5eeb82789ed231e0557f_v2_3_7_6", json_data
)
[docs] def get_network_v2(self, site_id, headers=None, **request_parameters):
"""API to get SNMP, NTP, Network AAA, Client and Endpoint AAA, and/or DNS center server settings. .
Args:
site_id(str): siteId query parameter. Site Id to get the network settings associated with the
site. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!get-network-v2
"""
check_type(headers, dict)
check_type(site_id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {
"siteId": site_id,
}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v2/network"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_d0b7bffe821755dab4e2a2df8ea79404_v2_3_7_6", json_data
)
[docs] def create_network_v2(
self,
site_id,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to create network settings for DHCP, Syslog, SNMP, NTP, Network AAA, Client and Endpoint AAA, and/or DNS
center server settings. .
Args:
settings(object): Network Settings's settings.
site_id(str): siteId path parameter. Site Id to which site details to associate with the network
settings. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!create-network-v2
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(site_id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"siteId": site_id,
}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_c5f97865727857d5b1eeaedee3dcccd2_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v2/network/{siteId}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_c5f97865727857d5b1eeaedee3dcccd2_v2_3_7_6", json_data
)
[docs] def update_network_v2(
self,
site_id,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to update network settings for DHCP, Syslog, SNMP, NTP, Network AAA, Client and Endpoint AAA, and/or DNS
center server settings. .
Args:
settings(object): Network Settings's settings.
site_id(str): siteId path parameter. Site Id to update the network settings which is associated
with the site .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!update-network-v2
"""
check_type(headers, dict)
check_type(payload, dict)
check_type(site_id, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"siteId": site_id,
}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_a7935eedd53a5b8c84668c903cc1c705_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v2/network/{siteId}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_a7935eedd53a5b8c84668c903cc1c705_v2_3_7_6", json_data
)
[docs] def create_sp_profile_v2(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to create Service Provider Profile(QOS). .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!create-sp-profile-v2
"""
check_type(headers, dict)
check_type(payload, dict)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator(
"jsd_a66db26df529597c84c2a15ea2d632ce_v2_3_7_6"
).validate(_payload)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v2/service-provider"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.post(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory(
"bpm_a66db26df529597c84c2a15ea2d632ce_v2_3_7_6", json_data
)
[docs] def update_sp_profile_v2(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""API to update Service Provider Profile (QoS). .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(dict): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!update-sp-profile-v2
"""
check_type(headers, dict)
check_type(payload, dict)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
_payload = {
"settings": settings,
}
_payload.update(payload or {})
_payload = dict_from_items_with_values(_payload)
if active_validation:
self._request_validator("jsd_e0b654c39dc6e19cd6f5194d_v2_3_7_6").validate(
_payload
)
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v2/service-provider"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload, headers=_headers
)
else:
json_data = self._session.put(
endpoint_full_url, params=_params, json=_payload
)
return self._object_factory("bpm_e0b654c39dc6e19cd6f5194d_v2_3_7_6", json_data)
[docs] def get_service_provider_details_v2(self, headers=None, **request_parameters):
"""API to get Service Provider details (QoS). .
Args:
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!get-service-provider-details-v2
"""
check_type(headers, dict)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v2/service-provider"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.get(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.get(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_f01025635a52bdfdac7226911b31_v2_3_7_6", json_data
)
[docs] def delete_sp_profile_v2(self, sp_profile_name, headers=None, **request_parameters):
"""API to delete Service Provider Profile (QoS). .
Args:
sp_profile_name(str): spProfileName path parameter. SP profile name .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
MyDict: JSON response. Access the object's properties by using
the dot notation or the bracket notation.
Raises:
TypeError: If the parameter types are incorrect.
MalformedRequest: If the request body created is invalid.
ApiError: If the DNA Center cloud returns an error.
Documentation Link:
https://developer.cisco.com/docs/dna-center/#!delete-sp-profile-v2
"""
check_type(headers, dict)
check_type(sp_profile_name, str, may_be_none=False)
if headers is not None:
if "X-Auth-Token" in headers:
check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
_params = {}
_params.update(request_parameters)
_params = dict_from_items_with_values(_params)
path_params = {
"spProfileName": sp_profile_name,
}
with_custom_headers = False
_headers = self._session.headers or {}
if headers:
_headers.update(dict_of_str(headers))
with_custom_headers = True
e_url = "/dna/intent/api/v2/sp-profile/{spProfileName}"
endpoint_full_url = apply_path_params(e_url, path_params)
if with_custom_headers:
json_data = self._session.delete(
endpoint_full_url, params=_params, headers=_headers
)
else:
json_data = self._session.delete(endpoint_full_url, params=_params)
return self._object_factory(
"bpm_a9bbbce953615baeb0a324c61753139d_v2_3_7_6", json_data
)
# Alias Function
[docs] def set_image_distribution_settings_for_a_site(
self,
id,
imageDistribution=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of set_image_distribution_settings_for_a_site_v1 .
Args:
imageDistribution(object): Network Settings's imageDistribution.
id(basestring): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of set_image_distribution_settings_for_a_site_v1 .
"""
return self.set_image_distribution_settings_for_a_site_v1(
id=id,
imageDistribution=imageDistribution,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def delete_sp_profile(self, sp_profile_name, headers=None, **request_parameters):
"""This function is an alias of delete_sp_profile_v1 .
Args:
sp_profile_name(basestring): spProfileName path parameter. sp profile name .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of delete_sp_profile_v1 .
"""
return self.delete_sp_profile_v1(
sp_profile_name=sp_profile_name, headers=headers, **request_parameters
)
# Alias Function
[docs] def set_dhcp_settings_for_a_site(
self,
id,
dhcp=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of set_dhcp_settings_for_a_site_v1 .
Args:
dhcp(object): Network Settings's dhcp.
id(basestring): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of set_dhcp_settings_for_a_site_v1 .
"""
return self.set_dhcp_settings_for_a_site_v1(
id=id,
dhcp=dhcp,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def get_device_credential_settings_for_a_site(
self, id, inherited=None, headers=None, **request_parameters
):
"""This function is an alias of get_device_credential_settings_for_a_site_v1 .
Args:
id(basestring): id path parameter. Site Id, retrievable from the `id` attribute in
`/dna/intent/api/v1/sites` .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of get_device_credential_settings_for_a_site_v1 .
"""
return self.get_device_credential_settings_for_a_site_v1(
id=id, inherited=inherited, headers=headers, **request_parameters
)
# Alias Function
[docs] def retrieve_d_h_c_p_settings_for_a_site(
self, id, inherited=None, headers=None, **request_parameters
):
"""This function is an alias of retrieve_d_h_c_p_settings_for_a_site_v1 .
Args:
id(basestring): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of retrieve_d_h_c_p_settings_for_a_site_v1 .
"""
return self.retrieve_d_h_c_p_settings_for_a_site_v1(
id=id, inherited=inherited, headers=headers, **request_parameters
)
# Alias Function
[docs] def release_reserve_ip_subpool(self, id, headers=None, **request_parameters):
"""This function is an alias of release_reserve_ip_subpool_v1 .
Args:
id(basestring): id path parameter. Id of reserve ip subpool to be deleted. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of release_reserve_ip_subpool_v1 .
"""
return self.release_reserve_ip_subpool_v1(
id=id, headers=headers, **request_parameters
)
# Alias Function
[docs] def delete_device_credential(self, id, headers=None, **request_parameters):
"""This function is an alias of delete_device_credential_v1 .
Args:
id(basestring): id path parameter. global credential id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of delete_device_credential_v1 .
"""
return self.delete_device_credential_v1(
id=id, headers=headers, **request_parameters
)
# Alias Function
[docs] def get_service_provider_details(self, headers=None, **request_parameters):
"""This function is an alias of get_service_provider_details_v1 .
Args:
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of get_service_provider_details_v1 .
"""
return self.get_service_provider_details_v1(
headers=headers, **request_parameters
)
# Alias Function
[docs] def create_sp_profile(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of create_sp_profile_v1 .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of create_sp_profile_v1 .
"""
return self.create_sp_profile_v1(
settings=settings,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def retrieve_banner_settings_for_a_site(
self, id, inherited=None, headers=None, **request_parameters
):
"""This function is an alias of retrieve_banner_settings_for_a_site_v1 .
Args:
id(basestring): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of retrieve_banner_settings_for_a_site_v1 .
"""
return self.retrieve_banner_settings_for_a_site_v1(
id=id, inherited=inherited, headers=headers, **request_parameters
)
# Alias Function
[docs] def get_network(self, site_id=None, headers=None, **request_parameters):
"""This function is an alias of get_network_v1 .
Args:
site_id(basestring): siteId query parameter. Site id to get the network settings associated with the
site. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of get_network_v1 .
"""
return self.get_network_v1(
site_id=site_id, headers=headers, **request_parameters
)
# Alias Function
[docs] def set_aaa_settings_for_a_site(
self,
id,
aaaClient=None,
aaaNetwork=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of set_aaa_settings_for_a_site_v1 .
Args:
aaaClient(object): Network Settings's aaaClient.
aaaNetwork(object): Network Settings's aaaNetwork.
id(basestring): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of set_aaa_settings_for_a_site_v1 .
"""
return self.set_aaa_settings_for_a_site_v1(
id=id,
aaaClient=aaaClient,
aaaNetwork=aaaNetwork,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def retrieve_image_distribution_settings_for_a_site(
self, id, inherited=None, headers=None, **request_parameters
):
"""This function is an alias of retrieve_image_distribution_settings_for_a_site_v1 .
Args:
id(basestring): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of retrieve_image_distribution_settings_for_a_site_v1 .
"""
return self.retrieve_image_distribution_settings_for_a_site_v1(
id=id, inherited=inherited, headers=headers, **request_parameters
)
# Alias Function
[docs] def update_sp_profile(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of update_sp_profile_v1 .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of update_sp_profile_v1 .
"""
return self.update_sp_profile_v1(
settings=settings,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def set_time_zone_for_a_site(
self,
id,
timeZone=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of set_time_zone_for_a_site_v1 .
Args:
timeZone(object): Network Settings's timeZone.
id(basestring): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of set_time_zone_for_a_site_v1 .
"""
return self.set_time_zone_for_a_site_v1(
id=id,
timeZone=timeZone,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def create_device_credentials(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of create_device_credentials_v1 .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of create_device_credentials_v1 .
"""
return self.create_device_credentials_v1(
settings=settings,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def sync_network_devices_credential(
self,
deviceCredentialId=None,
siteId=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of sync_network_devices_credential_v1 .
Args:
deviceCredentialId(string): Network Settings's It must be cli/snmpV2Read/snmpV2Write/snmpV3 Id. .
siteId(string): Network Settings's Site Id. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of sync_network_devices_credential_v1 .
"""
return self.sync_network_devices_credential_v1(
deviceCredentialId=deviceCredentialId,
siteId=siteId,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def assign_device_credential_to_site(
self,
site_id,
cliId=None,
httpRead=None,
httpWrite=None,
snmpV2ReadId=None,
snmpV2WriteId=None,
snmpV3Id=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of assign_device_credential_to_site_v1 .
Args:
cliId(string): Network Settings's Cli Id.
httpRead(string): Network Settings's Http Read.
httpWrite(string): Network Settings's Http Write.
snmpV2ReadId(string): Network Settings's Snmp V2 Read Id.
snmpV2WriteId(string): Network Settings's Snmp V2 Write Id.
snmpV3Id(string): Network Settings's Snmp V3 Id.
site_id(basestring): siteId path parameter. site id to assign credential. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of assign_device_credential_to_site_v1 .
"""
return self.assign_device_credential_to_site_v1(
site_id=site_id,
cliId=cliId,
httpRead=httpRead,
httpWrite=httpWrite,
snmpV2ReadId=snmpV2ReadId,
snmpV2WriteId=snmpV2WriteId,
snmpV3Id=snmpV3Id,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def create_network(
self,
site_id,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of create_network_v1 .
Args:
settings(object): Network Settings's settings.
site_id(basestring): siteId path parameter. Site id to which site details to associate with the network
settings. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of create_network_v1 .
"""
return self.create_network_v1(
site_id=site_id,
settings=settings,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def update_device_credential_settings_for_a_site(
self,
id,
cliCredentialsId=None,
httpReadCredentialsId=None,
httpWriteCredentialsId=None,
snmpv2cReadCredentialsId=None,
snmpv2cWriteCredentialsId=None,
snmpv3CredentialsId=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of update_device_credential_settings_for_a_site_v1 .
Args:
cliCredentialsId(object): Network Settings's cliCredentialsId.
httpReadCredentialsId(object): Network Settings's httpReadCredentialsId.
httpWriteCredentialsId(object): Network Settings's httpWriteCredentialsId.
snmpv2cReadCredentialsId(object): Network Settings's snmpv2cReadCredentialsId.
snmpv2cWriteCredentialsId(object): Network Settings's snmpv2cWriteCredentialsId.
snmpv3CredentialsId(object): Network Settings's snmpv3CredentialsId.
id(basestring): id path parameter. Site Id, retrievable from the `id` attribute in
`/dna/intent/api/v1/sites` .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of update_device_credential_settings_for_a_site_v1 .
"""
return self.update_device_credential_settings_for_a_site_v1(
id=id,
cliCredentialsId=cliCredentialsId,
httpReadCredentialsId=httpReadCredentialsId,
httpWriteCredentialsId=httpWriteCredentialsId,
snmpv2cReadCredentialsId=snmpv2cReadCredentialsId,
snmpv2cWriteCredentialsId=snmpv2cWriteCredentialsId,
snmpv3CredentialsId=snmpv3CredentialsId,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def update_device_credentials(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of update_device_credentials_v1 .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of update_device_credentials_v1 .
"""
return self.update_device_credentials_v1(
settings=settings,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def get_global_pool(
self, limit=None, offset=None, headers=None, **request_parameters
):
"""This function is an alias of get_global_pool_v1 .
Args:
offset(int): offset query parameter. Offset/starting row. Indexed from 1. Default value of 1. .
limit(int): limit query parameter. Number of Global Pools to be retrieved. Default is 25 if not
specified. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of get_global_pool_v1 .
"""
return self.get_global_pool_v1(
limit=limit, offset=offset, headers=headers, **request_parameters
)
# Alias Function
[docs] def retrieve_time_zone_settings_for_a_site(
self, id, inherited=None, headers=None, **request_parameters
):
"""This function is an alias of retrieve_time_zone_settings_for_a_site_v1 .
Args:
id(basestring): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of retrieve_time_zone_settings_for_a_site_v1 .
"""
return self.retrieve_time_zone_settings_for_a_site_v1(
id=id, inherited=inherited, headers=headers, **request_parameters
)
# Alias Function
[docs] def update_global_pool(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of update_global_pool_v1 .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of update_global_pool_v1 .
"""
return self.update_global_pool_v1(
settings=settings,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def retrieve_d_n_s_settings_for_a_site(
self, id, inherited=None, headers=None, **request_parameters
):
"""This function is an alias of retrieve_d_n_s_settings_for_a_site_v1 .
Args:
id(basestring): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of retrieve_d_n_s_settings_for_a_site_v1 .
"""
return self.retrieve_d_n_s_settings_for_a_site_v1(
id=id, inherited=inherited, headers=headers, **request_parameters
)
# Alias Function
[docs] def set_n_t_p_settings_for_a_site(
self,
id,
ntp=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of set_n_t_p_settings_for_a_site_v1 .
Args:
ntp(object): Network Settings's ntp.
id(basestring): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of set_n_t_p_settings_for_a_site_v1 .
"""
return self.set_n_t_p_settings_for_a_site_v1(
id=id,
ntp=ntp,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def get_device_credential_details(
self, site_id=None, headers=None, **request_parameters
):
"""This function is an alias of get_device_credential_details_v1 .
Args:
site_id(basestring): siteId query parameter. Site id to retrieve the credential details associated with
the site. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of get_device_credential_details_v1 .
"""
return self.get_device_credential_details_v1(
site_id=site_id, headers=headers, **request_parameters
)
# Alias Function
[docs] def retrieve_telemetry_settings_for_a_site(
self, id, inherited=None, headers=None, **request_parameters
):
"""This function is an alias of retrieve_telemetry_settings_for_a_site_v1 .
Args:
id(basestring): id path parameter. Site Id, retrievable from the `id` attribute in
`/dna/intent/api/v1/sites` .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of retrieve_telemetry_settings_for_a_site_v1 .
"""
return self.retrieve_telemetry_settings_for_a_site_v1(
id=id, inherited=inherited, headers=headers, **request_parameters
)
# Alias Function
[docs] def retrieve_aaa_settings_for_a_site(
self, id, inherited=None, headers=None, **request_parameters
):
"""This function is an alias of retrieve_aaa_settings_for_a_site_v1 .
Args:
id(basestring): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of retrieve_aaa_settings_for_a_site_v1 .
"""
return self.retrieve_aaa_settings_for_a_site_v1(
id=id, inherited=inherited, headers=headers, **request_parameters
)
# Alias Function
[docs] def delete_global_ip_pool(self, id, headers=None, **request_parameters):
"""This function is an alias of delete_global_ip_pool_v1 .
Args:
id(basestring): id path parameter. global pool id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of delete_global_ip_pool_v1 .
"""
return self.delete_global_ip_pool_v1(
id=id, headers=headers, **request_parameters
)
# Alias Function
[docs] def set_telemetry_settings_for_a_site(
self,
id,
applicationVisibility=None,
snmpTraps=None,
syslogs=None,
wiredDataCollection=None,
wirelessTelemetry=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of set_telemetry_settings_for_a_site_v1 .
Args:
applicationVisibility(object): Network Settings's applicationVisibility.
snmpTraps(object): Network Settings's snmpTraps.
syslogs(object): Network Settings's syslogs.
wiredDataCollection(object): Network Settings's wiredDataCollection.
wirelessTelemetry(object): Network Settings's wirelessTelemetry.
id(basestring): id path parameter. Site Id, retrievable from the `id` attribute in
`/dna/intent/api/v1/sites` .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of set_telemetry_settings_for_a_site_v1 .
"""
return self.set_telemetry_settings_for_a_site_v1(
id=id,
applicationVisibility=applicationVisibility,
snmpTraps=snmpTraps,
syslogs=syslogs,
wiredDataCollection=wiredDataCollection,
wirelessTelemetry=wirelessTelemetry,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def get_reserve_ip_subpool(
self,
group_name=None,
ignore_inherited_groups=None,
limit=None,
offset=None,
pool_usage=None,
site_id=None,
headers=None,
**request_parameters
):
"""This function is an alias of get_reserve_ip_subpool_v1 .
Args:
site_id(basestring): siteId query parameter. site id of site from which to retrieve associated reserve
pools. Either siteId (per site queries) or ignoreInheritedGroups must be used. They can
also be used together. .
offset(int): offset query parameter. offset/starting row. Indexed from 1. .
limit(int): limit query parameter. Number of reserve pools to be retrieved. Default is 25 if not
specified. Maximum allowed limit is 500. .
ignore_inherited_groups(basestring): ignoreInheritedGroups query parameter. Ignores pools inherited from
parent site. Either siteId or ignoreInheritedGroups must be passed. They can also be
used together. .
pool_usage(basestring): poolUsage query parameter. Can take values empty, partially-full or empty-
partially-full .
group_name(basestring): groupName query parameter. Name of the group .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of get_reserve_ip_subpool_v1 .
"""
return self.get_reserve_ip_subpool_v1(
group_name=group_name,
ignore_inherited_groups=ignore_inherited_groups,
limit=limit,
offset=offset,
pool_usage=pool_usage,
site_id=site_id,
headers=headers,
**request_parameters
)
# Alias Function
[docs] def reserve_ip_subpool(
self,
site_id,
ipv4DhcpServers=None,
ipv4DnsServers=None,
ipv4GateWay=None,
ipv4GlobalPool=None,
ipv4Prefix=None,
ipv4PrefixLength=None,
ipv4Subnet=None,
ipv4TotalHost=None,
ipv6AddressSpace=None,
ipv6DhcpServers=None,
ipv6DnsServers=None,
ipv6GateWay=None,
ipv6GlobalPool=None,
ipv6Prefix=None,
ipv6PrefixLength=None,
ipv6Subnet=None,
ipv6TotalHost=None,
name=None,
slaacSupport=None,
type=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of reserve_ip_subpool_v1 .
Args:
ipv4DhcpServers(list): Network Settings's IPv4 input for dhcp server ip example: ["1.1.1.1"] (list of
strings).
ipv4DnsServers(list): Network Settings's IPv4 input for dns server ip example: ["4.4.4.4"] (list of
strings).
ipv4GateWay(string): Network Settings's Gateway ip address details, example: 175.175.0.1 .
ipv4GlobalPool(string): Network Settings's IP v4 Global pool address with cidr, example: 175.175.0.0/16
.
ipv4Prefix(boolean): Network Settings's IPv4 prefix value is true, the ip4 prefix length input field is
enabled , if it is false ipv4 total Host input is enable .
ipv4PrefixLength(integer): Network Settings's The ipv4 prefix length is required when ipv4prefix value
is true. .
ipv4Subnet(string): Network Settings's IPv4 Subnet address, example: 175.175.0.0. Either ipv4Subnet or
ipv4TotalHost needs to be passed if creating IPv4 subpool. .
ipv4TotalHost(integer): Network Settings's IPv4 total host is required when ipv4prefix value is false. .
ipv6AddressSpace(boolean): Network Settings's If the value is omitted or false only ipv4 input are
required, otherwise both ipv6 and ipv4 are required .
ipv6DhcpServers(list): Network Settings's IPv6 format dhcp server as input example : ["2001:db8::1234"]
(list of strings).
ipv6DnsServers(list): Network Settings's IPv6 format dns server input example: ["2001:db8::1234"] (list
of strings).
ipv6GateWay(string): Network Settings's Gateway ip address details, example: 2001:db8:85a3:0:100::1 .
ipv6GlobalPool(string): Network Settings's IPv6 Global pool address with cidr this is required when
Ipv6AddressSpace value is true, example: 2001:db8:85a3::/64 .
ipv6Prefix(boolean): Network Settings's Ipv6 prefix value is true, the ip6 prefix length input field is
enabled , if it is false ipv6 total Host input is enable .
ipv6PrefixLength(integer): Network Settings's IPv6 prefix length is required when the ipv6prefix value
is true .
ipv6Subnet(string): Network Settings's IPv6 Subnet address, example :2001:db8:85a3:0:100::. Either
ipv6Subnet or ipv6TotalHost needs to be passed if creating IPv6 subpool. .
ipv6TotalHost(integer): Network Settings's IPv6 total host is required when ipv6prefix value is false. .
name(string): Network Settings's Name of the reserve ip sub pool .
slaacSupport(boolean): Network Settings's Slaac Support.
type(string): Network Settings's Type of the reserve ip sub pool . Available values are 'Generic',
'LAN', 'WAN', 'management' and 'service'.
site_id(basestring): siteId path parameter. Site id to reserve the ip sub pool. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of reserve_ip_subpool_v1 .
"""
return self.reserve_ip_subpool_v1(
site_id=site_id,
ipv4DhcpServers=ipv4DhcpServers,
ipv4DnsServers=ipv4DnsServers,
ipv4GateWay=ipv4GateWay,
ipv4GlobalPool=ipv4GlobalPool,
ipv4Prefix=ipv4Prefix,
ipv4PrefixLength=ipv4PrefixLength,
ipv4Subnet=ipv4Subnet,
ipv4TotalHost=ipv4TotalHost,
ipv6AddressSpace=ipv6AddressSpace,
ipv6DhcpServers=ipv6DhcpServers,
ipv6DnsServers=ipv6DnsServers,
ipv6GateWay=ipv6GateWay,
ipv6GlobalPool=ipv6GlobalPool,
ipv6Prefix=ipv6Prefix,
ipv6PrefixLength=ipv6PrefixLength,
ipv6Subnet=ipv6Subnet,
ipv6TotalHost=ipv6TotalHost,
name=name,
slaacSupport=slaacSupport,
type=type,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def set_d_n_s_settings_for_a_site(
self,
id,
dns=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of set_d_n_s_settings_for_a_site_v1 .
Args:
dns(object): Network Settings's dns.
id(basestring): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of set_d_n_s_settings_for_a_site_v1 .
"""
return self.set_d_n_s_settings_for_a_site_v1(
id=id,
dns=dns,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def update_reserve_ip_subpool(
self,
id,
site_id,
ipv4DhcpServers=None,
ipv4DnsServers=None,
ipv4GateWay=None,
ipv6AddressSpace=None,
ipv6DhcpServers=None,
ipv6DnsServers=None,
ipv6GateWay=None,
ipv6GlobalPool=None,
ipv6Prefix=None,
ipv6PrefixLength=None,
ipv6Subnet=None,
ipv6TotalHost=None,
name=None,
slaacSupport=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of update_reserve_ip_subpool_v1 .
Args:
ipv4DhcpServers(list): Network Settings's IPv4 input for dhcp server ip example: ["1.1.1.1"] (list of
strings).
ipv4DnsServers(list): Network Settings's IPv4 input for dns server ip example: ["4.4.4.4"] (list of
strings).
ipv4GateWay(string): Network Settings's Gateway ip address details, example: 175.175.0.1 .
ipv6AddressSpace(boolean): Network Settings's If the value is false only ipv4 input are required. NOTE
if value is false then any existing ipv6 subpool in the group will be removed. .
ipv6DhcpServers(list): Network Settings's IPv6 format dhcp server as input example : ["2001:db8::1234"]
(list of strings).
ipv6DnsServers(list): Network Settings's IPv6 format dns server input example: ["2001:db8::1234"] (list
of strings).
ipv6GateWay(string): Network Settings's Gateway ip address details, example: 2001:db8:85a3:0:100::1 .
ipv6GlobalPool(string): Network Settings's IPv6 Global pool address with cidr this is required when
Ipv6AddressSpace value is true, example: 2001:db8:85a3::/64 .
ipv6Prefix(boolean): Network Settings's Ipv6 prefix value is true, the ip6 prefix length input field is
enabled, if it is false ipv6 total Host input is enable .
ipv6PrefixLength(integer): Network Settings's IPv6 prefix length is required when the ipv6prefix value
is true .
ipv6Subnet(string): Network Settings's IPv6 Subnet address, example :2001:db8:85a3:0:100::. .
ipv6TotalHost(integer): Network Settings's Size of pool in terms of number of IPs. IPv6 total host is
required when ipv6prefix value is false. .
name(string): Network Settings's Name of the reserve ip sub pool .
slaacSupport(boolean): Network Settings's Slaac Support.
site_id(basestring): siteId path parameter. Site id of site to update sub pool. .
id(basestring): id query parameter. Id of subpool group .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of update_reserve_ip_subpool_v1 .
"""
return self.update_reserve_ip_subpool_v1(
id=id,
site_id=site_id,
ipv4DhcpServers=ipv4DhcpServers,
ipv4DnsServers=ipv4DnsServers,
ipv4GateWay=ipv4GateWay,
ipv6AddressSpace=ipv6AddressSpace,
ipv6DhcpServers=ipv6DhcpServers,
ipv6DnsServers=ipv6DnsServers,
ipv6GateWay=ipv6GateWay,
ipv6GlobalPool=ipv6GlobalPool,
ipv6Prefix=ipv6Prefix,
ipv6PrefixLength=ipv6PrefixLength,
ipv6Subnet=ipv6Subnet,
ipv6TotalHost=ipv6TotalHost,
name=name,
slaacSupport=slaacSupport,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def update_network(
self,
site_id,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of update_network_v1 .
Args:
settings(object): Network Settings's settings.
site_id(basestring): siteId path parameter. Site id to update the network settings which is associated
with the site .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of update_network_v1 .
"""
return self.update_network_v1(
site_id=site_id,
settings=settings,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def set_banner_settings_for_a_site(
self,
id,
banner=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of set_banner_settings_for_a_site_v1 .
Args:
banner(object): Network Settings's banner.
id(basestring): id path parameter. Site Id .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of set_banner_settings_for_a_site_v1 .
"""
return self.set_banner_settings_for_a_site_v1(
id=id,
banner=banner,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)
# Alias Function
[docs] def get_network_devices_credentials_sync_status(
self, id, headers=None, **request_parameters
):
"""This function is an alias of get_network_devices_credentials_sync_status_v1 .
Args:
id(basestring): id path parameter. Site Id. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of get_network_devices_credentials_sync_status_v1 .
"""
return self.get_network_devices_credentials_sync_status_v1(
id=id, headers=headers, **request_parameters
)
# Alias Function
[docs] def retrieve_n_t_p_settings_for_a_site(
self, id, inherited=None, headers=None, **request_parameters
):
"""This function is an alias of retrieve_n_t_p_settings_for_a_site_v1 .
Args:
id(basestring): id path parameter. Site Id .
inherited(bool): _inherited query parameter. Include settings explicitly set for this site and settings
inherited from sites higher in the site hierarchy; when `false`, `null` values indicate
that the site inherits that setting from the parent site or a site higher in the site
hierarchy. .
headers(dict): Dictionary of HTTP Headers to send with the Request
.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of retrieve_n_t_p_settings_for_a_site_v1 .
"""
return self.retrieve_n_t_p_settings_for_a_site_v1(
id=id, inherited=inherited, headers=headers, **request_parameters
)
# Alias Function
[docs] def create_global_pool(
self,
settings=None,
headers=None,
payload=None,
active_validation=True,
**request_parameters
):
"""This function is an alias of create_global_pool_v1 .
Args:
settings(object): Network Settings's settings.
headers(dict): Dictionary of HTTP Headers to send with the Request
.
payload(): A JSON serializable Python object to send in the
body of the Request.
active_validation(bool): Enable/Disable payload validation.
Defaults to True.
**request_parameters: Additional request parameters (provides
support for parameters that may be added in the future).
Returns:
This function returns the output of create_global_pool_v1 .
"""
return self.create_global_pool_v1(
settings=settings,
headers=headers,
payload=payload,
active_validation=active_validation,
**request_parameters
)