Skip to main content

Create File

Description​

Create a file.

Function Signature:​

def create_file(ws_config: WebServiceConfig, device_serial: str, filename: str, file_size: int, sha256_hash: str) -> FileResult:

Parameters​

  • ws_config (WebServiceConfig): Configuration for the web service connection.
  • device_serial (str): Device serial number.
  • filename (str): File name.
  • file_size (int): File size in bytes.
  • sha256_hash (str): SHA-256 hash of the file.

Returns​

  • FileResult: A result object containing:
    • code: HTTP status code (200 for success, -1 for exceptions).
    • description: Response body or error message.
    • file: Parsed response data when available.

Example Usage​

# Example usage
ws_config = WebServiceConfig(access_key="key", secret_key="secret", base_url="https://api.example.com/")
device_serial = "example"
filename = "example"
file_size = 1
sha256_hash = "example"
result = create_file(ws_config, device_serial, filename, file_size, sha256_hash)
print(result)

Behavior​

  • Sends a signed request to the web service.
  • On success (code 200), response data is parsed into the result object.
  • On success, returns the computed value or result object.

Error Handling​

  • Exceptions set the result code to -1 and include an error message when implemented.