GET Syslog REST API

This GET operation returns a list of Syslog servers configured for a Unified CVP device (such as Call Server, VXML Server or Reporting Server) owned by the authenticated sender of the request. To authenticate a request, use the same credentials that are configured in the Operations Console.

URI

https://<ipaddress>:8111/cvp-config/server/<id>/infrastructure/syslog/

HTTP Method

GET

Input/Output Format

XML or JSON

Throttled

Yes

For more information on throttling, see Unified CVP REST Request Throttling.

Authentication

Yes

Note	To authenticate a request, user must use valid credentials that are configured in the Operations Console, as anonymous requests are rejected.

API Type

Synchronous

Request

The GET operation on the service endpoint gets the Syslog configuration of the device.

GET
					 https://api.cvp.com:8111/cvp-config/server/040645fb-a4f0-4019-964f-c70d9e629fba/infrastructure/syslog

Authorization

Basic signaturevalue

Content-type

Application/XML or Application/JSON

Accept

Application/XML or Application/JSON

Response Data Structure

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<server>
    <infrastructure>
        <syslog>
            <primary>
                <active>
                    <host>prim111.cisco.com</host>
                    <port>514</port>
                </active>
                <backup>
                    <host>prim2.cisco.com</host>
                    <port>512</port>
                </backup>
            </primary>
            <secondary>
                <active>
                    <host>sec1.cisco.com</host>
                    <port>513</port>
                </active>
                <backup>
                    <host>sec21.cisco.com</host>
                    <port>514</port>
                </backup>
            </secondary>
        </syslog>
    </infrastructure>
    <hostname>CS43</hostname>
    <ipaddress>10.78.26.43</ipaddress>
    <refURL>https://10.78.26.43:8111/cvp-config/server/040645fb-a4f0-4019-964f-c70d9e629fba</refURL>
    <type>CALL</type>
</server>

syslog - High level element to wrap the Syslog configuration of the device.

primary - Primary Syslog Server.

secondary-Secondary Syslog Server.

active - Active Syslog Server.

host- Host name or IP address of the Syslog Server.

port - Port number of the Syslog Server.

backup - Backup for the active server.

Response Header


Response headers:
HTTP/1.1 200 OK
....
Content-Type: application/xml;charset=utf-8
Date: Mon, 26 Aug 2013 10:53:54 GMT

Response Code

400- Bad request. If the request body is invalid.

400- API error . If the object either does not exist or is stale.

401- Authorization Failure(for example, the user is not authenticated in the web session)

404- Not Found (for example, the resource is deleted and is not found )

406- Not Acceptable(for example, the accept headers sent in the request is not acceptable.

500- Internal Server Error( for example, the connection is broken with the database server or ORM or any other component.

503 Service Unavailable. When the request processing threshold is reached.

For more information on error codes and their descriptions, see Unified CVP API Error Codes.

Security Constraints

Only a Serviceability administrator can perform this operation.

For more information on code snippets, see Unified CVP API Client Sample Code.