Simple Upload

Last updated: 2021-03-08 17:18:28

    Simple upload refers to uploading objects using the PUT Object API. It is suitable for uploading an object smaller than 5 GB in a single request.

    To upload an object larger than 5 GB, you can use:

    • The COS console: You can upload an object up to 512 GB. For more information, please see Uploading Objects.
    • Multipart upload with APIs or SDKs: You can upload an object up to 48.82 TB (i.e., 50,000 GB). For more information, please see Multipart Upload
    • COSCMD: You can upload an object up to 40 TB. For more information, please see COSCMD.

    Note:


    When initiating a request, if you want to specify a directory or path, you can use /. For example, if you need to upload picture.png to the doc directory, set the object key to doc/picture.png.

    Use Cases

    Simple upload is suitable for uploading an object smaller than 5 GB.

    In a high bandwidth or weak network environment, if your object is relatively large, for example, over 100 MB, you are advised to use Multipart Upload, even if the object is smaller than 5 GB. This is because multipart upload supports uploading multiple parts concurrently, which gives full play to resources in high bandwidth environments. On the other hand, in weak network environments, the uploaded parts will not be affected by the failed ones. Therefore, failed parts can be re-uploaded with a simple retry, improving the overall upload success rate. For more information about uploading objects with a client in a weak network environment, please see Multipart Upload Resumption in a Weak Network Environment.

    Directions

    Using RESTful APIs

    You can use RESTful APIs directly to initiate a simple upload request. For more information, please see PUT Object.

    Using SDKs

    You can directly call the simple upload method in the SDK. For more information, please see the SDK documentation for the corresponding programming language below:

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help