To create a new system, provide a JSON object with the new system properties. The Listener API ignores read-only properties.
Definition
POST https://listener-app-services.teradata.com/v1/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://listener-app-services.teradata.com/v1/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" }
Response Codes
Code | Description |
---|---|
201 | System successfully created. |
400 | Required property missing from request. |
401 | Authorization header not found. |