Update a System - Teradata Listener

Teradata® Listener™ User Guide

Product
Teradata Listener
Release Number
2.04
Published
November 2018
Language
English (United States)
Last Update
2018-12-20
dita:mapPath
qin1538418638881.ditamap
dita:ditavalPath
ft:empty
dita:id
B035-2910
lifecycle
previous
Product Category
Analytical Ecosystem

To update a system, send a JSON object with updated values for one or more of the writable system properties. Read-only properties are ignored. All property values from the previous version of this system are carried over by default, if not included in the hash.

Definition

PATCH https://listener-app-services.domain.com/v1/systems/{system_id} 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"},
    "state": "1"
  }' \
  -i \
  https://listener-app-services.domain.com/v1/systems/9dda5570-70e0-45be-8449-83f33320cd08

Example Response

HTTP/1.1 200 OK
Content-Type: application/json
{
  "system_id": "9dda5570-70e0-45be-8449-83f33320cd08",
  "owner": ["jd123456"],
  "name": "My Updated System",
  "description": "A superb system",
  "system_type": "teradata",
  "system_info": { "host": "ip112233", "port": "8080" },
  "state": "1"
}

Response Codes

Code Description
200 System successfully updated.
400 Required property missing from request.
401 Authorization header not found.
404 Resource not found.