Salesforce

Java API endpoint: getEngines

« Go Back
Information
Java API endpoint: getEngines
000008806
Public
Product Selection
aiWare - API
Article Details

GetEnginesResponse getEngines(xCorrelationId, internalApplicationID, internalOrganizationID, engineName, engineState, engineType, engineOutputType, engineCategoryID, engineIDs, offset, limit, direction, startTime, endTime, preload, orderBy)

Get the list of engines deployed and available on aiWARE.

Example

// Import classes:
import com.veritone.aiware.ApiClient;
import com.veritone.aiware.ApiException;
import com.veritone.aiware.Configuration;
import com.veritone.aiware.auth.*;
import com.veritone.aiware.models.*;
import com.veritone.aiware.edge.EngineApi;

public class Example {
  public static void main(String[] args) {
    ApiClient defaultClient = Configuration.getDefaultApiClient();
    defaultClient.setBasePath("https://api.aiware.com/edge/v1");
    
    // Configure API key authorization: api_key
    ApiKeyAuth api_key = (ApiKeyAuth) defaultClient.getAuthentication("api_key");
    api_key.setApiKey("YOUR API KEY");
    // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
    //api_key.setApiKeyPrefix("Token");

    EngineApi apiInstance = new EngineApi(defaultClient);
    String xCorrelationId = "xCorrelationId_example"; // String | Correlation Id that can be passed, traced in the server and will be returned in the response if present in the request
    UUID internalApplicationID = new UUID(); // UUID | Internal ID of Application
    UUID internalOrganizationID = new UUID(); // UUID | ID of Organization.  UUID.  This ID is unique to this aiWARE installation.
    String engineName = "engineName_example"; // String | Field to string match against the engine names
    EngineStateEnum engineState = new EngineStateEnum(); // EngineStateEnum | Field to match the current state
    EngineTypeEnum engineType = new EngineTypeEnum(); // EngineTypeEnum | Field to match the current type
    EngineTypeEnum engineOutputType = new EngineTypeEnum(); // EngineTypeEnum | Field to match the current type
    String engineCategoryID = "engineCategoryID_example"; // String | Filter to the particular engine category ID
    String engineIDs = "engineIDs_example"; // String | Field to provide the input to get engines by Engine ID list. Separated by commas
    Long offset = 56L; // Long | the number of data to skip before getting the result set
    Long limit = 10lL; // Long | the number of items to return.
    String direction = "\"DESC\""; // String | the sort order.  ASC or DESC.
    Long startTime = 56L; // Long | The unix timestamp, describing the start time for the stats
    Long endTime = 56L; // Long | The unix timestamp, describing the end time for the stats
    Boolean preload = true; // Boolean | Filter engines by preload
    String orderBy = "orderBy_example"; // String | The value should be in [name, state, type, organizationID, createdTime]
    try {
      GetEnginesResponse result = apiInstance.getEngines(xCorrelationId, internalApplicationID, internalOrganizationID, engineName, engineState, engineType, engineOutputType, engineCategoryID, engineIDs, offset, limit, direction, startTime, endTime, preload, orderBy);
      System.out.println(result);
    } catch (ApiException e) {
      System.err.println("Exception when calling EngineApi#getEngines");
      System.err.println("Status code: " + e.getCode());
      System.err.println("Reason: " + e.getResponseBody());
      System.err.println("Response headers: " + e.getResponseHeaders());
      e.printStackTrace();
    }
  }
}

Parameters

NameTypeDescriptionNotes
xCorrelationIdStringCorrelation Id that can be passed, traced in the server and will be returned in the response if present in the request[optional]
internalApplicationIDUUIDInternal ID of Application[optional]
internalOrganizationIDUUIDID of Organization. UUID. This ID is unique to this aiWARE installation.[optional]
engineNameStringField to string match against the engine names[optional]
engineStateEngineStateEnumField to match the current state[optional] [enum: active, paused, replace]
engineTypeEngineTypeEnumField to match the current type[optional] [enum: chunk, stream, batch, any]
engineOutputTypeEngineTypeEnumField to match the current type[optional] [enum: chunk, stream, batch, any]
engineCategoryIDStringFilter to the particular engine category ID[optional]
engineIDsStringField to provide the input to get engines by Engine ID list. Separated by commas[optional]
offsetLongthe number of data to skip before getting the result set[optional]
limitLongthe number of items to return.[optional] [default to 10l]
directionStringthe sort order. ASC or DESC.[optional] [default to "DESC"]
startTimeLongThe unix timestamp, describing the start time for the stats[optional]
endTimeLongThe unix timestamp, describing the end time for the stats[optional]
preloadBooleanFilter engines by preload[optional]
orderByStringThe value should be in [name, state, type, organizationID, createdTime][optional]

Return type

GetEnginesResponse

Authorization

api_key

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200List of engines* X-Aiware-Version -
* X-Correlation-Id -
400Invalid argument. Please see the error response for more information.* X-Aiware-Version -
* X-Correlation-Id -
401Not authorized* X-Aiware-Version -
* X-Correlation-Id -
403Forbidden* X-Aiware-Version -
* X-Correlation-Id -
404Not Found* X-Aiware-Version -
* X-Correlation-Id -
405The request is not allowed.* X-Aiware-Version -
* X-Correlation-Id -
429Too Many Requests* Retry-After -
* X-Aiware-Version -
* X-Correlation-Id -
501Not Implemented* X-Aiware-Version -
* X-Correlation-Id -
503System Unavailable* Retry-After -
* X-Aiware-Version -
* X-Correlation-Id -

 

Additional Technical Documentation Information
Properties
5/19/2025 8:59 PM
5/19/2025 9:02 PM
5/19/2025 9:02 PM
Documentation
Documentation
000008806
Translation Information
English

Powered by