PopoOpenPlatform Api icon

PopoOpenPlatform Api

POPO OpenPlatform API

Actions59

云空间 → 文件分片上传-创建文件

AI-generated

Overview

This node interacts with the POPO OpenPlatform API, specifically supporting the '云空间' (Cloud Drive) resource and the '文件分片上传-创建文件' (File Part Upload - Create File) operation. It facilitates the creation of a file after uploading its parts in a multipart upload process. This is useful for uploading large files in chunks, ensuring efficient and reliable file uploads to the cloud storage. Practical use cases include uploading large documents, videos, or datasets in parts to avoid upload failures and to resume interrupted uploads.

Use Case Examples

  1. Uploading a large video file by splitting it into parts and then creating the file in the cloud storage after all parts are uploaded.
  2. Uploading a large dataset in chunks to ensure the upload process is resilient to network interruptions.

Properties

Name Meaning
bucketName The name of the storage bucket where the file parts are uploaded.
objectKey The key or identifier for the object (file) in the storage bucket.
fileName The name of the file to be created after all parts are uploaded.
folderId The ID of the folder in the cloud drive where the file will be created.
shareType The type of link sharing for the file: 0 means no sharing, 1 means read-only sharing, 2 means edit sharing.
uploadId The upload session ID that identifies the multipart upload process.
transferOnlineDoc Indicates whether the file should be converted to an online document format (1 for yes). Only supports certain file extensions like docx, txt, xls, xlsx, csv.
keepFileDoc If the file is converted online, indicates whether to keep the original file (1 for yes).
permission The permission level for the file.
etags A collection of ETags for each uploaded part, used to verify the integrity of each part during the creation of the file.

Output

JSON

  • fileId - The unique identifier of the created file in the cloud drive.
  • fileName - The name of the created file.
  • uploadId - The upload session ID associated with the multipart upload.
  • status - The status of the file creation operation.

Dependencies

  • Requires an API key credential for authentication with the POPO OpenPlatform API.

Troubleshooting

  • Ensure that the uploadId corresponds to a valid multipart upload session; otherwise, the file creation will fail.
  • Verify that the etags collection contains valid ETag values for each part uploaded; missing or incorrect ETags can cause integrity check failures.
  • Check that the bucketName and objectKey are correctly specified and accessible.
  • If the file conversion to online document fails, verify that the file extension is supported and the transferOnlineDoc flag is set correctly.

Links

Discussion