Resource Information
Rate Limiting?
|
Yes
|
Sorting?
|
Yes
|
Paging?
|
Yes
|
Filtering?
|
Yes
|
Group Filtering?
|
No
|
Aggregation?
|
No
|
Response Formats
|
|
User Group
|
NBI Read
|
HTTP Methods
|
|
API version v1 is deprecated
This API version has been deprecated. It will be removed in a future release of the product. Please develop new clients using the latest API version. Please modify your existing clients to use a later API version.
Resource URL
/webacs/api/v1/data/GuestUsers
Deprecated
This version has been deprecated in favor of the v4 version, which allows for easier filtering of controller Ids.
Response Parameters
applyGuestUserTo
ApplyGuestUserTo
|
Approach to choose a set of controllers for applying the guest user account.
|
building
String
|
Name of a building for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA.
|
campus
String
|
Name of a campus for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA or OUTDOOR_AREA.
|
configGroup
String
|
Name of a config group for which the guest user is configured. This field using only if applyGuestUserTo equals CONFIG_GROUP.
|
controllerId
Long[]
|
The list of controller IDs containing the guest user.
|
description
String
|
Description of the guest user.
|
disclaimer
String
|
Text with a disclaimer for a guest.
|
endTime
Date
|
An expiry time for the limited guest user. If time is not specified the user is not limited.
Note: The date has an incorrect UTC offset. Please see
the FAQ for details.
|
floor
String
|
Name of a floor for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA. If this field equals "All Floors" the guest account will apply to controllers on all floors.
|
lastModifiedTime
Date
|
The time when the guest user was created or modified in last time.
Note: The date has an incorrect UTC offset. Please see
the FAQ for details.
|
outdoorArea
String
|
Name of an outdoor area for which the guest user is configured. This field using only if applyGuestUserTo equals OUTDOOR_AREA.
|
password
String
|
Password of the guest user. You should use ".case_sensitive=true" if you want to filter by password.
|
profile
String
|
Name of a WLAN profile. The guest account will apply only to controllers with an appropriate WLAN profile. If the profile has a value "ANY PROFILE" the guest account will apply to all controllers.
You can use the following API for getting a list of profiles:
/data/WlanProfiles?.full=true&
layer3WebPolicyAuthenticationEnabled=true&
layer3WebPolicyOnMacFailureEnabled=true&.or_filter=true
|
rebootController
boolean
|
Indicates that a controller will be rebooted after applying the guest user.
|
saveConfigToFlash
boolean
|
Indicates that the guest account will be saved to a WLC flash so that account is maintained across WLC reboots.
|
status
GuestUserStatus
|
Current status of the guest account.
|
userRole
String
|
Name of a local net user role. The guest account will apply only on controllers with an appropriate user role. If the user role has a value "default" the guest account will apply to all controllers.
You can use API data/WlanControllerDetails for getting a list of user roles appropriate for a controller.
|
username
String
|
|
Sample Payloads
Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.
Sample XML Payload
https://10.64.88.203/webacs/api/v1/data/GuestUsers/15
<?xml version="1.0" ?>
<queryResponse type="GuestUsers" responseType="getEntity" requestUrl="https://10.64.88.203/webacs/api/v1/data/GuestUsers/15" rootUrl="https://10.64.88.203/webacs/api/v1/data">
<entity dtoType="guestUsersDTO" type="GuestUsers" url="https://10.64.88.203/webacs/api/v1/data/GuestUsers/15">
<guestUsersDTO displayName="String value" id="15" uuid="String value">
<applyGuestUserTo>CONTROLLER_LIST</applyGuestUserTo>
<building>String value</building>
<campus>String value</campus>
<configGroup>String value</configGroup>
<description>String value</description>
<disclaimer>String value</disclaimer>
<endTime>1986-07-24T00:00:00+05:30</endTime>
<floor>String value</floor>
<lastModifiedTime>1986-07-24T00:00:00+05:30</lastModifiedTime>
<outdoorArea>String value</outdoorArea>
<password>String value</password>
<profile>String value</profile>
<rebootController>true</rebootController>
<saveConfigToFlash>true</saveConfigToFlash>
<status>ACTIVE</status>
<userRole>String value</userRole>
<username>String value</username>
<controllerIds>
<controllerId>15</controllerId>
<controllerId>25</controllerId>
</controllerIds>
</guestUsersDTO>
</entity>
</queryResponse>
Sample JSON Payload
https://10.64.88.203/webacs/api/v1/data/GuestUsers/15.json
{
"queryResponse" : {
"@type" : "GuestUsers",
"@responseType" : "getEntity",
"@requestUrl" : "https : //10.64.88.203/webacs/api/v1/data/GuestUsers/15",
"@rootUrl" : "https : //10.64.88.203/webacs/api/v1/data",
"entity" : {
"@dtoType" : "guestUsersDTO",
"@type" : "GuestUsers",
"@url" : "https : //10.64.88.203/webacs/api/v1/data/GuestUsers/15",
"guestUsersDTO" : {
"@displayName" : "String value",
"@id" : 15,
"@uuid" : "String value",
"applyGuestUserTo" : "CONTROLLER_LIST",
"building" : "String value",
"campus" : "String value",
"configGroup" : "String value",
"description" : "String value",
"disclaimer" : "String value",
"endTime" : "1986-07-24T00 : 00 : 00+05 : 30",
"floor" : "String value",
"lastModifiedTime" : "1986-07-24T00 : 00 : 00+05 : 30",
"outdoorArea" : "String value",
"password" : "String value",
"profile" : "String value",
"rebootController" : true,
"saveConfigToFlash" : true,
"status" : "ACTIVE",
"userRole" : "String value",
"username" : "String value",
"controllerIds" : {
"controllerId" : [15,
25]
}
}
}
}
}
Resource Information
Rate Limiting?
|
Yes
|
Sorting?
|
Yes
|
Paging?
|
Yes
|
Filtering?
|
Yes
|
Group Filtering?
|
No
|
Aggregation?
|
No
|
Response Formats
|
|
User Group
|
NBI Read
|
HTTP Methods
|
|
Resource URL
/webacs/api/v2/data/GuestUsers
Unmodified
This resource has not been modified since the previous API version.
Deprecated
This version has been deprecated in favor of the v4 version, which allows for easier filtering of controller Ids.
Response Parameters
applyGuestUserTo
ApplyGuestUserTo
|
Approach to choose a set of controllers for applying the guest user account.
|
building
String
|
Name of a building for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA.
|
campus
String
|
Name of a campus for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA or OUTDOOR_AREA.
|
configGroup
String
|
Name of a config group for which the guest user is configured. This field using only if applyGuestUserTo equals CONFIG_GROUP.
|
controllerId
Long[]
|
The list of controller IDs containing the guest user.
|
description
String
|
Description of the guest user.
|
disclaimer
String
|
Text with a disclaimer for a guest.
|
endTime
Date
|
An expiry time for the limited guest user. If time is not specified the user is not limited.
Note: The date has an incorrect UTC offset. Please see
the FAQ for details.
|
floor
String
|
Name of a floor for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA. If this field equals "All Floors" the guest account will apply to controllers on all floors.
|
lastModifiedTime
Date
|
The time when the guest user was created or modified in last time.
Note: The date has an incorrect UTC offset. Please see
the FAQ for details.
|
outdoorArea
String
|
Name of an outdoor area for which the guest user is configured. This field using only if applyGuestUserTo equals OUTDOOR_AREA.
|
password
String
|
Password of the guest user. You should use ".case_sensitive=true" if you want to filter by password.
|
profile
String
|
Name of a WLAN profile. The guest account will apply only to controllers with an appropriate WLAN profile. If the profile has a value "ANY PROFILE" the guest account will apply to all controllers.
You can use the following API for getting a list of profiles:
/data/WlanProfiles?.full=true&
layer3WebPolicyAuthenticationEnabled=true&
layer3WebPolicyOnMacFailureEnabled=true&.or_filter=true
|
rebootController
boolean
|
Indicates that a controller will be rebooted after applying the guest user.
|
saveConfigToFlash
boolean
|
Indicates that the guest account will be saved to a WLC flash so that account is maintained across WLC reboots.
|
status
GuestUserStatus
|
Current status of the guest account.
|
userRole
String
|
Name of a local net user role. The guest account will apply only on controllers with an appropriate user role. If the user role has a value "default" the guest account will apply to all controllers.
You can use API data/WlanControllerDetails for getting a list of user roles appropriate for a controller.
|
username
String
|
|
Sample Payloads
Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.
Sample XML Payload
https://10.64.88.203/webacs/api/v2/data/GuestUsers/15
<?xml version="1.0" ?>
<queryResponse type="GuestUsers" responseType="getEntity" requestUrl="https://10.64.88.203/webacs/api/v2/data/GuestUsers/15" rootUrl="https://10.64.88.203/webacs/api/v2/data">
<entity dtoType="guestUsersDTO" type="GuestUsers" url="https://10.64.88.203/webacs/api/v2/data/GuestUsers/15">
<guestUsersDTO displayName="String value" id="15" uuid="String value">
<applyGuestUserTo>CONTROLLER_LIST</applyGuestUserTo>
<building>String value</building>
<campus>String value</campus>
<configGroup>String value</configGroup>
<description>String value</description>
<disclaimer>String value</disclaimer>
<endTime>1986-07-24T00:00:00+05:30</endTime>
<floor>String value</floor>
<lastModifiedTime>1986-07-24T00:00:00+05:30</lastModifiedTime>
<outdoorArea>String value</outdoorArea>
<password>String value</password>
<profile>String value</profile>
<rebootController>true</rebootController>
<saveConfigToFlash>true</saveConfigToFlash>
<status>ACTIVE</status>
<userRole>String value</userRole>
<username>String value</username>
<controllerIds>
<controllerId>15</controllerId>
<controllerId>25</controllerId>
</controllerIds>
</guestUsersDTO>
</entity>
</queryResponse>
Sample JSON Payload
https://10.64.88.203/webacs/api/v2/data/GuestUsers/15.json
{
"queryResponse" : {
"@type" : "GuestUsers",
"@requestUrl" : "https://10.64.88.203/webacs/api/v2/data/GuestUsers/15",
"@responseType" : "getEntity",
"@rootUrl" : "https://10.64.88.203/webacs/api/v2/data",
"entity" : [ {
"@dtoType" : "guestUsersDTO",
"@type" : "GuestUsers",
"@url" : "https://10.64.88.203/webacs/api/v2/data/GuestUsers/15",
"guestUsersDTO" : {
"@displayName" : "String value",
"@id" : 15,
"@uuid" : "String value",
"applyGuestUserTo" : "CONTROLLER_LIST",
"building" : "String value",
"campus" : "String value",
"configGroup" : "String value",
"controllerIds" : {
"controllerId" : [ 15, 25 ]
},
"description" : "String value",
"disclaimer" : "String value",
"endTime" : 522527400000,
"floor" : "String value",
"lastModifiedTime" : 522527400000,
"outdoorArea" : "String value",
"password" : "String value",
"profile" : "String value",
"rebootController" : true,
"saveConfigToFlash" : true,
"status" : "ACTIVE",
"userRole" : "String value",
"username" : "String value"
}
} ]
}
}
Resource Information
Rate Limiting?
|
Yes
|
Sorting?
|
Yes
|
Paging?
|
Yes
|
Filtering?
|
Yes
|
Group Filtering?
|
No
|
Aggregation?
|
No
|
Response Formats
|
|
User Group
|
NBI Read
|
HTTP Methods
|
|
Resource URL
/webacs/api/v3/data/GuestUsers
Unmodified
This resource has not been modified since the previous API version.
Deprecated
This version has been deprecated in favor of the v4 version, which allows for easier filtering of controller Ids.
Response Parameters
applyGuestUserTo
ApplyGuestUserTo
|
Approach to choose a set of controllers for applying the guest user account.
|
building
String
|
Name of a building for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA.
|
campus
String
|
Name of a campus for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA or OUTDOOR_AREA.
|
configGroup
String
|
Name of a config group for which the guest user is configured. This field using only if applyGuestUserTo equals CONFIG_GROUP.
|
controllerId
Long[]
|
The list of controller IDs containing the guest user.
|
description
String
|
Description of the guest user.
|
disclaimer
String
|
Text with a disclaimer for a guest.
|
endTime
Date
|
An expiry time for the limited guest user. If time is not specified the user is not limited.
Note: The date has an incorrect UTC offset. Please see
the FAQ for details.
|
floor
String
|
Name of a floor for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA. If this field equals "All Floors" the guest account will apply to controllers on all floors.
|
lastModifiedTime
Date
|
The time when the guest user was created or modified in last time.
Note: The date has an incorrect UTC offset. Please see
the FAQ for details.
|
outdoorArea
String
|
Name of an outdoor area for which the guest user is configured. This field using only if applyGuestUserTo equals OUTDOOR_AREA.
|
password
String
|
Password of the guest user. You should use ".case_sensitive=true" if you want to filter by password.
|
profile
String
|
Name of a WLAN profile. The guest account will apply only to controllers with an appropriate WLAN profile. If the profile has a value "ANY PROFILE" the guest account will apply to all controllers.
You can use the following API for getting a list of profiles:
/data/WlanProfiles?.full=true&
layer3WebPolicyAuthenticationEnabled=true&
layer3WebPolicyOnMacFailureEnabled=true&.or_filter=true
|
rebootController
boolean
|
Indicates that a controller will be rebooted after applying the guest user.
|
saveConfigToFlash
boolean
|
Indicates that the guest account will be saved to a WLC flash so that account is maintained across WLC reboots.
|
status
GuestUserStatus
|
Current status of the guest account.
|
userRole
String
|
Name of a local net user role. The guest account will apply only on controllers with an appropriate user role. If the user role has a value "default" the guest account will apply to all controllers.
You can use API data/WlanControllerDetails for getting a list of user roles appropriate for a controller.
|
username
String
|
|
Sample Payloads
Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.
Sample XML Payload
https://10.64.88.203/webacs/api/v3/data/GuestUsers/15
<?xml version="1.0" ?>
<queryResponse type="GuestUsers" responseType="getEntity" requestUrl="https://10.64.88.203/webacs/api/v3/data/GuestUsers/15" rootUrl="https://10.64.88.203/webacs/api/v3/data">
<entity dtoType="guestUsersDTO" type="GuestUsers" url="https://10.64.88.203/webacs/api/v3/data/GuestUsers/15">
<guestUsersDTO displayName="String value" id="15" uuid="String value">
<applyGuestUserTo>CONTROLLER_LIST</applyGuestUserTo>
<building>String value</building>
<campus>String value</campus>
<configGroup>String value</configGroup>
<description>String value</description>
<disclaimer>String value</disclaimer>
<endTime>1986-07-24T00:00:00+05:30</endTime>
<floor>String value</floor>
<lastModifiedTime>1986-07-24T00:00:00+05:30</lastModifiedTime>
<outdoorArea>String value</outdoorArea>
<password>String value</password>
<profile>String value</profile>
<rebootController>true</rebootController>
<saveConfigToFlash>true</saveConfigToFlash>
<status>ACTIVE</status>
<userRole>String value</userRole>
<username>String value</username>
<controllerIds>
<controllerId>15</controllerId>
<controllerId>25</controllerId>
</controllerIds>
</guestUsersDTO>
</entity>
</queryResponse>
Sample JSON Payload
https://10.64.88.203/webacs/api/v3/data/GuestUsers/15.json
{
"queryResponse" : {
"@type" : "GuestUsers",
"@requestUrl" : "https://10.64.88.203/webacs/api/v3/data/GuestUsers/15",
"@responseType" : "getEntity",
"@rootUrl" : "https://10.64.88.203/webacs/api/v3/data",
"entity" : [ {
"@dtoType" : "guestUsersDTO",
"@type" : "GuestUsers",
"@url" : "https://10.64.88.203/webacs/api/v3/data/GuestUsers/15",
"guestUsersDTO" : {
"@displayName" : "String value",
"@id" : 15,
"@uuid" : "String value",
"applyGuestUserTo" : "CONTROLLER_LIST",
"building" : "String value",
"campus" : "String value",
"configGroup" : "String value",
"controllerIds" : {
"controllerId" : [ 15, 25 ]
},
"description" : "String value",
"disclaimer" : "String value",
"endTime" : "1986-07-23T18:30:00.000Z",
"floor" : "String value",
"lastModifiedTime" : "1986-07-23T18:30:00.000Z",
"outdoorArea" : "String value",
"password" : "String value",
"profile" : "String value",
"rebootController" : true,
"saveConfigToFlash" : true,
"status" : "ACTIVE",
"userRole" : "String value",
"username" : "String value"
}
} ]
}
}
Resource Information
Rate Limiting?
|
Yes
|
Sorting?
|
Yes
|
Paging?
|
Yes
|
Filtering?
|
Yes
|
Group Filtering?
|
No
|
Aggregation?
|
No
|
Response Formats
|
|
User Group
|
NBI Read
|
HTTP Methods
|
|
Resource URL
/webacs/api/v4/data/GuestUsers
Updated
Since version 4 this API uses a ControllerItemDTO collection to represent controller Ids.
Response Parameters
applyGuestUserTo
ApplyGuestUserTo
|
Approach to choose a set of controllers for applying the guest user account.
|
building
String
|
Name of a building for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA.
|
campus
String
|
Name of a campus for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA or OUTDOOR_AREA.
|
configGroup
String
|
Name of a config group for which the guest user is configured. This field using only if applyGuestUserTo equals CONFIG_GROUP.
|
controllerId
ControllerItemDTO[]
|
The list of controller IDs containing the guest user.
|
|
description
String
|
Description of the guest user.
|
disclaimer
String
|
Text with a disclaimer for a guest.
|
email
String
|
Email address of the guest user. Credentials of the scheduled guest user will be sent to this email address.
|
endTime
Date
|
An expiry time for the limited guest user. If time is not specified the user is not limited.
Note: The date has an incorrect UTC offset. Please see
the FAQ for details.
|
floor
String
|
Name of a floor for which the guest user is configured. This field using only if applyGuestUserTo equals INDOOR_AREA. If this field equals "All Floors" the guest account will apply to controllers on all floors.
|
lastModifiedTime
Date
|
The time when the guest user was created or modified in last time.
Note: The date has an incorrect UTC offset. Please see
the FAQ for details.
|
outdoorArea
String
|
Name of an outdoor area for which the guest user is configured. This field using only if applyGuestUserTo equals OUTDOOR_AREA.
|
password
String
|
Password of the guest user. You should use ".case_sensitive=true" if you want to filter by password.
|
profile
String
|
Name of a WLAN profile. The guest account will apply only to controllers with an appropriate WLAN profile. If the profile has a value "ANY PROFILE" the guest account will apply to all controllers.
You can use the following API for getting a list of profiles:
/data/WlanProfiles?.full=true&
layer3WebPolicyAuthenticationEnabled=true&
layer3WebPolicyOnMacFailureEnabled=true&.or_filter=true
|
rebootController
boolean
|
Indicates that a controller will be rebooted after applying the guest user.
|
saveConfigToFlash
boolean
|
Indicates that the guest account will be saved to a WLC flash so that account is maintained across WLC reboots.
|
startTime
Date
|
Start time of the guest user.
Note: The date has an incorrect UTC offset. Please see
the FAQ for details.
|
status
GuestUserStatus
|
Current status of the guest account.
|
userRole
String
|
Name of a local net user role. The guest account will apply only on controllers with an appropriate user role. If the user role has a value "default" the guest account will apply to all controllers.
You can use API data/WlanControllerDetails for getting a list of user roles appropriate for a controller.
|
username
String
|
|
weekdays
String
|
Comma-separated list of weekdays when the guest user is scheduled.
|
Sample Payloads
Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.
Sample XML Payload
https://10.64.88.203/webacs/api/v4/data/GuestUsers/15
<?xml version="1.0" ?>
<queryResponse type="GuestUsers" responseType="getEntity" requestUrl="https://10.64.88.203/webacs/api/v4/data/GuestUsers/15" rootUrl="https://10.64.88.203/webacs/api/v4/data">
<entity dtoType="guestUsersDTO" type="GuestUsers" url="https://10.64.88.203/webacs/api/v4/data/GuestUsers/15">
<guestUsersDTO displayName="String value" id="15" uuid="String value">
<applyGuestUserTo>CONTROLLER_LIST</applyGuestUserTo>
<building>String value</building>
<campus>String value</campus>
<configGroup>String value</configGroup>
<description>String value</description>
<disclaimer>String value</disclaimer>
<endTime>1986-07-24T00:00:00+05:30</endTime>
<floor>String value</floor>
<lastModifiedTime>1986-07-24T00:00:00+05:30</lastModifiedTime>
<outdoorArea>String value</outdoorArea>
<password>String value</password>
<profile>String value</profile>
<rebootController>true</rebootController>
<saveConfigToFlash>true</saveConfigToFlash>
<status>ACTIVE</status>
<userRole>String value</userRole>
<username>String value</username>
<controllerIds>
<controllerId>
<id>2</id>
</controllerId>
<controllerId>
<id>12</id>
</controllerId>
</controllerIds>
<email>String value</email>
<startTime>1986-07-24T00:00:00+05:30</startTime>
<weekdays>String value</weekdays>
</guestUsersDTO>
</entity>
</queryResponse>
Sample JSON Payload
https://10.64.88.203/webacs/api/v4/data/GuestUsers/15.json
{
"queryResponse" : {
"@type" : "GuestUsers",
"@requestUrl" : "https://10.64.88.203/webacs/api/v4/data/GuestUsers/15",
"@responseType" : "getEntity",
"@rootUrl" : "https://10.64.88.203/webacs/api/v4/data",
"entity" : [ {
"@dtoType" : "guestUsersDTO",
"@type" : "GuestUsers",
"@url" : "https://10.64.88.203/webacs/api/v4/data/GuestUsers/15",
"guestUsersDTO" : {
"@displayName" : "String value",
"@id" : 15,
"@uuid" : "String value",
"applyGuestUserTo" : "CONTROLLER_LIST",
"building" : "String value",
"campus" : "String value",
"configGroup" : "String value",
"controllerIds" : {
"controllerId" : [ {
"id" : 2
}, {
"id" : 12
} ]
},
"description" : "String value",
"disclaimer" : "String value",
"email" : "String value",
"endTime" : "1986-07-23T18:30:00.000Z",
"floor" : "String value",
"lastModifiedTime" : "1986-07-23T18:30:00.000Z",
"outdoorArea" : "String value",
"password" : "String value",
"profile" : "String value",
"rebootController" : true,
"saveConfigToFlash" : true,
"startTime" : "1986-07-23T18:30:00.000Z",
"status" : "ACTIVE",
"userRole" : "String value",
"username" : "String value",
"weekdays" : "String value"
}
} ]
}
}