Simple upload refers to the upload of a single object by using the Put Object method in the OSS API. Simple upload is applicable to the scenario where a single HTTP request interaction completes an upload, for example, the upload of a small object.

Set object metadata when uploading an object

When using the simple upload, you can set object metadata that describes the object, for example, Content-Type and other standard HTTP headers. You can also set user-defined information. For more information, see Object metadata.

Upload restrictions

  • The maximum size of a single object is 5 GB.
  • The naming conventions of objects are as follows:
    • Object names must use UTF-8 encoding.
    • Object names must be at least 1 byte and no more than 1,023 bytes in length.
    • Object names cannot start with a backslash ( \ ) or a forward slash ( / ).

Upload large objects

In the single upload, objects are uploaded through a single HTTP request. Therefore, it may take a long time for you to upload large objects. If you experience bad network connection, the upload has a high failure rate. For objects larger than 5 GB, we recommend that you use multipart upload.

Security and authorization

To prevent unauthorized third parties from uploading objects to your bucket, OSS provides access control both on the bucket level and on the object level. For more information, see Access control. OSS also provides account-level authorization for third-party uploads. For more information, see Authorized third-party uploads.

Further operations

After uploading objects to OSS, you may want to:
  • Initiate a callback request to a specified application server. For more information, see Upload callback.
  • Process the uploaded images. For more information, see Image processing.


Best practices