[Index]
Model ref.: device/cuc/VpimLocation
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": { "EnableAutoUpdateContactDisplayName": { "minItems": 0, "type": "boolean", "description": " A flag indicating whether a contact's display name is updated when a contact is automatically updated. ", "name": "EnableAutoUpdateContactDisplayName", "title": "Enable Auto Update Contact Display Name" }, "DisplayName": { "minItems": 0, "type": "string", "description": " The unique text name of this Location, e.g. \"Seattle Office.\" Used when displaying entries in the administrative console, e.g. Cisco Unity Connection Administration.", "name": "DisplayName", "title": "Display Name" }, "AutoCreateDisplayNameRule": { "minItems": 0, "type": "string", "description": " Indicates how text names on incoming messages will be mapped to the display name for auto-created contacts.\n\nA value of NULL indicates the text name is mapped directly to the display name of the contact.\nA non-null value indicates this is a custom rule that defines the mapping of the text name to the display name. Example: <FirstName>, <LastName>", "name": "AutoCreateDisplayNameRule", "title": "Auto Create Display Name Rule" }, "EnableAutoDeleteContact": { "minItems": 0, "type": "boolean", "description": " A flag indicating whether a contact is automatically deleted when an NDR is received.", "name": "EnableAutoDeleteContact", "title": "Enable Auto Delete Contact" }, "VoiceName": { "minItems": 0, "type": "string", "description": " The name of the WAV file containing the recorded audio (voice name, greeting, etc.) for the parent object.", "name": "VoiceName", "title": "Voice Name" }, "AudioFormatOutgoing": { "minItems": 0, "type": "integer", "description": " An enumeration indicating whether VPIM messages from Unity to the remote system corresponding to this location should be converted to another audio format.", "name": "AudioFormatOutgoing", "title": "Audio Format Outgoing" }, "LocalPhonePrefix": { "minItems": 0, "type": "string", "description": " The number used to construct addresses for contacts who use the voice messaging system that corresponds to this location. NULL is allowed.", "name": "LocalPhonePrefix", "title": "Local Phone Prefix" }, "DestinationType": { "minItems": 0, "type": "integer", "description": " For delivery locations, the destination type for that location, e.g. Connection, Unity, VPIM, Bridge.", "name": "DestinationType", "title": "Destination Type" }, "LastDirectoryPushDate": { "minItems": 0, "type": "string", "description": " The time and date of the last manual directory push to this VPIM location.\n\nNULL indicates no push has taken place.", "name": "LastDirectoryPushDate", "title": "Last Directory Push Date" }, "IpAddress": { "minItems": 0, "type": "string", "name": "IpAddress", "title": "Ip Address" }, "ContactTemplateObjectId": { "minItems": 0, "type": "string", "description": " The template upon which to base new contacts created whose destination for messages is this LocationVPIM.", "name": "ContactTemplateObjectId", "title": "Contact Template Object Id" }, "PartitionObjectId": { "minItems": 0, "type": "string", "description": " The unique identifier of the Partition to which the DtmfAccessId is assigned.", "name": "PartitionObjectId", "title": "Partition Object Id" }, "UseSmartSmtpHost": { "minItems": 0, "type": "boolean", "description": " A flag indicating whether the Unity Connection SMTP server forwards messages to the SMTP Smart Host for delivery.\n\nValues:\n0: Do not forward to SMTP Smart Host\n1: Forward message to SMTP Smart Host\n", "name": "UseSmartSmtpHost", "title": "Use Smart Smtp Host" }, "SmtpDomain": { "minItems": 0, "type": "string", "description": " The domain portion (right-half) of an internet-addressable address (for example, london.cisco.com). This is used to form a user's, contact's, and distribution list's SMTP address (tbl_Alias.SmtpAddress).", "name": "SmtpDomain", "title": "Smtp Domain" }, "DtmfName": { "minItems": 0, "type": "string", "description": " The series of digits corresponding to the numeric keypad mapping on a standard touchtone phone representing the display name of the location. These digits are used for searching the location by name via the phone.", "name": "DtmfName", "title": "Dtmf Name" }, "EnableAGC": { "minItems": 0, "type": "boolean", "description": " A flag indicating whether Cisco Unity Connection should apply software-based gain control to messages received from this VPIM location.", "name": "EnableAGC", "title": "Enable AGC" }, "VoiceNameURI": { "name": "VoiceNameURI", "format": "uri", "minItems": 0, "title": "Voice Name URI", "choices": [], "type": "string", "target": "/api/choices/?format=json&hierarchy=[hierarchy]&auth_token=[authtoken] }, "PushDirectory": { "minItems": 0, "type": "boolean", "description": " Tells SMTP service whether or not to execute a manual directory push to this VPIM location.", "name": "PushDirectory", "title": "Push Directory" }, "LocationObjectId": { "minItems": 0, "type": "string", "description": " Points to the LocationVMS record identifying where this VPIM location was created.", "name": "LocationObjectId", "title": "Location Object Id" }, "AllowBlindAddressing": { "minItems": 0, "type": "boolean", "description": " A flag indicating whether messages can be addressed to this location without an existing handler or subscriber.", "name": "AllowBlindAddressing", "title": "Allow Blind Addressing" }, "EnableAutoUpdateContact": { "minItems": 0, "type": "integer", "description": " An enumeration indicating whether a contact is automatically updated when messages are received from senders at this location, and if so, under what condition the contact is updated.", "name": "EnableAutoUpdateContact", "title": "Enable Auto Update Contact" }, "SearchSpaceObjectId": { "minItems": 0, "type": "string", "description": " The unique identifier of the SearchSpace that determines the Partition(s) that are searched to find the recipient of an incoming VPIM message to a user.", "name": "SearchSpaceObjectId", "title": "Search Space Object Id" }, "EnableAutoCreateNoVoiceName": { "minItems": 0, "type": "boolean", "description": " A flag indicating whether a contact may be automatically created/updated when the incoming VPIM message does not include a recorded voice name.", "name": "EnableAutoCreateNoVoiceName", "title": "Enable Auto Create No Voice Name" }, "EnableOutgoingSecureMessages": { "minItems": 0, "type": "boolean", "description": " A flag indicating whether outgoing messages can be marked \"Secure.\"", "name": "EnableOutgoingSecureMessages", "title": "Enable Outgoing Secure Messages" }, "EnableOutgoingPrivateMessages": { "minItems": 0, "type": "boolean", "description": " A flag indicating whether outgoing messages can be marked \"Private.\"", "name": "EnableOutgoingPrivateMessages", "title": "Enable Outgoing Private Messages" }, "SearchSpaceURI": { "name": "SearchSpaceURI", "format": "uri", "minItems": 0, "title": "Search Space URI", "choices": [], "type": "string", "target": "/api/choices/?format=json&hierarchy=[hierarchy]&auth_token=[authtoken] }, "AudioFormatIncoming": { "minItems": 0, "type": "integer", "description": " An enumeration indicating whether incoming VPIM messages from the remote system corresponding to this location should be converted to another audio format.", "name": "AudioFormatIncoming", "title": "Audio Format Incoming" }, "ObjectId": { "description": " The primary key for this table. A globally unique, system-generated identifier for a VPIM location. - template parameter [1]", "title": "Object Id", "minItems": 0, "readonly": true, "type": "string", "name": "ObjectId" }, "IncludeSenderVoiceName": { "minItems": 0, "type": "boolean", "description": " A flag indicating whether Unity adds the sender?s recorded voice name to an outgoing VPIM message.", "name": "IncludeSenderVoiceName", "title": "Include Sender Voice Name" }, "EnableAutoCreateContact": { "minItems": 0, "type": "boolean", "description": " A flag indicating whether a contact is automatically created when messages are received from senders at this location.", "name": "EnableAutoCreateContact", "title": "Enable Auto Create Contact" }, "URI": { "name": "URI", "format": "uri", "minItems": 0, "title": "URI", "choices": [], "type": "string", "target": "/api/choices/?format=json&hierarchy=[hierarchy]&auth_token=[authtoken] }, "ListContactsInDirectory": { "minItems": 0, "type": "boolean", "description": " A flag indicating whether a contact should be listed in the phone directory for outside callers, when a contact is automatically created. Default value is 0. \n\nValues:\n0: Do not list contact in directory\n1: List contact in directory\n", "name": "ListContactsInDirectory", "title": "List Contacts In Directory" }, "AlternateNamesURI": { "type": "string", "description": "The URI to get the alternate names of the VPIM location.", "name": "AlternateNamesURI", "title": "Alternate Names URI" }, "VoiceFileURI": { "name": "VoiceFileURI", "format": "uri", "minItems": 0, "title": "Voice File URI", "choices": [], "type": "string", "target": "/api/choices/?format=json&hierarchy=[hierarchy]&auth_token=[authtoken] }, "RemotePhonePrefix": { "minItems": 0, "type": "string", "description": " The number used to construct addresses for contacts who use the voice messaging system that corresponds to this location. NULL is allowed.", "name": "RemotePhonePrefix", "title": "Remote Phone Prefix" }, "AutoCreateExtensionRule": { "minItems": 0, "type": "integer", "description": " An enumeration indicating how the phone number on incoming VPIM messages should be mapped to the extension for the auto-created contact.", "name": "AutoCreateExtensionRule", "title": "Auto Create Extension Rule" }, "PartitionURI": { "name": "PartitionURI", "format": "uri", "minItems": 0, "title": "Partition URI", "choices": [], "type": "string", "target": "/api/choices/?format=json&hierarchy=[hierarchy]&auth_token=[authtoken] }, "DtmfAccessId": { "minItems": 0, "type": "string", "description": " The dialable number.", "name": "DtmfAccessId", "title": "Dtmf Access Id" }, "LocationURI": { "name": "LocationURI", "format": "uri", "minItems": 0, "title": "Location URI", "choices": [], "type": "string", "target": "/api/choices/?format=json&hierarchy=[hierarchy]&auth_token=[authtoken] } }, "schema_version": "12.5" }
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get the GUI Add form. | GET | /api/device/cuc/VpimLocation/add/ |
|
The GUI Add form of device/cuc/VpimLocation as JSON |
The API call to the /add/ URL can only be made from a hierarchy that allows the model type to be added. The actions in the response shows the url for the POST API call to create an instance.
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Create | POST | /api/device/cuc/VpimLocation/ | hierarchy=[hierarchy] |
|
tool/Transaction/[trans pkid]to inspect the created resource and its instance pkid.
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Bulk delete [pkid1],[pkid2]... | DELETE | /api/device/cuc/VpimLocation/ | hierarchy=[hierarchy] | {"hrefs":["/api/device/cuc/VpimLocation/[pkid1]", "/api/device/cuc/VpimLocation/[pkid2]", ...]} |
GET http://[host-proxy]/api/device/cuc/VpimLocation/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Bulk Modify | GET | /api/device/cuc/VpimLocation/bulk_update/?schema=&schema_rules=true |
|
|
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Bulk Modify | POST | /api/device/cuc/VpimLocation/bulk_update/ |
|
For example: {"data":{"name":"value"}, "meta":{}, "request_meta":{ "hrefs":["/api/v0/device/cuc/VpimLocation/[pkid1]", "/api/v0/device/cuc/VpimLocation/[pkid2]",...]}} |
GET http://[host-proxy]/api/device/cuc/VpimLocation/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move the instance with [pkid] to [target_hierarchy] | POST | /api/tool/DataMove/?model_type=device/cuc/VpimLocation |
|
{"hrefs": ["/api/device/cuc/VpimLocation/[pkid]"]} |
Bulk Move | POST | /api/tool/DataMove/?model_type=device/cuc/VpimLocation |
|
{"hrefs": ["/api/device/cuc/VpimLocation/[pkid1]", "/api/device/cuc/VpimLocation/[pkid2]",...]} |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Get a selected [export_format] of the schema and instances [pkid1], [pkid2],... of device/cuc/VpimLocation; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | POST | /api/device/cuc/VpimLocation/export/ |
|
{ "hrefs":["/api/device/cuc/VpimLocation/[pkid1]", "/api/device/cuc/VpimLocation/[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/cuc/VpimLocation and the JSON format can be used to import instances of device/cuc/VpimLocation.
GET http://[host-proxy]/api/device/cuc/VpimLocation/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get a compressed format of the Bulk Load spreadsheet template for device/cuc/VpimLocation | POST | /api/device/cuc/VpimLocation/export_bulkload_template/ |
|
The response is an attachment of the format: filetype_bulkloadsheet.xlsx.gz |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Configuration Template | GET | /api/device/cuc/VpimLocation/configuration_template/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/ConfigurationTemplate/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Field Display Policy | GET | /api/device/cuc/VpimLocation/field_display_policy/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/FieldDisplayPolicy/?hierarchy=[hierarchy]
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
List | GET | /api/device/cuc/VpimLocation/ |
|
The device/cuc/VpimLocation schema and all instances as JSON. |
(The list will return 0 to 3 device/cuc/VpimLocation instances)
{ "operations": [ "move" ], "pagination": { "direction": "asc", "order_by": "DisplayName", "maximum_limit": 2000, "skip": 0, "current": "/api/device/cuc/VpimLocation/?skip=0&limit=3&order_by=DisplayName&direction=asc&traversal=default", "limit": 3, "total_limit": null, "total": 0 }, "meta": { "tags": [], "cached": true, "title": "", "business_key": {}, "schema_version": "12.5", "references": { "device": [ { "pkid": "", "href": "" } ], "children": [], "parent": [ { "pkid": "6t0ggef2c0deab00hb595101", "href": "/api/data/HierarchyNode/6t0ggef2c0deab00hb595101" } ], "foreign_key": [] }, "actions": [ { "add": { "support_async": false, "class": "add", "href": "/api/device/cuc/VpimLocation/add/?hierarchy=[hierarchy]", "method": "GET", "title": "Add" } }, { "remove": { "support_async": true, "class": "delete", "href": "/api/device/cuc/VpimLocation/?hierarchy=[hierarchy]", "method": "DELETE", "title": "Delete" } }, { "bulk_update_form": { "support_async": false, "class": "update", "href": "/api/device/cuc/VpimLocation/bulk_update/?hierarchy=[hierarchy]&schema=&schema_rules=true", "method": "GET", "title": "Bulk Modify" } }, { "move": { "title": "Move", "support_async": true, "class": "move", "href": "/api/tool/DataMove/?hierarchy=[hierarchy]&model_type=device/cuc/VpimLocation", "method": "POST", "view": "/api/tool/DataMove/?auth_token=[authtoken] } }, { "export": { "title": "Export", "support_async": false, "submit": "payload", "class": "export", "href": "/api/device/cuc/VpimLocation/export/?hierarchy=[hierarchy]", "method": "POST", "view": "/api/view/ExportData/add/?auth_token=[authtoken] } }, { "export_bulkload_template": { "support_async": false, "class": "bulkload_template", "href": "/api/device/cuc/VpimLocation/export_bulkload_template/?hierarchy=[hierarchy]", "method": "POST", "title": "Export Bulk Load Template" } }, { "configuration_template": { "support_async": false, "class": "config", "href": "/api/device/cuc/VpimLocation/configuration_template/?hierarchy=[hierarchy]", "method": "GET", "title": "Configuration Template" } }, { "field_display_policy": { "support_async": false, "class": "display_policy", "href": "/api/device/cuc/VpimLocation/field_display_policy/?hierarchy=[hierarchy]", "method": "GET", "title": "Field Display Policy" } }, { "list": { "support_async": false, "class": "list", "href": "/api/device/cuc/VpimLocation/?hierarchy=[hierarchy]", "method": "GET", "title": "List" } }, { "help": { "support_async": false, "class": "help", "href": "/api/device/cuc/VpimLocation/help?hierarchy=[hierarchy]", "method": "GET", "title": "Help" } }, { "purge": { "support_async": false, "class": "purge", "href": "/api/device/cuc/VpimLocation/purge/?hierarchy=[hierarchy]", "method": "POST", "title": "Purge" } } ], "model_type": "device/cuc/VpimLocation", "model_specific_actions": [ "add", "list", "update", "get", "remove", "bulk_update_form", "clone", "configuration_template", "export", "export_bulkload_template", "field_display_policy", "help", "move" ], "summary_attrs": [ { "name": "DisplayName", "title": "Display Name" }, { "allow_filtering": true, "name": "hierarchy_friendly_name", "title": "Located At" } ], "api_version": "19.3.1", "tagged_versions": [] }, "resources": [] }
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get the on-line Help for device/cuc/VpimLocation. | GET | /api/device/cuc/VpimLocation/help | hierarchy=[hierarchy] | On-line help of Model ref.: device/cuc/VpimLocation as HTML |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Modify | PUT | /api/device/cuc/VpimLocation/[pkid]/ | hierarchy=[hierarchy] | (For payload specification) |
For Bulk modification, refer to the Bulk Modify section.
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Delete | DELETE | /api/device/cuc/VpimLocation/[pkid]/ | hierarchy=[hierarchy] |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Clone instance with [pkid]. The schema rules are applied. | GET | /api/device/cuc/VpimLocation/[pkid]/clone/?schema=&schema_rules=true |
|
A JSON payload with:
|
GET http://[host-proxy]/api/device/cuc/VpimLocation/?hierarchy=[hierarchy]&format=json
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Move | POST | /api/tool/DataMove/[pkid]/?model_type=device/cuc/VpimLocation | 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/cuc/VpimLocation; optionally with tag_version at [version] and Configuration Template as [configtemplate]. | GET | /api/device/cuc/VpimLocation/[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/cuc/VpimLocation and the JSON format can be used to import instances of device/cuc/VpimLocation.
For Bulk Export, refer to the Bulk Export section.
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Get | GET | /api/device/cuc/VpimLocation/[pkid]/ | hierarchy=[hierarchy] | The device/cuc/VpimLocation instance with [pkid]. |
Task | Call | URL | Parameters | Response |
---|---|---|---|---|
Help | GET | /api/device/cuc/VpimLocation/[pkid]/help | hierarchy=[hierarchy] | The on-line Help for device/cuc/VpimLocation. |
Task | Call | URL | Parameters | Payload |
---|---|---|---|---|
Purge | POST | /api/device/cuc/VpimLocation/[pkid]/purge/ | hierarchy=[hierarchy] | If payload required: |