disable_schedule¶
- SchedulesApi.disable_schedule(role_id, id, datalab_id=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)¶
Disable a schedule
Disables a job/event schedule, or a notebook datalab schedule when DatalabId is provided. Requires editor access on the schedule (or datalab for notebook schedules).
- Parameters:
role_id (str) – Amorphic role ID used for authorization. (required)
id (str) – Schedule ID to disable. (required)
datalab_id (str) – When set, disables a notebook datalab schedule for this datalab (sagemaker-notebook). Omit for job/event schedules.
_request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.
_request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.
_content_type (str, Optional) – force content-type for the request.
_headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.
_host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.
- Return type:
- Returns:
Returns the result object.
Request and Response Examples¶
HTTP: PUT /schedules/{id}/disable
Parameter examples¶
Name |
In |
Example |
|---|---|---|
|
header |
|
|
path |
|
|
query |
|
Success (HTTP 200)¶
Schedule disabled. Job schedules return `Schedule disabled`; datalab schedules return `Successfully disabled notebook schedule`.
jobScheduleDisabled
{
"Message": "Schedule disabled"
}
datalabScheduleDisabled
{
"Message": "Successfully disabled notebook schedule"
}
Errors¶
Documented error codes: IPV-1002.
HTTP 400
Validation or authorization failure (missing schedule, no editor access, or invalid datalab schedule).
notFound
{
"Message": "IPV-1002 - Invalid value for parameter - ScheduleId"
}
HTTP 500
Unexpected server error while disabling the schedule.
disableFailed
{
"Message": "Unable to disable schedule, error - ..."
}