Oracle Enterprise Scheduling Service

Initiate a force cancel operation for the job request

post

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

Complete an asynchronous request with a CANCEL status. The request will be transitioned to CANCELLED state if the prerequisites are met. 1. The caller must make sure the remote job is no longer executing. 2. The request must be waiting for an asynchronous response and be in CANCELLING state 3. It must be at least 30 minutes since the request was put in CANCELLING state or the last time the job checked in for this request.

Request

Path Parameters

requestId(required): integer(int64)

the job request ID

There's no request body for this operation.

Response

Supported Media Types

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

200 Response

Operation initiated

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

Unsupported state for 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."
        }
    }
}

403 Response

Not authorized to force cancel this request

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."
        }
    }
}

409 Response

Conflict

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

Scheduling sub-system error

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."
        }
    }
}