Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

smartAssign

URL api.php?target=vlan&action=smartAssign
Description Finds and enables an unassigned VLAN matching the provided search parameters and optionally renames it.
Returns

Examples

SUCCESSFUL

Return Data:  the full domain description, plus the chosen VLAN with its new name (optional)

 {"success":1,"message":"VLAN enabled. ","data":{"21":{"id":"21","domain":"Swisscom Demo","attr_6c":"{\"range\":\"E\"}","attr_custom":null,"vlans":[{"id":"46183","vlan":"1808","name":"RESERVED_DEV"}]}}}

ERROR{ "success":0, "message":"error message" }
Required Parameters
NameTypeExampleDescription
domainIdINTEGER15The Id number of the domain you would like to Smart Assign from.
Optional Parameters
NameTypeExampleDescription
tagsSTRINGINTEGER5,7,12A comma-separated list of the Tag Ids being used for the Smart Assign.
nameSTRING

CustomerName_13 , RESERVED_DEV

The name that will be assigned to the VLAN matching the given search parameters. 
Example URLapi.php?target=vlan&action=smartAssign&domainId=21&name=RESERVED_DEV&tags=5,7,12