WorkRequest¶

class oci.iot.models.WorkRequest(**kwargs)¶

Bases: object

An asynchronous work request helps monitor long-running operations. When you initiate a long-running operation, the service creates a work request. This work request acts as an activity log, allowing you to track each step of the operation’s progress. Each work request has an OCID, enabling programmatic interaction and automation.

Attributes

`OPERATION_TYPE_CHANGE_IOT_DOMAIN_DATA_RETENTION`	A constant which can be used with the operation_type property of a WorkRequest.
`OPERATION_TYPE_CONFIGURE_DOMAIN_DATA_ACCESS`	A constant which can be used with the operation_type property of a WorkRequest.
`OPERATION_TYPE_CONFIGURE_DOMAIN_GROUP_DATA_ACCESS`	A constant which can be used with the operation_type property of a WorkRequest.
`OPERATION_TYPE_CREATE_IOT_DOMAIN`	A constant which can be used with the operation_type property of a WorkRequest.
`OPERATION_TYPE_CREATE_IOT_DOMAIN_GROUP`	A constant which can be used with the operation_type property of a WorkRequest.
`OPERATION_TYPE_DELETE_IOT_DOMAIN`	A constant which can be used with the operation_type property of a WorkRequest.
`OPERATION_TYPE_DELETE_IOT_DOMAIN_GROUP`	A constant which can be used with the operation_type property of a WorkRequest.
`OPERATION_TYPE_MOVE_IOT_DOMAIN`	A constant which can be used with the operation_type property of a WorkRequest.
`OPERATION_TYPE_MOVE_IOT_DOMAIN_GROUP`	A constant which can be used with the operation_type property of a WorkRequest.
`OPERATION_TYPE_UPDATE_IOT_DOMAIN`	A constant which can be used with the operation_type property of a WorkRequest.
`OPERATION_TYPE_UPDATE_IOT_DOMAIN_GROUP`	A constant which can be used with the operation_type property of a WorkRequest.
`STATUS_ACCEPTED`	A constant which can be used with the status property of a WorkRequest.
`STATUS_FAILED`	A constant which can be used with the status property of a WorkRequest.
`STATUS_IN_PROGRESS`	A constant which can be used with the status property of a WorkRequest.
`STATUS_NEEDS_ATTENTION`	A constant which can be used with the status property of a WorkRequest.
`STATUS_SUCCEEDED`	A constant which can be used with the status property of a WorkRequest.
`STATUS_WAITING`	A constant which can be used with the status property of a WorkRequest.
`compartment_id`	[Required] Gets the compartment_id of this WorkRequest.
`id`	[Required] Gets the id of this WorkRequest.
`operation_type`	[Required] Gets the operation_type of this WorkRequest.
`percent_complete`	[Required] Gets the percent_complete of this WorkRequest.
`resources`	[Required] Gets the resources of this WorkRequest.
`status`	[Required] Gets the status of this WorkRequest.
`time_accepted`	[Required] Gets the time_accepted of this WorkRequest.
`time_finished`	Gets the time_finished of this WorkRequest.
`time_started`	Gets the time_started of this WorkRequest.
`time_updated`	Gets the time_updated of this WorkRequest.

Methods

__init__(**kwargs) Initializes a new WorkRequest object with values from keyword arguments.

OPERATION_TYPE_CHANGE_IOT_DOMAIN_DATA_RETENTION = 'CHANGE_IOT_DOMAIN_DATA_RETENTION'¶: A constant which can be used with the operation_type property of a WorkRequest. This constant has a value of “CHANGE_IOT_DOMAIN_DATA_RETENTION”

OPERATION_TYPE_CONFIGURE_DOMAIN_DATA_ACCESS = 'CONFIGURE_DOMAIN_DATA_ACCESS'¶: A constant which can be used with the operation_type property of a WorkRequest. This constant has a value of “CONFIGURE_DOMAIN_DATA_ACCESS”

