Create a System

Teradata® Listener™ User Guide

brand
Analytical Ecosystem
prodname
Teradata Listener
vrm_release
2.05
category
User Guide
featnum
B035-2910-039K

To create a new system, provide a JSON object with the new system properties. The Listener API ignores read-only properties.

Definition

POST https://CLUSTER.DOMAIN/listener/appservices/systems HTTP/1.1

Example Request

curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TOKEN" \
  -X POST \
  -d '{
    "name": "My System",
    "description": "A superb system",
    "system_type": "teradata",
    "system_info": { "host": "ip112233", "port": "8080", "username": "listener", "password": "listener" }
  }' \
  -i \
  https://CLUSTER.DOMAIN/listener/appservices/systems

Example Response

HTTP/1.1 201 OK
Content-Type: application/json
{
  "system_id": "9dda5570-70e0-45be-8449-83f33320cd08",
  "owner": ["jd123456"],
  "name": "My System",
  "description": "A superb system",
  "system_type": "teradata",
  "system_info": { "host": "ip112233", "port": "8080" },
  "state": "1"
}
In the response for HDFS systems, Listener returns a port that is a datatype string instead of the expected datatype int. This does not affect system functionality.

Response Codes

Code Description
201 System successfully created.
400 Required property missing from request.
401 Authorization header not found.