Oracle Enterprise Scheduling Service

Set the status of the request execution

post

ess/rest/scheduler/v1/requests/{requestId}/executionStatus

Set the status of the request execution. It is meant to be invoked from a job request to signal to the scheduler the result of its execution. The scheduler uses it as an indicator how should proceed to transition the request state.

Request

Path Parameters

requestId(required): integer(int64)

the job request ID

Supported Media Types

application/json
application/vnd.oracle.resource+json

Root Schema : schema

Type: object

Show Source

requestHandle: string

The request handle associated with the executing request represents an opaque identifer for the executing instance of the request.
status: string

Allowed Values: [ "SUCCESS", "UPDATE", "PAUSE", "WARNING", "ERROR", "BUSINESS_ERROR", "CANCEL", "SUSPEND" ]

Callback status of an asynchronous job. Returning an asynchronous status does not guarantee that the state of the request will change to the corresponding value. The new state of the request will depend on the old state, the async status, and any errors that may occur in subsequent processing. SUCCESS -- the job ran successfully UPDATE -- the asynchronous job is updated PAUSE -- the job has paused for the execution of sub-requests WARNING -- the job is issuing a warning ERROR -- the job encountered a retryable error CANCEL -- The job has cancelled its execution. Usually this originates from cancelling the job using the scheduler APIs SUSPEND -- the job has suspended itself BUSINESS_ERROR -- the job encountered a non-retryable error
statusMessage: string

An error message if the status is ERROR or BUSINESS_ERROR, a warning message if the status is WARNING, the paused state if the status is PAUSED. The value will be ignored if the status is SUCCESS or CANCEL.

{
    "type":"object",
    "properties":{
        "requestHandle":{
            "type":"string",
            "description":"The request handle associated with the executing request represents an opaque identifer for the executing instance of the request."
        },
        "status":{
            "type":"string",
            "description":"Callback status of an asynchronous job. Returning an asynchronous status does not guarantee\nthat the state of the request will change to the corresponding value. The new state of the request\nwill depend on the old state, the async status, and any errors that may occur in subsequent processing.\n\nSUCCESS         -- the job ran successfully\n\nUPDATE          -- the asynchronous job is updated\n\nPAUSE           -- the job has paused for the execution of sub-requests\n\nWARNING         -- the job is issuing a warning\n\nERROR           -- the job encountered a retryable error\n\nCANCEL          -- The job has cancelled its execution. Usually this originates from cancelling the job using the scheduler APIs\n\nSUSPEND         -- the job has suspended itself\n\nBUSINESS_ERROR  -- the job encountered a non-retryable error\n",
            "enum":[
                "SUCCESS",
                "UPDATE",
                "PAUSE",
                "WARNING",
                "ERROR",
                "BUSINESS_ERROR",
                "CANCEL",
                "SUSPEND"
            ]
        },
        "statusMessage":{
            "type":"string",
            "description":"An error message if the status is ERROR or BUSINESS_ERROR, a warning message if the status\nis WARNING, the paused state if the status is PAUSED. The value will be ignored if the\nstatus is SUCCESS or CANCEL.\n"
        }
    }
}

Root Schema : schema

Type: object

Show Source

requestHandle: string

The request handle associated with the executing request represents an opaque identifer for the executing instance of the request.
status: string

Allowed Values: [ "SUCCESS", "UPDATE", "PAUSE", "WARNING", "ERROR", "BUSINESS_ERROR", "CANCEL", "SUSPEND" ]

Callback status of an asynchronous job. Returning an asynchronous status does not guarantee that the state of the request will change to the corresponding value. The new state of the request will depend on the old state, the async status, and any errors that may occur in subsequent processing. SUCCESS -- the job ran successfully UPDATE -- the asynchronous job is updated PAUSE -- the job has paused for the execution of sub-requests WARNING -- the job is issuing a warning ERROR -- the job encountered a retryable error CANCEL -- The job has cancelled its execution. Usually this originates from cancelling the job using the scheduler APIs SUSPEND -- the job has suspended itself BUSINESS_ERROR -- the job encountered a non-retryable error
statusMessage: string

An error message if the status is ERROR or BUSINESS_ERROR, a warning message if the status is WARNING, the paused state if the status is PAUSED. The value will be ignored if the status is SUCCESS or CANCEL.

