[Index]
Stores generic driver connection parameters for interfacing to an external service.
Title | Description | Details | |||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Name * | Name for this instance of generic driver connection details. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Description * | Description for this instance of generic driver connection details. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Version * | Version of models to use. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Authentication Method * | Type of authentication to use when interfacing to the external service. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Username | Username to use with specified authentication method. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Password | Password to use with specified authentication method. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Token | Token to use with specified authentication method. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Test Connection URI | URI to use when testing connection to external service, e.g. https://service.domain/api/health, {{ driver_parameters.host_base }}/status |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Driver Parameters | Additional parameters for the driver |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Name * | Name of additional driver parameter. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Value * | Value of additional driver parameter. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Secure Driver Parameters | Additional secure parameters for the driver |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Name * | Name of additional secure driver parameter. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Value * | Value of additional secure driver parameter. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Default Request Headers | Default HTTP request headers to send with all device model API operation requests. Defaults specified here will be overriden by request headers specified on individual device model API operation definitions. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Name * | Name of HTTP request header, e.g. Accept. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Value * | Value of HTTP request header, e.g. text/plain. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Default Response Handlers | Default handlers to execute on all API operation responses. Only those response handlers' which condition evaluates to True are executed. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Condition * | Jinja template which if evaluation results in a value of True will cause the specified handler type to be executed, e.g. {{ status_code == 429 }}. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Type * | Response handler type to execute if specified condition evaluates to True, e.g. Backoff & Retry. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Session Based Auth Request | Describes the API request required to obtain a valid auth token. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Login URI | URI for the API Login request. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Login HTTP Method | HTTP method for API login request. Default: POST |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Login Request Headers | Request headers for the initial login request. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Header Name | Name of session request header, e.g. Cookie. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Header Value | Value of session request header, e.g. session=12345. This is a jinja template with custom functions and driver parameter context available. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Request Template for POST requests | A request template that will be used for POST requests. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Session Expire Time (min) | The amount of time a session is valid specifiec in minutes. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Headers | Session headers to include for all requests. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Header Name | Name of session request header, e.g. Cookie. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Header Value | Value of session request header, e.g. session=12345. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Common Actions | Actions used identically by many device models |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Action * | Name of the device model operation for e.g. add |
|
|||||||||||||||||||||||||||||||||||||||||||||||
URI | URI for the API request |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Target | Target of this operation Default: HTTP |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Request Format | Request format Default: JSON |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Response Format | Response format Default: JSON |
|
|||||||||||||||||||||||||||||||||||||||||||||||
HTTP Method | HTTP method for API request Default: get |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Response Code Template | Jinja template for mapping API endpoint specific error/status response |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Request Headers | HTTP request headers to send with API operation request. Takes precedence over default request headers specified on related Connection Parameters Type instance. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Name * | Name of HTTP request header, e.g. Accept. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Value * | Value of HTTP request header, e.g. text/plain. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Response Handlers | Handlers to execute on API responses. Only those response handlers' which condition evaluate to True are executed. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Condition * | Jinja template which if evaluation results in a value of True will cause the specified handler type to be executed, e.g. {{ status_code == 429 }}. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Type * | Response handler type to execute if specified condition evaluates to True, e.g. Backoff & Retry. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Variables | List of context variables availble to template rendering (supports Macros) |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Name | Context variable name. This will appear in the context as 'variables.<name>' |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Value | Value of this variable. This field supports Macros |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Pre-request Calls | List of API calls to make before making this request |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Post-request Calls | List of API calls to make after making this request |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Request Template | Jinja template for API request. Maps system schema to external application schema. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Response Template | Jinja template for API response. Maps external application schema to system schema. |
|