BatchJobSchedule Class
A Job Schedule that allows recurring Jobs by specifying when to run Jobs and a specification used to create each Job.
Constructor
BatchJobSchedule(*args: Any, **kwargs: Any)
Variables
| Name | Description |
|---|---|
|
id
|
A string that uniquely identifies the schedule within the Account. Required. |
|
display_name
|
The display name for the schedule. |
|
url
|
The URL of the Job Schedule. Required. |
|
etag
|
The ETag of the Job Schedule. This is an opaque string. You can use it to detect whether the Job Schedule has changed between requests. In particular, you can be pass the ETag with an Update Job Schedule request to specify that your changes should take effect only if nobody else has modified the schedule in the meantime. Required. |
|
last_modified
|
The last modified time of the Job Schedule. This is the last time at which the schedule level data, such as the Job specification or recurrence information, changed. It does not factor in job-level changes such as new Jobs being created or Jobs changing state. Required. |
|
creation_time
|
The creation time of the Job Schedule. Required. |
|
state
|
The current state of the Job Schedule. Required. Known values are: "active", "completed", "disabled", "terminating", and "deleting". |
|
state_transition_time
|
The time at which the Job Schedule entered the current state. Required. |
|
previous_state
|
The previous state of the Job Schedule. This property is not present if the Job Schedule is in its initial active state. Known values are: "active", "completed", "disabled", "terminating", and "deleting". |
|
previous_state_transition_time
|
The time at which the Job Schedule entered its previous state. This property is not present if the Job Schedule is in its initial active state. |
|
schedule
|
The schedule according to which Jobs will be created. All times are fixed respective to UTC and are not impacted by daylight saving time. |
|
job_specification
|
The details of the Jobs to be created on this schedule. Required. |
|
execution_info
|
Information about Jobs that have been and will be run under this schedule. Required. |
|
metadata
|
A list of name-value pairs associated with the schedule as metadata. The Batch service does not assign any meaning to metadata; it is solely for the use of user code. |
|
job_schedule_statistics
|
The lifetime resource usage statistics for the Job Schedule. The statistics may not be immediately available. The Batch service performs periodic roll-up of statistics. The typical delay is about 30 minutes. |
Methods
| as_dict |
Return a dict that can be turned into json using json.dump. |
| clear |
Remove all items from D. |
| copy | |
| get |
Get the value for key if key is in the dictionary, else default. :param str key: The key to look up. :param any default: The value to return if key is not in the dictionary. Defaults to None :returns: D[k] if k in D, else d. :rtype: any |
| items | |
| keys | |
| pop |
Removes specified key and return the corresponding value. :param str key: The key to pop. :param any default: The value to return if key is not in the dictionary :returns: The value corresponding to the key. :rtype: any :raises KeyError: If key is not found and default is not given. |
| popitem |
Removes and returns some (key, value) pair :returns: The (key, value) pair. :rtype: tuple :raises KeyError: if D is empty. |
| setdefault |
Same as calling D.get(k, d), and setting D[k]=d if k not found :param str key: The key to look up. :param any default: The value to set if key is not in the dictionary :returns: D[k] if k in D, else d. :rtype: any |
| update |
Updates D from mapping/iterable E and F. :param any args: Either a mapping object or an iterable of key-value pairs. |
| values |
as_dict
Return a dict that can be turned into json using json.dump.
as_dict(*, exclude_readonly: bool = False) -> dict[str, Any]
Keyword-Only Parameters
| Name | Description |
|---|---|
|
exclude_readonly
|
Whether to remove the readonly properties. Default value: False
|
Returns
| Type | Description |
|---|---|
|
A dict JSON compatible object |
clear
Remove all items from D.
clear() -> None
copy
copy() -> Model
get
Get the value for key if key is in the dictionary, else default. :param str key: The key to look up. :param any default: The value to return if key is not in the dictionary. Defaults to None :returns: D[k] if k in D, else d. :rtype: any
get(key: str, default: Any = None) -> Any
Parameters
| Name | Description |
|---|---|
|
key
Required
|
|
|
default
|
Default value: None
|
items
items() -> ItemsView[str, Any]
Returns
| Type | Description |
|---|---|
|
set-like object providing a view on D's items |
keys
keys() -> KeysView[str]
Returns
| Type | Description |
|---|---|
|
a set-like object providing a view on D's keys |
pop
Removes specified key and return the corresponding value. :param str key: The key to pop. :param any default: The value to return if key is not in the dictionary :returns: The value corresponding to the key. :rtype: any :raises KeyError: If key is not found and default is not given.
pop(key: str, default: ~typing.Any = <object object>) -> Any
Parameters
| Name | Description |
|---|---|
|
key
Required
|
|
|
default
|
|
popitem
Removes and returns some (key, value) pair :returns: The (key, value) pair. :rtype: tuple :raises KeyError: if D is empty.
popitem() -> tuple[str, Any]
setdefault
Same as calling D.get(k, d), and setting D[k]=d if k not found :param str key: The key to look up. :param any default: The value to set if key is not in the dictionary :returns: D[k] if k in D, else d. :rtype: any
setdefault(key: str, default: ~typing.Any = <object object>) -> Any
Parameters
| Name | Description |
|---|---|
|
key
Required
|
|
|
default
|
|
update
Updates D from mapping/iterable E and F. :param any args: Either a mapping object or an iterable of key-value pairs.
update(*args: Any, **kwargs: Any) -> None
values
values() -> ValuesView[Any]
Returns
| Type | Description |
|---|---|
|
an object providing a view on D's values |
Attributes
creation_time
The creation time of the Job Schedule. Required.
creation_time: datetime
display_name
The display name for the schedule.
display_name: str | None
etag
The ETag of the Job Schedule. This is an opaque string. You can use it to detect whether the Job Schedule has changed between requests. In particular, you can be pass the ETag with an Update Job Schedule request to specify that your changes should take effect only if nobody else has modified the schedule in the meantime. Required.
etag: str
execution_info
Information about Jobs that have been and will be run under this schedule. Required.
execution_info: _models.BatchJobScheduleExecutionInfo
id
A string that uniquely identifies the schedule within the Account. Required.
id: str
job_schedule_statistics
The lifetime resource usage statistics for the Job Schedule. The statistics may not be immediately available. The Batch service performs periodic roll-up of statistics. The typical delay is about 30 minutes.
job_schedule_statistics: _models.BatchJobScheduleStatistics | None
job_specification
The details of the Jobs to be created on this schedule. Required.
job_specification: _models.BatchJobSpecification
last_modified
The last modified time of the Job Schedule. This is the last time at which the schedule level data, such as the Job specification or recurrence information, changed. It does not factor in job-level changes such as new Jobs being created or Jobs changing state. Required.
last_modified: datetime
metadata
A list of name-value pairs associated with the schedule as metadata. The Batch service does not assign any meaning to metadata; it is solely for the use of user code.
metadata: list['_models.BatchMetadataItem'] | None
previous_state
The previous state of the Job Schedule. This property is not present if the Job Schedule is in its initial active state. Known values are: "active", "completed", "disabled", "terminating", and "deleting".
previous_state: str | _models.BatchJobScheduleState | None
previous_state_transition_time
The time at which the Job Schedule entered its previous state. This property is not present if the Job Schedule is in its initial active state.
previous_state_transition_time: datetime | None
schedule
The schedule according to which Jobs will be created. All times are fixed respective to UTC and are not impacted by daylight saving time.
schedule: _models.BatchJobScheduleConfiguration | None
state
"active", "completed", "disabled", "terminating", and "deleting".
state: str | _models.BatchJobScheduleState
state_transition_time
The time at which the Job Schedule entered the current state. Required.
state_transition_time: datetime
url
The URL of the Job Schedule. Required.
url: str