blob: 67eea124b259b5a6aad7edfaeef4efd106644a7d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
#!/usr/bin/python
# -*- coding: utf-8 -*-
# Copyright (c) 2021, Cisco Systems
# GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)
DOCUMENTATION = r"""
---
module: client_proximity_info
short_description: Information module for Client Proximity
description:
- Get all Client Proximity.
- >
This intent API will provide client proximity information for a specific wireless user. Proximity is defined as
presence on the same floor at the same time as the specified wireless user. The Proximity workflow requires the
subscription to the following event via the Event Notification workflow prior to making this API call NETWORK-
CLIENTS-3-506 - Client Proximity Report.
version_added: '3.1.0'
extends_documentation_fragment:
- cisco.dnac.module_info
author: Rafael Campos (@racampos)
options:
headers:
description: Additional headers.
type: dict
username:
description:
- Username query parameter. Wireless client username for which proximity information is required.
type: str
number_days:
description:
- >
Number_days query parameter. Number of days to track proximity until current date. Defaults and maximum up
to 14 days.
type: float
time_resolution:
description:
- >
Time_resolution query parameter. Time interval (in minutes) to measure proximity. Defaults to 15 minutes
with a minimum 5 minutes.
type: float
requirements:
- dnacentersdk >= 2.7.1
- python >= 3.5
seealso:
- name: Cisco DNA Center documentation for Clients ClientProximity
description: Complete reference of the ClientProximity API.
link: https://developer.cisco.com/docs/dna-center/#!client-proximity
notes:
- SDK Method used are
clients.Clients.client_proximity,
- Paths used are
get /dna/intent/api/v1/client-proximity,
"""
EXAMPLES = r"""
- name: Get all Client Proximity
cisco.dnac.client_proximity_info:
dnac_host: "{{dnac_host}}"
dnac_username: "{{dnac_username}}"
dnac_password: "{{dnac_password}}"
dnac_verify: "{{dnac_verify}}"
dnac_port: "{{dnac_port}}"
dnac_version: "{{dnac_version}}"
dnac_debug: "{{dnac_debug}}"
headers: "{{my_headers | from_json}}"
username: string
number_days: 0
time_resolution: 0
register: result
"""
RETURN = r"""
dnac_response:
description: A dictionary or list with the response returned by the Cisco DNAC Python SDK
returned: always
type: dict
sample: >
{
"executionId": "string",
"executionStatusUrl": "string",
"message": "string"
}
"""
|
