Create a System - Teradata Listener

Teradata® Listener™ User Guide

Product
Teradata Listener
Release Number
2.05
Published
March 2019
Language
English (United States)
Last Update
2019-04-25
dita:mapPath
vlj1546974296436.ditamap
dita:ditavalPath
ft:empty
dita:id
B035-2910
lifecycle
previous
Product Category
Analytical Ecosystem

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.