IRPCObjectOperations.UploadTempFileCommit

View as Markdown

Vault API / core write session or assertion idempotent

Completes an upload made with UploadTempFile.

ServiceObjects, versions, properties and files MFiles.IRPCObjectOperations
gRPC method/MFiles.IRPCObjectOperations/UploadTempFileCommit
HTTP (mf-http-grpc)POST /grpc/v1/upload-temp-file-commit
RequestUploadTempFileCommitRequest
ResponseUploadTempFileCommitResponse
Book and levelVault API, core
Kindwrite
SessionRequired: a session (mfiles-session-id-bin metadata) or a session assertion (x-mf-session-assertion metadata).
Idempotentyes
Returns metadata structure versionno
Streamingnone (unary)

Remarks

logical_size must equal the number of bytes uploaded. Otherwise the call fails with "File size mismatch." (0x8004003D) and the server removes the upload, so it must be uploaded again. Commit only once: a second commit of the same upload also fails with "File size mismatch." and removes it. The response is empty; the upload is used by its upload_id.

Request: UploadTempFileCommitRequest

Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

FieldTypeDescription
upload_idint32The ID from UploadTempFile.
logical_sizeint64The total number of bytes uploaded.
low_digestint64Leave 0.
high_digestint64Not checked by this method; leave 0.

Response: UploadTempFileCommitResponse

No fields.