[Index]
Model ref.: device/genericcucm/HeadsetInventory
The full URL would include the host-proxy name: https://[host-proxy].
Variables are enclosed in square brackets.
{ "$schema": "http://json-schema.org/draft-03/schema", "type": "object", "properties": { "headset_serialNumber": { "name": "headset_serialNumber", "type": "string", "title": "Headset Serial Number", "required": true, "readonly": true }, "userId": { "name": "userId", "type": "string", "title": "User ID", "description": "This is current owner of the headset. If the headset has an owner set the value will be that user, otherwise it will be the user associated with the connected device.", "readonly": true }, "firstSeenTime": { "name": "firstSeenTime", "type": "string", "title": "Headset First Seen", "description": "This is the time the headset was first seen in the UCM", "readonly": true, "format": "date-time" }, "headset_owner": { "name": "headset_owner", "type": "string", "title": "Headset Owner", "description": "This is the user logged in/associated with the headset", "readonly": true }, "lastChangeTime": { "name": "lastChangeTime", "type": "string", "title": "Headset Last Change", "description": "This is the last time the headset status changed in the UCM", "readonly": true, "format": "date-time" }, "host_client": { "name": "host_client", "type": "string", "title": "Connected Device Client", "readonly": true }, "host_serialNumber": { "name": "host_serialNumber", "type": "string", "title": "Connected Device Serial Number", "readonly": true }, "host_deviceName": { "name": "host_deviceName", "type": "string", "title": "Connected Device Name (Full)", "description": "This is the device the headset is connected to", "readonly": true }, "host_deviceNameTrimmed": { "name": "host_deviceNameTrimmed", "type": "string", "title": "Connected Device Name", "description": "This is the device the headset is connected to", "readonly": true }, "host_model": { "name": "host_model", "type": "string", "title": "Connected Device Model", "readonly": true }, "host_firmwareVersion": { "name": "host_firmwareVersion", "type": "string", "title": "Connected Device Firmware Version", "readonly": true }, "host_hostOSVersion": { "name": "host_hostOSVersion", "type": "string", "title": "Connected Device OS Version", "readonly": true }, "host_userId": { "name": "host_userId", "type": "string", "title": "Connected Device Owner", "description": "This is the owner ID assigned to the connected device", "readonly": true }, "dock_serialNumber": { "name": "dock_serialNumber", "type": "string", "title": "Dock Serial Number", "readonly": true }, "dock_firmwareVersion": { "name": "dock_firmwareVersion", "type": "string", "title": "Dock Firmware Version", "readonly": true }, "dock_model": { "name": "dock_model", "type": "string", "title": "Dock Model", "readonly": true }, "headset_firmwareVersion": { "name": "headset_firmwareVersion", "type": "string", "title": "Headset Firmware Version", "readonly": true }, "headset_vendor": { "name": "headset_vendor", "type": "string", "title": "Headset Vendor", "readonly": true }, "headset_model": { "name": "headset_model", "type": "string", "title": "Headset Model", "readonly": true }, "headset_connectionType": { "name": "headset_connectionType", "type": "string", "title": "Headset Connection Type", "readonly": true }, "headset_connectionStatus": { "name": "headset_connectionStatus", "type": "string", "title": "Headset Connection Status", "readonly": true } }, "schema_version": "11.5" }
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Bulk Modify | GET | /api/device/genericcucm/HeadsetInventory/bulk_update/?schema=&schema_rules=true |
|
|
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Bulk Modify | POST | /api/device/genericcucm/HeadsetInventory/bulk_update/ |
|
For example: {"data":{"name":"value"}, "meta":{}, "request_meta":{ "hrefs":["/api/v0/device/genericcucm/HeadsetInventory/[pkid1]", "/api/v0/device/genericcucm/HeadsetInventory/[pkid2]",...]}} |
GET http://[host-proxy]/api/device/genericcucm/HeadsetInventory/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move the instance with [pkid] to [target_hierarchy] | POST | /api/tool/DataMove/?model_type=device/genericcucm/HeadsetInventory |
|
{"hrefs": ["/api/device/genericcucm/HeadsetInventory/[pkid]"]} |
Bulk Move | POST | /api/tool/DataMove/?model_type=device/genericcucm/HeadsetInventory |
|
{"hrefs": ["/api/device/genericcucm/HeadsetInventory/[pkid1]", "/api/device/genericcucm/HeadsetInventory/[pkid2]",...]} |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Get a selected [export_format] of the schema and instances [pkid1], [pkid2],... of device/genericcucm/HeadsetInventory; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | POST | /api/device/genericcucm/HeadsetInventory/export/ |
|
{ "hrefs":["/api/device/genericcucm/HeadsetInventory/[pkid1]", "/api/device/genericcucm/HeadsetInventory/[pkid2]",...]}} |
For export_format=json, the response is a time stamped zip file of data in JSON as in the system database. Item properties such as strings that are empty or Boolean values that are not set, are not included. The filename in the response is of the format as the example:
Content-Disposition: attachment; filename=export_2013-05-17_14:20:19.186444.json.zip Content-Language:en Content-Type:application/x-zip
For export_format=raw_xlsx, the response is a MS Excel spreadsheet with columns corresponding to the JSON format export and a response filename format:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
For export_format=xlsx, the response is a MS Excel spreadsheet, arranged by any Field Display Policies that apply. The columns correspond with those of a Bulk Load Template export sheet. The response filename format is:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_formatted_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
The XLSX format can be used to bulk load instances of device/genericcucm/HeadsetInventory and the JSON format can be used to import instances of device/genericcucm/HeadsetInventory.
GET http://[host-proxy]/api/device/genericcucm/HeadsetInventory/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get a compressed format of the Bulk Load spreadsheet template for device/genericcucm/HeadsetInventory | POST | /api/device/genericcucm/HeadsetInventory/export_bulkload_template/ |
|
The response is an attachment of the format: filetype_bulkloadsheet.xlsx.gz |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Tag | PATCH | /api/device/genericcucm/HeadsetInventory/+tag/ |
|
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Tag Version | PATCH | /api/device/genericcucm/HeadsetInventory/+tag_version/ |
|
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Configuration Template | GET | /api/device/genericcucm/HeadsetInventory/configuration_template/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/ConfigurationTemplate/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Field Display Policy | GET | /api/device/genericcucm/HeadsetInventory/field_display_policy/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/FieldDisplayPolicy/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Migration Template | GET | /api/device/genericcucm/HeadsetInventory/migration/ |
|
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
List | GET | /api/device/genericcucm/HeadsetInventory/ |
|
The device/genericcucm/HeadsetInventory schema and all instances as JSON. |
(The list will return 0 to 3 device/genericcucm/HeadsetInventory instances)
{ "pagination": { "skip": 0, "limit": 3, "maximum_limit": 2000, "total": 0, "total_limit": null, "order_by": "headset_serialNumber", "direction": "asc", "current": "/api/device/genericcucm/HeadsetInventory/?skip=0&limit=3&order_by=headset_serialNumber&direction=asc&traversal=down" }, "operations": [ "list" ], "meta": { "model_type": "device/genericcucm/HeadsetInventory", "summary_attrs": [ { "name": "headset_serialNumber", "title": "Headset Serial Number" }, { "name": "headset_vendor", "title": "Headset Vendor" }, { "name": "headset_model", "title": "Headset Model" }, { "name": "headset_owner", "title": "Headset Owner" }, { "name": "host_userId", "title": "Connected Device Owner" }, { "name": "headset_connectionType", "title": "Headset Connection Type" }, { "name": "headset_firmwareVersion", "title": "Headset Firmware Version" }, { "name": "headset_connectionStatus", "title": "Headset Connection Status" }, { "name": "host_deviceNameTrimmed", "title": "Connected Device Name" }, { "name": "lastChangeTime", "title": "Headset Last Change" }, { "name": "hierarchy_friendly_name", "title": "Located At", "allow_filtering": true } ], "tagged_versions": [], "tags": [], "title": "", "business_key": {}, "api_version": "21.2", "cached": true, "references": { "children": [], "parent": [ { "href": "/api/data/HierarchyNode/6t0ggef2c0deab00hb595101", "pkid": "6t0ggef2c0deab00hb595101" } ], "device": [ { "href": "", "pkid": "" } ], "foreign_key": [] }, "model_specific_actions": [ "list", "get", "move", "clone", "export", "export_bulkload_template", "bulk_update_form", "configuration_template", "field_display_policy", "help", "migration", "transform", "tag", "tag_version" ], "schema_version": "11.5", "actions": [ { "bulk_update_form": { "method": "GET", "class": "update", "href": "/api/device/genericcucm/HeadsetInventory/bulk_update/?hierarchy=[hierarchy]&schema=&schema_rules=true", "support_async": false, "title": "Bulk Modify" } }, { "move": { "method": "POST", "class": "move", "href": "/api/tool/DataMove/?hierarchy=[hierarchy]&model_type=device/genericcucm/HeadsetInventory", "support_async": true, "title": "Move", "view": "/api/tool/DataMove/?auth_token=[authtoken] } }, { "export": { "method": "POST", "class": "export", "href": "/api/device/genericcucm/HeadsetInventory/export/?hierarchy=[hierarchy]", "support_async": false, "title": "Export", "view": "/api/view/ExportData/add/?auth_token=[authtoken], "submit": "payload" } }, { "export_bulkload_template": { "method": "POST", "class": "bulkload_template", "href": "/api/device/genericcucm/HeadsetInventory/export_bulkload_template/?hierarchy=[hierarchy]", "support_async": false, "title": "Export Bulk Load Template" } }, { "tag": { "method": "PATCH", "class": "tag", "href": "/api/device/genericcucm/HeadsetInventory/+tag/?hierarchy=[hierarchy]", "support_async": true, "title": "Tag", "view": "/api/view/TagNameForm/add/?auth_token=[authtoken] } }, { "tag_version": { "method": "PATCH", "class": "tag_version", "href": "/api/device/genericcucm/HeadsetInventory/+tag_version/?hierarchy=[hierarchy]", "support_async": true, "title": "Tag Version", "view": "/api/view/TagVersionForm/add/?auth_token=[authtoken] } }, { "configuration_template": { "method": "GET", "class": "config", "href": "/api/device/genericcucm/HeadsetInventory/configuration_template/?hierarchy=[hierarchy]", "support_async": false, "title": "Configuration Template" } }, { "field_display_policy": { "method": "GET", "class": "display_policy", "href": "/api/device/genericcucm/HeadsetInventory/field_display_policy/?hierarchy=[hierarchy]", "support_async": false, "title": "Field Display Policy" } }, { "migration": { "method": "GET", "class": "migration", "href": "/api/device/genericcucm/HeadsetInventory/migration/?hierarchy=[hierarchy]", "support_async": false, "title": "Migration Template" } }, { "list": { "method": "GET", "class": "list", "href": "/api/device/genericcucm/HeadsetInventory/?hierarchy=[hierarchy]", "support_async": false, "title": "List" } }, { "help": { "method": "GET", "class": "help", "href": "/api/device/genericcucm/HeadsetInventory/help?hierarchy=[hierarchy]", "support_async": false, "title": "Help" } }, { "purge": { "method": "POST", "class": "purge", "href": "/api/device/genericcucm/HeadsetInventory/purge/?hierarchy=[hierarchy]", "support_async": false, "title": "Purge" } }, { "transform": { "method": "GET", "class": "transform", "href": "/api/device/genericcucm/HeadsetInventory/transform/?hierarchy=[hierarchy]", "support_async": false, "title": "Transform Template" } } ] }, "resources": [] }
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get the on-line Help for device/genericcucm/HeadsetInventory. | GET | /api/device/genericcucm/HeadsetInventory/help | hierarchy=[hierarchy] | On-line help of Model ref.: device/genericcucm/HeadsetInventory as HTML |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Purge | POST | /api/device/genericcucm/HeadsetInventory/purge/ |
|
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Transform Template | GET | /api/device/genericcucm/HeadsetInventory/transform/ |
|
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Clone instance with [pkid]. The schema rules are applied. | GET | /api/device/genericcucm/HeadsetInventory/[pkid]/clone/?schema=&schema_rules=true |
|
A JSON payload with:
|
GET http://[host-proxy]/api/device/genericcucm/HeadsetInventory/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move | POST | /api/tool/DataMove/[pkid]/?model_type=device/genericcucm/HeadsetInventory | hierarchy=[hierarchy] | If payload required: |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get a selected [export_format] of the schema and a single instance with [pkid] of device/genericcucm/HeadsetInventory; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | GET | /api/device/genericcucm/HeadsetInventory/[pkid]/export |
|
The response is an attachment. Refer to the list below. |
For export_format=raw_xlsx, the response is a "raw" MS Excel spreadsheet with columns corresponding to the JSON format export and a response format:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
For export_format=xlsx, the response is a MS Excel spreadsheet, formatted to show all columns and a response format:
Content-Disposition: attachment; filename=<resource_type>_<resource_name>_exportedsheet_formatted_CCYY-MM-DD_HH-MM-SS.xlsx Content-Language:en Content-Type:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
For export_format=json, the response is a time stamped zip file of data in JSON and a response format:
Content-Disposition: attachment; filename=export_2013-05-17_14:20:19.186444.json.zip Content-Language:en Content-Type:application/x-zip
The XLSX format can be used to bulk load instances of device/genericcucm/HeadsetInventory and the JSON format can be used to import instances of device/genericcucm/HeadsetInventory.
For Bulk Export, refer to the Bulk Export section.
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Tag | PATCH | /api/device/genericcucm/HeadsetInventory/[pkid]/+tag | hierarchy=[hierarchy] | If payload required: |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get | GET | /api/device/genericcucm/HeadsetInventory/[pkid] | hierarchy=[hierarchy] | The device/genericcucm/HeadsetInventory instance with [pkid]. |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Help | GET | /api/device/genericcucm/HeadsetInventory/[pkid]/help | hierarchy=[hierarchy] | The on-line Help for device/genericcucm/HeadsetInventory. |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Purge | POST | /api/device/genericcucm/HeadsetInventory/[pkid]/purge | hierarchy=[hierarchy] | If payload required: |