{
    "type":"object",
    "properties":{
        "requestHandle":{
            "type":"string",
            "description":"The request handle associated with the executing request represents an opaque identifer for the executing instance of the request."
        },
        "status":{
            "type":"string",
            "description":"Callback status of an asynchronous job. Returning an asynchronous status does not guarantee\nthat the state of the request will change to the corresponding value. The new state of the request\nwill depend on the old state, the async status, and any errors that may occur in subsequent processing.\n\nSUCCESS         -- the job ran successfully\n\nUPDATE          -- the asynchronous job is updated\n\nPAUSE           -- the job has paused for the execution of sub-requests\n\nWARNING         -- the job is issuing a warning\n\nERROR           -- the job encountered a retryable error\n\nCANCEL          -- The job has cancelled its execution. Usually this originates from cancelling the job using the scheduler APIs\n\nSUSPEND         -- the job has suspended itself\n\nBUSINESS_ERROR  -- the job encountered a non-retryable error\n",
            "enum":[
                "SUCCESS",
                "UPDATE",
                "PAUSE",
                "WARNING",
                "ERROR",
                "BUSINESS_ERROR",
                "CANCEL",
                "SUSPEND"
            ]
        },
        "statusMessage":{
            "type":"string",
            "description":"An error message if the status is ERROR or BUSINESS_ERROR, a warning message if the status\nis WARNING, the paused state if the status is PAUSED. The value will be ignored if the\nstatus is SUCCESS or CANCEL.\n"
        }
    }
}

Response

Supported Media Types

application/json
application/vnd.oracle.resource+json

200 Response

Root Schema : Links

Type: array

Show Source

Array of: object Link

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : Link

Type: object

Show Source

href(required): string
rel(required): string

Allowed Values: [ "self", "cancel", "forceCancel", "hold", "release", "subscribe", "permissions", "executionStatus" ]

{
    "required":[
        "href",
        "rel"
    ],
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "enum":[
                "self",
                "cancel",
                "forceCancel",
                "hold",
                "release",
                "subscribe",
                "permissions",
                "executionStatus"
            ]
        },
        "href":{
            "type":"string"
        }
    }
}

400 Response

Invalid input

Root Schema : SimpleExceptionDetail

Type: object

Show Source

detail: string

Detailed error message
errorCode: string

ESS-specific error code. For example ESS-00500.
status: integer

HTTP status code
title(required): string

summary error message
type(required): string

URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page.

{
    "required":[
        "title",
        "type"
    ],
    "type":"object",
    "properties":{
        "type":{
            "type":"string",
            "description":"URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page."
        },
        "title":{
            "type":"string",
            "description":"summary error message"
        },
        "status":{
            "type":"integer",
            "description":"HTTP status code"
        },
        "detail":{
            "type":"string",
            "description":"Detailed error message"
        },
        "errorCode":{
            "type":"string",
            "description":"ESS-specific error code. For example ESS-00500."
        }
    }
}

403 Response

Not allowed for this operation

Root Schema : SimpleExceptionDetail

Type: object

Show Source

detail: string

Detailed error message
errorCode: string

ESS-specific error code. For example ESS-00500.
status: integer

HTTP status code
title(required): string

summary error message
type(required): string

URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page.

{
    "required":[
        "title",
        "type"
    ],
    "type":"object",
    "properties":{
        "type":{
            "type":"string",
            "description":"URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page."
        },
        "title":{
            "type":"string",
            "description":"summary error message"
        },
        "status":{
            "type":"integer",
            "description":"HTTP status code"
        },
        "detail":{
            "type":"string",
            "description":"Detailed error message"
        },
        "errorCode":{
            "type":"string",
            "description":"ESS-specific error code. For example ESS-00500."
        }
    }
}

404 Response

Request ID not found

Root Schema : SimpleExceptionDetail

Type: object

Show Source

detail: string

Detailed error message
errorCode: string

ESS-specific error code. For example ESS-00500.
status: integer

HTTP status code
title(required): string

summary error message
type(required): string

URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page.

{
    "required":[
        "title",
        "type"
    ],
    "type":"object",
    "properties":{
        "type":{
            "type":"string",
            "description":"URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page."
        },
        "title":{
            "type":"string",
            "description":"summary error message"
        },
        "status":{
            "type":"integer",
            "description":"HTTP status code"
        },
        "detail":{
            "type":"string",
            "description":"Detailed error message"
        },
        "errorCode":{
            "type":"string",
            "description":"ESS-specific error code. For example ESS-00500."
        }
    }
}

500 Response

A scheduling sub-system error occurred.

Root Schema : SimpleExceptionDetail

Type: object

Show Source

detail: string

Detailed error message
errorCode: string

ESS-specific error code. For example ESS-00500.
status: integer

HTTP status code
title(required): string

summary error message
type(required): string

URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page.

{
    "required":[
        "title",
        "type"
    ],
    "type":"object",
    "properties":{
        "type":{
            "type":"string",
            "description":"URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page."
        },
        "title":{
            "type":"string",
            "description":"summary error message"
        },
        "status":{
            "type":"integer",
            "description":"HTTP status code"
        },
        "detail":{
            "type":"string",
            "description":"Detailed error message"
        },
        "errorCode":{
            "type":"string",
            "description":"ESS-specific error code. For example ESS-00500."
        }
    }
}