Table of Contents

Search

  1. Preface
  2. Introduction to Edge Data Streaming Custom Entity Types
  3. Managing Custom Entity Types
  4. Custom Entities from Maven Archetypes
  5. REST APIs
  6. HTTP Request and Response Parameters
  7. Sample JSON Requests and Responses
  8. Glossary

Developer Guide

Developer Guide

Create Parameters

Create Parameters

Use the POST method to create a parameter in EDS.

POST Request in JSON Format

Generate a POST request. For example, the following POST request creates a parameter:
POST /api/parameters Content-Type: application/json Accept: application/json

POST Body in JSON Format

{ "parameters": [ {"key": "TestKey", "value": "TestValue"}, {"key": "Key2", "value": "Value2", "secure": true}, ] }

POST Response in JSON Format

The following are sample responses for the 201 Created code:
{ "total": 1, "count": 1, "success": true, "items": [ {"parameterId": {parameter-id}, "key": {parameter-key}, "success": true, "value": {parameter-value-masked}, "secure": false, "timestamp": {timestamp}} } ] }
{ "total": 2, "count": 2, "success": true, "items": [ {"parameterId": {parameter-id}, "key": {parameter-key}, "success": true, "value": {parameter-value-masked}, "secure": true, "timestamp": {timestamp}}, {"parameterId": {parameter-id}, "key": {parameter-key}, "success": true, "value": {parameter-value}, "secure": false, "timestamp": {timestamp}} ] }
The following are sample responses for the 400 Bad Request code:
{ "success": false, "errors": [ { "code": PARAMETER_KEY_FIELD_NOT_FOUND, "parameters": null, "errorMessage": "'key' field is missing in request" } ] }
{ "success": false, "errors": [ { "code": PARAMETER_NAME_ALREADY_EXISTS, "parameters": null, "errorMessage": "Parameter name already exists." } ] }
The following is a sample response for the 500 Internal Server Error code:
{ "success": false, "errors": [ { "code": INTERNAL_SERVER_ERROR, "parameters": [{error-message}], "errorMessage": "Failed to create parameter. Exception: {error-message}" } ] }

0 COMMENTS

We’d like to hear from you!