All Products
Search

This Product

    ApsaraVideo VOD:Upload OSS objects

    Document Center

    ApsaraVideo VOD:Upload OSS objects

    Last Updated:Jul 05, 2019

    Overview

    After obtaining the upload URL and credential for a video or image, you can use Base64 decoding to obtain the STS token and URL for OSS upload. Then, call the following operations to upload the video or image file.

    For your convenience, we recommend that you use an upload SDK.

    Simple upload operations

    Note: The maximum size of an object to be uploaded is 5 GB. Resumable upload is not supported.

    Operation Description
    PutObject Uploads an object in simple mode.
    PostObject Uploads an object by using the HTML form.
    AppendObject Uploads an object in append mode.

    Multipart upload operations

    Note: The maximum size of an object to be uploaded is 48.8 TB. Resumable upload is supported.

    Operation Description
    InitiateMultipartUpload Initializes a multipart upload event.
    UploadPart Uploads an object in multipart mode.
    CompleteMultipartUpload Completes the multipart upload of the entire object.
    AbortMultipartUpload Cancels a multipart upload event.
    ListMultipartUploads Lists all the ongoing multipart upload events.
    ListParts Lists all uploaded parts matching a specific upload ID.

    Upload verification operations

    Note: You can obtain the 64-bit CRC value from the metadata of an object to check the data integrity of the object.

    Operation Description
    GetObjectMeta Obtains the metadata of an object.
    HeadObject Obtains the metadata of an object. This operation functions the same as the GetObjectMeta operation.

    Instructions

    Before calling an operation, ensure that you have obtained and decoded the upload URL and credential. The mapping between request parameters and decoded upload information is as follows:

    • The ObjectName parameter maps to the decoded FileName parameter.

    • The Host parameter maps to the decoded Bucket.Endpoint parameter.

      Note: Place http(s): of the Endpoint parameter at the very beginning.

    • When calculating the value of the Authorization parameter:

      • Use the decoded AccessKey ID and AccessKey Secret pair as the signature key. Do not use the AccessKey of your own account.
      • Include the decoded SecurityToken parameter in the request header or in a URL as a request parameter. Use either of these two methods to specify the AccessKey. If both methods are used, OSS returns an InvalidArgument error.
      • Include x-oss-security-token:SecurityToken in the header. When calculating CanonicalizedOSSHeaders for a signature, take x-oss-security-token into consideration.

      • Include security-token=SecurityToken in a URL. When calculating CanonicalizedResource for a signature, include security-token as a sub-resource.

        Note: For more information about how to calculate Authorization for a signature, see Add a signature to the header and Add a signature to a URL.

    If you call OSS operations, you need to go through a complex process to calculate a signature. We recommend that you use an OSS upload SDK.