OPERATION_TYPE_CONFIGURE_DOMAIN_GROUP_DATA_ACCESS = 'CONFIGURE_DOMAIN_GROUP_DATA_ACCESS'¶: A constant which can be used with the operation_type property of a WorkRequest. This constant has a value of “CONFIGURE_DOMAIN_GROUP_DATA_ACCESS”

OPERATION_TYPE_CREATE_IOT_DOMAIN = 'CREATE_IOT_DOMAIN'¶: A constant which can be used with the operation_type property of a WorkRequest. This constant has a value of “CREATE_IOT_DOMAIN”

OPERATION_TYPE_CREATE_IOT_DOMAIN_GROUP = 'CREATE_IOT_DOMAIN_GROUP'¶: A constant which can be used with the operation_type property of a WorkRequest. This constant has a value of “CREATE_IOT_DOMAIN_GROUP”

OPERATION_TYPE_DELETE_IOT_DOMAIN = 'DELETE_IOT_DOMAIN'¶: A constant which can be used with the operation_type property of a WorkRequest. This constant has a value of “DELETE_IOT_DOMAIN”

OPERATION_TYPE_DELETE_IOT_DOMAIN_GROUP = 'DELETE_IOT_DOMAIN_GROUP'¶: A constant which can be used with the operation_type property of a WorkRequest. This constant has a value of “DELETE_IOT_DOMAIN_GROUP”

OPERATION_TYPE_MOVE_IOT_DOMAIN = 'MOVE_IOT_DOMAIN'¶: A constant which can be used with the operation_type property of a WorkRequest. This constant has a value of “MOVE_IOT_DOMAIN”

OPERATION_TYPE_MOVE_IOT_DOMAIN_GROUP = 'MOVE_IOT_DOMAIN_GROUP'¶: A constant which can be used with the operation_type property of a WorkRequest. This constant has a value of “MOVE_IOT_DOMAIN_GROUP”

OPERATION_TYPE_UPDATE_IOT_DOMAIN = 'UPDATE_IOT_DOMAIN'¶: A constant which can be used with the operation_type property of a WorkRequest. This constant has a value of “UPDATE_IOT_DOMAIN”

OPERATION_TYPE_UPDATE_IOT_DOMAIN_GROUP = 'UPDATE_IOT_DOMAIN_GROUP'¶: A constant which can be used with the operation_type property of a WorkRequest. This constant has a value of “UPDATE_IOT_DOMAIN_GROUP”

STATUS_ACCEPTED = 'ACCEPTED'¶: A constant which can be used with the status property of a WorkRequest. This constant has a value of “ACCEPTED”

STATUS_FAILED = 'FAILED'¶: A constant which can be used with the status property of a WorkRequest. This constant has a value of “FAILED”

STATUS_IN_PROGRESS = 'IN_PROGRESS'¶: A constant which can be used with the status property of a WorkRequest. This constant has a value of “IN_PROGRESS”

STATUS_NEEDS_ATTENTION = 'NEEDS_ATTENTION'¶: A constant which can be used with the status property of a WorkRequest. This constant has a value of “NEEDS_ATTENTION”

STATUS_SUCCEEDED = 'SUCCEEDED'¶: A constant which can be used with the status property of a WorkRequest. This constant has a value of “SUCCEEDED”

STATUS_WAITING = 'WAITING'¶: A constant which can be used with the status property of a WorkRequest. This constant has a value of “WAITING”

__init__(**kwargs)¶

Initializes a new WorkRequest object with values from keyword arguments. The following keyword arguments are supported (corresponding to the getters/setters of this class):

Parameters:

