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. |