The following fields are associated with the error responses that use this error template:

  • code
  • message

To create the error template, perform the following steps:

  1. Create a file named error-template.vtl with the following contents:
    #set ($code = "UNEXPECTED_ERROR")
    #if($status == 403)
      #set ($code = "ACCESS_FAILED")
    #end
    {
      "code":"$code",
      "message":"$message"
    }
  2. Add the error template to the configuration.
    dsconfig create-error-template \
      --template-name "Custom Error Template" \
      --set "velocity-template<error-template.vtl"
  3. Assign the error template to the Sideband API Endpoint.
    dsconfig set-sideband-api-endpoint-prop \
      --endpoint-name "Test API" \
      --set "error-template:Custom Error Template"

The error template is used whenever the Sideband API generates an error in response to a request.