Skip to content

Latest commit

 

History

History
38 lines (30 loc) · 3.02 KB

FileOperationDto.md

File metadata and controls

38 lines (30 loc) · 3.02 KB

FileOperationDto

One background file operation of the caller, as it stood when the answer was built.

Properties

Name Type Description Notes
id str The identifier of the operation, the one to pass to PUT api/2.0/files/fileops/terminate/{id} to stop it. Operations belong to the account that started them, so an identifier of somebody else is never listed here.
operation FileOperationType What the operation does with the entries, which also decides what else is reported: only a download fills url, and a deletion leaves files and folders empty.
progress int How far the operation has come, from 0 to 100. Reaching 100 only means it stopped; whether it did what it was asked for is told by error.
error str The reason the operation could not finish its work, in the language of the request. Empty when nothing went wrong, which is the only way to tell a successful operation from a failed one.
processed str How many entries the operation has handled so far, written as a decimal number in a string. It counts items, not percent, and stays behind progress on operations that walk into subfolders.
finished bool Whether the operation has stopped running. A finished operation is reported once and then dropped, so the next read of the operation list no longer contains it.
url str The address the packed archive can be downloaded from once a bulk download has finished. Empty for every other kind of operation. [optional]
files List[FileEntryBaseDto] The files the operation produced or moved, in the order it wrote them down. Empty while nothing has been written yet and for a deletion, which reports no entries at all. [optional]
folders List[FileEntryBaseDto] The folders the operation produced or moved, in the order it wrote them down. Empty while nothing has been written yet and for a deletion. [optional]
status DistributedTaskStatus The state of the background task behind the operation, which tells a task that was cancelled or that crashed from one that ran to its end. [optional]

Example

from docspace_api_sdk.models.file_operation_dto import FileOperationDto

# TODO update the JSON string below
json = "{}"
# create an instance of FileOperationDto from a JSON string
file_operation_dto_instance = FileOperationDto.from_json(json)
# print the JSON string representation of the object
print(FileOperationDto.to_json())

# convert the object into a dict
file_operation_dto_dict = file_operation_dto_instance.to_dict()
# create an instance of FileOperationDto from a dict
file_operation_dto_from_dict = FileOperationDto.from_dict(file_operation_dto_dict)

[Back to Model list] [Back to API list] [Back to README]