operation_type (str) – The value to assign to the operation_type property of this WorkRequest. Allowed values for this property are: “CREATE_IOT_DOMAIN”, “UPDATE_IOT_DOMAIN”, “DELETE_IOT_DOMAIN”, “MOVE_IOT_DOMAIN”, “MOVE_IOT_DOMAIN_GROUP”, “CREATE_IOT_DOMAIN_GROUP”, “UPDATE_IOT_DOMAIN_GROUP”, “DELETE_IOT_DOMAIN_GROUP”, “CONFIGURE_DOMAIN_DATA_ACCESS”, “CONFIGURE_DOMAIN_GROUP_DATA_ACCESS”, “CHANGE_IOT_DOMAIN_DATA_RETENTION”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
status (str) – The value to assign to the status property of this WorkRequest. Allowed values for this property are: “ACCEPTED”, “IN_PROGRESS”, “WAITING”, “NEEDS_ATTENTION”, “FAILED”, “SUCCEEDED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
id (str) – The value to assign to the id property of this WorkRequest.
compartment_id (str) – The value to assign to the compartment_id property of this WorkRequest.
resources (list[oci.iot.models.WorkRequestResource]) – The value to assign to the resources property of this WorkRequest.
percent_complete (float) – The value to assign to the percent_complete property of this WorkRequest.
time_accepted (datetime) – The value to assign to the time_accepted property of this WorkRequest.
time_started (datetime) – The value to assign to the time_started property of this WorkRequest.
time_finished (datetime) – The value to assign to the time_finished property of this WorkRequest.
time_updated (datetime) – The value to assign to the time_updated property of this WorkRequest.

compartment_id¶

[Required] Gets the compartment_id of this WorkRequest. The OCID of the compartment that contains the work request.

Returns:	The compartment_id of this WorkRequest.
Return type:	str

id¶

[Required] Gets the id of this WorkRequest. The OCID of the work request.

Returns:	The id of this WorkRequest.
Return type:	str

operation_type¶

[Required] Gets the operation_type of this WorkRequest. The asynchronous operation tracked by this work request.

Allowed values for this property are: “CREATE_IOT_DOMAIN”, “UPDATE_IOT_DOMAIN”, “DELETE_IOT_DOMAIN”, “MOVE_IOT_DOMAIN”, “MOVE_IOT_DOMAIN_GROUP”, “CREATE_IOT_DOMAIN_GROUP”, “UPDATE_IOT_DOMAIN_GROUP”, “DELETE_IOT_DOMAIN_GROUP”, “CONFIGURE_DOMAIN_DATA_ACCESS”, “CONFIGURE_DOMAIN_GROUP_DATA_ACCESS”, “CHANGE_IOT_DOMAIN_DATA_RETENTION”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The operation_type of this WorkRequest.
Return type:	str

percent_complete¶

[Required] Gets the percent_complete of this WorkRequest. Shows the progress of the operation tracked by the work request as a percentage of the total work to be completed.

Returns:	The percent_complete of this WorkRequest.
Return type:	float

resources¶

[Required] Gets the resources of this WorkRequest. The resources that are affected by the work request.

Returns:	The resources of this WorkRequest.
Return type:	list[oci.iot.models.WorkRequestResource]

status¶

[Required] Gets the status of this WorkRequest. The status of the work request.

Allowed values for this property are: “ACCEPTED”, “IN_PROGRESS”, “WAITING”, “NEEDS_ATTENTION”, “FAILED”, “SUCCEEDED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The status of this WorkRequest.
Return type:	str

time_accepted¶

[Required] Gets the time_accepted of this WorkRequest. The date and time the work request was created, in the format defined by RFC 3339.

Returns:	The time_accepted of this WorkRequest.
Return type:	datetime

time_finished¶

Gets the time_finished of this WorkRequest. The date and time the work request was finished, in the format defined by RFC 3339.

Returns:	The time_finished of this WorkRequest.
Return type:	datetime

time_started¶

Gets the time_started of this WorkRequest. The date and time the work request was started, in the format defined by RFC 3339.

Returns:	The time_started of this WorkRequest.
Return type:	datetime

time_updated¶

Gets the time_updated of this WorkRequest. The date and time the work request was updated, in the format defined by RFC 3339.

Returns:	The time_updated of this WorkRequest.
Return type:	datetime