Get a Source - 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

Get a single source by a specific source ID.

Listener includes the secret key for the source only when the requestor is a source owner or administrator.

Definition

GET https://CLUSTER.DOMAIN/listener/appservices/sources/{source_id} HTTP/1.1

Example Request

curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TOKEN" \
  -X  GET \
 -i \
  https://CLUSTER.DOMAIN/listener/appservices/sources/758fbda4-accc-4f90-8f09-cc0a164c8c28

Example REST Source Response

HTTP/1.1 200 OK
Content-Type: application/json
{
  "source_id": "758fbda4-accc-4f90-8f09-cc0a164c8c28",
  "owner": ["jd123456"],
  "created_at": "2015-07-04T10:20:00Z",
  "created_by": "av012345",
  "updated_at": "2015-12-20T10:20:00Z",
  "updated_by": "jd123456",
  "secret": "f8a9f620-e0e6-470b-a6b8-1f16b003c034",
  "name": "My source",
  "description": "A superb source",
  "state": 1,
  "production": false,
  "source_type": "REST"
}

Example MQTT Source Response

HTTP/1.1 200 OK
Content-Type: application/json
{
  "source_id": "758fbda4-accc-4f90-8f09-cc0a164c8c29",
  "owner": ["jd123456"],
  "created_at": "2015-07-04T10:21:00Z",
  "created_by": "av012345",
  "updated_at": "2015-12-20T10:21:00Z",
  "updated_by": "jd123456",
  "secret": "f8a9f620-e0e6-470b-a6b8-1f16b003c035",
  "name": "My other source",
  "description": "Another superb source",
  "state": 1,
  "production": false,
  "source_type": "MQTT",
  "subscription_info": {
    "broker": "http://localhost:1234",
    "topic": "My MQTT topic",
    "state": "connected"
  }
}

Response Codes

Code Description
200 Source successfully returned.
401 Authorization header not found.
404 Resource not found.